[GUEST ACCESS MODE: Data is scrambled or limited to provide examples. Make requests using your API key to unlock full data. Check https://lunarcrush.ai/auth for authentication information.]

time	interactions
2025-10-11 21:00	3925719
2025-10-11 22:00	2648768
2025-10-11 23:00	2220601
2025-10-12 00:00	2227196
2025-10-12 01:00	2544807
2025-10-12 02:00	3303147
2025-10-12 03:00	2081859
2025-10-12 04:00	2426080
2025-10-12 05:00	2996796
2025-10-12 06:00	4102576
2025-10-12 07:00	2881493
2025-10-12 08:00	2883450
2025-10-12 09:00	3334220
2025-10-12 10:00	4587230
2025-10-12 11:00	3427479
2025-10-12 12:00	2910507
2025-10-12 13:00	3157410
2025-10-12 14:00	4524269
2025-10-12 15:00	2885916
2025-10-12 16:00	3570571
2025-10-12 17:00	6959144
2025-10-12 18:00	8237091
2025-10-12 19:00	5698909
2025-10-12 20:00	2936646
2025-10-12 21:00	2725138
2025-10-12 22:00	3295242
2025-10-12 23:00	2591306
2025-10-13 00:00	2452974
2025-10-13 01:00	2072446
2025-10-13 02:00	2471243
2025-10-13 03:00	2924240
2025-10-13 04:00	2414102
2025-10-13 05:00	1694691
2025-10-13 06:00	2343284
2025-10-13 07:00	2763799
2025-10-13 08:00	3067023
2025-10-13 09:00	2876129
2025-10-13 10:00	3040234
2025-10-13 11:00	2907630
2025-10-13 12:00	2569428
2025-10-13 13:00	2795783
2025-10-13 14:00	3200492
2025-10-13 15:00	3388285
2025-10-13 16:00	5958190
2025-10-13 17:00	6034958
2025-10-13 18:00	7227323
2025-10-13 19:00	3211108
2025-10-13 20:00	3607792
2025-10-13 21:00	3356388
2025-10-13 22:00	3126706
2025-10-13 23:00	2402943
2025-10-14 00:00	2673656
2025-10-14 01:00	2630569
2025-10-14 02:00	3383239
2025-10-14 03:00	3604574
2025-10-14 04:00	3208509
2025-10-14 05:00	3278991
2025-10-14 06:00	3629855
2025-10-14 07:00	3366541
2025-10-14 08:00	2781686
2025-10-14 09:00	2959712
2025-10-14 10:00	2911413
2025-10-14 11:00	3631866
2025-10-14 12:00	3438568
2025-10-14 13:00	3004967
2025-10-14 14:00	3048860
2025-10-14 15:00	4006910
2025-10-14 16:00	5067710
2025-10-14 17:00	4589069
2025-10-14 18:00	3577589
2025-10-14 19:00	3735650
2025-10-14 20:00	4135383
2025-10-14 21:00	3264362
2025-10-14 22:00	2247392
2025-10-14 23:00	2738931
2025-10-15 00:00	2968126
2025-10-15 01:00	2522957
2025-10-15 02:00	2724233
2025-10-15 03:00	2549334
2025-10-15 04:00	3009797
2025-10-15 05:00	3752559
2025-10-15 06:00	2278562
2025-10-15 07:00	2532388
2025-10-15 08:00	2699382
2025-10-15 09:00	2825204
2025-10-15 10:00	2345308
2025-10-15 11:00	2381044
2025-10-15 12:00	1570954
2025-10-15 13:00	3781275
2025-10-15 14:00	2728690
2025-10-15 15:00	3161038
2025-10-15 16:00	3970532
2025-10-15 17:00	5450699
2025-10-15 18:00	2796109
2025-10-15 19:00	3235562
2025-10-15 20:00	2646648
2025-10-15 21:00	3209834
2025-10-15 22:00	2062316
2025-10-15 23:00	1755282
2025-10-16 00:00	1792529
2025-10-16 01:00	1456188
2025-10-16 02:00	1672100
2025-10-16 03:00	2013318
2025-10-16 04:00	2562311
2025-10-16 05:00	2103121
2025-10-16 06:00	2713074
2025-10-16 07:00	2370679
2025-10-16 08:00	1806226
2025-10-16 09:00	2274152
2025-10-16 10:00	2975176
2025-10-16 11:00	2361265
2025-10-16 12:00	2355659
2025-10-16 13:00	2492470
2025-10-16 14:00	3162412
2025-10-16 15:00	2696405
2025-10-16 16:00	3193924
2025-10-16 17:00	3544635
2025-10-16 18:00	3866173
2025-10-16 19:00	3203678
2025-10-16 20:00	2158581
2025-10-16 21:00	1980893
2025-10-16 22:00	2546705
2025-10-16 23:00	2364434
2025-10-17 00:00	1812196
2025-10-17 01:00	2284456
2025-10-17 02:00	2807956
2025-10-17 03:00	2937821
2025-10-17 04:00	2350629
2025-10-17 05:00	2303395
2025-10-17 06:00	2198251
2025-10-17 07:00	3281031
2025-10-17 08:00	2508422
2025-10-17 09:00	2735964
2025-10-17 10:00	3173548
2025-10-17 11:00	3539375
2025-10-17 12:00	3081263
2025-10-17 13:00	2564938
2025-10-17 14:00	3456272
2025-10-17 15:00	3848658
2025-10-17 16:00	3508040
2025-10-17 17:00	5120281
2025-10-17 18:00	3903698
2025-10-17 19:00	4368372
2025-10-17 20:00	4063436
2025-10-17 21:00	3724986
2025-10-17 22:00	2849061
2025-10-17 23:00	3087252
2025-10-18 00:00	3285877
2025-10-18 01:00	2469394
2025-10-18 02:00	2547928
2025-10-18 03:00	3051656
2025-10-18 04:00	3364207
2025-10-18 05:00	2697717
2025-10-18 06:00	2755981
2025-10-18 07:00	2565683
2025-10-18 08:00	3636127
2025-10-18 09:00	3209060
2025-10-18 10:00	2985545
2025-10-18 11:00	2900263
2025-10-18 12:00	4136576
2025-10-18 13:00	3210918
2025-10-18 14:00	3160848
2025-10-18 15:00	3047609
2025-10-18 16:00	6409463
2025-10-18 17:00	3311421
2025-10-18 18:00	4445142
2025-10-18 19:00	2978380
2025-10-18 20:00	4051749
2025-10-18 21:00	3252213
2025-10-18 22:00	2033848
2025-10-18 23:00	1847551
2025-10-19 00:00	2204267
2025-10-19 01:00	2378498
2025-10-19 02:00	1987197
2025-10-19 03:00	2304749
2025-10-19 04:00	1904923
2025-10-19 05:00	2997313
2025-10-19 06:00	1922627
2025-10-19 07:00	2270417
2025-10-19 08:00	1750904
2025-10-19 09:00	2838891
2025-10-19 10:00	2310596
2025-10-19 11:00	2448254
2025-10-19 12:00	1860951
2025-10-19 13:00	3301002
2025-10-19 14:00	2685180
2025-10-19 15:00	2892316
2025-10-19 16:00	3060918
2025-10-19 17:00	4446188
2025-10-19 18:00	3669809
2025-10-19 19:00	3721767
2025-10-19 20:00	3273644

### Topics List

https://lunarcrush.com/api4/public/topics/list/v1

Get a list of trending social topics.

Example request:

```bash
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topics/list/v1
```



Example response:

```json
{
  "data": [
    {
      "topic": "youtube",
      "title": "YouTube",
      "topic_rank": 1,
      "topic_rank_1h_previous": 1,
      "topic_rank_24h_previous": 1,
      "num_contributors": 335952,
      "num_posts": 733220,
      "interactions_24h": 3296046298
    }
  ]
}
```

Schema:

+ **topic**: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
+ **title**: The case sensitive title of the topic or category
+ **topic_rank**: LunarCrush metric for ranking a social topic relative to all other social topics
+ **topic_rank_1h_previous**: The topic rank from X hour ago
+ **topic_rank_24h_previous**: The topic rank from XX hours ago
+ **num_contributors**: The number of unique social contributors to the topic
+ **num_posts**: Total number of posts with interactions on this topic in the last XX hours
+ **interactions_24h**: Number of interactions in the last XX hours




---

### Topic Time Series v2

https://lunarcrush.com/api4/public/topic/:topic/time-series/v2

Get historical time series data for a social topic

input parameters:

+ **topic**: _Provide the topic to get details for. A topic must be all lower case and can only include letters, numbers, spaces, # and $._ **required**
+ **bucket**: _Leave blank (default) for the most week aggregated by hour, specify hour for full historical data available in hourly aggregation, specify day for full historical data available in daily aggregation._ 

Example request:

```bash
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v2
```



Example response:

```json
{
  "config": {
    "topic": "bitcoin",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1759968000,
    "end": 1760654918,
    "bucket": "hour",
    "metrics": [],
    "generated": 1760647718
  },
  "data": [
    {
      "time": 1759968000,
      "contributors_active": 30745,
      "contributors_created": 1810,
      "interactions": 3972578,
      "posts_active": 62957,
      "posts_created": 2440,
      "sentiment": 78,
      "spam": 339,
      "alt_rank": 198,
      "circulating_supply": 19931834,
      "close": 123004.71,
      "galaxy_score": 56,
      "high": 123004.71,
      "low": 122931.87,
      "market_cap": 2453542301616,
      "market_dominance": 58.0797,
      "open": 123004.71,
      "social_dominance": 30.3039,
      "volume_24h": 62979418928
    }
  ]
}
```

Schema:

+ **config**: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
+ **topic**: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
+ **id**: LunarCrush internal ID for the asset
+ **name**: The full name of the asset
+ **symbol**: The symbol for the asset
+ **interval**: Typically used for specifying time intervals like 1w = X week, 1m = X month etc
+ **start**: Start/from unix timestamp (in seconds)
+ **end**: End/to unix timestamp (in seconds)
+ **bucket**: Data is generally bucketed into hours or days
+ **metrics**: Comma separated list of metrics to include or that are included
+ **generated**: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
+ **time**: A unix timestamp (in seconds)
+ **contributors_active**: number of unique social accounts with posts that have interactions
+ **contributors_created**: number of unique social accounts that created new posts
+ **interactions**: number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)
+ **posts_active**: number of unique social posts with interactions
+ **posts_created**: number of unique social posts created
+ **sentiment**: % of posts (weighted by interactions) that are positive. XXX% means all posts are positive, XX% is half positive and half negative, and X% is all negative posts.
+ **spam**: The number of posts created that are considered spam
+ **alt_rank**: A proprietary score based on how an asset is performing relative to all other assets supported
+ **circulating_supply**: Circulating Supply is the total number of coins or tokens that are actively available for trade and are being used in the market and in general public
+ **close**: Close price for the time period
+ **galaxy_score**: A proprietary score based on technical indicators of price, average social sentiment, relative social activity, and a factor of how closely social indicators correlate with price and volume
+ **high**: Higest price fo rthe time period
+ **low**: Lowest price for the time period
+ **market_cap**: Total dollar market value of all circulating supply or outstanding shares
+ **market_dominance**: The percent of the total market cap that this asset represents
+ **open**: Open price for the time period
+ **social_dominance**: The percent of the total social volume that this topic represents
+ **volume_24h**: Volume in USD for XX hours up to this data point




