[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	210328
2025-10-13 01:00	218399
2025-10-13 02:00	356522
2025-10-13 03:00	408669
2025-10-13 04:00	483043
2025-10-13 05:00	421098
2025-10-13 06:00	527687
2025-10-13 07:00	650657
2025-10-13 08:00	610620
2025-10-13 09:00	523434
2025-10-13 10:00	509115
2025-10-13 11:00	340943
2025-10-13 12:00	577287
2025-10-13 13:00	640302
2025-10-13 14:00	687496
2025-10-13 15:00	753042
2025-10-13 16:00	432576
2025-10-13 17:00	484359
2025-10-13 18:00	384518
2025-10-13 19:00	284812
2025-10-13 20:00	174994
2025-10-13 21:00	151903
2025-10-13 22:00	171949
2025-10-13 23:00	158587
2025-10-14 00:00	195607
2025-10-14 01:00	269641
2025-10-14 02:00	436115
2025-10-14 03:00	358665
2025-10-14 04:00	359853
2025-10-14 05:00	468523
2025-10-14 06:00	646305
2025-10-14 07:00	512604
2025-10-14 08:00	468516
2025-10-14 09:00	383827
2025-10-14 10:00	508090
2025-10-14 11:00	723596
2025-10-14 12:00	786011
2025-10-14 13:00	658120
2025-10-14 14:00	370829
2025-10-14 15:00	575064
2025-10-14 16:00	524573
2025-10-14 17:00	412210
2025-10-14 18:00	266158
2025-10-14 19:00	241107
2025-10-14 20:00	176104
2025-10-14 21:00	138554
2025-10-14 22:00	118151
2025-10-14 23:00	118563
2025-10-15 00:00	194450
2025-10-15 01:00	273242
2025-10-15 02:00	240590
2025-10-15 03:00	286783
2025-10-15 04:00	441747
2025-10-15 05:00	462566
2025-10-15 06:00	377360
2025-10-15 07:00	377407
2025-10-15 08:00	558717
2025-10-15 09:00	526796
2025-10-15 10:00	429503
2025-10-15 11:00	401845
2025-10-15 12:00	457009
2025-10-15 13:00	702824
2025-10-15 14:00	560339
2025-10-15 15:00	511197
2025-10-15 16:00	447195
2025-10-15 17:00	526938
2025-10-15 18:00	281820
2025-10-15 19:00	273321
2025-10-15 20:00	184337
2025-10-15 21:00	174977
2025-10-15 22:00	119738
2025-10-15 23:00	114690
2025-10-16 00:00	147686
2025-10-16 01:00	142962
2025-10-16 02:00	487402
2025-10-16 03:00	609068
2025-10-16 04:00	368248
2025-10-16 05:00	430377
2025-10-16 06:00	465580
2025-10-16 07:00	437537
2025-10-16 08:00	355856
2025-10-16 09:00	510446
2025-10-16 10:00	504101
2025-10-16 11:00	385913
2025-10-16 12:00	436626
2025-10-16 13:00	503119
2025-10-16 14:00	641712
2025-10-16 15:00	511859
2025-10-16 16:00	611924
2025-10-16 17:00	472016
2025-10-16 18:00	417015
2025-10-16 19:00	229807
2025-10-16 20:00	148486
2025-10-16 21:00	116249
2025-10-16 22:00	128562
2025-10-16 23:00	165977
2025-10-17 00:00	320915
2025-10-17 01:00	291153
2025-10-17 02:00	428789
2025-10-17 03:00	408303
2025-10-17 04:00	448261
2025-10-17 05:00	513004
2025-10-17 06:00	646116
2025-10-17 07:00	819827
2025-10-17 08:00	620160
2025-10-17 09:00	473165
2025-10-17 10:00	555254
2025-10-17 11:00	591706
2025-10-17 12:00	712042
2025-10-17 13:00	553312
2025-10-17 14:00	602554
2025-10-17 15:00	593273
2025-10-17 16:00	640193
2025-10-17 17:00	516434
2025-10-17 18:00	319046
2025-10-17 19:00	294283
2025-10-17 20:00	254376
2025-10-17 21:00	190945
2025-10-17 22:00	164739
2025-10-17 23:00	203521
2025-10-18 00:00	330039
2025-10-18 01:00	328705
2025-10-18 02:00	391805
2025-10-18 03:00	564880
2025-10-18 04:00	518661
2025-10-18 05:00	492749
2025-10-18 06:00	504466
2025-10-18 07:00	593379
2025-10-18 08:00	583560
2025-10-18 09:00	517126
2025-10-18 10:00	406391
2025-10-18 11:00	489411
2025-10-18 12:00	588795
2025-10-18 13:00	560376
2025-10-18 14:00	538909
2025-10-18 15:00	403314
2025-10-18 16:00	870441
2025-10-18 17:00	457255
2025-10-18 18:00	454062
2025-10-18 19:00	262470
2025-10-18 20:00	359088
2025-10-18 21:00	260303
2025-10-18 22:00	249249
2025-10-18 23:00	152204
2025-10-19 00:00	298439
2025-10-19 01:00	309642
2025-10-19 02:00	331234
2025-10-19 03:00	450736
2025-10-19 04:00	501309
2025-10-19 05:00	564244
2025-10-19 06:00	527178
2025-10-19 07:00	497631
2025-10-19 08:00	587257
2025-10-19 09:00	546745
2025-10-19 10:00	476684
2025-10-19 11:00	438927
2025-10-19 12:00	423823
2025-10-19 13:00	696344
2025-10-19 14:00	702645
2025-10-19 15:00	577820
2025-10-19 16:00	581170
2025-10-19 17:00	693417
2025-10-19 18:00	412942
2025-10-19 19:00	366067
2025-10-19 20:00	210817
2025-10-19 21:00	195126
2025-10-19 22:00	187797
2025-10-19 23:00	162770
2025-10-20 00:00	243004
2025-10-20 01:00	239659
2025-10-20 02:00	414100
2025-10-20 03:00	518091
2025-10-20 04:00	429323
2025-10-20 05:00	559834
2025-10-20 06:00	476959
2025-10-20 07:00	610861
2025-10-20 08:00	XXX
2025-10-20 09:00	338430
2025-10-20 10:00	46760
2025-10-20 11:00	3358

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




---