[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-10-29 14:00	115253
2025-10-29 15:00	126976
2025-10-29 16:00	174937
2025-10-29 17:00	102831
2025-10-29 18:00	136302
2025-10-29 19:00	145701
2025-10-29 20:00	118868
2025-10-29 21:00	109251
2025-10-29 22:00	84321
2025-10-29 23:00	98466
2025-10-30 00:00	106190
2025-10-30 01:00	100538
2025-10-30 02:00	97021
2025-10-30 03:00	110050
2025-10-30 04:00	111186
2025-10-30 05:00	130467
2025-10-30 06:00	149941
2025-10-30 07:00	108682
2025-10-30 08:00	97940
2025-10-30 09:00	110282
2025-10-30 10:00	104729
2025-10-30 11:00	122543
2025-10-30 12:00	119996
2025-10-30 13:00	111904
2025-10-30 14:00	196628
2025-10-30 15:00	125159
2025-10-30 16:00	175880
2025-10-30 17:00	118155
2025-10-30 18:00	138753
2025-10-30 19:00	100104
2025-10-30 20:00	127812
2025-10-30 21:00	100076
2025-10-30 22:00	114689
2025-10-30 23:00	127254
2025-10-31 00:00	80496
2025-10-31 01:00	61898
2025-10-31 02:00	124703
2025-10-31 03:00	100835
2025-10-31 04:00	148458
2025-10-31 05:00	65157
2025-10-31 06:00	106914
2025-10-31 07:00	96164
2025-10-31 08:00	134535
2025-10-31 09:00	80837
2025-10-31 10:00	78823
2025-10-31 11:00	132500
2025-10-31 12:00	141168
2025-10-31 13:00	64622
2025-10-31 14:00	132462
2025-10-31 15:00	99016
2025-10-31 16:00	53011
2025-10-31 17:00	122028
2025-10-31 18:00	154994
2025-10-31 19:00	178171
2025-10-31 20:00	78258
2025-10-31 21:00	138665
2025-10-31 22:00	63608
2025-10-31 23:00	91298
2025-11-01 00:00	79954
2025-11-01 01:00	74134
2025-11-01 02:00	65830
2025-11-01 03:00	82771
2025-11-01 04:00	71980
2025-11-01 05:00	75703
2025-11-01 06:00	43604
2025-11-01 07:00	83060
2025-11-01 08:00	72799
2025-11-01 09:00	93362
2025-11-01 10:00	44121
2025-11-01 11:00	52376
2025-11-01 12:00	70817
2025-11-01 13:00	79687
2025-11-01 14:00	49579
2025-11-01 15:00	95346
2025-11-04 18:00	23373
2025-11-04 19:00	25777
2025-11-04 20:00	1059
2025-11-06 18:00	39117
2025-11-06 19:00	4983
2025-11-06 20:00	6617
2025-11-07 16:00	51233
2025-11-07 17:00	101508
2025-11-07 18:00	58699
2025-11-07 19:00	22625
2025-11-07 20:00	6018
2025-11-08 17:00	30963
2025-11-08 18:00	59258
2025-11-08 19:00	9046
2025-11-09 07:00	30477
2025-11-09 08:00	15800
2025-11-09 09:00	XXX
2025-11-09 17:00	36587
2025-11-09 18:00	13586
2025-11-09 19:00	1885
2025-11-10 13:00	29617
2025-11-10 14:00	3406
2025-11-10 17:00	36354
2025-11-10 18:00	16467
2025-11-10 19:00	5213
2025-11-11 17:00	73766
2025-11-11 18:00	25843
2025-11-11 19:00	5986
2025-11-13 21:00	38369
2025-11-13 22:00	8224
2025-11-13 23:00	3314
2025-11-15 00:00	26464
2025-11-15 01:00	17642
2025-11-15 02:00	XXX
2025-11-16 00:00	37689
2025-11-16 01:00	2789
2025-11-16 02:00	XXX
2025-11-17 00:00	30480
2025-11-17 01:00	XXX
2025-11-17 19:00	65589
2025-11-17 20:00	27419
2025-11-17 21:00	2062
2025-11-17 22:00	28465
2025-11-17 23:00	21251
2025-11-18 00:00	5207
2025-11-18 01:00	XXX
2025-11-19 00:00	418930
2025-11-19 01:00	2892
2025-11-19 18:00	177172
2025-11-19 19:00	5013
2025-11-19 20:00	XXX
2025-11-20 01:00	36939
2025-11-20 02:00	6454
2025-11-20 03:00	XXX
2025-11-20 13:00	37567
2025-11-20 14:00	11697
2025-11-20 15:00	1136
2025-11-21 01:00	35002
2025-11-21 02:00	20157
2025-11-21 03:00	XXX
2025-11-23 01:00	24597
2025-11-23 02:00	3983
2025-11-23 03:00	4744
2025-11-24 09:00	24315
2025-11-24 10:00	7699
2025-11-24 11:00	XXX
2025-11-25 01:00	29559
2025-11-25 02:00	7834
2025-11-25 03:00	XXX
2025-11-26 02:00	30066
2025-11-26 03:00	7460
2025-11-26 04:00	XXX
2025-11-28 01:00	27713
2025-11-28 02:00	15587
2025-11-28 03:00	XXX
2025-11-29 00:00	XX
2025-11-29 01:00	XX
2025-11-29 02:00	XX
2025-11-29 03:00	XX
2025-11-29 04:00	XX
2025-11-29 05:00	XX
2025-11-29 06:00	X
2025-11-29 07:00	XX
2025-11-29 08:00	XX
2025-11-29 09:00	XXX
2025-11-29 10:00	XX
2025-11-29 11:00	XX
2025-11-30 06:00	45475
2025-11-30 07:00	4760
2025-11-30 08:00	XX
2025-12-01 02:00	17993
2025-12-01 03:00	3464
2025-12-01 04:00	XXX
2025-12-02 03:00	26261
2025-12-02 04:00	4007
2025-12-02 05:00	XXX
2025-12-03 09:00	30883
2025-12-03 10:00	4688
2025-12-03 11:00	1707
2025-12-04 04:00	73068
2025-12-04 05:00	5310
2025-12-04 06:00	2081
2025-12-06 03:00	117287
2025-12-06 04:00	161870
2025-12-06 05:00	36185
2025-12-06 06:00	2337
2025-12-08 01:00	95418
2025-12-08 02:00	66534
2025-12-08 03:00	1337
2025-12-09 17:00	88588
2025-12-09 18:00	13003
2025-12-09 19:00	1494
2025-12-10 02:00	57683
2025-12-10 03:00	3682
2025-12-10 04:00	XXX
2025-12-10 10:00	65127
2025-12-10 11:00	8728
2025-12-10 12:00	9841

### 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": 302315,
      "num_posts": 302315,
      "interactions_24h": 3766865315
    }
  ]
}
```

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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1763424000,
    "end": 1764115200,
    "bucket": "hour",
    "metrics": [],
    "generated": 1764112845
  },
  "data": [
    {
      "time": 1763424000,
      "alt_rank": 150,
      "circulating_supply": 19950215,
      "close": 91913,
      "galaxy_score": 53,
      "high": 91913,
      "low": 91161.89,
      "market_cap": 1831844921030,
      "market_dominance": 58.7325,
      "open": 91913,
      "social_dominance": 37.7476,
      "volume_24h": 94214589868,
      "contributors_active": 31448,
      "contributors_created": 2314,
      "interactions": 5075541,
      "posts_active": 61441,
      "posts_created": 3505,
      "sentiment": 75,
      "spam": 5990
    }
  ]
}
```

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)
+ **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
+ **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




