[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-07 10:00	2340146
2025-07-07 11:00	7102672
2025-07-07 12:00	2734486
2025-07-07 13:00	2727602
2025-07-07 14:00	2688471
2025-07-07 15:00	3044234
2025-07-07 16:00	2730705
2025-07-07 17:00	2066858
2025-07-07 18:00	1241125
2025-07-07 19:00	1115509
2025-07-07 20:00	1064620
2025-07-07 21:00	754219
2025-07-07 22:00	659676
2025-07-07 23:00	970333
2025-07-08 00:00	1283232
2025-07-08 01:00	1410623
2025-07-08 02:00	1676412
2025-07-08 03:00	2106932
2025-07-08 04:00	2458303
2025-07-08 05:00	3265631
2025-07-08 06:00	2167361
2025-07-08 07:00	2144661
2025-07-08 08:00	2714180
2025-07-08 09:00	2372019
2025-07-08 10:00	1956642
2025-07-08 11:00	2459329
2025-07-08 12:00	2658776
2025-07-08 13:00	2982855
2025-07-08 14:00	3193837
2025-07-08 15:00	3214151
2025-07-08 16:00	3114876
2025-07-08 17:00	2600981
2025-07-08 18:00	10336389
2025-07-08 19:00	1318394
2025-07-08 20:00	1284981
2025-07-08 21:00	947008
2025-07-08 22:00	613190
2025-07-08 23:00	915237
2025-07-09 00:00	1439513
2025-07-09 01:00	1809884
2025-07-09 02:00	1854756
2025-07-09 03:00	2127485
2025-07-09 04:00	2607699
2025-07-09 05:00	2682266
2025-07-09 06:00	2324082
2025-07-09 07:00	2168053
2025-07-09 08:00	1135528
2025-07-09 20:00	1148101
2025-07-09 21:00	1047900
2025-07-09 22:00	975062
2025-07-09 23:00	912337
2025-07-10 00:00	1416580
2025-07-10 01:00	1887350
2025-07-10 02:00	2193246
2025-07-10 03:00	1937651
2025-07-10 04:00	2223184
2025-07-10 05:00	2405045
2025-07-10 06:00	3118775
2025-07-10 07:00	2603376
2025-07-10 08:00	2496980
2025-07-10 09:00	3236157
2025-07-10 10:00	3446749
2025-07-10 11:00	2223404
2025-07-10 12:00	2322333
2025-07-10 13:00	2199681
2025-07-10 14:00	2899468
2025-07-10 15:00	1989218
2025-07-10 16:00	2083955
2025-07-10 17:00	2870024
2025-07-10 18:00	1650924
2025-07-10 19:00	1082623
2025-07-10 20:00	723588
2025-07-10 21:00	560276
2025-07-10 22:00	543141
2025-07-10 23:00	687567
2025-07-11 00:00	895003
2025-07-11 01:00	1274007
2025-07-11 02:00	2072970
2025-07-11 03:00	2018724
2025-07-11 04:00	2001297
2025-07-11 05:00	1912036
2025-07-11 06:00	1953261
2025-07-11 07:00	2374623
2025-07-11 08:00	2216753
2025-07-11 09:00	2185047
2025-07-11 10:00	1955050
2025-07-11 11:00	2316110
2025-07-11 12:00	2468283
2025-07-11 13:00	2023920
2025-07-11 14:00	2286284
2025-07-11 15:00	1946958
2025-07-11 16:00	2050395
2025-07-11 17:00	2024082
2025-07-11 18:00	2799359
2025-07-11 19:00	1031332
2025-07-11 20:00	814148
2025-07-11 21:00	560067
2025-07-11 22:00	690525
2025-07-11 23:00	681653
2025-07-12 00:00	1306978
2025-07-12 01:00	1414751
2025-07-12 02:00	1773991
2025-07-12 03:00	2063002
2025-07-12 04:00	2282592
2025-07-12 05:00	2276041
2025-07-12 06:00	2185367
2025-07-12 07:00	1913346
2025-07-12 08:00	2515269
2025-07-12 09:00	1844706
2025-07-12 10:00	1886054
2025-07-12 11:00	1733956
2025-07-12 12:00	2010914
2025-07-12 13:00	2201082
2025-07-12 14:00	2056792
2025-07-12 15:00	2239244
2025-07-12 16:00	2232401
2025-07-12 17:00	1821962
2025-07-12 18:00	7389712
2025-07-12 19:00	1177737
2025-07-12 20:00	1006440
2025-07-12 21:00	534981
2025-07-12 22:00	638292
2025-07-12 23:00	1038637
2025-07-13 00:00	970077
2025-07-13 01:00	1567289
2025-07-13 02:00	1616267
2025-07-13 03:00	2236762
2025-07-13 04:00	2253662
2025-07-13 05:00	2660040
2025-07-13 06:00	2480977
2025-07-13 07:00	785293
2025-07-14 16:00	2746067
2025-07-14 17:00	1838980
2025-07-14 18:00	1235769
2025-07-14 19:00	1653594
2025-07-14 20:00	1268929
2025-07-14 21:00	889326
2025-07-14 22:00	973414
2025-07-14 23:00	1204057
2025-07-15 00:00	1335898
2025-07-15 01:00	1266650
2025-07-15 02:00	1497351
2025-07-15 03:00	1845843
2025-07-15 04:00	1840430
2025-07-15 05:00	2109664
2025-07-15 06:00	2827170
2025-07-15 07:00	2817476
2025-07-15 08:00	2748035
2025-07-15 09:00	2184194
2025-07-15 10:00	2159918
2025-07-15 11:00	6351229
2025-07-15 12:00	2811918
2025-07-15 13:00	2392586
2025-07-15 14:00	3234937
2025-07-15 15:00	3090597
2025-07-15 16:00	2547159
2025-07-15 17:00	1534225
2025-07-15 18:00	1348402
2025-07-15 19:00	831858
2025-07-15 20:00	1145624
2025-07-15 21:00	835133
2025-07-15 22:00	741820
2025-07-15 23:00	807856
2025-07-16 00:00	1280661
2025-07-16 01:00	1255473
2025-07-16 02:00	1348758
2025-07-16 03:00	1340553
2025-07-16 04:00	2045125
2025-07-16 05:00	2151685
2025-07-16 06:00	2456529
2025-07-16 07:00	2089823
2025-07-16 08:00	2418694
2025-07-16 09:00	2748604
2025-07-16 10:00	3114387
2025-07-16 11:00	3254601
2025-07-16 12:00	2574660
2025-07-16 13:00	2633052
2025-07-16 14:00	2772790
2025-07-16 15:00	2629101
2025-07-16 16:00	2300672
2025-07-16 17:00	1925761
2025-07-16 18:00	1058261
2025-07-16 19:00	837894
2025-07-16 20:00	589464
2025-07-16 21:00	532605
2025-07-16 22:00	636418
2025-07-16 23:00	633778
2025-07-17 00:00	1208653
2025-07-17 01:00	1150863
2025-07-17 02:00	1158068
2025-07-17 03:00	928752
2025-07-17 04:00	742789

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




---