[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 00:00	129598
2025-10-12 01:00	341394
2025-10-12 02:00	208455
2025-10-12 03:00	209472
2025-10-12 04:00	101037
2025-10-12 05:00	44507
2025-10-12 06:00	51554
2025-10-12 07:00	55379
2025-10-12 08:00	59727
2025-10-12 09:00	34313
2025-10-12 10:00	40707
2025-10-12 11:00	78712
2025-10-12 12:00	100687
2025-10-12 13:00	90428
2025-10-12 14:00	217092
2025-10-12 15:00	161936
2025-10-12 16:00	165326
2025-10-12 17:00	177542
2025-10-12 18:00	205964
2025-10-12 19:00	152171
2025-10-12 20:00	133782
2025-10-12 21:00	112293
2025-10-12 22:00	125166
2025-10-12 23:00	109392
2025-10-13 00:00	123887
2025-10-13 01:00	161437
2025-10-13 02:00	200726
2025-10-13 03:00	119693
2025-10-13 04:00	101064
2025-10-13 05:00	59124
2025-10-13 06:00	47766
2025-10-13 07:00	30506
2025-10-13 08:00	25077
2025-10-13 09:00	45954
2025-10-13 10:00	19704
2025-10-13 11:00	168090
2025-10-13 12:00	124386
2025-10-13 13:00	143926
2025-10-13 14:00	121079
2025-10-13 15:00	138424
2025-10-13 16:00	115237
2025-10-13 17:00	107066
2025-10-13 18:00	47424
2025-10-13 19:00	51279
2025-10-13 20:00	44280
2025-10-13 21:00	60680
2025-10-13 22:00	39883
2025-10-13 23:00	39908
2025-10-14 00:00	40066
2025-10-14 01:00	45190
2025-10-14 02:00	34186
2025-10-14 03:00	41406
2025-10-14 04:00	25239
2025-10-14 05:00	66407
2025-10-14 06:00	154381
2025-10-14 07:00	41231
2025-10-14 08:00	44762
2025-10-14 09:00	93127
2025-10-14 10:00	62198
2025-10-14 11:00	69963
2025-10-14 12:00	54053
2025-10-14 13:00	66813
2025-10-14 14:00	91108
2025-10-14 15:00	153000
2025-10-14 16:00	92321
2025-10-14 17:00	93110
2025-10-14 18:00	119027
2025-10-14 19:00	102603
2025-10-14 20:00	154926
2025-10-14 21:00	138539
2025-10-14 22:00	130525
2025-10-14 23:00	147932
2025-10-15 00:00	87223
2025-10-15 01:00	141268
2025-10-15 02:00	119614
2025-10-15 03:00	110335
2025-10-15 04:00	100496
2025-10-15 05:00	96223
2025-10-15 06:00	97605
2025-10-15 07:00	117986
2025-10-15 08:00	215385
2025-10-15 09:00	166646
2025-10-15 10:00	180193
2025-10-15 11:00	168622
2025-10-15 12:00	301960
2025-10-15 13:00	702160
2025-10-15 14:00	207920
2025-10-15 15:00	325867
2025-10-15 16:00	316516
2025-10-15 17:00	457155
2025-10-15 18:00	498509
2025-10-15 19:00	366916
2025-10-15 20:00	488814
2025-10-15 21:00	352285
2025-10-15 22:00	360880
2025-10-15 23:00	326289
2025-10-16 00:00	454998
2025-10-16 01:00	322012
2025-10-16 02:00	147560
2025-10-16 03:00	89631
2025-10-16 04:00	66490
2025-10-16 05:00	41974
2025-10-16 06:00	29096
2025-10-16 07:00	24179
2025-10-16 08:00	27252
2025-10-16 09:00	33124
2025-10-16 10:00	48965
2025-10-16 11:00	55791
2025-10-16 12:00	77297
2025-10-16 13:00	91293
2025-10-16 14:00	93986
2025-10-16 15:00	84833
2025-10-16 16:00	78681
2025-10-16 17:00	79241
2025-10-16 18:00	82232
2025-10-16 19:00	63252
2025-10-16 20:00	69233
2025-10-16 21:00	60315
2025-10-16 22:00	49084
2025-10-16 23:00	46892
2025-10-17 00:00	53774
2025-10-17 01:00	47379
2025-10-17 02:00	31882
2025-10-17 03:00	23712
2025-10-17 04:00	17405
2025-10-17 05:00	13023
2025-10-17 06:00	9180
2025-10-17 07:00	9363
2025-10-17 08:00	9875
2025-10-17 09:00	9999
2025-10-17 10:00	16014
2025-10-17 11:00	20021
2025-10-17 12:00	27194
2025-10-17 13:00	37304
2025-10-17 14:00	38118
2025-10-17 15:00	27421
2025-10-17 16:00	35301
2025-10-17 17:00	44475
2025-10-17 18:00	40622
2025-10-17 19:00	28391
2025-10-17 20:00	33408
2025-10-17 21:00	34964
2025-10-17 22:00	30315
2025-10-17 23:00	29123
2025-10-18 00:00	33035
2025-10-18 01:00	25162
2025-10-18 02:00	23399
2025-10-18 03:00	16822
2025-10-18 04:00	11880
2025-10-18 05:00	7882
2025-10-18 06:00	6736
2025-10-18 07:00	5103
2025-10-18 08:00	9116
2025-10-18 09:00	6762
2025-10-18 10:00	10469
2025-10-18 11:00	11597
2025-10-18 12:00	16276
2025-10-18 13:00	17867
2025-10-18 14:00	27055
2025-10-18 15:00	32606
2025-10-18 16:00	30878
2025-10-18 17:00	33408
2025-10-18 18:00	42352
2025-10-18 19:00	54916
2025-10-18 20:00	98101
2025-10-18 21:00	218557
2025-10-18 22:00	570446
2025-10-18 23:00	531548
2025-10-19 00:00	446583
2025-10-19 01:00	310081
2025-10-19 02:00	278756
2025-10-19 03:00	431760
2025-10-19 04:00	294252
2025-10-19 05:00	166024
2025-10-19 06:00	98819
2025-10-19 07:00	68325
2025-10-19 08:00	41165
2025-10-19 09:00	39673
2025-10-19 10:00	46080
2025-10-19 11:00	87947
2025-10-19 12:00	XXX
2025-10-19 13:00	150915
2025-10-19 14:00	XXX
2025-10-19 15: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": 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




---