[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	alt_rank
2025-12-02 10:00	4038
2025-12-02 11:00	3148
2025-12-02 12:00	3148
2025-12-02 13:00	3871
2025-12-02 14:00	3148
2025-12-02 15:00	3711
2025-12-02 16:00	3148
2025-12-02 17:00	3148
2025-12-02 18:00	3148
2025-12-02 19:00	3148
2025-12-02 20:00	3148
2025-12-02 21:00	3148
2025-12-02 22:00	2241
2025-12-02 23:00	1749
2025-12-03 00:00	3148
2025-12-03 01:00	1790
2025-12-03 02:00	1739
2025-12-03 03:00	1708
2025-12-03 04:00	1656
2025-12-03 05:00	1665
2025-12-03 06:00	1651
2025-12-03 07:00	1679
2025-12-03 08:00	1582
2025-12-03 09:00	1773
2025-12-03 10:00	1582
2025-12-03 11:00	1783
2025-12-03 12:00	1766
2025-12-03 13:00	1653
2025-12-03 14:00	1784
2025-12-03 15:00	1653
2025-12-03 16:00	1653
2025-12-03 17:00	1723
2025-12-03 18:00	1724
2025-12-03 19:00	1504
2025-12-03 20:00	XXX
2025-12-03 21:00	XXX
2025-12-03 22:00	XXX
2025-12-03 23:00	XXX
2025-12-04 00:00	XXX
2025-12-04 01:00	XXX
2025-12-04 02:00	XXX
2025-12-04 03:00	3281
2025-12-04 04:00	3482
2025-12-04 05:00	3344
2025-12-04 06:00	3456
2025-12-04 07:00	3205
2025-12-04 08:00	3205
2025-12-04 09:00	3375
2025-12-04 10:00	3398
2025-12-04 11:00	3115
2025-12-04 12:00	3431
2025-12-04 13:00	3471
2025-12-04 14:00	3418
2025-12-04 15:00	3268
2025-12-04 16:00	3268
2025-12-04 17:00	3508
2025-12-04 18:00	3599
2025-12-04 19:00	3574
2025-12-04 20:00	3463
2025-12-04 21:00	3331
2025-12-04 22:00	3606
2025-12-04 23:00	3636
2025-12-05 00:00	3670
2025-12-05 01:00	3141
2025-12-05 02:00	3841
2025-12-05 03:00	3872
2025-12-05 04:00	3012
2025-12-05 05:00	3798
2025-12-05 06:00	3012
2025-12-05 07:00	3897
2025-12-05 08:00	3798
2025-12-05 09:00	3789
2025-12-05 10:00	3717
2025-12-05 11:00	3750
2025-12-05 12:00	3645
2025-12-05 13:00	3658
2025-12-05 14:00	3740
2025-12-05 15:00	3687
2025-12-05 16:00	3527
2025-12-05 17:00	XXX
2025-12-05 18:00	XXX
2025-12-05 19:00	XXX
2025-12-05 20:00	XXX
2025-12-05 21:00	XXX
2025-12-05 22:00	1083
2025-12-05 23:00	1041
2025-12-06 00:00	1049
2025-12-06 01:00	1051
2025-12-06 02:00	1156
2025-12-06 03:00	1136
2025-12-06 04:00	1118
2025-12-06 05:00	1112
2025-12-06 06:00	1103
2025-12-06 07:00	1079
2025-12-06 08:00	1147
2025-12-06 09:00	1063
2025-12-06 10:00	1052
2025-12-06 11:00	1080
2025-12-06 12:00	1124
2025-12-06 13:00	1058
2025-12-06 14:00	1042
2025-12-06 15:00	1047
2025-12-06 16:00	1066
2025-12-06 17:00	1047
2025-12-06 18:00	1110
2025-12-06 19:00	1170
2025-12-06 20:00	1335
2025-12-06 21:00	1335
2025-12-06 22:00	1335
2025-12-06 23:00	1035
2025-12-07 00:00	1083
2025-12-07 01:00	1083
2025-12-07 02:00	1541
2025-12-07 03:00	1013
2025-12-07 04:00	1013
2025-12-07 05:00	1013
2025-12-07 06:00	1013
2025-12-07 07:00	1013
2025-12-07 08:00	1013
2025-12-07 09:00	1013
2025-12-07 10:00	1013
2025-12-07 11:00	1013
2025-12-07 12:00	1013
2025-12-07 13:00	1013
2025-12-07 14:00	1013
2025-12-07 15:00	1013
2025-12-07 16:00	1013
2025-12-07 17:00	1013
2025-12-07 18:00	1013
2025-12-07 19:00	1013
2025-12-07 20:00	1013
2025-12-07 21:00	1013
2025-12-07 22:00	1013
2025-12-07 23:00	1013
2025-12-08 00:00	1013
2025-12-08 01:00	3576
2025-12-08 02:00	1013
2025-12-08 03:00	1013
2025-12-08 04:00	1013
2025-12-08 05:00	1013
2025-12-08 06:00	1013
2025-12-08 07:00	1013
2025-12-08 08:00	1013
2025-12-08 09:00	1013
2025-12-08 10:00	1013
2025-12-08 11:00	1013
2025-12-08 12:00	1013
2025-12-08 13:00	3900
2025-12-08 14:00	2943
2025-12-08 15:00	2943
2025-12-08 16:00	2943
2025-12-08 17:00	2943
2025-12-08 18:00	2943
2025-12-08 19:00	2943
2025-12-08 20:00	2943
2025-12-08 21:00	2943
2025-12-08 22:00	4006
2025-12-08 23:00	2943
2025-12-09 00:00	2943
2025-12-09 01:00	2943
2025-12-09 02:00	2943
2025-12-09 03:00	2943
2025-12-09 04:00	2943
2025-12-09 05:00	2943
2025-12-09 06:00	2943
2025-12-09 07:00	3673
2025-12-09 08:00	1282
2025-12-09 09:00	1249
2025-12-09 10:00	2392
2025-12-09 11:00	1078
2025-12-09 12:00	1101
2025-12-09 13:00	1078
2025-12-09 14:00	1078
2025-12-09 15:00	2569
2025-12-09 16:00	2995
2025-12-09 17:00	2462
2025-12-09 18:00	1781
2025-12-09 19:00	3493
2025-12-09 20:00	1673
2025-12-09 21:00	1282
2025-12-09 22:00	1412
2025-12-09 23:00	3368
2025-12-10 00:00	1412
2025-12-10 01:00	1412
2025-12-10 02:00	3420
2025-12-10 03:00	1412
2025-12-10 04:00	1412
2025-12-10 05:00	1412
2025-12-10 06:00	1412
2025-12-10 07:00	1412
2025-12-10 08:00	1412
2025-12-10 09:00	1412

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




---