---

### Topic Time Series

https://lunarcrush.com/api4/public/topic/:topic/time-series/v1

Get historical time series data for a social topic

input parameters:

+ **topic**: _Provide the topic to get details for. A topic must be all lower case and can only include letters, numbers, spaces, # and $._ **required**
+ **bucket**: _bucket time series data into hours or days. default is hours._ 
+ **interval**: _Use interval to specify the start and end time automatically for convenience. If "start" or "end" parameters are provided this parameter is ignored._ 
+ **start**: _The start time (unix timestamp) to go back to._ 
+ **end**: _The end time (unix timestamp) to stop at._ 

Example request:

```bash
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v1
```



Example response:

```json
{
  "config": {
    "topic": "bitcoin",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1759968000,
    "end": 1760654918,
    "bucket": "hour",
    "metrics": [],
    "generated": 1760647718
  },
  "data": [
    {
      "time": 1759968000,
      "contributors_active": 30745,
      "contributors_created": 1810,
      "interactions": 3972578,
      "posts_active": 62957,
      "posts_created": 2440,
      "sentiment": 78,
      "spam": 339,
      "alt_rank": 198,
      "circulating_supply": 19931834,
      "close": 123004.71,
      "galaxy_score": 56,
      "high": 123004.71,
      "low": 122931.87,
      "market_cap": 2453542301616,
      "market_dominance": 58.0797,
      "open": 123004.71,
      "social_dominance": 30.3039,
      "volume_24h": 62979418928
    }
  ]
}
```

