[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-12 12:00	14567
2025-10-12 13:00	11023
2025-10-12 14:00	61471
2025-10-12 15:00	16620
2025-10-12 16:00	19067
2025-10-12 17:00	10777
2025-10-12 18:00	40522
2025-10-12 19:00	17498
2025-10-12 20:00	18399
2025-10-12 21:00	12118
2025-10-12 22:00	31666
2025-10-12 23:00	10207
2025-10-13 00:00	14654
2025-10-13 01:00	16951
2025-10-13 02:00	35993
2025-10-13 03:00	29878
2025-10-13 04:00	50881
2025-10-13 05:00	36245
2025-10-13 06:00	34046
2025-10-13 07:00	41101
2025-10-13 08:00	36970
2025-10-13 09:00	21800
2025-10-13 10:00	17472
2025-10-13 11:00	33441
2025-10-13 12:00	23414
2025-10-13 13:00	39661
2025-10-13 14:00	39093
2025-10-13 15:00	24043
2025-10-13 16:00	26040
2025-10-13 17:00	29344
2025-10-13 18:00	58179
2025-10-13 19:00	23526
2025-10-13 20:00	20300
2025-10-13 21:00	25011
2025-10-13 22:00	32935
2025-10-13 23:00	19427
2025-10-14 00:00	16913
2025-10-14 01:00	9308
2025-10-14 02:00	11941
2025-10-14 03:00	26182
2025-10-14 04:00	12456
2025-10-14 05:00	45938
2025-10-14 06:00	33105
2025-10-14 07:00	9880
2025-10-14 08:00	8189
2025-10-14 09:00	10424
2025-10-14 10:00	16385
2025-10-14 11:00	22268
2025-10-14 12:00	10657
2025-10-14 13:00	29678
2025-10-14 14:00	9751
2025-10-14 15:00	29672
2025-10-14 16:00	15235
2025-10-14 17:00	19788
2025-10-14 18:00	17174
2025-10-14 19:00	15874
2025-10-14 20:00	33692
2025-10-14 21:00	13105
2025-10-14 22:00	21469
2025-10-14 23:00	11559
2025-10-15 00:00	38087
2025-10-15 01:00	47318
2025-10-15 02:00	25620
2025-10-15 03:00	82626
2025-10-15 04:00	36491
2025-10-15 05:00	131035
2025-10-15 06:00	25160
2025-10-15 07:00	11454
2025-10-15 08:00	21775
2025-10-15 09:00	15579
2025-10-15 10:00	27136
2025-10-15 11:00	17089
2025-10-15 12:00	35367
2025-10-15 13:00	61525
2025-10-15 14:00	66010
2025-10-15 15:00	58143
2025-10-15 16:00	51944
2025-10-15 17:00	46632
2025-10-15 18:00	18236
2025-10-15 19:00	18030
2025-10-15 20:00	17650
2025-10-15 21:00	20646
2025-10-15 22:00	8642
2025-10-15 23:00	9925
2025-10-16 00:00	8563
2025-10-16 01:00	10157
2025-10-16 02:00	16525
2025-10-16 03:00	35784
2025-10-16 04:00	64904
2025-10-16 05:00	59922
2025-10-16 06:00	44982
2025-10-16 07:00	85779
2025-10-16 08:00	69166
2025-10-16 09:00	95451
2025-10-16 10:00	105675
2025-10-16 11:00	106254
2025-10-16 12:00	68682
2025-10-16 13:00	68077
2025-10-16 14:00	82019
2025-10-16 15:00	73462
2025-10-16 16:00	85906
2025-10-16 17:00	86939
2025-10-16 18:00	70359
2025-10-16 19:00	64499
2025-10-16 20:00	53735
2025-10-16 21:00	41522
2025-10-16 22:00	40088
2025-10-16 23:00	23119
2025-10-17 00:00	36946
2025-10-17 01:00	25641
2025-10-17 02:00	27083
2025-10-17 03:00	38396
2025-10-17 04:00	40553
2025-10-17 05:00	39626
2025-10-17 06:00	53815
2025-10-17 07:00	84989
2025-10-17 08:00	33416
2025-10-17 09:00	32733
2025-10-17 10:00	29535
2025-10-17 11:00	44607
2025-10-17 12:00	50195
2025-10-17 13:00	27561
2025-10-17 14:00	38826
2025-10-17 15:00	46642
2025-10-17 16:00	61777
2025-10-17 17:00	91394
2025-10-17 18:00	100165
2025-10-17 19:00	142319
2025-10-17 20:00	159653
2025-10-17 21:00	171727
2025-10-17 22:00	96777
2025-10-17 23:00	113401
2025-10-18 00:00	158679
2025-10-18 01:00	101006
2025-10-18 02:00	124120
2025-10-18 03:00	211446
2025-10-18 04:00	222300
2025-10-18 05:00	271504
2025-10-18 06:00	319005
2025-10-18 07:00	311466
2025-10-18 08:00	303846
2025-10-18 09:00	343050
2025-10-18 10:00	250824
2025-10-18 11:00	241025
2025-10-18 12:00	286564
2025-10-18 13:00	206341
2025-10-18 14:00	237196
2025-10-18 15:00	67157
2025-10-18 16:00	340274
2025-10-18 17:00	147461
2025-10-18 18:00	336636
2025-10-18 19:00	189707
2025-10-18 20:00	283333
2025-10-18 21:00	202399
2025-10-18 22:00	161630
2025-10-18 23:00	114473
2025-10-19 00:00	125145
2025-10-19 01:00	129560
2025-10-19 02:00	137380
2025-10-19 03:00	163639
2025-10-19 04:00	177203
2025-10-19 05:00	287975
2025-10-19 06:00	256312
2025-10-19 07:00	420155
2025-10-19 08:00	427238
2025-10-19 09:00	246534
2025-10-19 10:00	161082
2025-10-19 11:00	227449
2025-10-19 12:00	158879
2025-10-19 13:00	199584
2025-10-19 14:00	175362
2025-10-19 15:00	159379
2025-10-19 16:00	237420
2025-10-19 17:00	262760
2025-10-19 18:00	243040
2025-10-19 19:00	326733
2025-10-19 20:00	192679
2025-10-19 21:00	145275
2025-10-19 22:00	132174
2025-10-19 23:00	117666
2025-10-20 00:00	120179
2025-10-20 01:00	101281
2025-10-20 02:00	58199
2025-10-20 03:00	88750
2025-10-20 04:00	95118
2025-10-20 05:00	97941
2025-10-20 06:00	108221
2025-10-20 07:00	95774
2025-10-20 08:00	146645
2025-10-20 09:00	121327
2025-10-20 10:00	101029
2025-10-20 11:00	90598

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




---