LunarCrush LLM | LunarCrush AI Interface

[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-12 00:00 377723 2025-10-12 01:00 460367 2025-10-12 02:00 452958 2025-10-12 03:00 396460 2025-10-12 04:00 405122 2025-10-12 05:00 413475 2025-10-12 06:00 327512 2025-10-12 07:00 266085 2025-10-12 08:00 338337 2025-10-12 09:00 334495 2025-10-12 10:00 316321 2025-10-12 11:00 408004 2025-10-12 12:00 333266 2025-10-12 13:00 614810 2025-10-12 14:00 603794 2025-10-12 15:00 466254 2025-10-12 16:00 464033 2025-10-12 17:00 534069 2025-10-12 18:00 615598 2025-10-12 19:00 605640 2025-10-12 20:00 448764 2025-10-12 21:00 448809 2025-10-12 22:00 385706 2025-10-12 23:00 404305 2025-10-13 00:00 357731 2025-10-13 01:00 361656 2025-10-13 02:00 323237 2025-10-13 03:00 326493 2025-10-13 04:00 295790 2025-10-13 05:00 212472 2025-10-13 06:00 195452 2025-10-13 07:00 203794 2025-10-13 08:00 154041 2025-10-13 09:00 200063 2025-10-13 10:00 95063 2025-10-13 11:00 286707 2025-10-13 12:00 236272 2025-10-13 13:00 235727 2025-10-13 14:00 238078 2025-10-13 15:00 322243 2025-10-13 16:00 303834 2025-10-13 17:00 281353 2025-10-13 18:00 235749 2025-10-13 19:00 321326 2025-10-13 20:00 247719 2025-10-13 21:00 236549 2025-10-13 22:00 221818 2025-10-13 23:00 205856 2025-10-14 00:00 242834 2025-10-14 01:00 201209 2025-10-14 02:00 182476 2025-10-14 03:00 170750 2025-10-14 04:00 180136 2025-10-14 05:00 139795 2025-10-14 06:00 127022 2025-10-14 07:00 113495 2025-10-14 08:00 88029 2025-10-14 09:00 84734 2025-10-14 10:00 80775 2025-10-14 11:00 91136 2025-10-14 12:00 80834 2025-10-14 13:00 115862 2025-10-14 14:00 100766 2025-10-14 15:00 107528 2025-10-14 16:00 122172 2025-10-14 17:00 125143 2025-10-14 18:00 116927 2025-10-14 19:00 150631 2025-10-14 20:00 120148 2025-10-14 21:00 138241 2025-10-14 22:00 158739 2025-10-14 23:00 137385 2025-10-15 00:00 154329 2025-10-15 01:00 124779 2025-10-15 02:00 182458 2025-10-15 03:00 150929 2025-10-15 04:00 137366 2025-10-15 05:00 116500 2025-10-15 06:00 94542 2025-10-15 07:00 100937 2025-10-15 08:00 95291 2025-10-15 09:00 108923 2025-10-15 10:00 93933 2025-10-15 11:00 102635 2025-10-15 12:00 82009 2025-10-15 13:00 161636 2025-10-15 14:00 144396 2025-10-15 15:00 123293 2025-10-15 16:00 135149 2025-10-15 17:00 143564 2025-10-15 18:00 122640 2025-10-15 19:00 166974 2025-10-15 20:00 206515 2025-10-15 21:00 236587 2025-10-15 22:00 182299 2025-10-15 23:00 172509 2025-10-16 00:00 200552 2025-10-16 01:00 196496 2025-10-16 02:00 245657 2025-10-16 03:00 267687 2025-10-16 04:00 231452 2025-10-16 05:00 214235 2025-10-16 06:00 321651 2025-10-16 07:00 227039 2025-10-16 08:00 149372 2025-10-16 09:00 198192 2025-10-16 10:00 204721 2025-10-16 11:00 219553 2025-10-16 12:00 173071 2025-10-16 13:00 244451 2025-10-16 14:00 185738 2025-10-16 15:00 199875 2025-10-16 16:00 215744 2025-10-16 17:00 337334 2025-10-16 18:00 433383 2025-10-16 19:00 275301 2025-10-16 20:00 461423 2025-10-16 21:00 395479 2025-10-16 22:00 352963 2025-10-16 23:00 466036 2025-10-17 00:00 335683 2025-10-17 01:00 278471 2025-10-17 02:00 559910 2025-10-17 03:00 396320 2025-10-17 04:00 512273 2025-10-17 05:00 385533 2025-10-17 06:00 297967 2025-10-17 07:00 275771 2025-10-17 08:00 208248 2025-10-17 09:00 204931 2025-10-17 10:00 244050 2025-10-17 11:00 332353 2025-10-17 12:00 307252 2025-10-17 13:00 367863 2025-10-17 14:00 434925 2025-10-17 15:00 391666 2025-10-17 16:00 466222 2025-10-17 17:00 399920 2025-10-17 18:00 495406 2025-10-17 19:00 10059 2025-10-17 20:00 XXX 2025-10-19 00:00 60834 2025-10-19 01:00 2189

Topics List

https://lunarcrush.com/api4/public/topics/list/v1

Get a list of trending social topics.

Example request:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topics/list/v1

Example response:

{
  "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:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v2

Example response:

{
  "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:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v1

Example response:

{
  "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:

curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/posts/v1

Example response:

{
  "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