[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-12-07 00:00	12583
2025-12-07 01:00	9978
2025-12-07 02:00	16747
2025-12-07 03:00	12677
2025-12-07 04:00	10966
2025-12-07 05:00	14825
2025-12-07 06:00	19513
2025-12-07 07:00	20671
2025-12-07 08:00	21559
2025-12-07 09:00	18210
2025-12-07 10:00	35191
2025-12-07 11:00	32966
2025-12-07 12:00	18048
2025-12-07 13:00	23699
2025-12-07 14:00	27005
2025-12-07 15:00	27832
2025-12-07 16:00	28927
2025-12-07 17:00	29080
2025-12-07 18:00	22118
2025-12-07 19:00	18752
2025-12-07 20:00	13914
2025-12-07 21:00	13572
2025-12-07 22:00	11616
2025-12-07 23:00	11142
2025-12-08 00:00	9696
2025-12-08 01:00	10695
2025-12-08 02:00	13016
2025-12-08 03:00	13163
2025-12-08 04:00	13659
2025-12-08 05:00	13754
2025-12-08 06:00	15263
2025-12-08 07:00	14103
2025-12-08 08:00	11837
2025-12-08 09:00	17152
2025-12-08 10:00	20958
2025-12-08 11:00	18102
2025-12-08 12:00	20244
2025-12-08 13:00	26658
2025-12-08 14:00	26843
2025-12-08 15:00	24334
2025-12-08 16:00	24083
2025-12-08 17:00	22443
2025-12-08 18:00	20320
2025-12-08 19:00	15600
2025-12-08 20:00	13347
2025-12-08 21:00	13406
2025-12-08 22:00	11926
2025-12-08 23:00	11289
2025-12-09 00:00	9170
2025-12-09 01:00	8554
2025-12-09 02:00	9961
2025-12-09 03:00	10815
2025-12-09 04:00	15680
2025-12-09 05:00	12941
2025-12-09 06:00	11631
2025-12-09 07:00	17938
2025-12-09 08:00	13341
2025-12-09 09:00	25218
2025-12-09 10:00	24768
2025-12-09 11:00	19013
2025-12-09 12:00	22216
2025-12-09 13:00	31368
2025-12-09 14:00	31470
2025-12-09 15:00	22922
2025-12-09 16:00	26192
2025-12-09 17:00	27609
2025-12-09 18:00	26661
2025-12-09 19:00	24091
2025-12-09 20:00	20064
2025-12-09 21:00	15167
2025-12-09 22:00	13507
2025-12-09 23:00	14268
2025-12-10 00:00	13157
2025-12-10 01:00	11536
2025-12-10 02:00	12052
2025-12-10 03:00	12733
2025-12-10 04:00	14156
2025-12-10 05:00	15143
2025-12-10 06:00	35648
2025-12-10 07:00	15020
2025-12-10 08:00	12866
2025-12-10 09:00	23634
2025-12-10 10:00	21337
2025-12-10 11:00	19585
2025-12-10 12:00	18954
2025-12-10 13:00	17090
2025-12-10 14:00	14286
2025-12-10 15:00	22585
2025-12-10 16:00	25255
2025-12-10 17:00	27830
2025-12-10 18:00	30145
2025-12-10 19:00	15427
2025-12-10 20:00	15412
2025-12-10 21:00	15022
2025-12-10 22:00	13543
2025-12-10 23:00	11903
2025-12-11 00:00	12861
2025-12-11 01:00	10594
2025-12-11 02:00	8636
2025-12-11 03:00	10201
2025-12-11 04:00	11921
2025-12-11 05:00	15267
2025-12-11 06:00	22407
2025-12-11 07:00	11587
2025-12-11 08:00	11927
2025-12-11 09:00	25599
2025-12-11 10:00	27448
2025-12-11 11:00	19848
2025-12-11 12:00	16865
2025-12-11 13:00	16482
2025-12-11 14:00	24255
2025-12-11 15:00	16796
2025-12-11 16:00	17048
2025-12-11 17:00	22009
2025-12-11 18:00	18141
2025-12-11 19:00	15178
2025-12-11 20:00	11841
2025-12-11 21:00	14143
2025-12-11 22:00	12999
2025-12-11 23:00	7965
2025-12-12 00:00	5469
2025-12-12 01:00	7760
2025-12-12 02:00	8866
2025-12-12 03:00	10214
2025-12-12 04:00	10917
2025-12-12 05:00	16196
2025-12-12 06:00	24385
2025-12-12 07:00	14610
2025-12-12 08:00	12257
2025-12-12 09:00	14912
2025-12-12 10:00	22898
2025-12-12 11:00	14844
2025-12-12 12:00	13365
2025-12-12 13:00	15376
2025-12-12 14:00	18328
2025-12-12 15:00	17130
2025-12-12 16:00	19611
2025-12-12 17:00	13232
2025-12-12 18:00	17289
2025-12-12 19:00	14184
2025-12-12 20:00	10441
2025-12-12 21:00	6998
2025-12-12 22:00	7717
2025-12-12 23:00	5931
2025-12-13 00:00	4513
2025-12-13 01:00	4758
2025-12-13 02:00	3655
2025-12-13 03:00	5226
2025-12-13 04:00	1722
2025-12-13 05:00	8406
2025-12-13 06:00	10543
2025-12-13 07:00	13064
2025-12-13 08:00	10423
2025-12-13 09:00	15093
2025-12-13 10:00	12446
2025-12-13 11:00	11553
2025-12-13 12:00	15735
2025-12-13 13:00	16632
2025-12-13 14:00	2355
2025-12-13 15:00	XXX
2025-12-13 16:00	XXX
2025-12-13 17:00	XXX
2025-12-13 18:00	XXX
2025-12-13 19:00	5090
2025-12-13 20:00	5271
2025-12-13 21:00	10448
2025-12-13 22:00	XXX
2025-12-13 23:00	XXX
2025-12-14 00:00	9467
2025-12-14 01:00	XXX
2025-12-14 02: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": 300754,
      "num_posts": 300754,
      "interactions_24h": 2980779418
    }
  ]
}
```

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

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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1764806400,
    "end": 1765493023,
    "bucket": "hour",
    "metrics": [],
    "generated": 1765485823
  },
  "data": [
    {
      "time": 1764806400,
      "contributors_active": 23704,
      "contributors_created": 1429,
      "interactions": 2850530,
      "posts_active": 46702,
      "posts_created": 2732,
      "sentiment": 79,
      "spam": 5826,
      "alt_rank": 215,
      "circulating_supply": 19957250,
      "close": 93033,
      "galaxy_score": 53,
      "high": 93033,
      "low": 92735.28,
      "market_cap": 1856638537230,
      "market_dominance": 58.4039,
      "open": 93033,
      "social_dominance": 28.896,
      "volume_24h": 77427662033
    }
  ]
}
```

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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1764806400,
    "end": 1765493023,
    "bucket": "hour",
    "metrics": [],
    "generated": 1765485823
  },
  "data": [
    {
      "time": 1764806400,
      "contributors_active": 23704,
      "contributors_created": 1429,
      "interactions": 2850530,
      "posts_active": 46702,
      "posts_created": 2732,
      "sentiment": 79,
      "spam": 5826,
      "alt_rank": 215,
      "circulating_supply": 19957250,
      "close": 93033,
      "galaxy_score": 53,
      "high": 93033,
      "low": 92735.28,
      "market_cap": 1856638537230,
      "market_dominance": 58.4039,
      "open": 93033,
      "social_dominance": 28.896,
      "volume_24h": 77427662033
    }
  ]
}
```

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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "generated": 1765485823
  },
  "data": [
    {
      "id": "t3_1pk4b3i",
      "post_type": "reddit-post",
      "post_title": "I can’t wait to be rich guys",
      "post_link": "https://redd.it/1pk4b3i",
      "post_image": null,
      "post_created": 1765476409,
      "post_sentiment": 3.36,
      "creator_id": "reddit::t2_1kq495hgxu",
      "creator_name": "Cold-Ad-7980",
      "creator_display_name": "Cold-Ad-7980",
      "interactions_24h": 4752,
      "interactions_total": 4740
    }
  ]
}
```

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
+ **interactions_24h**: Number of interactions in the last XX hours
+ **interactions_total**: Number of total interactions




---