Dark | Light
[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-10 12:00	17026
2025-07-10 13:00	12760
2025-07-10 14:00	11900
2025-07-10 15:00	8437
2025-07-10 16:00	9292
2025-07-10 17:00	7072
2025-07-10 18:00	3702
2025-07-10 19:00	3510
2025-07-10 20:00	1944
2025-07-10 21:00	2486
2025-07-10 22:00	1767
2025-07-10 23:00	1611
2025-07-11 00:00	2159
2025-07-11 01:00	2991
2025-07-11 02:00	1701
2025-07-11 03:00	2043
2025-07-11 04:00	1653
2025-07-11 05:00	2166
2025-07-11 06:00	1420
2025-07-11 07:00	1233
2025-07-11 08:00	1171
2025-07-11 09:00	5097
2025-07-11 10:00	5906
2025-07-11 11:00	2326
2025-07-11 12:00	2375
2025-07-11 13:00	4321
2025-07-11 14:00	6794
2025-07-11 15:00	5153
2025-07-11 16:00	4665
2025-07-11 17:00	4934
2025-07-11 18:00	4494
2025-07-11 19:00	3876
2025-07-11 20:00	2816
2025-07-11 21:00	2988
2025-07-11 22:00	2734
2025-07-11 23:00	2486
2025-07-12 00:00	2456
2025-07-12 01:00	3080
2025-07-12 02:00	2742
2025-07-12 03:00	2853
2025-07-12 04:00	2731
2025-07-12 05:00	2551
2025-07-12 06:00	2467
2025-07-12 07:00	2136
2025-07-12 08:00	2304
2025-07-12 09:00	1938
2025-07-12 10:00	2132
2025-07-12 11:00	XXX
2025-07-12 12:00	2207
2025-07-12 13:00	2208
2025-07-12 14:00	2305
2025-07-12 15:00	1003
2025-07-12 16:00	1792
2025-07-12 17:00	1281
2025-07-12 18:00	1759
2025-07-12 19:00	1384
2025-07-12 20:00	1434
2025-07-12 21:00	XXX
2025-07-12 22:00	1336
2025-07-12 23:00	1240
2025-07-13 00:00	1209
2025-07-13 01:00	XXX
2025-07-13 02:00	1152
2025-07-13 03:00	1154
2025-07-13 04:00	XXX
2025-07-13 05:00	XXX
2025-07-13 06:00	XXX
2025-07-13 07:00	1074
2025-07-13 08:00	XXX
2025-07-13 09:00	XXX
2025-07-13 10:00	XXX
2025-07-13 11:00	1164
2025-07-13 12:00	1306
2025-07-13 13:00	1977
2025-07-13 14:00	XXX
2025-07-13 15:00	1378
2025-07-13 16:00	1070
2025-07-13 17:00	1171
2025-07-13 18:00	XXX
2025-07-13 19:00	1101
2025-07-13 20:00	1114
2025-07-13 21:00	1236
2025-07-13 22:00	XXX
2025-07-13 23:00	XXX
2025-07-14 00:00	1046
2025-07-14 01:00	1076
2025-07-14 02:00	1047
2025-07-14 03:00	XXX
2025-07-14 04:00	XXX
2025-07-14 05:00	1095
2025-07-14 06:00	XXX
2025-07-14 07:00	XXX
2025-07-14 08:00	1979
2025-07-14 09:00	3023
2025-07-14 10:00	4520
2025-07-14 11:00	2032
2025-07-14 12:00	2071
2025-07-14 13:00	2440
2025-07-14 14:00	1212
2025-07-14 15:00	1423
2025-07-14 16:00	1624
2025-07-14 17:00	1520
2025-07-14 18:00	1346
2025-07-14 19:00	1383
2025-07-14 20:00	1138
2025-07-14 21:00	1388
2025-07-14 22:00	1514
2025-07-14 23:00	4154
2025-07-15 00:00	8515
2025-07-15 01:00	XXX
2025-07-15 02:00	1792
2025-07-15 03:00	4348
2025-07-15 04:00	3217
2025-07-15 05:00	3110
2025-07-15 06:00	1822
2025-07-15 07:00	XXX
2025-07-15 08:00	2182
2025-07-15 09:00	1581
2025-07-15 10:00	1607
2025-07-15 11:00	1655
2025-07-15 12:00	2050
2025-07-15 13:00	2235
2025-07-15 14:00	2276
2025-07-15 15:00	4349
2025-07-15 16:00	8874
2025-07-15 17:00	3884
2025-07-15 18:00	5692
2025-07-15 19:00	3317
2025-07-15 20:00	4181
2025-07-15 21:00	4528
2025-07-15 22:00	3733
2025-07-15 23:00	3538
2025-07-16 00:00	3866
2025-07-16 01:00	4842
2025-07-16 02:00	5327
2025-07-16 03:00	1675
2025-07-16 04:00	1109
2025-07-16 05:00	1074
2025-07-16 06:00	1187
2025-07-16 07:00	1482
2025-07-16 08:00	2307
2025-07-16 09:00	XXX
2025-07-16 10:00	XXX
2025-07-16 11:00	1290
2025-07-16 12:00	XXX
2025-07-16 13:00	1148
2025-07-16 14:00	1093
2025-07-16 15:00	2629
2025-07-16 16:00	2370
2025-07-16 17:00	2611
2025-07-16 18:00	2907
2025-07-16 19:00	3329
2025-07-16 20:00	2201
2025-07-16 21:00	2012
2025-07-16 22:00	1879
2025-07-16 23:00	79272
2025-07-17 00:00	1449
2025-07-17 01:00	1193
2025-07-17 02:00	1107
2025-07-17 03:00	4891
2025-07-17 04:00	9430
2025-07-17 05:00	4465
2025-07-17 06:00	3977
2025-07-17 07:00	2944
2025-07-17 08:00	2035
2025-07-17 09:00	3445
2025-07-17 10:00	2898
2025-07-17 11:00	2368
2025-07-17 12:00	2719
2025-07-17 13:00	3192
2025-07-17 14:00	2509
2025-07-17 15:00	2321
2025-07-17 16:00	2026
2025-07-17 17:00	2112
2025-07-17 18:00	1722
2025-07-17 19:00	1673
2025-07-17 20:00	1363
2025-07-17 21:00	2166
2025-07-17 22:00	1393
2025-07-17 23:00	1242
2025-07-18 00:00	1170
2025-07-18 01:00	1603
2025-07-18 02:00	2063
2025-07-18 03:00	1550
2025-07-18 04:00	2570
2025-07-18 05:00	4001
2025-07-18 06:00	4401
2025-07-18 07:00	2813
2025-07-18 08:00	2559
2025-07-18 09:00	XXX
2025-07-18 10:00	XXX
2025-07-18 11:00	XXX
2025-07-18 20:00	1911
2025-07-18 21:00	1075
2025-07-18 22:00	XX

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




---

[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-10 12:00 17026 2025-07-10 13:00 12760 2025-07-10 14:00 11900 2025-07-10 15:00 8437 2025-07-10 16:00 9292 2025-07-10 17:00 7072 2025-07-10 18:00 3702 2025-07-10 19:00 3510 2025-07-10 20:00 1944 2025-07-10 21:00 2486 2025-07-10 22:00 1767 2025-07-10 23:00 1611 2025-07-11 00:00 2159 2025-07-11 01:00 2991 2025-07-11 02:00 1701 2025-07-11 03:00 2043 2025-07-11 04:00 1653 2025-07-11 05:00 2166 2025-07-11 06:00 1420 2025-07-11 07:00 1233 2025-07-11 08:00 1171 2025-07-11 09:00 5097 2025-07-11 10:00 5906 2025-07-11 11:00 2326 2025-07-11 12:00 2375 2025-07-11 13:00 4321 2025-07-11 14:00 6794 2025-07-11 15:00 5153 2025-07-11 16:00 4665 2025-07-11 17:00 4934 2025-07-11 18:00 4494 2025-07-11 19:00 3876 2025-07-11 20:00 2816 2025-07-11 21:00 2988 2025-07-11 22:00 2734 2025-07-11 23:00 2486 2025-07-12 00:00 2456 2025-07-12 01:00 3080 2025-07-12 02:00 2742 2025-07-12 03:00 2853 2025-07-12 04:00 2731 2025-07-12 05:00 2551 2025-07-12 06:00 2467 2025-07-12 07:00 2136 2025-07-12 08:00 2304 2025-07-12 09:00 1938 2025-07-12 10:00 2132 2025-07-12 11:00 XXX 2025-07-12 12:00 2207 2025-07-12 13:00 2208 2025-07-12 14:00 2305 2025-07-12 15:00 1003 2025-07-12 16:00 1792 2025-07-12 17:00 1281 2025-07-12 18:00 1759 2025-07-12 19:00 1384 2025-07-12 20:00 1434 2025-07-12 21:00 XXX 2025-07-12 22:00 1336 2025-07-12 23:00 1240 2025-07-13 00:00 1209 2025-07-13 01:00 XXX 2025-07-13 02:00 1152 2025-07-13 03:00 1154 2025-07-13 04:00 XXX 2025-07-13 05:00 XXX 2025-07-13 06:00 XXX 2025-07-13 07:00 1074 2025-07-13 08:00 XXX 2025-07-13 09:00 XXX 2025-07-13 10:00 XXX 2025-07-13 11:00 1164 2025-07-13 12:00 1306 2025-07-13 13:00 1977 2025-07-13 14:00 XXX 2025-07-13 15:00 1378 2025-07-13 16:00 1070 2025-07-13 17:00 1171 2025-07-13 18:00 XXX 2025-07-13 19:00 1101 2025-07-13 20:00 1114 2025-07-13 21:00 1236 2025-07-13 22:00 XXX 2025-07-13 23:00 XXX 2025-07-14 00:00 1046 2025-07-14 01:00 1076 2025-07-14 02:00 1047 2025-07-14 03:00 XXX 2025-07-14 04:00 XXX 2025-07-14 05:00 1095 2025-07-14 06:00 XXX 2025-07-14 07:00 XXX 2025-07-14 08:00 1979 2025-07-14 09:00 3023 2025-07-14 10:00 4520 2025-07-14 11:00 2032 2025-07-14 12:00 2071 2025-07-14 13:00 2440 2025-07-14 14:00 1212 2025-07-14 15:00 1423 2025-07-14 16:00 1624 2025-07-14 17:00 1520 2025-07-14 18:00 1346 2025-07-14 19:00 1383 2025-07-14 20:00 1138 2025-07-14 21:00 1388 2025-07-14 22:00 1514 2025-07-14 23:00 4154 2025-07-15 00:00 8515 2025-07-15 01:00 XXX 2025-07-15 02:00 1792 2025-07-15 03:00 4348 2025-07-15 04:00 3217 2025-07-15 05:00 3110 2025-07-15 06:00 1822 2025-07-15 07:00 XXX 2025-07-15 08:00 2182 2025-07-15 09:00 1581 2025-07-15 10:00 1607 2025-07-15 11:00 1655 2025-07-15 12:00 2050 2025-07-15 13:00 2235 2025-07-15 14:00 2276 2025-07-15 15:00 4349 2025-07-15 16:00 8874 2025-07-15 17:00 3884 2025-07-15 18:00 5692 2025-07-15 19:00 3317 2025-07-15 20:00 4181 2025-07-15 21:00 4528 2025-07-15 22:00 3733 2025-07-15 23:00 3538 2025-07-16 00:00 3866 2025-07-16 01:00 4842 2025-07-16 02:00 5327 2025-07-16 03:00 1675 2025-07-16 04:00 1109 2025-07-16 05:00 1074 2025-07-16 06:00 1187 2025-07-16 07:00 1482 2025-07-16 08:00 2307 2025-07-16 09:00 XXX 2025-07-16 10:00 XXX 2025-07-16 11:00 1290 2025-07-16 12:00 XXX 2025-07-16 13:00 1148 2025-07-16 14:00 1093 2025-07-16 15:00 2629 2025-07-16 16:00 2370 2025-07-16 17:00 2611 2025-07-16 18:00 2907 2025-07-16 19:00 3329 2025-07-16 20:00 2201 2025-07-16 21:00 2012 2025-07-16 22:00 1879 2025-07-16 23:00 79272 2025-07-17 00:00 1449 2025-07-17 01:00 1193 2025-07-17 02:00 1107 2025-07-17 03:00 4891 2025-07-17 04:00 9430 2025-07-17 05:00 4465 2025-07-17 06:00 3977 2025-07-17 07:00 2944 2025-07-17 08:00 2035 2025-07-17 09:00 3445 2025-07-17 10:00 2898 2025-07-17 11:00 2368 2025-07-17 12:00 2719 2025-07-17 13:00 3192 2025-07-17 14:00 2509 2025-07-17 15:00 2321 2025-07-17 16:00 2026 2025-07-17 17:00 2112 2025-07-17 18:00 1722 2025-07-17 19:00 1673 2025-07-17 20:00 1363 2025-07-17 21:00 2166 2025-07-17 22:00 1393 2025-07-17 23:00 1242 2025-07-18 00:00 1170 2025-07-18 01:00 1603 2025-07-18 02:00 2063 2025-07-18 03:00 1550 2025-07-18 04:00 2570 2025-07-18 05:00 4001 2025-07-18 06:00 4401 2025-07-18 07:00 2813 2025-07-18 08:00 2559 2025-07-18 09:00 XXX 2025-07-18 10:00 XXX 2025-07-18 11:00 XXX 2025-07-18 20:00 1911 2025-07-18 21:00 1075 2025-07-18 22:00 XX

Topics List

https://lunarcrush.com/api4/public/topics/list/v1

Get a list of trending social topics.

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topics/list/v1

Example response:

{
  "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:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v2

Example response:

{
  "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:

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

Example response:

{
  "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:

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

Example response:

{
  "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

Sequoia Capital Engagements
/topic/sequoia-capital/interactions