[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-25 13:00	4449
2025-07-25 14:00	4201
2025-07-25 15:00	6049
2025-07-25 16:00	5942
2025-07-25 17:00	2595
2025-07-25 18:00	6333
2025-07-25 19:00	6518
2025-07-25 20:00	9468
2025-07-25 21:00	3740
2025-07-25 22:00	7797
2025-07-25 23:00	7091
2025-07-26 00:00	4689
2025-07-26 01:00	6063
2025-07-26 02:00	5121
2025-07-26 03:00	4686
2025-07-26 04:00	3822
2025-07-26 05:00	4077
2025-07-26 06:00	2721
2025-07-26 07:00	3559
2025-07-26 08:00	3118
2025-07-26 09:00	3385
2025-07-26 10:00	3516
2025-07-26 11:00	3665
2025-07-26 12:00	2635
2025-07-26 13:00	5191
2025-07-26 14:00	8718
2025-07-26 15:00	11151
2025-07-26 16:00	11057
2025-07-26 17:00	5606
2025-07-26 18:00	8077
2025-07-26 19:00	8706
2025-07-26 20:00	8805
2025-07-26 21:00	4481
2025-07-26 22:00	4945
2025-07-26 23:00	8855
2025-07-27 00:00	6840
2025-07-27 01:00	3270
2025-07-27 02:00	3414
2025-07-27 03:00	6158
2025-07-27 04:00	6682
2025-07-27 05:00	3118
2025-07-27 06:00	1918
2025-07-27 07:00	3301
2025-07-27 08:00	5010
2025-07-27 09:00	2607
2025-07-27 10:00	2878
2025-07-27 11:00	2172
2025-07-27 12:00	3215
2025-07-27 13:00	7341
2025-07-27 14:00	4864
2025-07-27 15:00	4077
2025-07-27 16:00	3847
2025-07-27 17:00	9212
2025-07-27 18:00	7449
2025-07-27 19:00	3248
2025-07-27 20:00	5408
2025-07-27 21:00	8176
2025-07-27 22:00	12828
2025-07-27 23:00	7464
2025-07-28 00:00	9444
2025-07-28 01:00	12699
2025-07-28 02:00	14015
2025-07-28 03:00	10667
2025-07-28 04:00	9642
2025-07-28 05:00	9391
2025-07-28 06:00	18439
2025-07-28 07:00	18988
2025-07-28 08:00	41885
2025-07-28 09:00	27866
2025-07-28 10:00	6551
2025-07-28 11:00	42137
2025-07-28 12:00	76486
2025-07-28 13:00	53564
2025-07-28 14:00	40608
2025-07-28 15:00	62792
2025-07-28 16:00	31734
2025-07-28 17:00	42071
2025-07-28 18:00	39872
2025-07-28 19:00	27966
2025-07-28 20:00	45065
2025-07-28 21:00	32041
2025-07-28 22:00	22817
2025-07-28 23:00	25949
2025-07-29 00:00	25710
2025-07-29 01:00	18670
2025-07-29 02:00	26493
2025-07-29 03:00	15381
2025-07-29 04:00	2058
2025-07-29 05:00	XXX
2025-07-29 06:00	32022
2025-07-29 07:00	4899
2025-07-29 08:00	7172
2025-07-29 09:00	8843
2025-07-29 10:00	11979
2025-07-29 11:00	14365
2025-07-29 12:00	12283
2025-07-29 13:00	16916
2025-07-29 14:00	14057
2025-07-29 15:00	25387
2025-07-29 16:00	18980
2025-07-29 17:00	12486
2025-07-29 18:00	25290
2025-07-29 19:00	15629
2025-07-29 20:00	17570
2025-07-29 21:00	16397
2025-07-29 22:00	13127
2025-07-29 23:00	12146
2025-07-30 00:00	13586
2025-07-30 01:00	13547
2025-07-30 02:00	16008
2025-07-30 03:00	10302
2025-07-30 04:00	10244
2025-07-30 05:00	5834
2025-07-30 06:00	4164
2025-07-30 07:00	6572
2025-07-30 08:00	6842
2025-07-30 09:00	3634
2025-07-30 10:00	4958
2025-07-30 11:00	5163
2025-07-30 12:00	6051
2025-07-30 13:00	7636
2025-07-30 14:00	6948
2025-07-30 15:00	11482
2025-07-30 16:00	14684
2025-07-30 17:00	14517
2025-07-30 18:00	24406
2025-07-30 19:00	7228
2025-07-30 20:00	8226
2025-07-30 21:00	23339
2025-07-30 22:00	15201
2025-07-30 23:00	19462
2025-07-31 00:00	41327
2025-07-31 01:00	28637
2025-07-31 02:00	8117
2025-07-31 03:00	16846
2025-07-31 04:00	14801
2025-07-31 05:00	11649
2025-07-31 06:00	7357
2025-07-31 07:00	10795
2025-07-31 08:00	6782
2025-07-31 09:00	8968
2025-07-31 10:00	10559
2025-07-31 11:00	15061
2025-07-31 12:00	5714
2025-07-31 13:00	20974
2025-07-31 14:00	19390
2025-07-31 15:00	17871
2025-07-31 16:00	27445
2025-07-31 17:00	33749
2025-07-31 18:00	33972
2025-07-31 19:00	22857
2025-07-31 20:00	20119
2025-07-31 21:00	18786
2025-07-31 22:00	13406
2025-07-31 23:00	9743
2025-08-01 00:00	9326
2025-08-01 01:00	12894
2025-08-01 02:00	8998
2025-08-01 03:00	10232
2025-08-01 04:00	5045
2025-08-01 05:00	9591
2025-08-01 06:00	4627
2025-08-01 07:00	6826
2025-08-01 08:00	2939
2025-08-01 09:00	5551
2025-08-01 10:00	6441
2025-08-01 11:00	5137
2025-08-01 12:00	5895
2025-08-01 13:00	6047
2025-08-01 14:00	7077
2025-08-01 15:00	4430
2025-08-01 16:00	36532
2025-08-01 17:00	5761
2025-08-01 18:00	5752
2025-08-01 19:00	6386
2025-08-01 20:00	4712
2025-08-01 21:00	4225
2025-08-01 22:00	6827
2025-08-01 23:00	5468
2025-08-02 00:00	2588
2025-08-02 01:00	4198
2025-08-02 02:00	5455
2025-08-02 03:00	4749
2025-08-02 04:00	2010
2025-08-02 05:00	1959
2025-08-02 06:00	2234
2025-08-02 07:00	3581
2025-08-02 08:00	3004
2025-08-02 09:00	1397
2025-08-02 10:00	1539
2025-08-02 11:00	9082
2025-08-02 12:00	8733
2025-08-02 13:00	3642
2025-08-02 14:00	XXX

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




---