Schema:

+ **config**: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
+ **topic**: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
+ **id**: LunarCrush internal ID for the asset
+ **name**: The full name of the asset
+ **symbol**: The symbol for the asset
+ **interval**: Typically used for specifying time intervals like 1w = X week, 1m = X month etc
+ **start**: Start/from unix timestamp (in seconds)
+ **end**: End/to unix timestamp (in seconds)
+ **bucket**: Data is generally bucketed into hours or days
+ **metrics**: Comma separated list of metrics to include or that are included
+ **generated**: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
+ **time**: A unix timestamp (in seconds)
+ **contributors_active**: number of unique social accounts with posts that have interactions
+ **contributors_created**: number of unique social accounts that created new posts
+ **interactions**: number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)
+ **posts_active**: number of unique social posts with interactions
+ **posts_created**: number of unique social posts created
+ **sentiment**: % of posts (weighted by interactions) that are positive. XXX% means all posts are positive, XX% is half positive and half negative, and X% is all negative posts.
+ **spam**: The number of posts created that are considered spam
+ **alt_rank**: A proprietary score based on how an asset is performing relative to all other assets supported
+ **circulating_supply**: Circulating Supply is the total number of coins or tokens that are actively available for trade and are being used in the market and in general public
+ **close**: Close price for the time period
+ **galaxy_score**: A proprietary score based on technical indicators of price, average social sentiment, relative social activity, and a factor of how closely social indicators correlate with price and volume
+ **high**: Higest price fo rthe time period
+ **low**: Lowest price for the time period
+ **market_cap**: Total dollar market value of all circulating supply or outstanding shares
+ **market_dominance**: The percent of the total market cap that this asset represents
+ **open**: Open price for the time period
+ **social_dominance**: The percent of the total social volume that this topic represents
+ **volume_24h**: Volume in USD for XX hours up to this data point




