Dark | Light
[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	volume_24h
2025-12-02 10:00	19944.2
2025-12-02 11:00	21601
2025-12-02 12:00	21601
2025-12-02 13:00	20911
2025-12-02 14:00	25343
2025-12-02 15:00	24657
2025-12-02 16:00	25972
2025-12-02 17:00	26631
2025-12-02 18:00	27238
2025-12-02 19:00	25114
2025-12-02 20:00	26412
2025-12-02 21:00	27905
2025-12-02 22:00	25771
2025-12-02 23:00	26300
2025-12-03 00:00	24511
2025-12-03 01:00	25825
2025-12-03 02:00	26645
2025-12-03 03:00	31949
2025-12-03 04:00	40497
2025-12-03 05:00	30141
2025-12-03 06:00	31285
2025-12-03 07:00	27178
2025-12-03 08:00	24338
2025-12-03 09:00	23764
2025-12-03 10:00	23984
2025-12-03 11:00	23432
2025-12-03 12:00	31423
2025-12-03 13:00	30051
2025-12-03 14:00	28931
2025-12-03 15:00	26417
2025-12-03 16:00	27056
2025-12-03 17:00	26564
2025-12-03 18:00	26768
2025-12-03 19:00	27610
2025-12-03 20:00	26239
2025-12-03 21:00	22838
2025-12-03 22:00	26054
2025-12-03 23:00	25421
2025-12-04 00:00	24059
2025-12-04 01:00	25170
2025-12-04 02:00	25490
2025-12-04 03:00	23027
2025-12-04 04:00	20597
2025-12-04 05:00	20708
2025-12-04 06:00	21075
2025-12-04 07:00	20320
2025-12-04 08:00	20242
2025-12-04 09:00	20538
2025-12-04 10:00	20302
2025-12-04 11:00	20915
2025-12-04 12:00	19786.8
2025-12-04 13:00	17877.3
2025-12-04 14:00	19034.3
2025-12-04 15:00	17619.6
2025-12-04 16:00	17360.9
2025-12-04 17:00	16690.5
2025-12-04 18:00	17003.7
2025-12-04 19:00	16642.5
2025-12-04 20:00	17897.2
2025-12-04 21:00	21381
2025-12-04 22:00	19157.6
2025-12-04 23:00	18567.8
2025-12-05 00:00	18704.5
2025-12-05 01:00	17721.5
2025-12-05 02:00	18115.2
2025-12-05 03:00	18702.9
2025-12-05 04:00	17816.4
2025-12-05 05:00	18515.9
2025-12-05 06:00	18231.8
2025-12-05 07:00	17421.7
2025-12-05 08:00	18370.8
2025-12-05 09:00	18370.8
2025-12-05 10:00	18455.7
2025-12-05 11:00	17379.9
2025-12-05 12:00	22061
2025-12-05 13:00	18587.6
2025-12-05 14:00	19038.4
2025-12-05 15:00	19845.1
2025-12-05 16:00	18348.1
2025-12-05 17:00	23793
2025-12-05 18:00	34326
2025-12-05 19:00	35593
2025-12-05 20:00	33080
2025-12-05 21:00	30332
2025-12-05 22:00	30205
2025-12-05 23:00	28712
2025-12-06 00:00	28584
2025-12-06 01:00	27642
2025-12-06 02:00	25966
2025-12-06 03:00	26017
2025-12-06 04:00	27610
2025-12-06 05:00	26219
2025-12-06 06:00	30548
2025-12-06 07:00	32239
2025-12-06 08:00	31592
2025-12-06 09:00	31501
2025-12-06 10:00	31332
2025-12-06 11:00	30139
2025-12-06 12:00	28970
2025-12-06 13:00	29219
2025-12-06 14:00	29693
2025-12-06 15:00	28574
2025-12-06 16:00	28071
2025-12-06 17:00	27324
2025-12-06 18:00	24464
2025-12-06 19:00	24072
2025-12-06 20:00	22476
2025-12-06 21:00	22633
2025-12-06 22:00	22449
2025-12-06 23:00	23442
2025-12-07 00:00	23590
2025-12-07 01:00	23590
2025-12-07 02:00	21853
2025-12-07 03:00	21349
2025-12-07 04:00	20186
2025-12-07 05:00	19793.7
2025-12-07 06:00	20562
2025-12-07 07:00	18811.1
2025-12-07 08:00	17491
2025-12-07 09:00	17571
2025-12-07 10:00	17845.1
2025-12-07 11:00	17960.3
2025-12-07 12:00	16732.8
2025-12-07 13:00	16671.3
2025-12-07 14:00	17273.6
2025-12-07 15:00	15744.3
2025-12-07 16:00	15316.9
2025-12-07 17:00	17332.4
2025-12-07 18:00	14970.3
2025-12-07 19:00	14546.8
2025-12-07 20:00	15351.6
2025-12-07 21:00	14957.3
2025-12-07 22:00	15123.3
2025-12-07 23:00	15323.3
2025-12-08 00:00	16265.7
2025-12-08 01:00	15621
2025-12-08 02:00	15815.9
2025-12-08 03:00	16075.6
2025-12-08 04:00	16621.8
2025-12-08 05:00	17883.7
2025-12-08 06:00	17883.6
2025-12-08 07:00	16892.4
2025-12-08 08:00	18041.9
2025-12-08 09:00	18203.3
2025-12-08 10:00	18461.4
2025-12-08 11:00	20053
2025-12-08 12:00	18657.4
2025-12-08 13:00	19000.4
2025-12-08 14:00	20581
2025-12-08 15:00	20575
2025-12-08 16:00	20677
2025-12-08 17:00	19005.6
2025-12-08 18:00	19004.7
2025-12-08 19:00	18402
2025-12-08 20:00	17971.3
2025-12-08 21:00	17428.8
2025-12-08 22:00	18451.9
2025-12-08 23:00	19002.5
2025-12-09 00:00	19104.4
2025-12-09 01:00	18058.5
2025-12-09 02:00	18508.7
2025-12-09 03:00	19294.3
2025-12-09 04:00	19574.7
2025-12-09 05:00	18254.1
2025-12-09 06:00	18106
2025-12-09 07:00	18487
2025-12-09 08:00	19651
2025-12-09 09:00	19446
2025-12-09 10:00	17565.3
2025-12-09 11:00	19606.5
2025-12-09 12:00	18467.6
2025-12-09 13:00	18016.3
2025-12-09 14:00	17809.3
2025-12-09 15:00	18262.5
2025-12-09 16:00	18709.4
2025-12-09 17:00	18382.3
2025-12-09 18:00	17558.7
2025-12-09 19:00	17417
2025-12-09 20:00	18581
2025-12-09 21:00	18244.8
2025-12-09 22:00	16541.5
2025-12-09 23:00	17897.3
2025-12-10 00:00	17393.5
2025-12-10 01:00	17849.2
2025-12-10 02:00	15641
2025-12-10 03:00	15796.8
2025-12-10 04:00	15796.8
2025-12-10 05:00	16993.3
2025-12-10 06:00	17501.9
2025-12-10 07:00	17376.4
2025-12-10 08:00	16319.6
2025-12-10 09:00	17347.1

### 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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1763424000,
    "end": 1764115200,
    "bucket": "hour",
    "metrics": [],
    "generated": 1764112845
  },
  "data": [
    {
      "time": 1763424000,
      "alt_rank": 150,
      "circulating_supply": 19950215,
      "close": 91913,
      "galaxy_score": 53,
      "high": 91913,
      "low": 91161.89,
      "market_cap": 1831844921030,
      "market_dominance": 58.7325,
      "open": 91913,
      "social_dominance": 37.7476,
      "volume_24h": 94214589868,
      "contributors_active": 31448,
      "contributors_created": 2314,
      "interactions": 5075541,
      "posts_active": 61441,
      "posts_created": 3505,
      "sentiment": 75,
      "spam": 5990
    }
  ]
}
```

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)
+ **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
+ **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




---

### 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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1763424000,
    "end": 1764115200,
    "bucket": "hour",
    "metrics": [],
    "generated": 1764112845
  },
  "data": [
    {
      "time": 1763424000,
      "alt_rank": 150,
      "circulating_supply": 19950215,
      "close": 91913,
      "galaxy_score": 53,
      "high": 91913,
      "low": 91161.89,
      "market_cap": 1831844921030,
      "market_dominance": 58.7325,
      "open": 91913,
      "social_dominance": 37.7476,
      "volume_24h": 94214589868,
      "contributors_active": 31448,
      "contributors_created": 2314,
      "interactions": 5075541,
      "posts_active": 61441,
      "posts_created": 3505,
      "sentiment": 75,
      "spam": 5990
    }
  ]
}
```

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)
+ **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
+ **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




