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 contributors_active 2025-12-11 22:00 XX 2025-12-11 23:00 XX 2025-12-12 00:00 XX 2025-12-12 06:00 XX 2025-12-12 07:00 XX 2025-12-12 08:00 XX 2025-12-12 09:00 XX 2025-12-12 10:00 XXX 2025-12-12 11:00 XXX 2025-12-12 12:00 XXX 2025-12-12 13:00 XX 2025-12-12 14:00 XX 2025-12-12 15:00 XX 2025-12-12 16:00 XX 2025-12-12 17:00 XX 2025-12-12 18:00 XX 2025-12-12 19:00 XX 2025-12-12 20:00 XXX 2025-12-12 21:00 XXX 2025-12-12 22:00 XXX 2025-12-12 23:00 XXX 2025-12-13 00:00 XXX 2025-12-13 01:00 XXX 2025-12-13 02:00 XXX 2025-12-13 03:00 XX 2025-12-13 04:00 XX 2025-12-13 05:00 XX 2025-12-13 06:00 XX 2025-12-13 07:00 XXX 2025-12-13 08:00 XX 2025-12-13 09:00 XX 2025-12-13 14:00 XXX 2025-12-13 15:00 XX 2025-12-13 16:00 XX

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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1764806400,
    "end": 1765493023,
    "bucket": "hour",
    "metrics": [],
    "generated": 1765485823
  },
  "data": [
    {
      "time": 1764806400,
      "contributors_active": 23704,
      "contributors_created": 1429,
      "interactions": 2850530,
      "posts_active": 46702,
      "posts_created": 2732,
      "sentiment": 79,
      "spam": 5826,
      "alt_rank": 215,
      "circulating_supply": 19957250,
      "close": 93033,
      "galaxy_score": 53,
      "high": 93033,
      "low": 92735.28,
      "market_cap": 1856638537230,
      "market_dominance": 58.4039,
      "open": 93033,
      "social_dominance": 28.896,
      "volume_24h": 77427662033
    }
  ]
}

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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1764806400,
    "end": 1765493023,
    "bucket": "hour",
    "metrics": [],
    "generated": 1765485823
  },
  "data": [
    {
      "time": 1764806400,
      "contributors_active": 23704,
      "contributors_created": 1429,
      "interactions": 2850530,
      "posts_active": 46702,
      "posts_created": 2732,
      "sentiment": 79,
      "spam": 5826,
      "alt_rank": 215,
      "circulating_supply": 19957250,
      "close": 93033,
      "galaxy_score": 53,
      "high": 93033,
      "low": 92735.28,
      "market_cap": 1856638537230,
      "market_dominance": 58.4039,
      "open": 93033,
      "social_dominance": 28.896,
      "volume_24h": 77427662033
    }
  ]
}

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

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": 300754,
      "num_posts": 300754,
      "interactions_24h": 2980779418
    }
  ]
}

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 Whatsup

https://lunarcrush.com/api4/public/topic/:topic/whatsup/v1

Generate an AI summary of the hottest news and social posts for a specific topic

input parameters:

topic: Provide the topic to get a summary for. A topic must be all lower case and can only include letters, numbers, spaces, # and $. required

Example request:

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

Example response:

{
  "config": {
    "id": "bitcoin",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "topic": "bitcoin",
    "generated": 1765476931
  },
  "summary": "Bitcoin experienced a sharp drop below $XXXXXX following the FOMC meeting, attributed to profit-taking and leveraged long liquidations, despite some positive institutional interest.",
  "supportive": [
    {
      "title": "Institutional Adoption & Investment",
      "description": "Major financial institutions and influential figures are increasingly investing in and integrating Bitcoin, signaling growing mainstream acceptance and potential for future price appreciation.",
      "percent": XX
    }
  ],
  "critical": [
    {
      "title": "Regulatory Uncertainty & Scrutiny",
      "description": "Ongoing regulatory discussions and potential crackdowns by governments worldwide create uncertainty and pose risks to Bitcoin's adoption and market stability.",
      "percent": XX
    }
  ]
}

Schema:

config: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
id: LunarCrush internal ID for the asset
name: The full name of the asset
symbol: The symbol for the asset
topic: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
generated: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
supportive: An array of supportive themes with a title, description, and an estimate of the percent of the circulating conversations on social around this theme.
title: The case sensitive title of the topic or category
description: Explanation of the change and the potential impact
critical: An array of critical themes with a title, description, and an estimate of the percent of the circulating conversations on social around this theme.