[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	518243
2025-10-13 01:00	494845
2025-10-13 02:00	561155
2025-10-13 03:00	655089
2025-10-13 04:00	500660
2025-10-13 05:00	431565
2025-10-13 06:00	379019
2025-10-13 07:00	554399
2025-10-13 08:00	474365
2025-10-13 09:00	456888
2025-10-13 10:00	460009
2025-10-13 11:00	454797
2025-10-13 12:00	585780
2025-10-13 13:00	654103
2025-10-13 14:00	671510
2025-10-13 15:00	714108
2025-10-13 16:00	621247
2025-10-13 17:00	698908
2025-10-13 18:00	771227
2025-10-13 19:00	600849
2025-10-13 20:00	595608
2025-10-13 21:00	692035
2025-10-13 22:00	717564
2025-10-13 23:00	558771
2025-10-14 00:00	530197
2025-10-14 01:00	584995
2025-10-14 02:00	684910
2025-10-14 03:00	701419
2025-10-14 04:00	526176
2025-10-14 05:00	522729
2025-10-14 06:00	567685
2025-10-14 07:00	524717
2025-10-14 08:00	424417
2025-10-14 09:00	393996
2025-10-14 10:00	353486
2025-10-14 11:00	552489
2025-10-14 12:00	501205
2025-10-14 13:00	439840
2025-10-14 14:00	501547
2025-10-14 15:00	605630
2025-10-14 16:00	760122
2025-10-14 17:00	739037
2025-10-14 18:00	577451
2025-10-14 19:00	596954
2025-10-14 20:00	898893
2025-10-14 21:00	701050
2025-10-14 22:00	438927
2025-10-14 23:00	483686
2025-10-15 00:00	658687
2025-10-15 01:00	583036
2025-10-15 02:00	465169
2025-10-15 03:00	502170
2025-10-15 04:00	604848
2025-10-15 05:00	661302
2025-10-15 06:00	440952
2025-10-15 07:00	374338
2025-10-15 08:00	519179
2025-10-15 09:00	559562
2025-10-15 10:00	545346
2025-10-15 11:00	514333
2025-10-15 12:00	384113
2025-10-15 13:00	998726
2025-10-15 14:00	868343
2025-10-15 15:00	771007
2025-10-15 16:00	684193
2025-10-15 17:00	786539
2025-10-15 18:00	784967
2025-10-15 19:00	691555
2025-10-15 20:00	642021
2025-10-15 21:00	720058
2025-10-15 22:00	603582
2025-10-15 23:00	820887
2025-10-16 00:00	509324
2025-10-16 01:00	523080
2025-10-16 02:00	675987
2025-10-16 03:00	750511
2025-10-16 04:00	618321
2025-10-16 05:00	622103
2025-10-16 06:00	620536
2025-10-16 07:00	471317
2025-10-16 08:00	425521
2025-10-16 09:00	539070
2025-10-16 10:00	522965
2025-10-16 11:00	517234
2025-10-16 12:00	589603
2025-10-16 13:00	570050
2025-10-16 14:00	658697
2025-10-16 15:00	640342
2025-10-16 16:00	687080
2025-10-16 17:00	534917
2025-10-16 18:00	694445
2025-10-16 19:00	575804
2025-10-16 20:00	603979
2025-10-16 21:00	503890
2025-10-16 22:00	696739
2025-10-16 23:00	507072
2025-10-17 00:00	475595
2025-10-17 01:00	514033
2025-10-17 02:00	649303
2025-10-17 03:00	508573
2025-10-17 04:00	535222
2025-10-17 05:00	531364
2025-10-17 06:00	572676
2025-10-17 07:00	500383
2025-10-17 08:00	443854
2025-10-17 09:00	460917
2025-10-17 10:00	535340
2025-10-17 11:00	560711
2025-10-17 12:00	607414
2025-10-17 13:00	552189
2025-10-17 14:00	589890
2025-10-17 15:00	597580
2025-10-17 16:00	696500
2025-10-17 17:00	704058
2025-10-17 18:00	629827
2025-10-17 19:00	690219
2025-10-17 20:00	622959
2025-10-17 21:00	538411
2025-10-17 22:00	531828
2025-10-17 23:00	631187
2025-10-18 00:00	650257
2025-10-18 01:00	499881
2025-10-18 02:00	527009
2025-10-18 03:00	638486
2025-10-18 04:00	584173
2025-10-18 05:00	487441
2025-10-18 06:00	442930
2025-10-18 07:00	521019
2025-10-18 08:00	496554
2025-10-18 09:00	445613
2025-10-18 10:00	375762
2025-10-18 11:00	459924
2025-10-18 12:00	544129
2025-10-18 13:00	603755
2025-10-18 14:00	497386
2025-10-18 15:00	507236
2025-10-18 16:00	873215
2025-10-18 17:00	698662
2025-10-18 18:00	615157
2025-10-18 19:00	523963
2025-10-18 20:00	673176
2025-10-18 21:00	652211
2025-10-18 22:00	460064
2025-10-18 23:00	411710
2025-10-19 00:00	478555
2025-10-19 01:00	603048
2025-10-19 02:00	558399
2025-10-19 03:00	483118
2025-10-19 04:00	542731
2025-10-19 05:00	583551
2025-10-19 06:00	451015
2025-10-19 07:00	534251
2025-10-19 08:00	388046
2025-10-19 09:00	509405
2025-10-19 10:00	511406
2025-10-19 11:00	392753
2025-10-19 12:00	409128
2025-10-19 13:00	640716
2025-10-19 14:00	672093
2025-10-19 15:00	428006
2025-10-19 16:00	458533
2025-10-19 17:00	692216
2025-10-19 18:00	671346
2025-10-19 19:00	586654
2025-10-19 20:00	384584
2025-10-19 21:00	61866
2025-10-19 22:00	277821
2025-10-19 23:00	185929

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




---