---

### 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": 302315,
      "num_posts": 302315,
      "interactions_24h": 3766865315
    }
  ]
}
```

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 Whatsup

https://lunarcrush.com/api4/public/topic/:topic/whatsup/v1

Generate an AI summary of the hottest news and social posts for a specific topic

input parameters:

+ **topic**: _Provide the topic to get a summary for. A topic must be all lower case and can only include letters, numbers, spaces, # and $._ **required**

Example request:

```bash
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/whatsup/v1
```



Example response:

```json
{
  "config": {
    "id": "bitcoin",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "topic": "bitcoin",
    "generated": 1764111936
  },
  "summary": "Texas makes history by purchasing $10M in Bitcoin ETFs, while BlackRock's Bitcoin ETF faces record outflows amidst ongoing accusations against JPMorgan for market manipulation.",
  "supportive": [
    {
      "title": "Texas Buys Bitcoin ETF",
      "description": "Texas becomes the first state to invest in a Bitcoin ETF, allocating $XX million to its strategic reserve.",
      "percent": XX
    }
  ],
  "critical": [
    {
      "title": "JPMorgan Accusations",
      "description": "JPMorgan is accused of manipulating the market, shorting MSTR, and spreading FUD, leading to calls for boycotts and investigations.",
      "percent": XX
    }
  ]
}
```

Schema:

+ **config**: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
+ **id**: LunarCrush internal ID for the asset
+ **name**: The full name of the asset
+ **symbol**: The symbol for the asset
+ **topic**: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
+ **generated**: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
+ **supportive**: An array of supportive themes with a title, description, and an estimate of the percent of the circulating conversations on social around this theme.
+ **title**: The case sensitive title of the topic or category
+ **description**: Explanation of the change and the potential impact
+ **critical**: An array of critical themes with a title, description, and an estimate of the percent of the circulating conversations on social around this theme.




---

[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 volume_24h 2025-12-02 10:00 19944.2 2025-12-02 11:00 21601 2025-12-02 12:00 21601 2025-12-02 13:00 20911 2025-12-02 14:00 25343 2025-12-02 15:00 24657 2025-12-02 16:00 25972 2025-12-02 17:00 26631 2025-12-02 18:00 27238 2025-12-02 19:00 25114 2025-12-02 20:00 26412 2025-12-02 21:00 27905 2025-12-02 22:00 25771 2025-12-02 23:00 26300 2025-12-03 00:00 24511 2025-12-03 01:00 25825 2025-12-03 02:00 26645 2025-12-03 03:00 31949 2025-12-03 04:00 40497 2025-12-03 05:00 30141 2025-12-03 06:00 31285 2025-12-03 07:00 27178 2025-12-03 08:00 24338 2025-12-03 09:00 23764 2025-12-03 10:00 23984 2025-12-03 11:00 23432 2025-12-03 12:00 31423 2025-12-03 13:00 30051 2025-12-03 14:00 28931 2025-12-03 15:00 26417 2025-12-03 16:00 27056 2025-12-03 17:00 26564 2025-12-03 18:00 26768 2025-12-03 19:00 27610 2025-12-03 20:00 26239 2025-12-03 21:00 22838 2025-12-03 22:00 26054 2025-12-03 23:00 25421 2025-12-04 00:00 24059 2025-12-04 01:00 25170 2025-12-04 02:00 25490 2025-12-04 03:00 23027 2025-12-04 04:00 20597 2025-12-04 05:00 20708 2025-12-04 06:00 21075 2025-12-04 07:00 20320 2025-12-04 08:00 20242 2025-12-04 09:00 20538 2025-12-04 10:00 20302 2025-12-04 11:00 20915 2025-12-04 12:00 19786.8 2025-12-04 13:00 17877.3 2025-12-04 14:00 19034.3 2025-12-04 15:00 17619.6 2025-12-04 16:00 17360.9 2025-12-04 17:00 16690.5 2025-12-04 18:00 17003.7 2025-12-04 19:00 16642.5 2025-12-04 20:00 17897.2 2025-12-04 21:00 21381 2025-12-04 22:00 19157.6 2025-12-04 23:00 18567.8 2025-12-05 00:00 18704.5 2025-12-05 01:00 17721.5 2025-12-05 02:00 18115.2 2025-12-05 03:00 18702.9 2025-12-05 04:00 17816.4 2025-12-05 05:00 18515.9 2025-12-05 06:00 18231.8 2025-12-05 07:00 17421.7 2025-12-05 08:00 18370.8 2025-12-05 09:00 18370.8 2025-12-05 10:00 18455.7 2025-12-05 11:00 17379.9 2025-12-05 12:00 22061 2025-12-05 13:00 18587.6 2025-12-05 14:00 19038.4 2025-12-05 15:00 19845.1 2025-12-05 16:00 18348.1 2025-12-05 17:00 23793 2025-12-05 18:00 34326 2025-12-05 19:00 35593 2025-12-05 20:00 33080 2025-12-05 21:00 30332 2025-12-05 22:00 30205 2025-12-05 23:00 28712 2025-12-06 00:00 28584 2025-12-06 01:00 27642 2025-12-06 02:00 25966 2025-12-06 03:00 26017 2025-12-06 04:00 27610 2025-12-06 05:00 26219 2025-12-06 06:00 30548 2025-12-06 07:00 32239 2025-12-06 08:00 31592 2025-12-06 09:00 31501 2025-12-06 10:00 31332 2025-12-06 11:00 30139 2025-12-06 12:00 28970 2025-12-06 13:00 29219 2025-12-06 14:00 29693 2025-12-06 15:00 28574 2025-12-06 16:00 28071 2025-12-06 17:00 27324 2025-12-06 18:00 24464 2025-12-06 19:00 24072 2025-12-06 20:00 22476 2025-12-06 21:00 22633 2025-12-06 22:00 22449 2025-12-06 23:00 23442 2025-12-07 00:00 23590 2025-12-07 01:00 23590 2025-12-07 02:00 21853 2025-12-07 03:00 21349 2025-12-07 04:00 20186 2025-12-07 05:00 19793.7 2025-12-07 06:00 20562 2025-12-07 07:00 18811.1 2025-12-07 08:00 17491 2025-12-07 09:00 17571 2025-12-07 10:00 17845.1 2025-12-07 11:00 17960.3 2025-12-07 12:00 16732.8 2025-12-07 13:00 16671.3 2025-12-07 14:00 17273.6 2025-12-07 15:00 15744.3 2025-12-07 16:00 15316.9 2025-12-07 17:00 17332.4 2025-12-07 18:00 14970.3 2025-12-07 19:00 14546.8 2025-12-07 20:00 15351.6 2025-12-07 21:00 14957.3 2025-12-07 22:00 15123.3 2025-12-07 23:00 15323.3 2025-12-08 00:00 16265.7 2025-12-08 01:00 15621 2025-12-08 02:00 15815.9 2025-12-08 03:00 16075.6 2025-12-08 04:00 16621.8 2025-12-08 05:00 17883.7 2025-12-08 06:00 17883.6 2025-12-08 07:00 16892.4 2025-12-08 08:00 18041.9 2025-12-08 09:00 18203.3 2025-12-08 10:00 18461.4 2025-12-08 11:00 20053 2025-12-08 12:00 18657.4 2025-12-08 13:00 19000.4 2025-12-08 14:00 20581 2025-12-08 15:00 20575 2025-12-08 16:00 20677 2025-12-08 17:00 19005.6 2025-12-08 18:00 19004.7 2025-12-08 19:00 18402 2025-12-08 20:00 17971.3 2025-12-08 21:00 17428.8 2025-12-08 22:00 18451.9 2025-12-08 23:00 19002.5 2025-12-09 00:00 19104.4 2025-12-09 01:00 18058.5 2025-12-09 02:00 18508.7 2025-12-09 03:00 19294.3 2025-12-09 04:00 19574.7 2025-12-09 05:00 18254.1 2025-12-09 06:00 18106 2025-12-09 07:00 18487 2025-12-09 08:00 19651 2025-12-09 09:00 19446 2025-12-09 10:00 17565.3 2025-12-09 11:00 19606.5 2025-12-09 12:00 18467.6 2025-12-09 13:00 18016.3 2025-12-09 14:00 17809.3 2025-12-09 15:00 18262.5 2025-12-09 16:00 18709.4 2025-12-09 17:00 18382.3 2025-12-09 18:00 17558.7 2025-12-09 19:00 17417 2025-12-09 20:00 18581 2025-12-09 21:00 18244.8 2025-12-09 22:00 16541.5 2025-12-09 23:00 17897.3 2025-12-10 00:00 17393.5 2025-12-10 01:00 17849.2 2025-12-10 02:00 15641 2025-12-10 03:00 15796.8 2025-12-10 04:00 15796.8 2025-12-10 05:00 16993.3 2025-12-10 06:00 17501.9 2025-12-10 07:00 17376.4 2025-12-10 08:00 16319.6 2025-12-10 09:00 17347.1

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:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v2

Example response:

{
  "config": {
    "topic": "bitcoin",
    "id": "bitcoin",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1763424000,
    "end": 1764115200,
    "bucket": "hour",
    "metrics": [],
    "generated": 1764112845
  },
  "data": [
    {
      "time": 1763424000,
      "alt_rank": 150,
      "circulating_supply": 19950215,
      "close": 91913,
      "galaxy_score": 53,
      "high": 91913,
      "low": 91161.89,
      "market_cap": 1831844921030,
      "market_dominance": 58.7325,
      "open": 91913,
      "social_dominance": 37.7476,
      "volume_24h": 94214589868,
      "contributors_active": 31448,
      "contributors_created": 2314,
      "interactions": 5075541,
      "posts_active": 61441,
      "posts_created": 3505,
      "sentiment": 75,
      "spam": 5990
    }
  ]
}

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)
  • 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
  • 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

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:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v1

Example response:

{
  "config": {
    "topic": "bitcoin",
    "id": "bitcoin",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1763424000,
    "end": 1764115200,
    "bucket": "hour",
    "metrics": [],
    "generated": 1764112845
  },
  "data": [
    {
      "time": 1763424000,
      "alt_rank": 150,
      "circulating_supply": 19950215,
      "close": 91913,
      "galaxy_score": 53,
      "high": 91913,
      "low": 91161.89,
      "market_cap": 1831844921030,
      "market_dominance": 58.7325,
      "open": 91913,
      "social_dominance": 37.7476,
      "volume_24h": 94214589868,
      "contributors_active": 31448,
      "contributors_created": 2314,
      "interactions": 5075541,
      "posts_active": 61441,
      "posts_created": 3505,
      "sentiment": 75,
      "spam": 5990
    }
  ]
}

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)
  • 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
  • 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

Topics List

https://lunarcrush.com/api4/public/topics/list/v1

Get a list of trending social topics.

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topics/list/v1

Example response:

{
  "data": [
    {
      "topic": "youtube",
      "title": "YouTube",
      "topic_rank": 1,
      "topic_rank_1h_previous": 1,
      "topic_rank_24h_previous": 1,
      "num_contributors": 302315,
      "num_posts": 302315,
      "interactions_24h": 3766865315
    }
  ]
}

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 Whatsup

https://lunarcrush.com/api4/public/topic/:topic/whatsup/v1

Generate an AI summary of the hottest news and social posts for a specific topic

input parameters:

  • topic: Provide the topic to get a summary for. A topic must be all lower case and can only include letters, numbers, spaces, # and $. required

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/whatsup/v1

Example response:

{
  "config": {
    "id": "bitcoin",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "topic": "bitcoin",
    "generated": 1764111936
  },
  "summary": "Texas makes history by purchasing $10M in Bitcoin ETFs, while BlackRock's Bitcoin ETF faces record outflows amidst ongoing accusations against JPMorgan for market manipulation.",
  "supportive": [
    {
      "title": "Texas Buys Bitcoin ETF",
      "description": "Texas becomes the first state to invest in a Bitcoin ETF, allocating $XX million to its strategic reserve.",
      "percent": XX
    }
  ],
  "critical": [
    {
      "title": "JPMorgan Accusations",
      "description": "JPMorgan is accused of manipulating the market, shorting MSTR, and spreading FUD, leading to calls for boycotts and investigations.",
      "percent": XX
    }
  ]
}

Schema:

  • config: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
  • id: LunarCrush internal ID for the asset
  • name: The full name of the asset
  • symbol: The symbol for the asset
  • topic: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
  • generated: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
  • supportive: An array of supportive themes with a title, description, and an estimate of the percent of the circulating conversations on social around this theme.
  • title: The case sensitive title of the topic or category
  • description: Explanation of the change and the potential impact
  • critical: An array of critical themes with a title, description, and an estimate of the percent of the circulating conversations on social around this theme.

Capitalism (CAPITALISM)
/topic/$capitalism/volume_24h