[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	interactions
2025-07-21 08:00	2689
2025-07-21 09:00	2321
2025-07-21 10:00	2232
2025-07-21 11:00	2634
2025-07-21 12:00	2529
2025-07-21 13:00	3575
2025-07-21 14:00	2043
2025-07-21 15:00	2470
2025-07-21 16:00	3674
2025-07-21 17:00	2247
2025-07-21 18:00	2654
2025-07-21 19:00	2962
2025-07-21 20:00	2057
2025-07-21 21:00	1950
2025-07-21 22:00	1486
2025-07-21 23:00	1750
2025-07-22 00:00	1502
2025-07-22 01:00	2661
2025-07-22 02:00	2019
2025-07-22 03:00	1494
2025-07-22 04:00	1539
2025-07-22 05:00	1596
2025-07-22 06:00	1927
2025-07-22 07:00	1278
2025-07-22 08:00	1515
2025-07-22 09:00	1862
2025-07-22 10:00	1839
2025-07-22 11:00	1636
2025-07-22 12:00	1831
2025-07-22 13:00	1649
2025-07-22 14:00	2660
2025-07-22 15:00	2357
2025-07-22 16:00	1977
2025-07-22 17:00	2264
2025-07-22 18:00	2059
2025-07-22 19:00	2219
2025-07-22 20:00	2774
2025-07-22 21:00	2769
2025-07-22 22:00	3303
2025-07-22 23:00	3400
2025-07-23 00:00	2965
2025-07-23 01:00	3417
2025-07-23 02:00	3067
2025-07-23 03:00	2893
2025-07-23 04:00	2584
2025-07-23 05:00	1892
2025-07-23 06:00	1788
2025-07-23 07:00	1249
2025-07-23 08:00	1404
2025-07-23 09:00	1637
2025-07-23 10:00	2605
2025-07-23 11:00	1670
2025-07-23 12:00	1534
2025-07-23 13:00	1550
2025-07-23 14:00	1969
2025-07-23 15:00	3167
2025-07-23 16:00	2285
2025-07-23 17:00	2211
2025-07-23 18:00	2276
2025-07-23 19:00	1801
2025-07-23 20:00	1594
2025-07-23 21:00	2080
2025-07-23 22:00	1509
2025-07-23 23:00	1552
2025-07-24 00:00	1629
2025-07-24 01:00	1451
2025-07-24 02:00	1155
2025-07-24 03:00	1447
2025-07-24 04:00	1355
2025-07-24 05:00	1110
2025-07-24 06:00	1304
2025-07-24 07:00	XXX
2025-07-24 08:00	1566
2025-07-24 09:00	1350
2025-07-24 10:00	1478
2025-07-24 11:00	1115
2025-07-24 12:00	1344
2025-07-24 13:00	1926
2025-07-24 14:00	1699
2025-07-24 15:00	1913
2025-07-24 16:00	2031
2025-07-24 17:00	1756
2025-07-24 18:00	1099
2025-07-24 19:00	1552
2025-07-24 20:00	1306
2025-07-24 21:00	1518
2025-07-24 22:00	1194
2025-07-24 23:00	XXX
2025-07-25 00:00	1018
2025-07-25 01:00	1033
2025-07-25 02:00	XXX
2025-07-25 03:00	1084
2025-07-25 04:00	XXX
2025-07-25 05:00	XXX
2025-07-25 06:00	XXX
2025-07-25 07:00	XXX
2025-07-25 08:00	XXX
2025-07-25 09:00	XXX
2025-07-25 10:00	XXX
2025-07-25 11:00	XXX
2025-07-25 12:00	XXX
2025-07-25 13:00	XXX
2025-07-25 14:00	XXX
2025-07-25 15:00	XXX
2025-07-25 16:00	XXX
2025-07-25 17:00	XXX
2025-07-25 18:00	XXX
2025-07-25 19:00	XXX
2025-07-25 20:00	XXX
2025-07-25 21:00	XXX
2025-07-25 22:00	XXX
2025-07-25 23:00	XXX
2025-07-26 00:00	XXX
2025-07-30 21:00	XXX
2025-07-30 22:00	XXX
2025-07-30 23:00	XXX
2025-07-31 00:00	XXX
2025-07-31 01:00	XXX
2025-07-31 02:00	XXX
2025-07-31 03:00	XXX
2025-07-31 04:00	XXX
2025-07-31 05:00	XXX
2025-07-31 06:00	XXX
2025-07-31 07:00	XXX
2025-07-31 08:00	XXX
2025-07-31 09:00	XXX
2025-07-31 10:00	XXX
2025-07-31 11:00	XXX
2025-07-31 12:00	XXX
2025-07-31 13:00	XXX
2025-07-31 14:00	XXX
2025-07-31 15:00	XX
2025-07-31 16:00	XXX
2025-07-31 17:00	XXX
2025-07-31 18:00	XXX
2025-07-31 19:00	XX
2025-07-31 20:00	XXX
2025-07-31 21:00	XXX
2025-07-31 22:00	XXX
2025-07-31 23:00	XX
2025-08-01 00:00	XXX
2025-08-01 01:00	XXX
2025-08-01 02:00	XXX
2025-08-01 03:00	XXX
2025-08-01 04:00	XX
2025-08-01 05:00	XXX
2025-08-01 06:00	XXX
2025-08-01 07:00	XXX
2025-08-01 08:00	XX
2025-08-01 09:00	XXX
2025-08-01 10:00	XXX
2025-08-01 11:00	XXX
2025-08-01 12:00	XX
2025-08-01 13:00	XXX
2025-08-01 14:00	XXX
2025-08-01 15:00	XXX
2025-08-01 16:00	XXX
2025-08-01 17:00	XXX
2025-08-01 18:00	XXX
2025-08-01 19:00	XXX
2025-08-01 20:00	XXX
2025-08-01 21:00	XX
2025-08-01 22:00	XXX
2025-08-01 23:00	XX
2025-08-02 00:00	XXX
2025-08-02 01:00	XXX
2025-08-02 02:00	XXX
2025-08-02 03:00	XX
2025-08-02 04:00	XX
2025-08-02 05:00	XX
2025-08-02 06:00	XX
2025-08-02 07:00	XXX
2025-08-02 08:00	XX
2025-08-02 09:00	XX
2025-08-02 10:00	XX
2025-08-02 11:00	XXX
2025-08-02 12:00	XX
2025-08-02 13:00	XX
2025-08-02 14:00	XX
2025-08-02 15:00	XXX
2025-08-02 16:00	XX
2025-08-02 17:00	XX
2025-08-02 18:00	XX
2025-08-02 19:00	XX
2025-08-02 20:00	XXX
2025-08-02 21:00	XX
2025-08-02 22:00	XXX
2025-08-02 23:00	XXX
2025-08-03 00:00	XXX
2025-08-03 01:00	XX
2025-08-03 02:00	XXX
2025-08-03 03:00	XXX

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




---

### Topic Posts

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

Get the top posts for a social topic. If start time is provided the result will be the top posts by interactions for the time range. If start is not provided it will be the most recent top posts by interactions from the last XX hours.

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**
+ **start**: _The start time (unix timestamp) to start at. Will be rounded to the beginning of the day. If the end parameter is not provided it will just be the top posts for this day._ 
+ **end**: _(Optional) The end time (unix timestamp) to stop at. Will be rounded to the end of the day._ 

Example request:

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



Example response:

```json
{
  "config": {
    "topic": "bitcoin",
    "type": "topic",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "generated": 1751552696
  },
  "data": [
    {
      "id": "1940767467934294480",
      "post_type": "tweet",
      "post_title": "NEW: 🇺🇸 Bitcoin & crypto market cap will \"probably go to $15-$20 TRILLION” once the Genius stablecoin legislation passes, says Trump's Digital Asset Director",
      "post_link": "https://x.com/BTC_Archive/status/1940767467934294480",
      "post_image": "https://pbs.twimg.com/media/Gu79uZ4WwAELycU.jpg",
      "post_created": 1751549996,
      "post_sentiment": 3.13,
      "creator_id": "twitter::970994516357472257",
      "creator_name": "BTC_Archive",
      "creator_display_name": "Bitcoin Archive",
      "creator_followers": 1726739,
      "creator_avatar": "https://pbs.twimg.com/profile_images/1938906052956700672/7aV7c-nF_200x200.jpg",
      "interactions_24h": 30978,
      "interactions_total": 31161
    }
  ]
}
```

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 $
+ **type**: Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
+ **id**: Unique id of the social post
+ **name**: The full name of the asset
+ **symbol**: The symbol for the asset
+ **generated**: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
+ **post_type**: The type of social post
+ **post_title**: The title text of the social post
+ **post_link**: The URL to view the social post on the social network
+ **post_image**: The URL to the primary image for the post if available
+ **post_created**: The unix timestamp of our best indication of when the post was created
+ **post_sentiment**: The sentiment of the post is a score between X and X with X being very negative, X being neutral, and X being very positive. A score of XXX is considered slightly positive.
+ **creator_id**: The [network]::[unique_id] for the influencer
+ **creator_name**: The unique screen name for the influencer
+ **creator_display_name**: The chosen display name for the influencer if available
+ **creator_followers**: number of followers the account has
+ **creator_avatar**: The URL to the avatar for the creator
+ **interactions_24h**: Number of interactions in the last XX hours
+ **interactions_total**: Number of total interactions




---