[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-26 00:00	14980
2025-10-26 01:00	14052
2025-10-26 02:00	13796
2025-10-26 03:00	18692
2025-10-26 04:00	17125
2025-10-26 05:00	22238
2025-10-26 06:00	17566
2025-10-26 07:00	19689
2025-10-26 08:00	24674
2025-10-26 09:00	28983
2025-10-26 10:00	20229
2025-10-26 11:00	35504
2025-10-26 12:00	31556
2025-10-26 13:00	19411
2025-10-26 14:00	16920
2025-10-26 15:00	18575
2025-10-26 16:00	18005
2025-10-26 17:00	25002
2025-10-26 18:00	25575
2025-10-26 19:00	15324
2025-10-26 20:00	13194
2025-10-26 21:00	24665
2025-10-26 22:00	11551
2025-10-26 23:00	8949
2025-10-27 00:00	11424
2025-10-27 01:00	10169
2025-10-27 02:00	16186
2025-10-27 03:00	9380
2025-10-27 04:00	11621
2025-10-27 05:00	21143
2025-10-27 06:00	18543
2025-10-27 07:00	20474
2025-10-27 08:00	21285
2025-10-27 09:00	37447
2025-10-27 10:00	34511
2025-10-27 11:00	28805
2025-10-27 12:00	36613
2025-10-27 13:00	32531
2025-10-27 14:00	47137
2025-10-27 15:00	24756
2025-10-27 16:00	31618
2025-10-27 17:00	22047
2025-10-27 18:00	61202
2025-10-27 19:00	30409
2025-10-27 20:00	34517
2025-10-27 21:00	22986
2025-10-27 22:00	25124
2025-10-27 23:00	20459
2025-10-28 00:00	17138
2025-10-28 01:00	14415
2025-10-28 02:00	15044
2025-10-28 03:00	12970
2025-10-28 04:00	15309
2025-10-28 05:00	20056
2025-10-28 06:00	17681
2025-10-28 07:00	20191
2025-10-28 08:00	17239
2025-10-28 09:00	23253
2025-10-28 10:00	25219
2025-10-28 11:00	33432
2025-10-28 12:00	36894
2025-10-28 13:00	27502
2025-10-28 14:00	29598
2025-10-28 15:00	27683
2025-10-28 16:00	23282
2025-10-28 17:00	27681
2025-10-28 18:00	27785
2025-10-28 19:00	35502
2025-10-28 20:00	30101
2025-10-28 21:00	25974
2025-10-28 22:00	25427
2025-10-28 23:00	18253
2025-10-29 00:00	13996
2025-10-29 01:00	14146
2025-10-29 02:00	13079
2025-10-29 03:00	13748
2025-10-29 04:00	11647
2025-10-29 05:00	14337
2025-10-29 06:00	18408
2025-10-29 07:00	23585
2025-10-29 08:00	27174
2025-10-29 09:00	32485
2025-10-29 10:00	30399
2025-10-29 11:00	38084
2025-10-29 12:00	38891
2025-10-29 13:00	30155
2025-10-29 14:00	32588
2025-10-29 15:00	34442
2025-10-29 16:00	33188
2025-10-29 17:00	23215
2025-10-29 18:00	28982
2025-10-29 19:00	33817
2025-10-29 20:00	33618
2025-10-29 21:00	28700
2025-10-29 22:00	19840
2025-10-29 23:00	16940
2025-10-30 00:00	14602
2025-10-30 01:00	15493
2025-10-30 02:00	13794
2025-10-30 03:00	13236
2025-10-30 04:00	15891
2025-10-30 05:00	14974
2025-10-30 06:00	15169
2025-10-30 07:00	18010
2025-10-30 08:00	25880
2025-10-30 09:00	23754
2025-10-30 10:00	22206
2025-10-30 11:00	23557
2025-10-30 12:00	27850
2025-10-30 13:00	28860
2025-10-30 14:00	25894
2025-10-30 15:00	29684
2025-10-30 16:00	27205
2025-10-30 17:00	36451
2025-10-30 18:00	29774
2025-10-30 19:00	23462
2025-10-30 20:00	26274
2025-10-30 21:00	33824
2025-10-30 22:00	33160
2025-10-30 23:00	22901
2025-10-31 00:00	23563
2025-10-31 01:00	24406
2025-10-31 02:00	26799
2025-10-31 03:00	22999
2025-10-31 04:00	25148
2025-10-31 05:00	31414
2025-10-31 06:00	31034
2025-10-31 07:00	23705
2025-10-31 08:00	24286
2025-10-31 09:00	29146
2025-10-31 10:00	29180
2025-10-31 11:00	33071
2025-10-31 12:00	34906
2025-10-31 13:00	31760
2025-10-31 14:00	34448
2025-10-31 15:00	29905
2025-10-31 16:00	23601
2025-10-31 17:00	26686
2025-10-31 18:00	32809
2025-10-31 19:00	31842
2025-10-31 20:00	25105
2025-10-31 21:00	19794
2025-10-31 22:00	29475
2025-10-31 23:00	32923
2025-11-01 00:00	19193
2025-11-01 01:00	18925
2025-11-01 02:00	21707
2025-11-01 03:00	26386
2025-11-01 04:00	17171
2025-11-01 05:00	15780
2025-11-01 06:00	27906
2025-11-01 07:00	26356
2025-11-01 08:00	24474
2025-11-01 09:00	24968
2025-11-02 00:00	12067
2025-11-02 01:00	379785
2025-11-02 02:00	XXX
2025-11-02 05:00	17199
2025-11-02 06:00	1788
2025-11-02 07:00	XX

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




---