[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-13 00:00	1880
2025-10-13 01:00	1582
2025-10-13 02:00	2526
2025-10-13 03:00	2097
2025-10-13 04:00	1924
2025-10-13 05:00	2527
2025-10-13 06:00	1878
2025-10-13 07:00	2005
2025-10-13 08:00	3232
2025-10-13 09:00	3904
2025-10-13 10:00	2230
2025-10-13 11:00	2470
2025-10-13 12:00	3200
2025-10-13 13:00	5148
2025-10-13 14:00	4024
2025-10-13 15:00	2473
2025-10-13 16:00	5018
2025-10-13 17:00	5325
2025-10-13 18:00	3476
2025-10-13 19:00	2795
2025-10-13 20:00	2442
2025-10-13 21:00	2580
2025-10-13 22:00	1871
2025-10-13 23:00	2309
2025-10-14 00:00	3260
2025-10-14 01:00	2295
2025-10-14 02:00	2038
2025-10-14 03:00	2576
2025-10-14 04:00	2816
2025-10-14 05:00	2759
2025-10-14 06:00	1940
2025-10-14 07:00	1970
2025-10-14 08:00	2406
2025-10-14 09:00	2142
2025-10-14 10:00	2149
2025-10-14 11:00	6734
2025-10-14 12:00	3326
2025-10-14 13:00	3518
2025-10-14 14:00	2798
2025-10-14 15:00	2365
2025-10-14 16:00	3653
2025-10-14 17:00	2467
2025-10-14 18:00	2508
2025-10-14 19:00	2063
2025-10-14 20:00	2445
2025-10-14 21:00	2411
2025-10-14 22:00	1486
2025-10-14 23:00	2486
2025-10-15 00:00	2020
2025-10-15 01:00	1994
2025-10-15 02:00	2015
2025-10-15 03:00	6687
2025-10-15 04:00	3814
2025-10-15 05:00	1522
2025-10-15 06:00	1019
2025-10-15 07:00	1634
2025-10-15 08:00	3953
2025-10-15 09:00	2028
2025-10-15 10:00	1764
2025-10-15 11:00	3208
2025-10-15 12:00	1900
2025-10-15 13:00	3174
2025-10-15 14:00	2309
2025-10-15 15:00	1884
2025-10-15 16:00	2200
2025-10-15 17:00	2768
2025-10-15 18:00	3096
2025-10-15 19:00	1971
2025-10-15 20:00	2431
2025-10-15 21:00	7194
2025-10-15 22:00	2204
2025-10-15 23:00	1604
2025-10-16 00:00	1568
2025-10-16 01:00	1560
2025-10-16 02:00	1294
2025-10-16 03:00	1029
2025-10-16 04:00	1147
2025-10-16 05:00	1576
2025-10-16 06:00	1906
2025-10-16 07:00	1221
2025-10-16 08:00	1071
2025-10-16 09:00	2187
2025-10-16 10:00	1396
2025-10-16 11:00	1853
2025-10-16 12:00	1435
2025-10-16 13:00	1605
2025-10-16 14:00	1907
2025-10-16 15:00	2091
2025-10-16 16:00	2053
2025-10-16 17:00	1832
2025-10-16 18:00	2290
2025-10-16 19:00	1793
2025-10-16 20:00	1543
2025-10-16 21:00	1047
2025-10-16 22:00	1902
2025-10-16 23:00	1494
2025-10-17 00:00	1183
2025-10-17 01:00	XXX
2025-10-17 02:00	1284
2025-10-17 03:00	1508
2025-10-17 04:00	1304
2025-10-17 05:00	1185
2025-10-17 06:00	1612
2025-10-17 07:00	1641
2025-10-17 08:00	1033
2025-10-17 09:00	1199
2025-10-17 10:00	1499
2025-10-17 11:00	1954
2025-10-17 12:00	1479
2025-10-17 13:00	1462
2025-10-17 14:00	1716
2025-10-17 15:00	2254
2025-10-17 16:00	1990
2025-10-17 17:00	2227
2025-10-17 18:00	1856
2025-10-17 19:00	2525
2025-10-17 20:00	2095
2025-10-17 21:00	1073
2025-10-17 22:00	1392
2025-10-17 23:00	1424
2025-10-18 00:00	1406
2025-10-18 01:00	XXX
2025-10-18 02:00	1757
2025-10-18 03:00	2076
2025-10-18 04:00	1933
2025-10-18 05:00	1644
2025-10-18 06:00	2028
2025-10-18 07:00	2840
2025-10-18 08:00	2055
2025-10-18 09:00	2192
2025-10-18 10:00	3629
2025-10-18 11:00	1872
2025-10-18 12:00	3352
2025-10-18 13:00	3577
2025-10-18 14:00	2926
2025-10-18 15:00	3816
2025-10-18 16:00	2419
2025-10-18 17:00	2542
2025-10-18 18:00	2917
2025-10-18 19:00	2515
2025-10-18 20:00	3378
2025-10-18 21:00	4424
2025-10-18 22:00	5266
2025-10-18 23:00	4470
2025-10-19 00:00	4418
2025-10-19 01:00	5501
2025-10-19 02:00	4038
2025-10-19 03:00	4640
2025-10-19 04:00	5606
2025-10-19 05:00	5674
2025-10-19 06:00	5768
2025-10-19 07:00	6909
2025-10-19 08:00	5903
2025-10-19 09:00	6282
2025-10-19 10:00	13271
2025-10-19 11:00	5498
2025-10-19 12:00	7089
2025-10-19 13:00	11109
2025-10-19 14:00	10704
2025-10-19 15:00	9229
2025-10-19 16:00	9025
2025-10-19 17:00	20548
2025-10-19 18:00	15459
2025-10-19 19:00	15064
2025-10-19 20:00	10106
2025-10-19 21:00	11679
2025-10-19 22:00	7861
2025-10-19 23:00	36493
2025-10-20 00:00	7822
2025-10-20 01:00	7072
2025-10-20 02:00	10536
2025-10-20 03:00	11891
2025-10-20 04:00	13103
2025-10-20 05:00	9080
2025-10-20 06:00	8202
2025-10-20 07:00	8272
2025-10-20 08:00	10763
2025-10-20 09:00	16360
2025-10-20 10:00	23801
2025-10-20 11:00	XXX
2025-10-20 12:00	24602
2025-10-20 13:00	XXX
2025-10-20 14: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": 335952,
      "num_posts": 733220,
      "interactions_24h": 3296046298
    }
  ]
}
```

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": 1759968000,
    "end": 1760654918,
    "bucket": "hour",
    "metrics": [],
    "generated": 1760647718
  },
  "data": [
    {
      "time": 1759968000,
      "contributors_active": 30745,
      "contributors_created": 1810,
      "interactions": 3972578,
      "posts_active": 62957,
      "posts_created": 2440,
      "sentiment": 78,
      "spam": 339,
      "alt_rank": 198,
      "circulating_supply": 19931834,
      "close": 123004.71,
      "galaxy_score": 56,
      "high": 123004.71,
      "low": 122931.87,
      "market_cap": 2453542301616,
      "market_dominance": 58.0797,
      "open": 123004.71,
      "social_dominance": 30.3039,
      "volume_24h": 62979418928
    }
  ]
}
```

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": 1759968000,
    "end": 1760654918,
    "bucket": "hour",
    "metrics": [],
    "generated": 1760647718
  },
  "data": [
    {
      "time": 1759968000,
      "contributors_active": 30745,
      "contributors_created": 1810,
      "interactions": 3972578,
      "posts_active": 62957,
      "posts_created": 2440,
      "sentiment": 78,
      "spam": 339,
      "alt_rank": 198,
      "circulating_supply": 19931834,
      "close": 123004.71,
      "galaxy_score": 56,
      "high": 123004.71,
      "low": 122931.87,
      "market_cap": 2453542301616,
      "market_dominance": 58.0797,
      "open": 123004.71,
      "social_dominance": 30.3039,
      "volume_24h": 62979418928
    }
  ]
}
```

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": 1760647718
  },
  "data": [
    {
      "id": "t3_1o7u058",
      "post_type": "reddit-post",
      "post_title": "Made this bitcoin shadow box. Not sure if I'm crazy about this design but it's something",
      "post_link": "https://redd.it/1o7u058",
      "post_image": null,
      "post_created": 1760646307,
      "post_sentiment": 3.2,
      "creator_id": "reddit::t2_kszqkqvk",
      "creator_name": "Outrageous-Garage179",
      "creator_display_name": "Outrageous-Garage179",
      "creator_avatar": "https://styles.redditmedia.com/t5_60m8fu/styles/profileIcon_63j7drb563fa1.png?width=256&height=256&crop=256:256,smart&s=9b79b5074a344e0e8cf39a127dcfa5c2f4b5ecf3",
      "interactions_24h": 1683,
      "interactions_total": 1683
    }
  ]
}
```

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




---