[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-11 02:00	4422
2025-07-11 03:00	4344
2025-07-11 04:00	4564
2025-07-11 05:00	4543
2025-07-11 06:00	4575
2025-07-11 07:00	4579
2025-07-11 08:00	4546
2025-07-11 09:00	4578
2025-07-11 10:00	4518
2025-07-11 11:00	4573
2025-07-11 12:00	4566
2025-07-11 13:00	4630
2025-07-11 14:00	4538
2025-07-11 15:00	4514
2025-07-11 16:00	4462
2025-07-11 17:00	4107
2025-07-11 18:00	4225
2025-07-11 19:00	4207
2025-07-11 20:00	4180
2025-07-11 21:00	3860
2025-07-11 22:00	4405
2025-07-11 23:00	4006
2025-07-12 00:00	4017
2025-07-12 01:00	3930
2025-07-12 02:00	4677
2025-07-12 03:00	4459
2025-07-12 04:00	3673
2025-07-12 05:00	4982
2025-07-12 06:00	4943
2025-07-12 07:00	5049
2025-07-12 08:00	5500
2025-07-12 09:00	5547
2025-07-12 10:00	5203
2025-07-12 11:00	4878
2025-07-12 12:00	5341
2025-07-12 13:00	4510
2025-07-12 14:00	3678
2025-07-12 15:00	4422
2025-07-12 16:00	3368
2025-07-12 17:00	4061
2025-07-12 18:00	4294
2025-07-12 19:00	4245
2025-07-12 20:00	4015
2025-07-12 21:00	4032
2025-07-12 22:00	3777
2025-07-12 23:00	4383
2025-07-13 00:00	4977
2025-07-13 01:00	3677
2025-07-13 02:00	3753
2025-07-13 03:00	4101
2025-07-13 04:00	3993
2025-07-13 05:00	4237
2025-07-13 06:00	4534
2025-07-13 07:00	5237
2025-07-13 08:00	4938
2025-07-13 09:00	5509
2025-07-13 10:00	4860
2025-07-13 11:00	4899
2025-07-13 12:00	5786
2025-07-13 13:00	5742
2025-07-13 14:00	5118
2025-07-13 15:00	5265
2025-07-13 16:00	5689
2025-07-13 17:00	5202
2025-07-13 18:00	5673
2025-07-13 19:00	5698
2025-07-13 20:00	5018
2025-07-13 21:00	5302
2025-07-13 22:00	5037
2025-07-13 23:00	4990
2025-07-14 00:00	4999
2025-07-14 01:00	4934
2025-07-14 02:00	5056
2025-07-14 03:00	5161
2025-07-14 04:00	5103
2025-07-14 05:00	5084
2025-07-14 06:00	5113
2025-07-14 07:00	5261
2025-07-14 08:00	5179
2025-07-14 09:00	5428
2025-07-14 10:00	5056
2025-07-14 11:00	5622
2025-07-14 12:00	5635
2025-07-14 13:00	5750
2025-07-14 14:00	5887
2025-07-14 15:00	6546
2025-07-14 16:00	5946
2025-07-14 17:00	6208
2025-07-14 18:00	5558
2025-07-14 19:00	5341
2025-07-14 20:00	5433
2025-07-14 21:00	6031
2025-07-14 22:00	5111
2025-07-14 23:00	5632
2025-07-15 00:00	4585
2025-07-15 01:00	4975
2025-07-15 02:00	3952
2025-07-15 03:00	2896
2025-07-15 04:00	4206
2025-07-15 05:00	4089
2025-07-15 06:00	3877
2025-07-15 07:00	4259
2025-07-15 08:00	2664
2025-07-15 09:00	2649
2025-07-15 10:00	2565
2025-07-15 11:00	2824
2025-07-15 12:00	2607
2025-07-15 13:00	2299
2025-07-15 14:00	2381
2025-07-15 15:00	2353
2025-07-15 16:00	2813
2025-07-15 17:00	3059
2025-07-15 18:00	3119
2025-07-15 19:00	2870
2025-07-15 20:00	3070
2025-07-15 21:00	3327
2025-07-15 22:00	3484
2025-07-15 23:00	3831
2025-07-16 00:00	3732
2025-07-16 01:00	3687
2025-07-16 02:00	3526
2025-07-16 03:00	3985
2025-07-16 04:00	3858
2025-07-16 05:00	3865
2025-07-16 06:00	3773
2025-07-16 07:00	4771
2025-07-16 08:00	4925
2025-07-16 09:00	5075
2025-07-16 10:00	4554
2025-07-16 11:00	4806
2025-07-16 12:00	4869
2025-07-16 13:00	4830
2025-07-16 14:00	4664
2025-07-16 15:00	4851
2025-07-16 16:00	4589
2025-07-16 17:00	4669
2025-07-16 18:00	4770
2025-07-16 19:00	5063
2025-07-16 20:00	4941
2025-07-16 21:00	4898
2025-07-16 22:00	4971
2025-07-16 23:00	4718
2025-07-17 00:00	5144
2025-07-17 01:00	4575
2025-07-17 02:00	4691
2025-07-17 03:00	4972
2025-07-17 04:00	4794
2025-07-17 05:00	4959
2025-07-17 06:00	4737
2025-07-17 07:00	4686
2025-07-17 08:00	4627
2025-07-17 09:00	4657
2025-07-17 10:00	4661
2025-07-17 11:00	4496
2025-07-17 12:00	4754
2025-07-17 13:00	4629
2025-07-17 14:00	4551
2025-07-17 15:00	4453
2025-07-17 16:00	5092
2025-07-17 17:00	4573
2025-07-17 18:00	4492
2025-07-17 19:00	4762
2025-07-17 20:00	4069
2025-07-17 21:00	4681
2025-07-17 22:00	5399
2025-07-17 23:00	4985
2025-07-18 00:00	5053
2025-07-18 01:00	4855
2025-07-18 02:00	4687
2025-07-18 03:00	4924
2025-07-18 04:00	5136
2025-07-18 05:00	4991
2025-07-18 06:00	5000
2025-07-18 07:00	5130
2025-07-18 08:00	5049
2025-07-18 09:00	4818
2025-07-18 10:00	4675
2025-07-18 11:00	5501
2025-07-18 12:00	5848
2025-07-18 13:00	5714
2025-07-18 14:00	5347
2025-07-18 15:00	5651
2025-07-18 16:00	5570
2025-07-18 17:00	5722
2025-07-18 18:00	5623
2025-07-18 19:00	5827
2025-07-18 20:00	5861
2025-07-18 21:00	5898
2025-07-18 22:00	5762
2025-07-18 23:00	6217
2025-07-19 00:00	5111
2025-07-19 01:00	5556
2025-07-19 02:00	3707
2025-07-19 03:00	3365
2025-07-19 04:00	3141
2025-07-19 05:00	3159
2025-07-19 06:00	3123
2025-07-19 07:00	3305
2025-07-19 08:00	3118

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




---