[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.]

$api3x

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": 420430,
      "num_posts": 912873,
      "interactions_24h": 2912785759
    }
  ]
}

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": {
    "topic": "bitcoin",
    "generated": 1758826249
  },
  "summary": "Several major companies, including Google and Capital Group, are investing in Bitcoin and related technologies, indicating growing institutional interest. Additionally, various firms, such as Melanion Capital and Oranjebtc, are developing new Bitcoin treasury models and expanding their Bitcoin holdings. Meanwhile, regulatory developments, like the SEC's approval of a new crypto ETF, are also shaping the market."
}

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 $
generated: A unix timestamp (in seconds) when the data was generated to understand possibly stale data

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": 1758153600,
    "end": 1758833579,
    "bucket": "hour",
    "metrics": [],
    "generated": 1758826379
  },
  "data": [
    {
      "time": 1758153600,
      "contributors_active": 19736,
      "contributors_created": 892,
      "interactions": 4231195,
      "posts_active": 38896,
      "posts_created": 1187,
      "sentiment": 80,
      "spam": 6467,
      "alt_rank": 667,
      "circulating_supply": 19922378,
      "close": 116313.13,
      "galaxy_score": 52,
      "high": 116313.13,
      "low": 116188.8,
      "market_cap": 2318184308977,
      "market_dominance": 56.8449,
      "open": 116313.13,
      "social_dominance": 18.7344,
      "volume_24h": 63629830396
    }
  ]
}

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": 1758153600,
    "end": 1758833584,
    "bucket": "hour",
    "metrics": [],
    "generated": 1758826384
  },
  "data": [
    {
      "time": 1758153600,
      "contributors_active": 19736,
      "contributors_created": 892,
      "interactions": 4231195,
      "posts_active": 38896,
      "posts_created": 1187,
      "sentiment": 80,
      "spam": 6467,
      "alt_rank": 667,
      "circulating_supply": 19922378,
      "close": 116313.13,
      "galaxy_score": 52,
      "high": 116313.13,
      "low": 116188.8,
      "market_cap": 2318184308977,
      "market_dominance": 56.8449,
      "open": 116313.13,
      "social_dominance": 18.7344,
      "volume_24h": 63629830396
    }
  ]
}

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