[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-07-09 04:00	240032
2025-07-09 05:00	196681
2025-07-09 06:00	175747
2025-07-09 07:00	191312
2025-07-09 08:00	175298
2025-07-09 09:00	208450
2025-07-09 10:00	175789
2025-07-09 11:00	176129
2025-07-09 12:00	157485
2025-07-09 13:00	194819
2025-07-09 14:00	187162
2025-07-09 15:00	201405
2025-07-09 16:00	180458
2025-07-09 17:00	221332
2025-07-09 18:00	267947
2025-07-09 19:00	244125
2025-07-09 20:00	250190
2025-07-09 21:00	309407
2025-07-09 22:00	273120
2025-07-09 23:00	163458
2025-07-10 00:00	163268
2025-07-10 01:00	256847
2025-07-10 02:00	238028
2025-07-10 03:00	205635
2025-07-10 04:00	214400
2025-07-10 05:00	256272
2025-07-10 06:00	280935
2025-07-10 07:00	183906
2025-07-10 08:00	163536
2025-07-10 09:00	216939
2025-07-10 10:00	234522
2025-07-10 11:00	227320
2025-07-10 12:00	199779
2025-07-10 13:00	180891
2025-07-10 14:00	433734
2025-07-10 15:00	307959
2025-07-10 16:00	235534
2025-07-10 17:00	277522
2025-07-10 18:00	347667
2025-07-10 19:00	322545
2025-07-10 20:00	298000
2025-07-10 21:00	275918
2025-07-10 22:00	306168
2025-07-10 23:00	283297
2025-07-11 00:00	214168
2025-07-11 01:00	211720
2025-07-11 02:00	215651
2025-07-11 03:00	260236
2025-07-11 04:00	169326
2025-07-11 05:00	153000
2025-07-11 06:00	152881
2025-07-11 07:00	201220
2025-07-11 08:00	187171
2025-07-11 09:00	181069
2025-07-11 10:00	180057
2025-07-11 11:00	274030
2025-07-11 12:00	250600
2025-07-11 13:00	182207
2025-07-11 14:00	470821
2025-07-11 15:00	622505
2025-07-11 16:00	328439
2025-07-11 17:00	394524
2025-07-11 18:00	721612
2025-07-11 19:00	510928
2025-07-11 20:00	360150
2025-07-11 21:00	310334
2025-07-11 22:00	236214
2025-07-11 23:00	250410
2025-07-12 00:00	277449
2025-07-12 01:00	195549
2025-07-12 02:00	295880
2025-07-12 03:00	223004
2025-07-12 04:00	297129
2025-07-12 05:00	206710
2025-07-12 06:00	199942
2025-07-12 07:00	172438
2025-07-12 08:00	268141
2025-07-12 09:00	207191
2025-07-12 10:00	191995
2025-07-12 11:00	178646
2025-07-12 12:00	232150
2025-07-12 13:00	208211
2025-07-12 14:00	214932
2025-07-12 15:00	224328
2025-07-12 16:00	281264
2025-07-12 17:00	260809
2025-07-12 18:00	211487
2025-07-12 19:00	210379
2025-07-12 20:00	242532
2025-07-12 21:00	230302
2025-07-12 22:00	194488
2025-07-12 23:00	204078
2025-07-13 00:00	157540
2025-07-13 01:00	220607
2025-07-13 02:00	167303
2025-07-13 03:00	182834
2025-07-13 04:00	171063
2025-07-13 05:00	214572
2025-07-13 06:00	169022
2025-07-13 07:00	177350
2025-07-13 08:00	144991
2025-07-13 09:00	186826
2025-07-13 10:00	174605
2025-07-13 11:00	166083
2025-07-13 12:00	182693
2025-07-13 13:00	224455
2025-07-13 14:00	239220
2025-07-13 15:00	193920
2025-07-13 16:00	287504
2025-07-13 17:00	315068
2025-07-13 18:00	428135
2025-07-13 19:00	438837
2025-07-13 20:00	298834
2025-07-13 21:00	257215
2025-07-13 22:00	336285
2025-07-13 23:00	254811
2025-07-14 00:00	268990
2025-07-14 01:00	220836
2025-07-14 02:00	244858
2025-07-14 03:00	212600
2025-07-14 04:00	226945
2025-07-14 05:00	191622
2025-07-14 06:00	206263
2025-07-14 07:00	175155
2025-07-14 08:00	179216
2025-07-14 09:00	161518
2025-07-14 10:00	161000
2025-07-14 11:00	184644
2025-07-14 12:00	195554
2025-07-14 13:00	172498
2025-07-14 14:00	227421
2025-07-14 15:00	254998
2025-07-14 16:00	215725
2025-07-14 17:00	216094
2025-07-14 18:00	256628
2025-07-14 19:00	298852
2025-07-14 20:00	215414
2025-07-14 21:00	228590
2025-07-14 22:00	210973
2025-07-14 23:00	247582
2025-07-15 00:00	160144
2025-07-15 01:00	180611
2025-07-15 02:00	154596
2025-07-15 03:00	194829
2025-07-15 04:00	201446
2025-07-15 05:00	169495
2025-07-15 06:00	140014
2025-07-15 07:00	194921
2025-07-15 08:00	159891
2025-07-15 09:00	168931
2025-07-15 10:00	204296
2025-07-15 11:00	201689
2025-07-15 12:00	189778
2025-07-15 13:00	161725
2025-07-15 14:00	274504
2025-07-15 15:00	291581
2025-07-15 16:00	265922
2025-07-15 17:00	197853
2025-07-15 18:00	273737
2025-07-15 19:00	220294
2025-07-15 20:00	325844
2025-07-15 21:00	223332
2025-07-15 22:00	280273
2025-07-15 23:00	210781
2025-07-16 00:00	301968
2025-07-16 01:00	205079
2025-07-16 02:00	294103
2025-07-16 03:00	183371
2025-07-16 04:00	212071
2025-07-16 05:00	158980
2025-07-16 06:00	176237
2025-07-16 07:00	127569
2025-07-16 08:00	161410
2025-07-16 09:00	181474
2025-07-16 10:00	151430
2025-07-16 11:00	170662
2025-07-16 12:00	188141
2025-07-16 13:00	191224
2025-07-16 14:00	169868
2025-07-16 15:00	189610
2025-07-16 16:00	194374
2025-07-16 17:00	236708
2025-07-16 18:00	172101
2025-07-16 19:00	223005
2025-07-16 20:00	173137
2025-07-16 21:00	242136
2025-07-16 22:00	180836
2025-07-16 23:00	195555
2025-07-17 00:00	177037
2025-07-17 01:00	148554
2025-07-17 02:00	141726
2025-07-17 03:00	130430
2025-07-17 07:00	65009
2025-07-17 08:00	84338
2025-07-17 09:00	24993

### 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": 412953,
      "num_posts": 836638,
      "interactions_24h": 3573313797
    }
  ]
}
```

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": 1750896000,
    "end": 1751559896,
    "bucket": "hour",
    "metrics": [],
    "generated": 1751552696
  },
  "data": [
    {
      "time": 1750896000,
      "contributors_active": 22916,
      "contributors_created": 1375,
      "interactions": 3979171,
      "posts_active": 46549,
      "posts_created": 1920,
      "sentiment": 77,
      "spam": 771,
      "alt_rank": 35,
      "circulating_supply": 19883512,
      "close": 107427,
      "galaxy_score": 72,
      "high": 107427,
      "low": 107324.55,
      "market_cap": 2136184884191,
      "market_dominance": 64.9097,
      "open": 107375.07,
      "social_dominance": 25.1594,
      "volume_24h": 51567717214
    }
  ]
}
```

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": 1750896000,
    "end": 1751559896,
    "bucket": "hour",
    "metrics": [],
    "generated": 1751552696
  },
  "data": [
    {
      "time": 1750896000,
      "contributors_active": 22916,
      "contributors_created": 1375,
      "interactions": 3979171,
      "posts_active": 46549,
      "posts_created": 1920,
      "sentiment": 77,
      "spam": 771,
      "alt_rank": 35,
      "circulating_supply": 19883512,
      "close": 107427,
      "galaxy_score": 72,
      "high": 107427,
      "low": 107324.55,
      "market_cap": 2136184884191,
      "market_dominance": 64.9097,
      "open": 107375.07,
      "social_dominance": 25.1594,
      "volume_24h": 51567717214
    }
  ]
}
```

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": 1751552696
  },
  "data": [
    {
      "id": "1940767467934294480",
      "post_type": "tweet",
      "post_title": "NEW: 🇺🇸 Bitcoin & crypto market cap will \"probably go to $15-$20 TRILLION” once the Genius stablecoin legislation passes, says Trump's Digital Asset Director",
      "post_link": "https://x.com/BTC_Archive/status/1940767467934294480",
      "post_image": "https://pbs.twimg.com/media/Gu79uZ4WwAELycU.jpg",
      "post_created": 1751549996,
      "post_sentiment": 3.13,
      "creator_id": "twitter::970994516357472257",
      "creator_name": "BTC_Archive",
      "creator_display_name": "Bitcoin Archive",
      "creator_followers": 1726739,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1938906052956700672/7aV7c-nF_200x200.jpg",
      "interactions_24h": 30978,
      "interactions_total": 31161
    }
  ]
}
```

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_followers**: number of followers the account has
+ **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




---