[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	11698
2025-10-12 01:00	15077
2025-10-12 02:00	9940
2025-10-12 03:00	11264
2025-10-12 04:00	6652
2025-10-12 05:00	6280
2025-10-12 06:00	3667
2025-10-12 07:00	3343
2025-10-12 08:00	2376
2025-10-12 09:00	2077
2025-10-12 10:00	2813
2025-10-12 11:00	3923
2025-10-12 12:00	5917
2025-10-12 13:00	6229
2025-10-12 14:00	6761
2025-10-12 15:00	8399
2025-10-12 16:00	7743
2025-10-12 17:00	8265
2025-10-12 18:00	9400
2025-10-12 19:00	8941
2025-10-12 20:00	9572
2025-10-12 21:00	7214
2025-10-12 22:00	8330
2025-10-12 23:00	8326
2025-10-13 00:00	8115
2025-10-13 01:00	8903
2025-10-13 02:00	7614
2025-10-13 03:00	6378
2025-10-13 04:00	4156
2025-10-13 05:00	2940
2025-10-13 06:00	2954
2025-10-13 07:00	1675
2025-10-13 08:00	1800
2025-10-13 09:00	1525
2025-10-13 10:00	2849
2025-10-13 11:00	4470
2025-10-13 12:00	3332
2025-10-13 13:00	4368
2025-10-13 14:00	4579
2025-10-13 15:00	4690
2025-10-13 16:00	8401
2025-10-13 17:00	12220
2025-10-13 18:00	8553
2025-10-13 19:00	10781
2025-10-13 20:00	5596
2025-10-13 21:00	5432
2025-10-13 22:00	6017
2025-10-13 23:00	5128
2025-10-14 00:00	6394
2025-10-14 01:00	6037
2025-10-14 02:00	5565
2025-10-14 03:00	4885
2025-10-14 04:00	3254
2025-10-14 05:00	2462
2025-10-14 06:00	2211
2025-10-14 07:00	1385
2025-10-14 08:00	1348
2025-10-14 09:00	1582
2025-10-14 10:00	1404
2025-10-14 11:00	2666
2025-10-14 12:00	2727
2025-10-14 13:00	3317
2025-10-14 14:00	1871
2025-10-14 15:00	3320
2025-10-14 16:00	3891
2025-10-14 17:00	3130
2025-10-14 18:00	3485
2025-10-14 19:00	2427
2025-10-14 20:00	4140
2025-10-14 21:00	4649
2025-10-14 22:00	3806
2025-10-14 23:00	3863
2025-10-15 00:00	5772
2025-10-15 01:00	3763
2025-10-15 02:00	3028
2025-10-15 03:00	3345
2025-10-15 04:00	2139
2025-10-15 05:00	1756
2025-10-15 06:00	1861
2025-10-15 07:00	XXX
2025-10-15 08:00	XXX
2025-10-15 09:00	XXX
2025-10-15 10:00	1059
2025-10-15 11:00	3585
2025-10-15 12:00	2204
2025-10-15 13:00	1642
2025-10-15 14:00	2373
2025-10-15 15:00	2046
2025-10-15 16:00	2980
2025-10-15 17:00	1521
2025-10-15 18:00	2668
2025-10-15 19:00	2173
2025-10-15 20:00	1772
2025-10-15 21:00	1972
2025-10-15 22:00	2612
2025-10-15 23:00	2718
2025-10-16 00:00	2952
2025-10-16 01:00	2019
2025-10-16 02:00	1934
2025-10-16 03:00	2571
2025-10-16 04:00	1538
2025-10-16 05:00	1295
2025-10-16 06:00	XXX
2025-10-16 07:00	XXX
2025-10-16 08:00	XXX
2025-10-16 09:00	XXX
2025-10-16 10:00	XXX
2025-10-16 11:00	XXX
2025-10-16 12:00	XXX
2025-10-16 13:00	1034
2025-10-16 14:00	1551
2025-10-16 15:00	XXX
2025-10-16 16:00	2170
2025-10-16 17:00	1228
2025-10-16 18:00	XXX
2025-10-16 19:00	2370
2025-10-16 20:00	1412
2025-10-16 21:00	1331
2025-10-16 22:00	1775
2025-10-16 23:00	5430
2025-10-17 00:00	1625
2025-10-17 01:00	1524
2025-10-17 02:00	2032
2025-10-17 03:00	1431
2025-10-17 04:00	1716
2025-10-17 05:00	1404
2025-10-17 06:00	XXX
2025-10-17 07:00	XXX
2025-10-17 08:00	XXX
2025-10-17 09:00	XXX
2025-10-17 10:00	1196
2025-10-17 11:00	1391
2025-10-17 12:00	1936
2025-10-17 13:00	2874
2025-10-17 14:00	3022
2025-10-17 15:00	2974
2025-10-17 16:00	157800
2025-10-17 17:00	1570
2025-10-17 18:00	2160
2025-10-17 19:00	2597
2025-10-17 20:00	4150
2025-10-17 21:00	2821
2025-10-17 22:00	1782
2025-10-17 23:00	2556
2025-10-18 00:00	2363
2025-10-18 01:00	2705
2025-10-18 02:00	1728
2025-10-18 03:00	1270
2025-10-18 04:00	1263
2025-10-18 05:00	XXX
2025-10-18 06:00	1094
2025-10-18 07:00	1018
2025-10-18 08:00	XXX
2025-10-18 09:00	XXX
2025-10-18 10:00	XXX
2025-10-18 11:00	XXX
2025-10-18 12:00	1020
2025-10-18 13:00	1896
2025-10-18 14:00	1599
2025-10-18 15:00	1021
2025-10-18 16:00	1439
2025-10-18 17:00	1484
2025-10-18 18:00	1935
2025-10-18 19:00	1240
2025-10-18 20:00	3616
2025-10-18 21:00	XXX
2025-10-18 22:00	1174
2025-10-18 23:00	3667
2025-10-19 00:00	4364
2025-10-19 01:00	6970
2025-10-19 02:00	5875
2025-10-19 03:00	6405
2025-10-19 04:00	3909
2025-10-19 05:00	3829
2025-10-19 06:00	2176
2025-10-19 07:00	1879
2025-10-19 08:00	2220
2025-10-19 09:00	1699
2025-10-19 10:00	1435
2025-10-19 11:00	1146

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




---