[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-13 00:00	96876
2025-10-13 01:00	77917
2025-10-13 02:00	142680
2025-10-13 03:00	127075
2025-10-13 04:00	181953
2025-10-13 05:00	117049
2025-10-13 06:00	133478
2025-10-13 07:00	187581
2025-10-13 08:00	152447
2025-10-13 09:00	147216
2025-10-13 10:00	187398
2025-10-13 11:00	90433
2025-10-13 12:00	147710
2025-10-13 13:00	127658
2025-10-13 14:00	146638
2025-10-13 15:00	177817
2025-10-13 16:00	77273
2025-10-13 17:00	142207
2025-10-13 18:00	95827
2025-10-13 19:00	75180
2025-10-13 20:00	47387
2025-10-13 21:00	59875
2025-10-13 22:00	66321
2025-10-13 23:00	45383
2025-10-14 00:00	67492
2025-10-14 01:00	103583
2025-10-14 02:00	173498
2025-10-14 03:00	128421
2025-10-14 04:00	149904
2025-10-14 05:00	131762
2025-10-14 06:00	127273
2025-10-14 07:00	139012
2025-10-14 08:00	122372
2025-10-14 09:00	136764
2025-10-14 10:00	122931
2025-10-14 11:00	190955
2025-10-14 12:00	130191
2025-10-14 13:00	113796
2025-10-14 14:00	127358
2025-10-14 15:00	117092
2025-10-14 16:00	192145
2025-10-14 17:00	115036
2025-10-14 18:00	51616
2025-10-14 19:00	23356
2025-10-14 20:00	1666
2025-10-15 05:00	132995
2025-10-15 06:00	127290
2025-10-15 07:00	86036
2025-10-15 08:00	158726
2025-10-15 09:00	140205
2025-10-15 10:00	121037
2025-10-15 11:00	113926
2025-10-15 12:00	77705
2025-10-15 13:00	213529
2025-10-15 14:00	113489
2025-10-15 15:00	124256
2025-10-15 16:00	91935
2025-10-15 17:00	185920
2025-10-15 18:00	70798
2025-10-15 19:00	66600
2025-10-15 20:00	63081
2025-10-15 21:00	80837
2025-10-15 22:00	50157
2025-10-15 23:00	47668
2025-10-16 00:00	56661
2025-10-16 01:00	89491
2025-10-16 02:00	80644
2025-10-16 03:00	147691
2025-10-16 04:00	175903
2025-10-16 05:00	132252
2025-10-16 06:00	187691
2025-10-16 07:00	112774
2025-10-16 08:00	85220
2025-10-16 09:00	114893
2025-10-16 10:00	181920
2025-10-16 11:00	109852
2025-10-16 12:00	108568
2025-10-16 13:00	80816
2025-10-16 14:00	161033
2025-10-16 15:00	123276
2025-10-16 16:00	102537
2025-10-16 17:00	112540
2025-10-16 18:00	128071
2025-10-16 19:00	74310
2025-10-16 20:00	51431
2025-10-16 21:00	56441
2025-10-16 22:00	49279
2025-10-16 23:00	53426
2025-10-17 00:00	62715
2025-10-17 01:00	90972
2025-10-17 02:00	164869
2025-10-17 03:00	116650
2025-10-17 04:00	135485
2025-10-17 05:00	129183
2025-10-17 06:00	101981
2025-10-17 07:00	163640
2025-10-17 08:00	118468
2025-10-17 09:00	105856
2025-10-17 10:00	110401
2025-10-17 11:00	200929
2025-10-17 12:00	139745
2025-10-17 13:00	108353
2025-10-17 14:00	104370
2025-10-17 15:00	162945
2025-10-17 16:00	116903
2025-10-17 17:00	104821
2025-10-17 18:00	86538
2025-10-17 19:00	84823
2025-10-17 20:00	72010
2025-10-17 21:00	52615
2025-10-17 22:00	65099
2025-10-17 23:00	68174
2025-10-18 00:00	81515
2025-10-18 01:00	117308
2025-10-18 02:00	118364
2025-10-18 03:00	234617
2025-10-18 04:00	167607
2025-10-18 05:00	181453
2025-10-18 06:00	149770
2025-10-18 07:00	110854
2025-10-18 08:00	190062
2025-10-18 09:00	140857
2025-10-18 10:00	131215
2025-10-18 11:00	121037
2025-10-18 12:00	216187
2025-10-18 13:00	104018
2025-10-18 14:00	113676
2025-10-18 15:00	112325
2025-10-18 16:00	184237
2025-10-18 17:00	134122
2025-10-18 18:00	85051
2025-10-18 19:00	86473
2025-10-18 20:00	89393
2025-10-18 21:00	70203
2025-10-18 22:00	44533
2025-10-18 23:00	55851
2025-10-19 00:00	90041
2025-10-19 01:00	100263
2025-10-19 02:00	163088
2025-10-19 03:00	186177
2025-10-19 04:00	169294
2025-10-19 05:00	268980
2025-10-19 06:00	160820
2025-10-19 07:00	154756
2025-10-19 08:00	93802
2025-10-19 09:00	217368
2025-10-19 10:00	159303
2025-10-19 11:00	156457
2025-10-19 12:00	109685
2025-10-19 13:00	185354
2025-10-19 14:00	113271
2025-10-19 15:00	157383
2025-10-19 16:00	115807
2025-10-19 17:00	123591
2025-10-19 18:00	77940
2025-10-19 19:00	80428
2025-10-19 20:00	64093
2025-10-19 21:00	61751
2025-10-19 22:00	50940
2025-10-19 23:00	39310
2025-10-20 00:00	69431
2025-10-20 01:00	84088
2025-10-20 02:00	27755
2025-10-20 14:00	69109
2025-10-20 15:00	18171
2025-10-20 16:00	XX

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




---