[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-07-24 22:00	2371
2025-07-24 23:00	2222
2025-07-25 00:00	1924
2025-07-25 01:00	1866
2025-07-25 02:00	2105
2025-07-25 03:00	4901
2025-07-25 04:00	1541
2025-07-25 05:00	1844
2025-07-25 06:00	1527
2025-07-25 07:00	3850
2025-07-25 08:00	2702
2025-07-25 09:00	3333
2025-07-25 10:00	3245
2025-07-25 11:00	3141
2025-07-25 12:00	3440
2025-07-25 13:00	3573
2025-07-25 14:00	3883
2025-07-25 15:00	7802
2025-07-25 16:00	16639
2025-07-25 17:00	2553
2025-07-25 18:00	32988
2025-07-25 19:00	16974
2025-07-25 20:00	12518
2025-07-25 21:00	18735
2025-07-25 22:00	23597
2025-07-25 23:00	33953
2025-07-26 00:00	18087
2025-07-26 01:00	12399
2025-07-26 02:00	7977
2025-07-26 03:00	6810
2025-07-26 04:00	8385
2025-07-26 05:00	8470
2025-07-26 06:00	9601
2025-07-26 07:00	6217
2025-07-26 08:00	8513
2025-07-26 09:00	7206
2025-07-26 10:00	6705
2025-07-26 11:00	9081
2025-07-26 12:00	15107
2025-07-26 13:00	12510
2025-07-26 14:00	14093
2025-07-26 15:00	11391
2025-07-26 16:00	9639
2025-07-26 17:00	14880
2025-07-26 18:00	16236
2025-07-26 19:00	12354
2025-07-26 20:00	24529
2025-07-26 21:00	30815
2025-07-26 22:00	33689
2025-07-26 23:00	24857
2025-07-27 00:00	17681
2025-07-27 01:00	11762
2025-07-27 02:00	9924
2025-07-27 03:00	8440
2025-07-27 04:00	6340
2025-07-27 05:00	7440
2025-07-27 06:00	7135
2025-07-27 07:00	6069
2025-07-27 08:00	7119
2025-07-27 09:00	5005
2025-07-27 10:00	4523
2025-07-27 11:00	3047
2025-07-27 12:00	5211
2025-07-27 13:00	4456
2025-07-27 14:00	6107
2025-07-27 15:00	4973
2025-07-27 16:00	4198
2025-07-27 17:00	3186
2025-07-27 18:00	3352
2025-07-27 19:00	3740
2025-07-27 20:00	3142
2025-07-27 21:00	3282
2025-07-27 22:00	2719
2025-07-27 23:00	4226
2025-07-28 00:00	5400
2025-07-28 01:00	2350
2025-07-28 02:00	4445
2025-07-28 03:00	8077
2025-07-28 04:00	4118
2025-07-28 05:00	4313
2025-07-28 06:00	3578
2025-07-28 07:00	3910
2025-07-28 08:00	1614
2025-07-28 09:00	1969
2025-07-28 10:00	2006
2025-07-28 11:00	1334
2025-07-28 12:00	1452
2025-07-28 13:00	2920
2025-07-28 14:00	1705
2025-07-28 15:00	2840
2025-07-28 16:00	4263
2025-07-28 17:00	2647
2025-07-28 18:00	1977
2025-07-28 19:00	2935
2025-07-28 20:00	4249
2025-07-28 21:00	2992
2025-07-28 22:00	2603
2025-07-28 23:00	3550
2025-07-29 00:00	3981
2025-07-29 01:00	2902
2025-07-29 02:00	3104
2025-07-29 03:00	2100
2025-07-29 04:00	1794
2025-07-29 05:00	XXX
2025-07-29 06:00	3067
2025-07-29 07:00	1449
2025-07-29 08:00	1393
2025-07-29 09:00	1460
2025-07-29 10:00	1589
2025-07-29 11:00	1577
2025-07-29 12:00	1283
2025-07-29 13:00	1866
2025-07-29 14:00	2203
2025-07-29 15:00	2119
2025-07-29 16:00	2610
2025-07-29 17:00	2469
2025-07-29 18:00	4237
2025-07-29 19:00	5388
2025-07-29 20:00	6661
2025-07-29 21:00	5894
2025-07-29 22:00	5299
2025-07-29 23:00	4855
2025-07-30 00:00	4946
2025-07-30 01:00	4397
2025-07-30 02:00	6578
2025-07-30 03:00	4165
2025-07-30 04:00	45634
2025-07-30 05:00	39567
2025-07-30 06:00	2452
2025-07-30 07:00	2121
2025-07-30 08:00	31763
2025-07-30 09:00	24815
2025-07-30 10:00	41102
2025-07-30 11:00	64656
2025-07-30 12:00	23100
2025-07-30 13:00	13546
2025-07-30 14:00	14572
2025-07-30 15:00	113169
2025-07-30 16:00	8910
2025-07-30 17:00	7801
2025-07-30 18:00	14974
2025-07-30 19:00	15546
2025-07-30 20:00	12224
2025-07-30 21:00	6454
2025-07-30 22:00	42379
2025-07-30 23:00	18997
2025-07-31 00:00	14326
2025-07-31 01:00	22222
2025-07-31 02:00	5722
2025-07-31 03:00	20984
2025-07-31 04:00	39345
2025-07-31 05:00	20026
2025-07-31 06:00	13161
2025-07-31 07:00	25103
2025-07-31 08:00	13234
2025-07-31 09:00	9639
2025-07-31 10:00	17330
2025-07-31 11:00	68559
2025-07-31 12:00	15287
2025-07-31 13:00	12977
2025-07-31 14:00	13644
2025-07-31 15:00	19771
2025-07-31 16:00	31098
2025-07-31 17:00	14990
2025-07-31 18:00	13899
2025-07-31 19:00	27072
2025-07-31 20:00	24941
2025-07-31 21:00	17385
2025-07-31 22:00	13470
2025-07-31 23:00	10089
2025-08-01 00:00	25769
2025-08-01 01:00	33434
2025-08-01 02:00	57416
2025-08-01 03:00	34512
2025-08-01 04:00	66105
2025-08-01 05:00	62569
2025-08-01 06:00	65131
2025-08-01 07:00	17784
2025-08-01 08:00	12148
2025-08-01 09:00	8447
2025-08-01 10:00	10221
2025-08-01 11:00	21646
2025-08-01 12:00	15600
2025-08-01 13:00	22288
2025-08-01 14:00	21465
2025-08-01 15:00	21779
2025-08-01 16:00	13927
2025-08-01 17:00	15136
2025-08-01 18:00	14358
2025-08-01 19:00	17782
2025-08-01 20:00	15946
2025-08-01 21:00	13689
2025-08-01 22:00	9624
2025-08-01 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": 412953,
      "num_posts": 836638,
      "interactions_24h": 3573313797
    }
  ]
}
```

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": 1750896000,
    "end": 1751559896,
    "bucket": "hour",
    "metrics": [],
    "generated": 1751552696
  },
  "data": [
    {
      "time": 1750896000,
      "contributors_active": 22916,
      "contributors_created": 1375,
      "interactions": 3979171,
      "posts_active": 46549,
      "posts_created": 1920,
      "sentiment": 77,
      "spam": 771,
      "alt_rank": 35,
      "circulating_supply": 19883512,
      "close": 107427,
      "galaxy_score": 72,
      "high": 107427,
      "low": 107324.55,
      "market_cap": 2136184884191,
      "market_dominance": 64.9097,
      "open": 107375.07,
      "social_dominance": 25.1594,
      "volume_24h": 51567717214
    }
  ]
}
```

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": 1750896000,
    "end": 1751559896,
    "bucket": "hour",
    "metrics": [],
    "generated": 1751552696
  },
  "data": [
    {
      "time": 1750896000,
      "contributors_active": 22916,
      "contributors_created": 1375,
      "interactions": 3979171,
      "posts_active": 46549,
      "posts_created": 1920,
      "sentiment": 77,
      "spam": 771,
      "alt_rank": 35,
      "circulating_supply": 19883512,
      "close": 107427,
      "galaxy_score": 72,
      "high": 107427,
      "low": 107324.55,
      "market_cap": 2136184884191,
      "market_dominance": 64.9097,
      "open": 107375.07,
      "social_dominance": 25.1594,
      "volume_24h": 51567717214
    }
  ]
}
```

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": 1751552696
  },
  "data": [
    {
      "id": "1940767467934294480",
      "post_type": "tweet",
      "post_title": "NEW: 🇺🇸 Bitcoin & crypto market cap will \"probably go to $15-$20 TRILLION” once the Genius stablecoin legislation passes, says Trump's Digital Asset Director",
      "post_link": "https://x.com/BTC_Archive/status/1940767467934294480",
      "post_image": "https://pbs.twimg.com/media/Gu79uZ4WwAELycU.jpg",
      "post_created": 1751549996,
      "post_sentiment": 3.13,
      "creator_id": "twitter::970994516357472257",
      "creator_name": "BTC_Archive",
      "creator_display_name": "Bitcoin Archive",
      "creator_followers": 1726739,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1938906052956700672/7aV7c-nF_200x200.jpg",
      "interactions_24h": 30978,
      "interactions_total": 31161
    }
  ]
}
```

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_followers**: number of followers the account has
+ **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




---