[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-12-02 14:00	6208
2025-12-02 15:00	9204
2025-12-02 16:00	4571
2025-12-02 17:00	5452
2025-12-02 18:00	5401
2025-12-02 19:00	4670
2025-12-02 20:00	4281
2025-12-02 21:00	4352
2025-12-02 22:00	5188
2025-12-02 23:00	10449
2025-12-03 00:00	4524
2025-12-03 01:00	5302
2025-12-03 02:00	27592
2025-12-03 03:00	23079
2025-12-03 04:00	14962
2025-12-03 05:00	8996
2025-12-03 06:00	12603
2025-12-03 07:00	10702
2025-12-03 08:00	12543
2025-12-03 09:00	11170
2025-12-03 10:00	13652
2025-12-03 11:00	14908
2025-12-03 12:00	15030
2025-12-03 13:00	10789
2025-12-03 14:00	12703
2025-12-03 15:00	14628
2025-12-03 16:00	13832
2025-12-03 17:00	14033
2025-12-03 18:00	10834
2025-12-03 19:00	13504
2025-12-03 20:00	12725
2025-12-03 21:00	14091
2025-12-03 22:00	15700
2025-12-03 23:00	16348
2025-12-04 00:00	13474
2025-12-04 01:00	11641
2025-12-04 02:00	13910
2025-12-04 03:00	12058
2025-12-04 04:00	10043
2025-12-04 05:00	10283
2025-12-04 06:00	14475
2025-12-04 07:00	29014
2025-12-04 08:00	18308
2025-12-04 09:00	15689
2025-12-04 10:00	22408
2025-12-04 11:00	22388
2025-12-04 12:00	14919
2025-12-04 13:00	16452
2025-12-04 14:00	17185
2025-12-04 15:00	14411
2025-12-04 16:00	14939
2025-12-04 17:00	15800
2025-12-04 18:00	17022
2025-12-04 19:00	22594
2025-12-04 20:00	21828
2025-12-04 21:00	18968
2025-12-04 22:00	12661
2025-12-04 23:00	9586
2025-12-05 00:00	24983
2025-12-05 01:00	9705
2025-12-05 02:00	13934
2025-12-05 03:00	10340
2025-12-05 04:00	10500
2025-12-05 05:00	24865
2025-12-05 06:00	12141
2025-12-05 07:00	11702
2025-12-05 08:00	9098
2025-12-05 09:00	6974
2025-12-05 10:00	6160
2025-12-05 11:00	5900
2025-12-05 12:00	6425
2025-12-05 13:00	6661
2025-12-05 14:00	6784
2025-12-05 15:00	7227
2025-12-05 16:00	5932
2025-12-05 17:00	9158
2025-12-05 18:00	11178
2025-12-05 19:00	8226
2025-12-05 20:00	8580
2025-12-05 21:00	7459
2025-12-05 22:00	8533
2025-12-05 23:00	8058
2025-12-06 00:00	8010
2025-12-06 01:00	6342
2025-12-06 02:00	5606
2025-12-06 03:00	5377
2025-12-06 04:00	7010
2025-12-06 05:00	4259
2025-12-06 06:00	4701
2025-12-06 07:00	4060
2025-12-06 08:00	5430
2025-12-06 09:00	3529
2025-12-06 10:00	4666
2025-12-06 11:00	2729
2025-12-06 12:00	2846
2025-12-06 13:00	3246
2025-12-06 14:00	2531
2025-12-06 15:00	2218
2025-12-06 16:00	1867
2025-12-06 17:00	20005
2025-12-06 18:00	2300
2025-12-06 19:00	1829
2025-12-06 20:00	1691
2025-12-06 21:00	2209
2025-12-06 22:00	3348
2025-12-06 23:00	7362
2025-12-07 00:00	14932
2025-12-07 01:00	1317
2025-12-07 02:00	17986
2025-12-07 03:00	2987
2025-12-07 04:00	6551
2025-12-07 05:00	4766
2025-12-07 06:00	3458
2025-12-07 07:00	5128
2025-12-07 08:00	2113
2025-12-07 09:00	3923
2025-12-07 10:00	2716
2025-12-07 11:00	3775
2025-12-07 12:00	5325
2025-12-07 13:00	5907
2025-12-07 14:00	6811
2025-12-07 15:00	7731
2025-12-07 16:00	8172
2025-12-07 17:00	5396
2025-12-07 18:00	11669
2025-12-07 19:00	14112
2025-12-07 20:00	11771
2025-12-07 21:00	13780
2025-12-07 22:00	10792
2025-12-07 23:00	11217
2025-12-08 00:00	14042
2025-12-08 01:00	11124
2025-12-08 02:00	17201
2025-12-08 03:00	44810
2025-12-08 04:00	120419
2025-12-08 05:00	42741
2025-12-08 06:00	18138
2025-12-08 07:00	136339
2025-12-08 08:00	20149
2025-12-08 09:00	159869
2025-12-08 10:00	109677
2025-12-08 11:00	212635
2025-12-08 12:00	216424
2025-12-08 13:00	192126
2025-12-08 14:00	157621
2025-12-08 15:00	109527
2025-12-08 16:00	102272
2025-12-08 17:00	108088
2025-12-08 18:00	86639
2025-12-08 19:00	120560
2025-12-08 20:00	103574
2025-12-08 21:00	92301
2025-12-08 22:00	107404
2025-12-08 23:00	77004
2025-12-09 00:00	62818
2025-12-09 01:00	55476
2025-12-09 02:00	44878
2025-12-09 03:00	35030
2025-12-09 04:00	34866
2025-12-09 05:00	36508
2025-12-09 06:00	25384
2025-12-09 07:00	40901
2025-12-09 08:00	32759
2025-12-09 09:00	37794
2025-12-09 10:00	49504
2025-12-09 11:00	64023
2025-12-09 12:00	170259
2025-12-09 13:00	81451
2025-12-09 14:00	75538
2025-12-09 15:00	101293
2025-12-09 16:00	72728
2025-12-09 17:00	121924
2025-12-09 18:00	74176
2025-12-09 19:00	76565
2025-12-09 20:00	68122
2025-12-09 21:00	69608
2025-12-09 22:00	50912
2025-12-09 23:00	19139
2025-12-10 00:00	43229
2025-12-10 01:00	37450
2025-12-10 02:00	34431
2025-12-10 03:00	39696
2025-12-10 04:00	28820
2025-12-10 05:00	24891
2025-12-10 06:00	39630
2025-12-10 07:00	21203
2025-12-10 08:00	19718
2025-12-10 09:00	28734
2025-12-10 10:00	19738
2025-12-10 11:00	34299
2025-12-10 12:00	25474
2025-12-10 13:00	28752

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




---