[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-05 16:00	32369
2025-10-05 17:00	11474
2025-10-05 18:00	11623
2025-10-05 19:00	23712
2025-10-05 20:00	47646
2025-10-05 21:00	XXX
2025-10-05 22:00	XX
2025-10-11 14:00	10528
2025-10-11 15:00	8301
2025-10-11 16:00	5576
2025-10-11 17:00	13688
2025-10-11 18:00	6365
2025-10-11 19:00	7529
2025-10-11 20:00	4107
2025-10-11 21:00	4259
2025-10-11 22:00	3994
2025-10-11 23:00	16577
2025-10-12 00:00	4845
2025-10-12 01:00	7543
2025-10-12 02:00	15268
2025-10-12 03:00	11732
2025-10-12 04:00	5805
2025-10-12 05:00	4233
2025-10-12 06:00	4810
2025-10-12 07:00	2574
2025-10-12 08:00	4267
2025-10-12 09:00	3776
2025-10-12 10:00	2674
2025-10-12 11:00	3184
2025-10-12 12:00	3712
2025-10-12 13:00	4634
2025-10-12 14:00	4881
2025-10-12 15:00	4524
2025-10-12 16:00	6637
2025-10-12 17:00	3823
2025-10-12 18:00	4130
2025-10-12 19:00	5747
2025-10-12 20:00	3527
2025-10-12 21:00	2458
2025-10-12 22:00	2571
2025-10-12 23:00	1901
2025-10-13 00:00	3268
2025-10-13 01:00	2276
2025-10-13 02:00	2915
2025-10-13 03:00	1371
2025-10-13 04:00	4082
2025-10-13 05:00	1496
2025-10-13 06:00	2130
2025-10-13 07:00	7099
2025-10-13 08:00	1755
2025-10-13 09:00	3597
2025-10-13 10:00	3020
2025-10-13 11:00	1712
2025-10-13 12:00	2552
2025-10-13 13:00	18558
2025-10-13 14:00	XXX
2025-10-13 15:00	X
2025-10-14 16:00	9293
2025-10-14 17:00	9939
2025-10-14 18:00	6155
2025-10-14 19:00	9507
2025-10-14 20:00	5866
2025-10-14 21:00	4162
2025-10-14 22:00	4430
2025-10-14 23:00	4249
2025-10-15 00:00	18923
2025-10-15 01:00	5370
2025-10-15 02:00	4137
2025-10-15 03:00	9064
2025-10-15 04:00	8491
2025-10-15 05:00	4579
2025-10-15 06:00	18026
2025-10-15 07:00	12747
2025-10-15 08:00	13696
2025-10-15 09:00	11056
2025-10-15 10:00	11650
2025-10-15 11:00	19238
2025-10-15 12:00	16478
2025-10-15 13:00	11189
2025-10-15 14:00	9020
2025-10-15 15:00	9913
2025-10-15 16:00	17691
2025-10-15 17:00	10613
2025-10-15 18:00	17960
2025-10-15 19:00	7028
2025-10-15 20:00	12535
2025-10-15 21:00	6974
2025-10-15 22:00	5000
2025-10-15 23:00	4625
2025-10-16 00:00	6116
2025-10-16 01:00	6053
2025-10-16 02:00	7525
2025-10-16 03:00	9377
2025-10-16 04:00	21190
2025-10-16 05:00	11974
2025-10-16 06:00	32392
2025-10-16 07:00	36874
2025-10-16 08:00	16447
2025-10-16 09:00	20836
2025-10-16 10:00	11122
2025-10-16 11:00	7969
2025-10-16 12:00	13630
2025-10-16 13:00	18358
2025-10-16 14:00	29054
2025-10-16 15:00	7454
2025-10-16 16:00	18165
2025-10-16 17:00	10092
2025-10-16 18:00	7171
2025-10-16 19:00	14776
2025-10-16 20:00	12230
2025-10-16 21:00	10371
2025-10-16 22:00	8364
2025-10-16 23:00	6964
2025-10-17 00:00	11661
2025-10-17 01:00	16181
2025-10-17 02:00	12935
2025-10-17 03:00	7486
2025-10-17 04:00	9403
2025-10-17 05:00	15163
2025-10-17 06:00	20174
2025-10-17 07:00	15475
2025-10-17 08:00	19969
2025-10-17 09:00	20755
2025-10-17 10:00	27427
2025-10-17 11:00	30646
2025-10-17 12:00	43088
2025-10-17 13:00	34168
2025-10-17 14:00	35247
2025-10-17 15:00	25121
2025-10-17 16:00	23414
2025-10-17 17:00	20448
2025-10-17 18:00	14869
2025-10-17 19:00	11669
2025-10-17 20:00	15300
2025-10-17 21:00	8063
2025-10-17 22:00	7835
2025-10-17 23:00	6699
2025-10-18 00:00	9108
2025-10-18 01:00	8735
2025-10-18 02:00	12800
2025-10-18 03:00	7942
2025-10-18 04:00	15098
2025-10-18 05:00	7704
2025-10-18 06:00	13806
2025-10-18 07:00	12808
2025-10-18 08:00	16241
2025-10-18 09:00	11171
2025-10-18 10:00	13854
2025-10-18 11:00	25881
2025-10-18 12:00	19551
2025-10-18 13:00	43779
2025-10-18 14:00	18500
2025-10-18 15:00	17345
2025-10-18 16:00	12400
2025-10-18 17:00	20499
2025-10-18 18:00	11934
2025-10-18 19:00	6503
2025-10-18 20:00	5415
2025-10-18 21:00	4540
2025-10-18 22:00	5128
2025-10-18 23:00	6792
2025-10-19 00:00	8988
2025-10-19 01:00	8783
2025-10-19 02:00	5772
2025-10-19 03:00	12053
2025-10-19 04:00	4969
2025-10-19 05:00	12104
2025-10-19 06:00	6050
2025-10-19 07:00	8854
2025-10-19 08:00	5863
2025-10-19 09:00	10454
2025-10-19 10:00	7452
2025-10-19 11:00	12383
2025-10-19 12:00	7231
2025-10-19 13:00	4937
2025-10-20 03:00	6662
2025-10-20 04:00	5573
2025-10-20 05:00	6983
2025-10-19 14:00	7537
2025-10-19 15:00	6024
2025-10-19 16:00	8299
2025-10-19 17:00	4603
2025-10-19 18:00	6429
2025-10-19 19:00	4576
2025-10-19 20:00	4747
2025-10-19 21:00	3835
2025-10-19 22:00	3147
2025-10-19 23:00	3171
2025-10-20 00:00	3636
2025-10-20 01:00	10834
2025-10-20 02:00	9505
2025-10-20 06:00	11987

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




---