[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-06 01:00	102079
2025-07-06 02:00	106321
2025-07-06 03:00	108923
2025-07-06 04:00	84176
2025-07-06 05:00	127017
2025-07-06 06:00	105372
2025-07-06 07:00	77921
2025-07-06 08:00	139440
2025-07-06 09:00	105801
2025-07-06 10:00	111837
2025-07-06 11:00	110816
2025-07-06 12:00	122837
2025-07-06 13:00	112504
2025-07-06 14:00	115679
2025-07-06 15:00	129138
2025-07-06 16:00	101274
2025-07-06 17:00	497210
2025-07-06 18:00	495241
2025-07-06 19:00	123063
2025-07-06 20:00	116770
2025-07-06 21:00	134998
2025-07-06 22:00	153887
2025-07-06 23:00	188558
2025-07-07 00:00	129815
2025-07-07 01:00	128706
2025-07-07 02:00	139239
2025-07-07 03:00	155108
2025-07-07 04:00	142082
2025-07-07 05:00	92406
2025-07-07 06:00	146891
2025-07-07 07:00	114473
2025-07-07 08:00	128858
2025-07-07 09:00	100169
2025-07-07 10:00	82523
2025-07-07 11:00	99364
2025-07-07 12:00	140221
2025-07-07 13:00	161952
2025-07-07 14:00	196639
2025-07-07 15:00	140043
2025-07-07 16:00	289306
2025-07-07 17:00	290711
2025-07-07 18:00	244311
2025-07-07 19:00	211726
2025-07-07 20:00	228388
2025-07-07 21:00	199113
2025-07-07 22:00	215249
2025-07-07 23:00	243090
2025-07-08 00:00	221936
2025-07-08 01:00	195490
2025-07-08 02:00	263942
2025-07-08 03:00	188448
2025-07-08 04:00	262722
2025-07-08 05:00	263497
2025-07-08 06:00	244510
2025-07-08 07:00	197348
2025-07-08 08:00	182614
2025-07-08 09:00	196799
2025-07-08 10:00	183685
2025-07-08 11:00	233533
2025-07-08 12:00	332443
2025-07-08 13:00	317170
2025-07-08 14:00	435023
2025-07-08 15:00	468491
2025-07-08 16:00	418169
2025-07-08 17:00	363546
2025-07-08 18:00	613600
2025-07-08 19:00	526402
2025-07-08 20:00	448293
2025-07-08 21:00	472386
2025-07-08 22:00	410622
2025-07-08 23:00	540839
2025-07-09 00:00	435277
2025-07-09 01:00	460778
2025-07-09 02:00	476188
2025-07-09 03:00	478005
2025-07-09 04:00	341594
2025-07-09 05:00	338349
2025-07-09 06:00	318804
2025-07-09 07:00	302565
2025-07-09 08:00	283864
2025-07-09 09:00	328231
2025-07-09 10:00	282586
2025-07-09 11:00	335615
2025-07-09 12:00	326314
2025-07-09 13:00	384934
2025-07-09 14:00	364246
2025-07-09 15:00	358365
2025-07-09 16:00	449901
2025-07-09 17:00	381085
2025-07-09 18:00	575530
2025-07-09 19:00	698100
2025-07-09 20:00	668053
2025-07-09 21:00	638212
2025-07-09 22:00	1014096
2025-07-09 23:00	1073293
2025-07-10 00:00	982352
2025-07-10 01:00	1046752
2025-07-10 02:00	950765
2025-07-10 03:00	839482
2025-07-10 04:00	742350
2025-07-10 05:00	818777
2025-07-10 06:00	583500
2025-07-10 07:00	611170
2025-07-10 08:00	444217
2025-07-10 09:00	425304
2025-07-10 10:00	603070
2025-07-10 11:00	581428
2025-07-10 12:00	594763
2025-07-10 13:00	826802
2025-07-10 14:00	725944
2025-07-10 15:00	776159
2025-07-10 16:00	656452
2025-07-10 17:00	855602
2025-07-10 18:00	737385
2025-07-10 19:00	594160
2025-07-10 20:00	449252
2025-07-10 21:00	372879
2025-07-10 22:00	346123
2025-07-10 23:00	367783
2025-07-11 00:00	284768
2025-07-11 01:00	325526
2025-07-11 02:00	292950
2025-07-11 03:00	386169
2025-07-11 04:00	330327
2025-07-11 05:00	308147
2025-07-11 06:00	424951
2025-07-11 07:00	440269
2025-07-11 08:00	563177
2025-07-11 09:00	595312
2025-07-11 10:00	687802
2025-07-11 11:00	762691
2025-07-11 12:00	1062372
2025-07-11 13:00	1197767
2025-07-11 14:00	1263152
2025-07-11 15:00	1339815
2025-07-11 16:00	1118940
2025-07-11 17:00	992434
2025-07-11 18:00	1019455
2025-07-11 19:00	1015508
2025-07-11 20:00	1005532
2025-07-11 21:00	1170833
2025-07-11 22:00	754821
2025-07-11 23:00	783960
2025-07-12 00:00	875870
2025-07-14 19:00	500013
2025-07-14 20:00	525829
2025-07-14 21:00	567383
2025-07-14 22:00	619312
2025-07-14 23:00	531900
2025-07-15 00:00	731858
2025-07-15 01:00	846537
2025-07-15 02:00	737761
2025-07-15 03:00	812158
2025-07-15 04:00	806513
2025-07-15 05:00	719869
2025-07-15 06:00	520794
2025-07-15 07:00	428285
2025-07-15 08:00	447049
2025-07-15 09:00	430801
2025-07-15 10:00	582970
2025-07-15 11:00	938987
2025-07-15 12:00	1015329
2025-07-15 13:00	1030890
2025-07-15 14:00	1181518
2025-07-15 15:00	1027737
2025-07-15 16:00	940695
2025-07-15 17:00	1005277
2025-07-15 18:00	931403
2025-07-15 19:00	1121957
2025-07-15 20:00	1128050
2025-07-15 21:00	1019413
2025-07-15 22:00	1080679
2025-07-15 23:00	1083950
2025-07-16 00:00	1028301
2025-07-16 01:00	1123848
2025-07-16 02:00	768352
2025-07-16 03:00	735561
2025-07-16 04:00	662567
2025-07-16 05:00	530607
2025-07-16 06:00	568356
2025-07-16 07:00	504243
2025-07-16 08:00	506226
2025-07-16 09:00	532820
2025-07-16 10:00	640348
2025-07-16 11:00	837834
2025-07-16 12:00	918428
2025-07-16 13:00	834495
2025-07-16 14:00	951131
2025-07-16 15:00	836523
2025-07-16 16:00	747287
2025-07-16 17:00	758653
2025-07-16 18:00	814260

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




---