[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	641346
2025-10-12 01:00	829107
2025-10-12 02:00	798261
2025-10-12 03:00	633185
2025-10-12 04:00	580429
2025-10-12 05:00	563584
2025-10-12 06:00	625824
2025-10-12 07:00	349564
2025-10-12 08:00	350630
2025-10-12 09:00	340850
2025-10-12 10:00	432732
2025-10-12 11:00	353252
2025-10-12 12:00	371781
2025-10-12 13:00	393595
2025-10-12 14:00	523872
2025-10-12 15:00	434716
2025-10-12 16:00	554093
2025-10-12 17:00	527396
2025-10-12 18:00	857231
2025-10-12 19:00	730448
2025-10-12 20:00	596772
2025-10-12 21:00	542504
2025-10-12 22:00	754527
2025-10-12 23:00	702309
2025-10-13 00:00	583031
2025-10-13 01:00	537035
2025-10-13 02:00	635949
2025-10-13 03:00	645807
2025-10-13 04:00	440245
2025-10-13 05:00	387482
2025-10-13 06:00	397501
2025-10-13 07:00	448050
2025-10-13 08:00	393839
2025-10-13 09:00	342044
2025-10-13 10:00	294167
2025-10-13 11:00	446687
2025-10-13 12:00	428142
2025-10-13 13:00	596200
2025-10-13 14:00	714737
2025-10-13 15:00	586430
2025-10-13 16:00	473492
2025-10-13 17:00	855614
2025-10-13 18:00	978890
2025-10-13 19:00	747690
2025-10-13 20:00	759040
2025-10-13 21:00	1049973
2025-10-13 22:00	903457
2025-10-13 23:00	649571
2025-10-14 00:00	658677
2025-10-14 01:00	677527
2025-10-14 02:00	889280
2025-10-14 03:00	697114
2025-10-14 04:00	600409
2025-10-14 05:00	478521
2025-10-14 06:00	548488
2025-10-14 07:00	541330
2025-10-14 08:00	388365
2025-10-14 09:00	365502
2025-10-14 10:00	453589
2025-10-14 11:00	600124
2025-10-14 12:00	545898
2025-10-14 13:00	683727
2025-10-14 14:00	611510
2025-10-14 15:00	802988
2025-10-14 16:00	1215193
2025-10-14 17:00	1023849
2025-10-14 18:00	771818
2025-10-14 19:00	1111094
2025-10-14 20:00	1187311
2025-10-14 21:00	1105956
2025-10-14 22:00	898583
2025-10-14 23:00	846951
2025-10-15 00:00	1193254
2025-10-15 01:00	1082564
2025-10-15 02:00	998127
2025-10-15 03:00	848994
2025-10-15 04:00	887643
2025-10-15 05:00	753444
2025-10-15 06:00	634866
2025-10-15 07:00	736244
2025-10-15 08:00	879590
2025-10-15 09:00	868283
2025-10-15 10:00	798677
2025-10-15 11:00	1047774
2025-10-15 12:00	971140
2025-10-15 13:00	1424472
2025-10-15 14:00	1203475
2025-10-15 15:00	1570027
2025-10-15 16:00	1779876
2025-10-15 17:00	2365666
2025-10-15 18:00	1910162
2025-10-15 19:00	1900273
2025-10-15 20:00	1702824
2025-10-15 21:00	1867510
2025-10-15 22:00	1752007
2025-10-15 23:00	1631864
2025-10-16 00:00	1495634
2025-10-16 01:00	1554170
2025-10-16 02:00	2007020
2025-10-16 03:00	1713741
2025-10-16 04:00	1284424
2025-10-16 05:00	1098106
2025-10-16 06:00	1265725
2025-10-16 07:00	1082173
2025-10-16 08:00	946680
2025-10-16 09:00	962829
2025-10-16 10:00	1713110
2025-10-16 11:00	1516482
2025-10-16 12:00	1555806
2025-10-16 13:00	1811202
2025-10-16 14:00	2320637
2025-10-16 15:00	2422572
2025-10-16 16:00	2969547
2025-10-16 17:00	2895334
2025-10-16 18:00	3112341
2025-10-16 19:00	2761743
2025-10-16 20:00	2918577
2025-10-16 21:00	2355554
2025-10-16 22:00	2519079
2025-10-16 23:00	2360140
2025-10-17 00:00	2026227
2025-10-17 01:00	2143137
2025-10-17 02:00	2292905
2025-10-17 03:00	2052043
2025-10-17 04:00	1865126
2025-10-17 05:00	1643586
2025-10-17 06:00	1297497
2025-10-17 07:00	1325098
2025-10-17 08:00	1012568
2025-10-17 09:00	957687
2025-10-17 10:00	1062007
2025-10-17 11:00	1531279
2025-10-17 12:00	1411584
2025-10-17 13:00	1376854
2025-10-17 14:00	1559689
2025-10-17 15:00	1669756
2025-10-17 16:00	1950856
2025-10-17 17:00	2074399
2025-10-17 18:00	1788729
2025-10-17 19:00	2038511
2025-10-17 20:00	2028537
2025-10-17 21:00	2022958
2025-10-17 22:00	1564664
2025-10-17 23:00	1673559
2025-10-18 00:00	1681896
2025-10-18 01:00	1363432
2025-10-18 02:00	1243543
2025-10-18 03:00	1234910
2025-10-18 04:00	1208621
2025-10-18 05:00	865671
2025-10-18 06:00	760485
2025-10-18 07:00	705453
2025-10-18 08:00	748194
2025-10-18 09:00	613947
2025-10-18 10:00	667312
2025-10-18 11:00	799723
2025-10-18 12:00	969225
2025-10-18 13:00	1174517
2025-10-18 14:00	1048356
2025-10-18 15:00	1214754
2025-10-18 16:00	1566120
2025-10-18 17:00	1272242
2025-10-18 18:00	1418641
2025-10-18 19:00	1247020
2025-10-18 20:00	1528844
2025-10-18 21:00	1592796
2025-10-18 22:00	1253751
2025-10-18 23:00	1282998
2025-10-19 00:00	1399489
2025-10-19 01:00	1382158
2025-10-19 02:00	1091716
2025-10-19 03:00	956487
2025-10-19 04:00	655944
2025-10-19 05:00	819648
2025-10-19 06:00	437203
2025-10-19 07:00	456942
2025-10-19 08:00	352482
2025-10-19 09:00	476839
2025-10-19 10:00	375924
2025-10-19 11:00	426028
2025-10-19 12:00	483084
2025-10-19 13:00	592875
2025-10-19 14:00	509882
2025-10-19 15:00	152282
2025-10-19 16:00	529297
2025-10-19 17:00	200584
2025-10-19 18:00	33963
2025-10-19 19:00	27497
2025-10-19 20:00	19248

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




---