[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-07-10 18:00	1045
2025-07-10 19:00	1055
2025-07-10 20:00	XXX
2025-07-10 21:00	XXX
2025-07-10 22:00	XXX
2025-07-10 23:00	XXX
2025-07-11 00:00	XXX
2025-07-11 01:00	XXX
2025-07-11 02:00	XXX
2025-07-11 03:00	XXX
2025-07-11 04:00	XXX
2025-07-11 05:00	XXX
2025-07-11 06:00	1015
2025-07-11 07:00	XXX
2025-07-11 08:00	XXX
2025-07-11 09:00	XXX
2025-07-11 10:00	XXX
2025-07-11 11:00	XXX
2025-07-11 12:00	XXX
2025-07-11 13:00	1025
2025-07-11 14:00	XXX
2025-07-11 15:00	XXX
2025-07-11 16:00	XXX
2025-07-11 17:00	XXX
2025-07-11 18:00	XXX
2025-07-11 19:00	XXX
2025-07-11 20:00	XXX
2025-07-11 21:00	XXX
2025-07-11 22:00	XXX
2025-07-11 23:00	XXX
2025-07-12 00:00	XXX
2025-07-12 01:00	XXX
2025-07-12 02:00	1427
2025-07-12 03:00	XXX
2025-07-12 04:00	1908
2025-07-12 05:00	1848
2025-07-12 06:00	XXX
2025-07-12 07:00	XXX
2025-07-12 08:00	1280
2025-07-12 09:00	1212
2025-07-12 10:00	1305
2025-07-12 11:00	1005
2025-07-12 12:00	1598
2025-07-12 13:00	1310
2025-07-12 14:00	1408
2025-07-12 15:00	1711
2025-07-12 16:00	2180
2025-07-12 17:00	2116
2025-07-12 18:00	2055
2025-07-12 19:00	2044
2025-07-12 20:00	2012
2025-07-12 21:00	1706
2025-07-12 22:00	1537
2025-07-12 23:00	1493
2025-07-13 00:00	XXX
2025-07-13 01:00	1014
2025-07-13 02:00	1114
2025-07-13 03:00	XXX
2025-07-13 04:00	XXX
2025-07-13 05:00	XXX
2025-07-13 06:00	XXX
2025-07-13 07:00	XXX
2025-07-13 08:00	XXX
2025-07-13 09:00	XXX
2025-07-13 10:00	XXX
2025-07-13 11:00	XXX
2025-07-13 12:00	XXX
2025-07-13 13:00	XXX
2025-07-13 14:00	XXX
2025-07-13 15:00	XXX
2025-07-13 16:00	XXX
2025-07-13 17:00	XXX
2025-07-13 18:00	XXX
2025-07-13 19:00	XXX
2025-07-13 20:00	XXX
2025-07-13 21:00	XXX
2025-07-13 22:00	XXX
2025-07-13 23:00	XXX
2025-07-14 00:00	XXX
2025-07-14 01:00	XXX
2025-07-14 02:00	XXX
2025-07-14 03:00	XXX
2025-07-14 04:00	XXX
2025-07-14 05:00	XXX
2025-07-14 06:00	XXX
2025-07-14 07:00	XXX
2025-07-14 08:00	XXX
2025-07-14 09:00	XXX
2025-07-14 10:00	XXX
2025-07-14 11:00	XXX
2025-07-14 12:00	XXX
2025-07-14 13:00	XXX
2025-07-14 14:00	1785
2025-07-14 15:00	1888
2025-07-14 16:00	1655
2025-07-14 17:00	1718
2025-07-14 18:00	1849
2025-07-14 19:00	1848
2025-07-14 20:00	1781
2025-07-14 21:00	1653
2025-07-14 22:00	1729
2025-07-14 23:00	1903
2025-07-15 00:00	2040
2025-07-15 01:00	1974
2025-07-15 02:00	2028
2025-07-15 03:00	2050
2025-07-15 04:00	2033
2025-07-15 05:00	1901
2025-07-15 06:00	1883
2025-07-15 07:00	1952
2025-07-15 08:00	1882
2025-07-15 09:00	1781
2025-07-15 10:00	1928
2025-07-15 11:00	2012
2025-07-15 12:00	1872
2025-07-15 13:00	1815
2025-07-15 14:00	1605
2025-07-15 15:00	XXX
2025-07-15 16:00	1008
2025-07-15 17:00	XXX
2025-07-15 18:00	XXX
2025-07-15 19:00	XXX
2025-07-15 20:00	XXX
2025-07-15 21:00	XXX
2025-07-15 22:00	XXX
2025-07-15 23:00	XXX
2025-07-16 00:00	XXX
2025-07-16 01:00	XXX
2025-07-16 02:00	XXX
2025-07-16 03:00	XXX
2025-07-16 04:00	XXX
2025-07-16 05:00	XXX
2025-07-16 06:00	XXX
2025-07-16 07:00	XXX
2025-07-16 08:00	XXX
2025-07-16 09:00	XXX
2025-07-16 10:00	XXX
2025-07-16 11:00	XXX
2025-07-16 12:00	XXX
2025-07-16 13:00	XXX
2025-07-16 14:00	XXX
2025-07-16 15:00	1238
2025-07-16 16:00	1159
2025-07-16 17:00	1131
2025-07-16 18:00	1249
2025-07-16 19:00	1258
2025-07-16 20:00	1199
2025-07-16 21:00	1170
2025-07-16 22:00	1379
2025-07-16 23:00	2043
2025-07-17 00:00	1482
2025-07-17 01:00	2218
2025-07-17 02:00	2082
2025-07-17 03:00	2277
2025-07-17 04:00	2105
2025-07-17 05:00	1905
2025-07-17 06:00	1536
2025-07-17 07:00	1972
2025-07-17 08:00	1355
2025-07-17 09:00	1195
2025-07-17 10:00	1244
2025-07-17 11:00	1265
2025-07-17 12:00	1189
2025-07-17 13:00	1273
2025-07-17 14:00	1366
2025-07-17 15:00	1215
2025-07-17 16:00	2072
2025-07-17 17:00	2005
2025-07-17 18:00	1973
2025-07-17 19:00	2021
2025-07-17 20:00	2127
2025-07-17 21:00	2180
2025-07-17 22:00	1823
2025-07-17 23:00	1186
2025-07-18 00:00	1053
2025-07-18 01:00	XXX
2025-07-18 02:00	XXX
2025-07-18 03:00	XXX
2025-07-18 04:00	XXX
2025-07-18 05:00	XXX
2025-07-18 06:00	XXX
2025-07-18 07:00	XXX
2025-07-18 08:00	XXX
2025-07-18 09:00	XXX
2025-07-18 10:00	XXX
2025-07-18 11:00	XXX
2025-07-18 12:00	XXX
2025-07-18 13:00	XXX
2025-07-18 14:00	1103
2025-07-18 15:00	XXX
2025-07-18 16:00	XXX
2025-07-18 17:00	XXX
2025-07-18 18:00	XXX
2025-07-18 19:00	XXX
2025-07-18 20:00

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




---

### 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 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": 1751552662
  },
  "summary": "Several major financial institutions and companies, such as BlackRock, Fidelity, and Microcloud Hologram Inc., are making significant moves in the Bitcoin space, including investing heavily in Bitcoin and launching new Bitcoin-related products. Additionally, regulatory developments, such as the SEC approving Grayscale's proposal to convert its fund into a spot ETF, are also having an impact. Meanwhile, some countries, like Pakistan, are exploring Bitcoin mining plans, while others, like South Africa, are seeing NFT marketplaces shut down due to market pressures."
}
```

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




---