---

### 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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1763424000,
    "end": 1764115200,
    "bucket": "hour",
    "metrics": [],
    "generated": 1764112845
  },
  "data": [
    {
      "time": 1763424000,
      "alt_rank": 150,
      "circulating_supply": 19950215,
      "close": 91913,
      "galaxy_score": 53,
      "high": 91913,
      "low": 91161.89,
      "market_cap": 1831844921030,
      "market_dominance": 58.7325,
      "open": 91913,
      "social_dominance": 37.7476,
      "volume_24h": 94214589868,
      "contributors_active": 31448,
      "contributors_created": 2314,
      "interactions": 5075541,
      "posts_active": 61441,
      "posts_created": 3505,
      "sentiment": 75,
      "spam": 5990
    }
  ]
}
```

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)
+ **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
+ **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




---

### 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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "generated": 1764112845
  },
  "data": [
    {
      "id": "t3_1p6nlzj",
      "post_type": "reddit-post",
      "post_title": "I hit a milestone 👏🪙",
      "post_link": "https://redd.it/1p6nlzj",
      "post_image": null,
      "post_created": 1764103889,
      "post_sentiment": 3,
      "creator_id": "reddit::t2_4ht48n2c",
      "creator_name": "MoistGameplays",
      "creator_display_name": "MoistGameplays",
      "creator_avatar": "https://i.redd.it/snoovatar/avatars/nftv2_bmZ0X2VpcDE1NToxMzdfZTY0YmI3ZGQwYTEzYWY2MjJlMGRlNjQ1NmQxYmJhZGM4ZDFlYzA5ZF8xNzY5Mw_rare_00fb7cc7-74a6-4af1-92bd-c2925e56abfa-headshot.png",
      "interactions_24h": 8580,
      "interactions_total": 8616
    }
  ]
}
```

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




---