[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 23:00	4623
2025-07-10 00:00	4227
2025-07-10 01:00	4422
2025-07-10 02:00	3769
2025-07-10 03:00	3824
2025-07-10 04:00	2888
2025-07-10 05:00	2467
2025-07-10 06:00	2738
2025-07-10 07:00	2440
2025-07-10 08:00	2542
2025-07-10 09:00	1688
2025-07-10 10:00	2318
2025-07-10 11:00	9360
2025-07-10 12:00	8827
2025-07-10 13:00	11072
2025-07-10 14:00	11873
2025-07-10 15:00	6523
2025-07-10 16:00	10100
2025-07-10 17:00	9393
2025-07-10 18:00	6791
2025-07-10 19:00	6055
2025-07-10 20:00	5549
2025-07-10 21:00	5783
2025-07-10 22:00	5015
2025-07-10 23:00	2845
2025-07-11 00:00	4752
2025-07-11 01:00	2462
2025-07-11 02:00	2879
2025-07-11 03:00	2066
2025-07-11 04:00	2350
2025-07-11 05:00	1883
2025-07-11 06:00	2180
2025-07-11 07:00	1857
2025-07-11 08:00	1868
2025-07-11 09:00	2116
2025-07-11 10:00	3201
2025-07-11 11:00	2723
2025-07-11 12:00	10782
2025-07-11 13:00	8180
2025-07-11 14:00	8095
2025-07-11 15:00	6697
2025-07-11 16:00	6640
2025-07-11 17:00	7696
2025-07-11 18:00	10153
2025-07-11 19:00	9760
2025-07-11 20:00	11370
2025-07-11 21:00	3929
2025-07-11 22:00	4871
2025-07-11 23:00	4093
2025-07-12 00:00	2845
2025-07-12 01:00	3096
2025-07-12 02:00	3466
2025-07-12 03:00	3329
2025-07-12 04:00	3256
2025-07-12 05:00	3362
2025-07-12 06:00	4818
2025-07-12 07:00	4816
2025-07-12 08:00	2995
2025-07-12 09:00	3541
2025-07-12 10:00	4711
2025-07-12 11:00	4639
2025-07-12 12:00	3845
2025-07-12 13:00	3931
2025-07-12 14:00	5012
2025-07-12 15:00	3551
2025-07-12 16:00	3696
2025-07-12 17:00	12673
2025-07-12 18:00	12564
2025-07-12 19:00	12239
2025-07-12 20:00	7622
2025-07-12 21:00	16929
2025-07-12 22:00	13158
2025-07-12 23:00	9013
2025-07-13 00:00	7554
2025-07-13 01:00	5174
2025-07-13 02:00	3710
2025-07-13 03:00	4329
2025-07-13 04:00	3554
2025-07-13 05:00	4333
2025-07-13 06:00	3786
2025-07-13 07:00	2713
2025-07-13 08:00	6908
2025-07-13 09:00	5836
2025-07-13 10:00	10106
2025-07-13 11:00	15009
2025-07-13 12:00	25476
2025-07-13 13:00	16853
2025-07-13 14:00	11995
2025-07-13 15:00	25031
2025-07-13 16:00	19065
2025-07-13 17:00	39282
2025-07-13 18:00	23271
2025-07-13 19:00	25411
2025-07-13 20:00	18313
2025-07-13 21:00	22116
2025-07-13 22:00	16776
2025-07-13 23:00	19651
2025-07-14 00:00	17795
2025-07-14 01:00	12154
2025-07-14 02:00	10989
2025-07-14 03:00	9193
2025-07-14 04:00	7182
2025-07-14 05:00	7981
2025-07-14 06:00	6327
2025-07-14 07:00	4949
2025-07-14 08:00	5226
2025-07-14 09:00	6413
2025-07-14 10:00	9902
2025-07-14 11:00	13344
2025-07-14 12:00	19427
2025-07-14 13:00	27463
2025-07-14 14:00	17388
2025-07-14 15:00	20269
2025-07-14 16:00	12251
2025-07-14 17:00	12106
2025-07-14 18:00	32591
2025-07-14 19:00	14440
2025-07-14 20:00	8601
2025-07-14 21:00	7760
2025-07-14 22:00	6544
2025-07-14 23:00	5366
2025-07-15 00:00	4506
2025-07-15 01:00	3954
2025-07-15 02:00	3724
2025-07-15 03:00	3807
2025-07-15 04:00	2632
2025-07-15 05:00	2818
2025-07-15 06:00	3372
2025-07-15 07:00	3428
2025-07-15 08:00	4493
2025-07-15 09:00	2880
2025-07-15 10:00	4180
2025-07-15 11:00	4909
2025-07-15 12:00	11436
2025-07-15 13:00	12513
2025-07-15 14:00	12542
2025-07-15 15:00	7654
2025-07-15 16:00	7988
2025-07-15 17:00	7393
2025-07-15 18:00	9229
2025-07-15 19:00	5910
2025-07-15 20:00	4228
2025-07-15 21:00	3008
2025-07-15 22:00	3011
2025-07-15 23:00	3236
2025-07-16 00:00	3564
2025-07-16 01:00	3718
2025-07-16 02:00	2984
2025-07-16 03:00	2893
2025-07-16 04:00	2515
2025-07-16 05:00	4764
2025-07-16 06:00	3363
2025-07-16 07:00	2423
2025-07-16 08:00	1891
2025-07-16 09:00	2550
2025-07-16 10:00	4990
2025-07-16 11:00	4511
2025-07-16 12:00	8171
2025-07-16 13:00	6074
2025-07-16 14:00	6981
2025-07-16 15:00	4209
2025-07-16 16:00	6084
2025-07-16 17:00	8925
2025-07-16 18:00	8363
2025-07-16 19:00	5049
2025-07-16 20:00	13764
2025-07-16 21:00	6627
2025-07-16 22:00	7803
2025-07-16 23:00	6622
2025-07-17 00:00	4305
2025-07-17 01:00	1803
2025-07-17 02:00	3503
2025-07-17 03:00	2385
2025-07-17 04:00	2635
2025-07-17 05:00	2062
2025-07-17 06:00	2101
2025-07-17 07:00	2702
2025-07-17 08:00	1774
2025-07-17 09:00	2565
2025-07-17 10:00	6015
2025-07-17 11:00	5929
2025-07-17 12:00	9267
2025-07-17 13:00	10419
2025-07-17 14:00	33481
2025-07-17 15:00	14382
2025-07-17 16:00	25770
2025-07-17 17:00	60657
2025-07-17 18:00	23626
2025-07-17 19:00	28837
2025-07-17 20:00	12896
2025-07-17 21:00	18433
2025-07-17 22:00	14803
2025-07-18 05:00	6682
2025-07-18 06:00	2106
2025-07-18 07:00	1190

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




---