[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-10-23 00:00	2971
2025-10-23 01:00	2730
2025-10-23 02:00	3071
2025-10-23 03:00	2154
2025-10-23 04:00	5496
2025-10-23 05:00	4543
2025-10-23 06:00	5680
2025-10-23 07:00	5917
2025-10-23 08:00	5659
2025-10-23 09:00	6314
2025-10-23 10:00	6995
2025-10-23 11:00	5654
2025-10-23 12:00	6468
2025-10-23 13:00	4908
2025-10-23 14:00	4786
2025-10-23 15:00	4965
2025-10-23 16:00	5344
2025-10-23 17:00	5871
2025-10-23 18:00	5328
2025-10-23 19:00	6078
2025-10-23 20:00	5907
2025-10-23 21:00	6569
2025-10-23 22:00	5352
2025-10-23 23:00	6165
2025-10-24 00:00	5511
2025-10-24 01:00	6202
2025-10-24 02:00	4981
2025-10-24 03:00	5991
2025-10-24 04:00	7008
2025-10-24 05:00	6171
2025-10-24 06:00	7878
2025-10-24 07:00	6202
2025-10-24 08:00	12978
2025-10-24 09:00	12247
2025-10-24 10:00	4642
2025-10-24 11:00	10129
2025-10-24 12:00	46791
2025-10-24 13:00	80942
2025-10-24 14:00	3037
2025-10-24 15:00	5252
2025-10-24 16:00	5818
2025-10-24 17:00	5546
2025-10-24 18:00	13100
2025-10-24 19:00	10539
2025-10-24 20:00	6509
2025-10-24 21:00	7606
2025-10-24 22:00	9230
2025-10-24 23:00	7167
2025-10-25 00:00	5971
2025-10-25 01:00	4696
2025-10-25 02:00	4206
2025-10-25 03:00	7627
2025-10-25 04:00	7499
2025-10-25 05:00	7501
2025-10-25 06:00	6460
2025-10-25 07:00	7951
2025-10-25 08:00	8188
2025-10-25 09:00	9027
2025-10-25 10:00	8402
2025-10-25 11:00	9297
2025-10-25 12:00	10770
2025-10-25 13:00	9598
2025-10-25 14:00	9472
2025-10-25 15:00	13506
2025-10-25 16:00	12383
2025-10-25 17:00	10249
2025-10-25 18:00	11693
2025-10-25 19:00	25542
2025-10-25 20:00	27758
2025-10-25 21:00	26367
2025-10-25 22:00	26394
2025-10-25 23:00	30576
2025-10-26 00:00	30090
2025-10-26 01:00	29442
2025-10-26 02:00	31496
2025-10-26 03:00	32924
2025-10-26 04:00	33223
2025-10-26 05:00	34599
2025-10-26 06:00	46512
2025-10-26 07:00	45468
2025-10-26 08:00	59365
2025-10-26 09:00	43124
2025-10-26 10:00	53508
2025-10-26 11:00	90207
2025-10-26 12:00	132734
2025-10-26 13:00	88702
2025-10-26 14:00	68315
2025-10-26 15:00	62772
2025-10-26 16:00	42337
2025-10-26 17:00	131344
2025-10-26 18:00	149514
2025-10-26 19:00	142945
2025-10-26 20:00	145134
2025-10-26 21:00	84365
2025-10-26 22:00	229781
2025-10-26 23:00	234188
2025-10-27 00:00	135401
2025-10-27 01:00	336902
2025-10-27 02:00	135211
2025-10-27 03:00	99212
2025-10-27 04:00	152607
2025-10-27 05:00	124188
2025-10-27 06:00	111289
2025-10-27 07:00	120055
2025-10-27 08:00	76692
2025-10-27 09:00	63525
2025-10-27 10:00	59672
2025-10-27 11:00	50851
2025-10-27 12:00	57202
2025-10-27 13:00	85639
2025-10-27 14:00	76313
2025-10-27 15:00	71025
2025-10-27 16:00	89589
2025-10-27 17:00	98005
2025-10-27 18:00	61382
2025-10-27 19:00	59370
2025-10-27 20:00	41608
2025-10-27 21:00	58081
2025-10-27 22:00	42076
2025-10-27 23:00	33350
2025-10-28 00:00	42766
2025-10-28 01:00	41646
2025-10-28 02:00	38616
2025-10-28 03:00	37451
2025-10-28 04:00	33712
2025-10-28 05:00	25763
2025-10-28 06:00	19482
2025-10-28 07:00	15542
2025-10-28 08:00	16661
2025-10-28 09:00	16612
2025-10-28 10:00	24973
2025-10-28 11:00	30699
2025-10-28 12:00	33274
2025-10-28 13:00	32574
2025-10-28 14:00	149418
2025-10-28 15:00	40283
2025-10-28 16:00	37448
2025-10-28 17:00	57359
2025-10-28 18:00	27829
2025-10-28 19:00	24423
2025-10-28 20:00	43808
2025-10-28 21:00	46224
2025-10-28 22:00	39876
2025-10-28 23:00	37893
2025-10-29 00:00	40405
2025-10-29 01:00	41731
2025-10-29 02:00	32726
2025-10-29 03:00	25115
2025-10-29 11:00	21507
2025-10-29 12:00	XXX
2025-10-29 13:00	XX
2025-10-30 00:00	35854
2025-10-30 01:00	6240
2025-10-30 02:00	XX
2025-10-30 06:00	21577
2025-10-30 07:00	15961

### 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": 335952,
      "num_posts": 733220,
      "interactions_24h": 3296046298
    }
  ]
}
```

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": 1759968000,
    "end": 1760654918,
    "bucket": "hour",
    "metrics": [],
    "generated": 1760647718
  },
  "data": [
    {
      "time": 1759968000,
      "contributors_active": 30745,
      "contributors_created": 1810,
      "interactions": 3972578,
      "posts_active": 62957,
      "posts_created": 2440,
      "sentiment": 78,
      "spam": 339,
      "alt_rank": 198,
      "circulating_supply": 19931834,
      "close": 123004.71,
      "galaxy_score": 56,
      "high": 123004.71,
      "low": 122931.87,
      "market_cap": 2453542301616,
      "market_dominance": 58.0797,
      "open": 123004.71,
      "social_dominance": 30.3039,
      "volume_24h": 62979418928
    }
  ]
}
```

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": 1759968000,
    "end": 1760654918,
    "bucket": "hour",
    "metrics": [],
    "generated": 1760647718
  },
  "data": [
    {
      "time": 1759968000,
      "contributors_active": 30745,
      "contributors_created": 1810,
      "interactions": 3972578,
      "posts_active": 62957,
      "posts_created": 2440,
      "sentiment": 78,
      "spam": 339,
      "alt_rank": 198,
      "circulating_supply": 19931834,
      "close": 123004.71,
      "galaxy_score": 56,
      "high": 123004.71,
      "low": 122931.87,
      "market_cap": 2453542301616,
      "market_dominance": 58.0797,
      "open": 123004.71,
      "social_dominance": 30.3039,
      "volume_24h": 62979418928
    }
  ]
}
```

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": 1760647718
  },
  "data": [
    {
      "id": "t3_1o7u058",
      "post_type": "reddit-post",
      "post_title": "Made this bitcoin shadow box. Not sure if I'm crazy about this design but it's something",
      "post_link": "https://redd.it/1o7u058",
      "post_image": null,
      "post_created": 1760646307,
      "post_sentiment": 3.2,
      "creator_id": "reddit::t2_kszqkqvk",
      "creator_name": "Outrageous-Garage179",
      "creator_display_name": "Outrageous-Garage179",
      "creator_avatar": "https://styles.redditmedia.com/t5_60m8fu/styles/profileIcon_63j7drb563fa1.png?width=256&height=256&crop=256:256,smart&s=9b79b5074a344e0e8cf39a127dcfa5c2f4b5ecf3",
      "interactions_24h": 1683,
      "interactions_total": 1683
    }
  ]
}
```

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




---