[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	118102
2025-07-25 14:00	110412
2025-07-25 15:00	100317
2025-07-25 16:00	102586
2025-07-25 17:00	91887
2025-07-25 18:00	115749
2025-07-25 19:00	111708
2025-07-25 20:00	92184
2025-07-25 21:00	89293
2025-07-25 22:00	88135
2025-07-25 23:00	82100
2025-07-26 00:00	88834
2025-07-26 01:00	72830
2025-07-26 02:00	96164
2025-07-26 03:00	82955
2025-07-26 04:00	72263
2025-07-26 05:00	72881
2025-07-26 06:00	82839
2025-07-26 07:00	148062
2025-07-26 08:00	74253
2025-07-26 09:00	61744
2025-07-26 10:00	226541
2025-07-26 11:00	91768
2025-07-26 12:00	184835
2025-07-26 13:00	124103
2025-07-26 14:00	88226
2025-07-26 15:00	99538
2025-07-26 16:00	101848
2025-07-26 17:00	92697
2025-07-26 18:00	91789
2025-07-26 19:00	85760
2025-07-26 20:00	66875
2025-07-26 21:00	67057
2025-07-26 22:00	52743
2025-07-26 23:00	47530
2025-07-27 00:00	34558
2025-07-27 01:00	44701
2025-07-27 02:00	38098
2025-07-27 03:00	38566
2025-07-27 04:00	45629
2025-07-27 05:00	46126
2025-07-27 06:00	61858
2025-07-27 07:00	70243
2025-07-27 08:00	69972
2025-07-27 09:00	79284
2025-07-27 10:00	76494
2025-07-27 11:00	112240
2025-07-27 12:00	69724
2025-07-27 13:00	67442
2025-07-27 14:00	90922
2025-07-27 15:00	75442
2025-07-27 16:00	66561
2025-07-27 17:00	84806
2025-07-27 18:00	86216
2025-07-27 19:00	84997
2025-07-27 20:00	80612
2025-07-27 21:00	68090
2025-07-27 22:00	63705
2025-07-27 23:00	63999
2025-07-28 00:00	61568
2025-07-28 01:00	67855
2025-07-28 02:00	68977
2025-07-28 03:00	64421
2025-07-28 04:00	69994
2025-07-28 05:00	73430
2025-07-28 06:00	66348
2025-07-28 07:00	65945
2025-07-28 08:00	66035
2025-07-28 09:00	83103
2025-07-28 10:00	75661
2025-07-28 11:00	69173
2025-07-28 12:00	75190
2025-07-28 13:00	68900
2025-07-28 14:00	86652
2025-07-28 15:00	85612
2025-07-28 16:00	71738
2025-07-28 17:00	78394
2025-07-28 18:00	79417
2025-07-28 19:00	112911
2025-07-28 20:00	55424
2025-07-28 21:00	66576
2025-07-28 22:00	60041
2025-07-28 23:00	73192
2025-07-29 00:00	38455
2025-07-29 01:00	54220
2025-07-29 02:00	41282
2025-07-29 03:00	37234
2025-07-29 04:00	28405
2025-07-29 05:00	31943
2025-07-29 06:00	86956
2025-07-29 07:00	33038
2025-07-29 08:00	44948
2025-07-29 09:00	44517
2025-07-29 10:00	62415
2025-07-29 11:00	51221
2025-07-29 12:00	58388
2025-07-29 13:00	42254
2025-07-29 14:00	71124
2025-07-29 15:00	103911
2025-07-29 16:00	121095
2025-07-29 17:00	127992
2025-07-29 18:00	147162
2025-07-29 19:00	145379
2025-07-29 20:00	147700
2025-07-29 21:00	107801
2025-07-29 22:00	111161
2025-07-29 23:00	99474
2025-07-30 00:00	111578
2025-07-30 01:00	85976
2025-07-30 02:00	89100
2025-07-30 03:00	87680
2025-07-30 04:00	90773
2025-07-30 05:00	72232
2025-07-30 06:00	68205
2025-07-30 07:00	80883
2025-07-30 08:00	76319
2025-07-30 09:00	76402
2025-07-30 10:00	100965
2025-07-30 11:00	97616
2025-07-30 12:00	157621
2025-07-30 13:00	192790
2025-07-30 14:00	128023
2025-07-30 15:00	137424
2025-07-30 16:00	159666
2025-07-30 17:00	128477
2025-07-30 18:00	77940
2025-07-30 19:00	104108
2025-07-30 20:00	73786
2025-07-30 21:00	65446
2025-07-30 22:00	63857
2025-07-30 23:00	60663
2025-07-31 00:00	61404
2025-07-31 01:00	74909
2025-07-31 02:00	53396
2025-07-31 03:00	40092
2025-07-31 04:00	44946
2025-07-31 05:00	37961
2025-07-31 06:00	31386
2025-07-31 07:00	28315
2025-07-31 08:00	30181
2025-07-31 09:00	31297
2025-07-31 10:00	28092
2025-07-31 11:00	29429
2025-07-31 12:00	30600
2025-07-31 13:00	40563
2025-07-31 14:00	37207
2025-07-31 15:00	63567
2025-07-31 16:00	41083
2025-07-31 17:00	44159
2025-07-31 18:00	44948
2025-07-31 19:00	37915
2025-07-31 20:00	41598
2025-07-31 21:00	31999
2025-07-31 22:00	27865
2025-07-31 23:00	36569
2025-08-01 00:00	26219
2025-08-01 01:00	67909
2025-08-01 02:00	33292
2025-08-01 03:00	48605
2025-08-01 04:00	22247
2025-08-01 05:00	26608
2025-08-01 06:00	26942
2025-08-01 07:00	26022
2025-08-01 08:00	20784
2025-08-01 09:00	28980
2025-08-01 10:00	23353
2025-08-01 11:00	27965
2025-08-01 12:00	32139
2025-08-01 13:00	62753
2025-08-01 14:00	157878
2025-08-01 15:00	31065
2025-08-01 16:00	33831
2025-08-01 17:00	110794
2025-08-01 18:00	59139
2025-08-01 19:00	76351
2025-08-01 20:00	39691
2025-08-01 21:00	34814
2025-08-01 22:00	23658
2025-08-01 23:00	26632
2025-08-02 00:00	34825
2025-08-02 01:00	28996
2025-08-02 02:00	24759
2025-08-02 03:00	78941
2025-08-02 04:00	54159
2025-08-02 05:00	46424
2025-08-02 06:00	39411
2025-08-02 07:00	56265
2025-08-02 08:00	38290
2025-08-02 09:00	35108
2025-08-02 10:00	40175
2025-08-02 11:00	46382
2025-08-02 12:00	43892
2025-08-02 13:00	3698

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




---