[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-10 18:00	5212
2025-07-10 19:00	18771
2025-07-10 20:00	11988
2025-07-10 21:00	4455
2025-07-10 22:00	2229
2025-07-10 23:00	12643
2025-07-11 00:00	10607
2025-07-11 01:00	9815
2025-07-11 02:00	9133
2025-07-11 03:00	19674
2025-07-11 04:00	17046
2025-07-11 05:00	11421
2025-07-11 06:00	9326
2025-07-11 07:00	22967
2025-07-11 08:00	15865
2025-07-11 09:00	16741
2025-07-11 10:00	12900
2025-07-11 11:00	25269
2025-07-11 12:00	30828
2025-07-11 13:00	28493
2025-07-11 14:00	19035
2025-07-11 15:00	21448
2025-07-11 16:00	26808
2025-07-11 17:00	22713
2025-07-11 18:00	19175
2025-07-11 19:00	4955
2025-07-11 20:00	16815
2025-07-11 21:00	13263
2025-07-11 22:00	5512
2025-07-11 23:00	4468
2025-07-12 00:00	5700
2025-07-12 01:00	18334
2025-07-12 02:00	23480
2025-07-12 03:00	11427
2025-07-12 04:00	19859
2025-07-12 05:00	24879
2025-07-12 06:00	25859
2025-07-12 07:00	10120
2025-07-12 08:00	21233
2025-07-12 09:00	17165
2025-07-12 10:00	16477
2025-07-12 11:00	20189
2025-07-12 12:00	17882
2025-07-12 13:00	14730
2025-07-12 14:00	16740
2025-07-12 15:00	22491
2025-07-12 16:00	18384
2025-07-12 17:00	8757
2025-07-12 18:00	14346
2025-07-12 19:00	10449
2025-07-12 20:00	14491
2025-07-12 21:00	4901
2025-07-12 22:00	6545
2025-07-12 23:00	28293
2025-07-13 00:00	4668
2025-07-13 01:00	16717
2025-07-13 02:00	8768
2025-07-13 03:00	21280
2025-07-13 04:00	19641
2025-07-13 05:00	15751
2025-07-13 06:00	26274
2025-07-13 07:00	13646
2025-07-13 08:00	21594
2025-07-13 09:00	21804
2025-07-13 10:00	31837
2025-07-13 11:00	12307
2025-07-13 12:00	17220
2025-07-13 13:00	13825
2025-07-13 14:00	18761
2025-07-13 15:00	10551
2025-07-13 16:00	15169
2025-07-13 17:00	15396
2025-07-13 18:00	3540
2025-07-13 19:00	11075
2025-07-13 20:00	10992
2025-07-13 21:00	5582
2025-07-13 22:00	11328
2025-07-13 23:00	7088
2025-07-14 00:00	8162
2025-07-14 01:00	4986
2025-07-14 02:00	7440
2025-07-14 03:00	5089
2025-07-14 04:00	16174
2025-07-14 05:00	8031
2025-07-14 06:00	11808
2025-07-14 07:00	8131
2025-07-14 08:00	10465
2025-07-14 09:00	12242
2025-07-14 10:00	10787
2025-07-14 11:00	10810
2025-07-14 12:00	8818
2025-07-14 13:00	16686
2025-07-14 14:00	18888
2025-07-14 15:00	9598
2025-07-14 16:00	11684
2025-07-14 17:00	15591
2025-07-14 18:00	4376
2025-07-14 19:00	6482
2025-07-14 20:00	4189
2025-07-14 21:00	4530
2025-07-14 22:00	3684
2025-07-14 23:00	3671
2025-07-15 00:00	4561
2025-07-15 01:00	8333
2025-07-15 02:00	7254
2025-07-15 03:00	7211
2025-07-15 04:00	11102
2025-07-15 05:00	13412
2025-07-15 06:00	12213
2025-07-15 07:00	12439
2025-07-15 08:00	10864
2025-07-15 09:00	6527
2025-07-15 10:00	12281
2025-07-15 11:00	15706
2025-07-15 12:00	14240
2025-07-15 13:00	10141
2025-07-15 14:00	14695
2025-07-15 15:00	23433
2025-07-15 16:00	9050
2025-07-15 17:00	11486
2025-07-15 18:00	10563
2025-07-15 19:00	5623
2025-07-15 20:00	5500
2025-07-15 21:00	4879
2025-07-15 22:00	6891
2025-07-15 23:00	4343
2025-07-16 00:00	5298
2025-07-16 01:00	7834
2025-07-16 02:00	6812
2025-07-16 03:00	10500
2025-07-16 04:00	11735
2025-07-16 05:00	9585
2025-07-16 06:00	10180
2025-07-16 07:00	14150
2025-07-16 08:00	15166
2025-07-16 09:00	12125
2025-07-16 10:00	8139
2025-07-16 11:00	14510
2025-07-16 12:00	18767
2025-07-16 13:00	7700
2025-07-16 14:00	14840
2025-07-16 15:00	20879
2025-07-16 16:00	12654
2025-07-16 17:00	12366
2025-07-16 18:00	7334
2025-07-16 19:00	9059
2025-07-16 20:00	4188
2025-07-16 21:00	3387
2025-07-16 22:00	4078
2025-07-16 23:00	2277
2025-07-17 00:00	3844
2025-07-17 01:00	4682
2025-07-17 02:00	10588
2025-07-17 03:00	8972
2025-07-17 04:00	6048
2025-07-17 05:00	6214
2025-07-17 06:00	12383
2025-07-17 07:00	16130
2025-07-17 08:00	17570
2025-07-17 09:00	13546
2025-07-17 10:00	23375
2025-07-17 11:00	13983
2025-07-17 12:00	14353
2025-07-17 13:00	20708
2025-07-17 14:00	12056
2025-07-17 15:00	27674
2025-07-17 16:00	11197
2025-07-17 17:00	18606
2025-07-17 18:00	5390
2025-07-17 19:00	8830
2025-07-17 20:00	3918
2025-07-17 21:00	4211
2025-07-17 22:00	1720
2025-07-17 23:00	4230
2025-07-18 00:00	5087
2025-07-18 01:00	4609
2025-07-18 02:00	6010
2025-07-18 03:00	7413
2025-07-18 04:00	7638
2025-07-18 05:00	14338
2025-07-18 06:00	10605
2025-07-18 07:00	7427
2025-07-18 08:00	6657
2025-07-18 09:00	2529
2025-07-18 10:00	8210
2025-07-18 11:00	7847
2025-07-18 12:00	7728
2025-07-18 13:00	7415
2025-07-18 14:00	12090
2025-07-18 15:00	8938
2025-07-18 16:00	15878
2025-07-18 17:00	14907
2025-07-19 00:00	2688
2025-07-19 01:00	3552

### 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




---