[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-14 00:00	2460
2025-10-14 01:00	3142
2025-10-14 02:00	3511
2025-10-14 03:00	2548
2025-10-14 04:00	2522
2025-10-14 05:00	2272
2025-10-14 06:00	3171
2025-10-14 07:00	5881
2025-10-14 08:00	3774
2025-10-14 09:00	2590
2025-10-14 10:00	2226
2025-10-14 11:00	2430
2025-10-14 12:00	2124
2025-10-14 13:00	5344
2025-10-14 14:00	3848
2025-10-14 15:00	2071
2025-10-14 16:00	6650
2025-10-14 17:00	2170
2025-10-14 18:00	XXX
2025-10-14 19:00	XXX
2025-10-14 20:00	3219
2025-10-14 21:00	3183
2025-10-14 22:00	3355
2025-10-14 23:00	2571
2025-10-15 00:00	4348
2025-10-15 01:00	5244
2025-10-15 02:00	4204
2025-10-15 03:00	32006
2025-10-15 04:00	8086
2025-10-15 05:00	2385
2025-10-15 06:00	15140
2025-10-15 07:00	50059
2025-10-15 08:00	41314
2025-10-15 09:00	39387
2025-10-15 10:00	29913
2025-10-15 11:00	35715
2025-10-15 12:00	24743
2025-10-15 13:00	8849
2025-10-15 14:00	14289
2025-10-15 15:00	10102
2025-10-15 16:00	8775
2025-10-15 17:00	32186
2025-10-15 18:00	29655
2025-10-15 19:00	6480
2025-10-15 20:00	8483
2025-10-15 21:00	9070
2025-10-15 22:00	32403
2025-10-15 23:00	39815
2025-10-16 00:00	6743
2025-10-16 01:00	6129
2025-10-16 02:00	5901
2025-10-16 03:00	6600
2025-10-16 04:00	7147
2025-10-16 05:00	13009
2025-10-16 06:00	6388
2025-10-16 07:00	9002
2025-10-16 08:00	5698
2025-10-16 09:00	7004
2025-10-16 10:00	9952
2025-10-16 11:00	6808
2025-10-16 12:00	8292
2025-10-16 13:00	9230
2025-10-16 14:00	16428
2025-10-16 15:00	9562
2025-10-16 16:00	18558
2025-10-16 17:00	6926
2025-10-16 18:00	6372
2025-10-16 19:00	17883
2025-10-16 20:00	15304
2025-10-16 21:00	12880
2025-10-16 22:00	7756
2025-10-16 23:00	6701
2025-10-17 00:00	5989
2025-10-17 01:00	8421
2025-10-17 02:00	8247
2025-10-17 03:00	7424
2025-10-17 04:00	12079
2025-10-17 05:00	17340
2025-10-17 06:00	8839
2025-10-17 07:00	46699
2025-10-17 08:00	17911
2025-10-17 09:00	8876
2025-10-17 10:00	9567
2025-10-17 11:00	8630
2025-10-17 12:00	8213
2025-10-17 13:00	9453
2025-10-17 14:00	7708
2025-10-17 15:00	11716
2025-10-17 16:00	20359
2025-10-17 17:00	5585
2025-10-17 18:00	5034
2025-10-17 19:00	3907
2025-10-17 20:00	7934
2025-10-17 21:00	4062
2025-10-17 22:00	4151
2025-10-17 23:00	4054
2025-10-18 00:00	5602
2025-10-18 01:00	6306
2025-10-18 02:00	6190
2025-10-18 03:00	5815
2025-10-18 04:00	4817
2025-10-18 05:00	5669
2025-10-18 06:00	10110
2025-10-18 07:00	4622
2025-10-18 08:00	7898
2025-10-18 09:00	7089
2025-10-18 10:00	35424
2025-10-18 11:00	23901
2025-10-18 12:00	5092
2025-10-18 13:00	15509
2025-10-18 14:00	6426
2025-10-18 15:00	5844
2025-10-18 16:00	8139
2025-10-18 17:00	4599
2025-10-18 18:00	3952
2025-10-18 19:00	4101
2025-10-18 20:00	7473
2025-10-18 21:00	11726
2025-10-18 22:00	2627
2025-10-18 23:00	4772
2025-10-19 00:00	3334
2025-10-19 01:00	3263
2025-10-19 02:00	4127
2025-10-19 03:00	5654
2025-10-19 04:00	5445
2025-10-19 05:00	4855
2025-10-19 06:00	4353
2025-10-19 07:00	6046
2025-10-19 08:00	7333
2025-10-19 09:00	7712
2025-10-19 10:00	4506
2025-10-19 11:00	7136
2025-10-19 12:00	4977
2025-10-19 13:00	3696
2025-10-19 14:00	4164
2025-10-19 15:00	4794
2025-10-19 16:00	13965
2025-10-19 17:00	11176
2025-10-19 18:00	6308
2025-10-19 19:00	14348
2025-10-19 20:00	33250
2025-10-19 21:00	6601
2025-10-19 22:00	3683
2025-10-19 23:00	3979
2025-10-20 00:00	4245
2025-10-20 01:00	5438
2025-10-20 02:00	12042
2025-10-20 03:00	6136
2025-10-20 04:00	6336
2025-10-20 05:00	5423
2025-10-20 06:00	7022
2025-10-20 07:00	6910
2025-10-20 08:00	7414
2025-10-20 09:00	16067
2025-10-20 10:00	9711
2025-10-20 11:00	4665
2025-10-20 12:00	2932
2025-10-20 21:00	1665
2025-10-20 22:00	XXX
2025-10-20 23: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




---