---

### Topic Posts

https://lunarcrush.com/api4/public/topic/:topic/posts/v1

Get the top posts for a social topic. If start time is provided the result will be the top posts by interactions for the time range. If start is not provided it will be the most recent top posts by interactions from the last XX hours.

input parameters:

+ **topic**: _Provide the topic to get details for. A topic must be all lower case and can only include letters, numbers, spaces, # and $._ **required**
+ **start**: _The start time (unix timestamp) to start at. Will be rounded to the beginning of the day. If the end parameter is not provided it will just be the top posts for this day._ 
+ **end**: _(Optional) The end time (unix timestamp) to stop at. Will be rounded to the end of the day._ 

Example request:

```bash
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/posts/v1
```



Example response:

```json
{
  "config": {
    "topic": "bitcoin",
    "type": "topic",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "generated": 1760647718
  },
  "data": [
    {
      "id": "t3_1o7u058",
      "post_type": "reddit-post",
      "post_title": "Made this bitcoin shadow box. Not sure if I'm crazy about this design but it's something",
      "post_link": "https://redd.it/1o7u058",
      "post_image": null,
      "post_created": 1760646307,
      "post_sentiment": 3.2,
      "creator_id": "reddit::t2_kszqkqvk",
      "creator_name": "Outrageous-Garage179",
      "creator_display_name": "Outrageous-Garage179",
      "creator_avatar": "https://styles.redditmedia.com/t5_60m8fu/styles/profileIcon_63j7drb563fa1.png?width=256&height=256&crop=256:256,smart&s=9b79b5074a344e0e8cf39a127dcfa5c2f4b5ecf3",
      "interactions_24h": 1683,
      "interactions_total": 1683
    }
  ]
}
```

Schema:

+ **config**: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
+ **topic**: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
+ **type**: Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
+ **id**: Unique id of the social post
+ **name**: The full name of the asset
+ **symbol**: The symbol for the asset
+ **generated**: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
+ **post_type**: The type of social post
+ **post_title**: The title text of the social post
+ **post_link**: The URL to view the social post on the social network
+ **post_image**: The URL to the primary image for the post if available
+ **post_created**: The unix timestamp of our best indication of when the post was created
+ **post_sentiment**: The sentiment of the post is a score between X and X with X being very negative, X being neutral, and X being very positive. A score of XXX is considered slightly positive.
+ **creator_id**: The [network]::[unique_id] for the influencer
+ **creator_name**: The unique screen name for the influencer
+ **creator_display_name**: The chosen display name for the influencer if available
+ **creator_avatar**: The URL to the avatar for the creator
+ **interactions_24h**: Number of interactions in the last XX hours
+ **interactions_total**: Number of total interactions




---