[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-10-13 00:00	1019
2025-10-13 01:00	XXX
2025-10-13 02:00	XXX
2025-10-13 03:00	XXX
2025-10-13 04:00	XXX
2025-10-13 05:00	XXX
2025-10-13 06:00	XXX
2025-10-13 07:00	XXX
2025-10-13 08:00	XXX
2025-10-13 09:00	XXX
2025-10-13 10:00	XXX
2025-10-13 11:00	XXX
2025-10-13 12:00	XXX
2025-10-13 13:00	XXX
2025-10-13 14:00	1584
2025-10-13 15:00	XXX
2025-10-13 16:00	XXX
2025-10-13 17:00	1264
2025-10-13 18:00	XXX
2025-10-13 19:00	XXX
2025-10-13 20:00	XXX
2025-10-13 21:00	XXX
2025-10-13 22:00	XXX
2025-10-13 23:00	XXX
2025-10-14 00:00	XXX
2025-10-14 01:00	XXX
2025-10-14 02:00	XXX
2025-10-14 03:00	XXX
2025-10-14 04:00	1659
2025-10-14 05:00	XXX
2025-10-14 06:00	XXX
2025-10-14 07:00	XXX
2025-10-14 08:00	XXX
2025-10-14 09:00	XXX
2025-10-14 10:00	XXX
2025-10-14 11:00	1368
2025-10-14 12:00	XXX
2025-10-14 13:00	XXX
2025-10-14 14:00	XXX
2025-10-14 15:00	XXX
2025-10-14 16:00	XX
2025-10-14 17:00	XX
2025-10-14 18:00	XX
2025-10-14 19:00	XX
2025-10-14 20:00	XX
2025-10-14 21:00	XX
2025-10-14 22:00	XX
2025-10-14 23:00	XX
2025-10-15 00:00	XX
2025-10-15 01:00	XX
2025-10-15 02:00	XX
2025-10-15 03:00	XX
2025-10-15 04:00	XX
2025-10-15 05:00	XX
2025-10-15 06:00	XX
2025-10-15 07:00	XX
2025-10-15 08:00	XX
2025-10-15 09:00	XX
2025-10-15 10:00	XX
2025-10-15 11:00	XX
2025-10-15 12:00	XX
2025-10-15 13:00	XX
2025-10-15 14:00	XX
2025-10-15 15:00	XX
2025-10-15 16:00	XXX
2025-10-15 17:00	XXX
2025-10-15 18:00	XXX
2025-10-15 19:00	1403
2025-10-15 20:00	1673
2025-10-15 21:00	1698
2025-10-15 22:00	1659
2025-10-15 23:00	1642
2025-10-16 00:00	1636
2025-10-16 01:00	1603
2025-10-16 02:00	1665
2025-10-16 03:00	1702
2025-10-16 04:00	1762
2025-10-16 05:00	1707
2025-10-16 06:00	1765
2025-10-16 07:00	1780
2025-10-16 08:00	1752
2025-10-16 09:00	1705
2025-10-16 10:00	1714
2025-10-16 11:00	1754
2025-10-16 12:00	1759
2025-10-16 13:00	1740
2025-10-16 14:00	1825
2025-10-16 15:00	1880
2025-10-16 16:00	1865
2025-10-16 17:00	1894
2025-10-16 18:00	1840
2025-10-16 19:00	1838
2025-10-16 20:00	1737
2025-10-16 21:00	1647
2025-10-16 22:00	1605
2025-10-16 23:00	1537
2025-10-17 00:00	1364
2025-10-17 01:00	1709
2025-10-17 02:00	1499
2025-10-17 03:00	XXX
2025-10-17 04:00	1257
2025-10-17 05:00	1139
2025-10-17 06:00	1326
2025-10-17 07:00	1241
2025-10-17 08:00	1396
2025-10-17 09:00	1540
2025-10-17 10:00	1503
2025-10-17 11:00	1643
2025-10-17 12:00	1580
2025-10-17 13:00	XXX
2025-10-17 14:00	XXX
2025-10-17 15:00	XXX
2025-10-17 16:00	XXX
2025-10-17 17:00	XXX
2025-10-17 18:00	XXX
2025-10-17 19:00	XXX
2025-10-17 20:00	XXX
2025-10-17 21:00	1543
2025-10-17 22:00	1555
2025-10-17 23:00	1679
2025-10-18 00:00	1096
2025-10-18 01:00	XXX
2025-10-18 02:00	1076
2025-10-18 03:00	1224
2025-10-18 04:00	XXX
2025-10-18 05:00	1062
2025-10-18 06:00	1129
2025-10-18 07:00	XXX
2025-10-18 08:00	XXX
2025-10-18 09:00	XXX
2025-10-18 10:00	XXX
2025-10-18 11:00	XXX
2025-10-18 12:00	XXX
2025-10-18 13:00	XXX
2025-10-18 14:00	XXX
2025-10-18 15:00	XXX
2025-10-18 16:00	XXX
2025-10-18 17:00	1520
2025-10-18 18:00	XXX
2025-10-18 19:00	XXX
2025-10-18 20:00	XXX
2025-10-18 21:00	XXX
2025-10-18 22:00	XXX
2025-10-18 23:00	XXX
2025-10-19 00:00	XXX
2025-10-19 01:00	XXX
2025-10-19 02:00	XXX
2025-10-19 03:00	XXX
2025-10-19 04:00	XXX
2025-10-19 05:00	1026
2025-10-19 06:00	XXX
2025-10-19 07:00	XXX
2025-10-19 08:00	XXX
2025-10-19 09:00	1656
2025-10-19 10:00	1042
2025-10-19 11:00	XXX
2025-10-19 12:00	XXX
2025-10-19 13:00	XXX
2025-10-19 14:00	XXX
2025-10-19 15:00	XXX
2025-10-19 16:00	XXX
2025-10-19 17:00	XXX
2025-10-19 18:00	XXX
2025-10-19 19:00	XXX
2025-10-19 20:00	XXX
2025-10-19 21:00	XXX
2025-10-19 22:00	1764
2025-10-19 23:00	XXX
2025-10-20 00:00	XXX
2025-10-20 01:00	XXX
2025-10-20 02:00	XXX
2025-10-20 03:00	XXX
2025-10-20 04:00	XXX
2025-10-20 05:00	XXX
2025-10-20 06:00	XXX
2025-10-20 07:00	XXX
2025-10-20 08:00	XXX
2025-10-20 09:00	3553

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




---

### 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 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": {
    "topic": "bitcoin",
    "generated": 1760641738
  },
  "summary": "Florida has introduced a new bill to establish Bitcoin and digital asset reserves, while BlackRock's CEO has taken back anti-Bitcoin comments, saying markets force investors to relook at their assumptions. Meanwhile, Bitcoin miners have deposited XXXXXX BTC to Binance since October 9, and traders are betting on a potential crash. Several major companies, including Steak 'n Shake and Compass Coffee, have made recent announcements related to Bitcoin adoption."
}
```

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 $
+ **generated**: A unix timestamp (in seconds) when the data was generated to understand possibly stale data




---