This documentation is available as JSON, OpenAPI v3, and markdown.
Base URL: https://lunarcrush.com/api4
Authentication: https://lunarcrush.com/developers/api/authentication
Available Endpoints:
Topics
Topics List
Topic Whatsup
Topic
Topic Time Series v2
Topic Time Series
Topic Posts
Topic News
Topic Creators
Categories
Category
Category Topics
Category Time Series
Category Posts
Category News
Category Creators
Categories List
Creators
Creators List
Creator
Creator Time Series
Creator Posts
Posts
Posts
Posts Time Series
Coins
Coins List v2
Coins List
Coins
Coins Time Series
Coins Meta
Stocks
Stocks List v2
Stocks List
Stocks
Stocks Time Series
Searches
Searches Search
Searches List
Searches Create
Searches Update
Searches Delete
Searches
Systems
System Changes
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", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"title": "YouTube", // The case sensitive title of the topic or category
"topic_rank": 1, // LunarCrush metric for ranking a social topic relative to all other social topics
"topic_rank_1h_previous": 1, // The topic rank from 1 hour ago
"topic_rank_24h_previous": 1, // The topic rank from 24 hours ago
"num_contributors": 302979, // The number of unique social contributors to the topic
"num_posts": 706422, // Total number of posts with interactions on this topic in the last 24 hours
"interactions_24h": 3814252218 // Number of interactions in the last 24 hours
}
]
}
Schema:
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:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/whatsup/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"id": "bitcoin", // LunarCrush internal ID for the asset
"_self_call": true,
"name": "Bitcoin", // The full name of the asset
"symbol": "BTC", // The symbol for the asset
"topic": "bitcoin", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"generated": 1781443945 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"summary": "Bitcoin holds a 60k floor as regulators hint at upside into the mid-60k range. Macro liquidity risks keep BTC range-bound around the 60k mark.",
"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": "BTC 60k Floor Holds", // The case sensitive title of the topic or category
"description": "Bitcoin defends the $60k level with robust on-chain demand anchoring the price floor, suggesting a potential move toward mid-$60k if policy clarity improves.", // Explanation of the change and the potential impact
"percent": 39.6
}
],
"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.
{
"title": "Policy Clarity Risk Caps Upside", // The case sensitive title of the topic or category
"description": "Unclear or ambiguous regulatory guidance could keep BTC range-bound and cap any upside until direction is clarified.", // Explanation of the change and the potential impact
"percent": 11
}
]
}
Schema:
https://lunarcrush.com/api4/public/topic/:topic/v1
Get summary information for a social topic. The output is a 24 hour aggregation social activity with metrics comparing the latest 24 hours to the previous 24 hours.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"id": "bitcoin", // LunarCrush internal ID for the asset
"_self_call": true,
"name": "Bitcoin", // The full name of the asset
"symbol": "BTC", // The symbol for the asset
"topic": "bitcoin", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"generated": 1781447089 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": {
"topic": "bitcoin", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"title": "Bitcoin", // The case sensitive title of the topic or category
"topic_rank": 218, // LunarCrush metric for ranking a social topic relative to all other social topics
"related_topics": [ // an array of related topics
"coins pow"
],
"types_count": { // An object with the counts of the total number of unique posts getting interactions from each social network in the last 24 hours
"tiktok-video": 10242,
"reddit-post": 661,
"instagram-post": 159,
"news": 283,
"tweet": 75729,
"youtube-video": 13723
},
"types_interactions": { // An object with the counts of the total number of interactions on each post from each social network in the last 24 hours
"tiktok-video": 7428787,
"reddit-post": 113247,
"instagram-post": 146673,
"news": 331558,
"tweet": 54103459,
"youtube-video": 24077525
},
"types_sentiment": { // An object with the sentiment score broken down by each supported social network. 0% is all posts negative, 100% is all posts positive. 50% is equal positive and negative posts. Each post is weighted by interactions.
"tiktok-video": 72,
"reddit-post": 77,
"news": 75,
"tweet": 79,
"youtube-video": 84
},
"types_sentiment_detail": { // An object with the breakdown of positive, neutral, and negative posts by 24h interactions for each social network
"tiktok-video": {
"negative": 1678,
"neutral": 6236,
"positive": 2328
},
"reddit-post": {
"negative": 119,
"neutral": 341,
"positive": 201
},
"instagram-post": {
"negative": 28,
"neutral": 104,
"positive": 27
},
"news": {
"negative": 55,
"neutral": 143,
"positive": 85
},
"tweet": {
"negative": 11100,
"neutral": 34625,
"positive": 30004
},
"youtube-video": {
"negative": 1435,
"neutral": 8036,
"positive": 4252
}
},
"interactions_24h": 86201249, // Number of interactions in the last 24 hours
"num_contributors": 40863, // The number of unique social contributors to the topic
"num_posts": 100797, // Total number of posts with interactions on this topic in the last 24 hours
"categories": [ // an array of categories this topic aggregates into
"Cryptocurrencies"
],
"trend": "down" // One of up, down or flat to represent the general trend in interactions
}
}
Schema:
https://lunarcrush.com/api4/public/topic/:topic/time-series/v2
Get historical time series data for a social topic
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v2
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"topic": "bitcoin", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"id": "bitcoin", // LunarCrush internal ID for the asset
"_self_call": true,
"name": "Bitcoin", // The full name of the asset
"symbol": "BTC", // The symbol for the asset
"interval": "1w", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc
"start": 1780790400, // Start/from unix timestamp (in seconds)
"end": 1781454289, // End/to unix timestamp (in seconds)
"bucket": "hour", // Data is generally bucketed into hours or days
"metrics": [], // Comma separated list of metrics to include or that are included
"generated": 1781447089 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"time": 1780790400, // A unix timestamp (in seconds)
"alt_rank": 210, // A proprietary score based on how an asset is performing relative to all other assets supported
"circulating_supply": 20039087, // 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": 60771, // Close price for the time period
"galaxy_score": 47, // 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": 60771, // Higest price fo rthe time period
"low": 60684, // Lowest price for the time period
"market_cap": 1217425063449, // Total dollar market value of all circulating supply or outstanding shares
"market_dominance": 58.0952, // The percent of the total market cap that this asset represents
"open": 60684, // Open price for the time period
"social_dominance": 29.7652, // The percent of the total social volume that this topic represents
"volume_24h": 31052912261, // Volume in USD for 24 hours up to this data point
"contributors_active": 63813, // number of unique social accounts with posts that have interactions
"contributors_created": 1062, // number of unique social accounts that created new posts
"interactions": 5479229, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)
"posts_active": 130589, // number of unique social posts with interactions
"posts_created": 2067, // number of unique social posts created
"sentiment": 65, // % of posts (weighted by interactions) that are positive. 100% means all posts are positive, 50% is half positive and half negative, and 0% is all negative posts.
"spam": 9390 // The number of posts created that are considered spam
}
]
}
Schema:
https://lunarcrush.com/api4/public/topic/:topic/time-series/v1
Get historical time series data for a social topic
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"topic": "bitcoin", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"id": "bitcoin", // LunarCrush internal ID for the asset
"_self_call": true,
"name": "Bitcoin", // The full name of the asset
"symbol": "BTC", // The symbol for the asset
"interval": "1w", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc
"start": 1780790400, // Start/from unix timestamp (in seconds)
"end": 1781454289, // End/to unix timestamp (in seconds)
"bucket": "hour", // Data is generally bucketed into hours or days
"metrics": [], // Comma separated list of metrics to include or that are included
"generated": 1781447089 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"time": 1780790400, // A unix timestamp (in seconds)
"alt_rank": 210, // A proprietary score based on how an asset is performing relative to all other assets supported
"circulating_supply": 20039087, // 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": 60771, // Close price for the time period
"galaxy_score": 47, // 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": 60771, // Higest price fo rthe time period
"low": 60684, // Lowest price for the time period
"market_cap": 1217425063449, // Total dollar market value of all circulating supply or outstanding shares
"market_dominance": 58.0952, // The percent of the total market cap that this asset represents
"open": 60684, // Open price for the time period
"social_dominance": 29.7652, // The percent of the total social volume that this topic represents
"volume_24h": 31052912261, // Volume in USD for 24 hours up to this data point
"contributors_active": 63813, // number of unique social accounts with posts that have interactions
"contributors_created": 1062, // number of unique social accounts that created new posts
"interactions": 5479229, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)
"posts_active": 130589, // number of unique social posts with interactions
"posts_created": 2067, // number of unique social posts created
"sentiment": 65, // % of posts (weighted by interactions) that are positive. 100% means all posts are positive, 50% is half positive and half negative, and 0% is all negative posts.
"spam": 9390 // The number of posts created that are considered spam
}
]
}
Schema:
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 24 hours.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/posts/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"topic": "bitcoin", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"type": "topic", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
"id": "bitcoin", // Unique id of the social post
"_self_call": true,
"name": "Bitcoin", // The full name of the asset
"symbol": "BTC", // The symbol for the asset
"generated": 1781447089 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"id": "2066140826430824823", // Unique id of the social post
"post_type": "tweet", // The type of social post
"post_title": "JUST IN: Michael Saylor hints at buying more Bitcoin. \n\"Still adding dots.\"", // The title text of the social post
"post_link": "https://x.com/WatcherGuru/status/2066140826430824823", // The URL to view the social post on the social network
"post_created": 1781441334, // The unix timestamp of our best indication of when the post was created
"post_sentiment": 3, // The sentiment of the post is a score between 1 and 5 with 1 being very negative, 3 being neutral, and 5 being very positive. A score of 3.5 is considered slightly positive.
"creator_id": "twitter::1387497871751196672", // The [network]::[unique_id] for the influencer
"creator_name": "WatcherGuru", // The unique screen name for the influencer
"creator_display_name": "Watcher.Guru", // The chosen display name for the influencer if available
"creator_followers": 4275618, // number of followers the account has
"creator_avatar": "https://pbs.twimg.com/profile_images/1641221212578754562/DfiC0KW2_200x200.png", // The URL to the avatar for the creator
"interactions_24h": 85072, // Number of interactions in the last 24 hours
"interactions_total": 85072, // Number of total interactions
"post_image": "https://pbs.twimg.com/media/HKxoIH_aAAAFe2g.jpg" // The URL to the primary image for the post if available
}
]
}
Schema:
https://lunarcrush.com/api4/public/topic/:topic/news/v1
Get the top news posts for a social topic. Top news is determined by the metrics related to the social posts that mention the news posts.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/news/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"topic": "bitcoin", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"type": "topic", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
"id": "bitcoin", // LunarCrush internal ID for the asset
"name": "Bitcoin", // The full name of the asset
"symbol": "BTC", // The symbol for the asset
"generated": 1781447089 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"id": "news.bitcoin.com-1828443641", // LunarCrush internal ID for the asset
"post_type": "news", // The type of social post
"post_title": "BTC Momentum Turns Positive as Bitcoin Fights to Hold the $64,000 Zone", // The title text of the social post
"post_description": "Bitcoin trades at $64,549 on June 14 with bearish MA signals, neutral oscillators, and bullish 1H and 4H chart structure.", // The larger text description or body of the social post if available
"post_link": "https://news.bitcoin.com/btc-momentum-turns-positive-as-bitcoin-fights-to-hold-the-64000-zone/", // The URL to view the social post on the social network
"post_created": 1781440329, // The unix timestamp of our best indication of when the post was created
"post_sentiment": 3, // The sentiment of the post is a score between 1 and 5 with 1 being very negative, 3 being neutral, and 5 being very positive. A score of 3.5 is considered slightly positive.
"creator_id": "twitter::3367334171", // The [network]::[unique_id] for the influencer
"creator_name": "BitcoinNews", // The unique screen name for the influencer
"creator_display_name": "Bitcoin.com News", // The chosen display name for the influencer if available
"creator_followers": 3275076, // number of followers the account has
"creator_avatar": "https://pbs.twimg.com/profile_images/1917825669825966080/2bAp4kVv_200x200.jpg", // The URL to the avatar for the creator
"interactions_24h": 1498, // Number of interactions in the last 24 hours
"interactions_total": 1498, // Number of total interactions
"post_image": "https://static.news.bitcoin.com/wp-content/uploads/2026/06/btc-momentum-turns-positive-as-bitcoin-fights-to-hold-the-64000-zone_nwmk.png" // The URL to the primary image for the post if available
}
]
}
Schema:
https://lunarcrush.com/api4/public/topic/:topic/creators/v1
Get the top creators for a social topic
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/creators/v1
Example response:
{
"data": [
{
"creator_id": "youtube::UCObE3J0qQ0DzcouV1w4DlGg", // The [network]::[unique_id] for the influencer
"creator_name": "bitcoinliveyt", // The unique screen name for the influencer
"creator_avatar": "https://yt3.ggpht.com/QKZNyoo-1_Iv2ganIMAflJIzvpfWGOADpKF40J6YLVIIz_E_TgCIKAxuYih2dGpbKggly4yq=s88-c-k-c0x00ffffff-no-rj", // The URL to the avatar for the creator
"creator_followers": 90800, // number of followers the account has
"creator_rank": 1, // ranking based on all posts in the last 24 hours that have interactions
"interactions_24h": 8078988 // Number of interactions in the last 24 hours
}
]
}
Schema:
https://lunarcrush.com/api4/public/category/:category/v1
Get summary information for a social category
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/category/musicians/v1
Example response:
{
"data": {
"topic": "_musicians", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"title": "Musicians", // The case sensitive title of the topic or category
"related_topics": [ // an array of related topics
"aerosmith"
],
"types_count": { // An object with the counts of the total number of unique posts getting interactions from each social network in the last 24 hours
"tiktok-video": 207956,
"instagram-post": 1806,
"reddit-post": 4982,
"youtube-video": 158441,
"news": 548,
"tweet": 204374
},
"types_interactions": { // An object with the counts of the total number of interactions on each post from each social network in the last 24 hours
"tiktok-video": 1140048708,
"instagram-post": 43484710,
"reddit-post": 2218806,
"youtube-video": 1056332499,
"news": 3361291,
"tweet": 610227775
},
"types_sentiment": { // An object with the sentiment score broken down by each supported social network. 0% is all posts negative, 100% is all posts positive. 50% is equal positive and negative posts. Each post is weighted by interactions.
"youtube-video": 79,
"reddit-post": 72,
"tweet": 78,
"news": 95,
"tiktok-video": 83
},
"types_sentiment_detail": { // An object with the breakdown of positive, neutral, and negative posts by 24h interactions for each social network
"tiktok-video": {
"negative": 28857,
"neutral": 104078,
"positive": 75021
},
"instagram-post": {
"negative": 184,
"neutral": 973,
"positive": 649
},
"reddit-post": {
"negative": 743,
"neutral": 2246,
"positive": 1993
},
"youtube-video": {
"negative": 25648,
"neutral": 70011,
"positive": 62782
},
"news": {
"negative": 86,
"neutral": 175,
"positive": 287
},
"tweet": {
"negative": 33735,
"neutral": 98345,
"positive": 72294
}
},
"interactions_24h": 2855673789, // Number of interactions in the last 24 hours
"num_contributors": 303201, // The number of unique social contributors to the topic
"num_posts": 578107, // Total number of posts with interactions on this topic in the last 24 hours
"trend": "down" // One of up, down or flat to represent the general trend in interactions
}
}
Schema:
https://lunarcrush.com/api4/public/category/:category/topics/v1
Get the top topics for a social category
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/category/musicians/topics/v1
Example response:
{
"data": [
{
"topic": 3038, // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"title": "Aerosmith", // The case sensitive title of the topic or category
"topic_rank": 2169, // LunarCrush metric for ranking a social topic relative to all other social topics
"topic_rank_1h_previous": 2169, // The topic rank from 1 hour ago
"topic_rank_24h_previous": 2206, // The topic rank from 24 hours ago
"num_contributors": 1274, // The number of unique social contributors to the topic
"social_dominance": 0.06927307497885654, // The percent of the total social volume that this topic represents
"num_posts": 2163, // Total number of posts with interactions on this topic in the last 24 hours
"interactions_24h": 1989447 // Number of interactions in the last 24 hours
}
]
}
Schema:
https://lunarcrush.com/api4/public/category/:category/time-series/v1
Get historical time series data for a social category
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/category/cryptocurrencies/time-series/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"category": "cryptocurrencies", // LunarCrush social category. Can only includes letters, numbers and spaces
"topic": "_cryptocurrencies", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"type": "topic", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
"id": "_cryptocurrencies", // LunarCrush internal ID for the asset
"interval": "1w", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc
"start": 1780790400, // Start/from unix timestamp (in seconds)
"end": 1781454290, // End/to unix timestamp (in seconds)
"bucket": "hour", // Data is generally bucketed into hours or days
"metrics": [], // Comma separated list of metrics to include or that are included
"generated": 1781447090 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"time": 1780790400, // A unix timestamp (in seconds)
"contributors_active": 154657, // number of unique social accounts with posts that have interactions
"contributors_created": 4115, // number of unique social accounts that created new posts
"interactions": 13238618, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)
"posts_active": 438730, // number of unique social posts with interactions
"posts_created": 11108, // number of unique social posts created
"sentiment": 70, // % of posts (weighted by interactions) that are positive. 100% means all posts are positive, 50% is half positive and half negative, and 0% is all negative posts.
"spam": 27194, // The number of posts created that are considered spam
"market_cap": 2095567529991, // Total dollar market value of all circulating supply or outstanding shares
"volume_24h": 82554271665 // Volume in USD for 24 hours up to this data point
}
]
}
Schema:
https://lunarcrush.com/api4/public/category/:category/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 24 hours.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/category/cryptocurrencies/posts/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"category": "cryptocurrencies", // LunarCrush social category. Can only includes letters, numbers and spaces
"type": "topic", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
"id": "_cryptocurrencies", // Unique id of the social post
"topic": "_cryptocurrencies", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"generated": 1781447090 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"id": "QUmH2GfpusY", // Unique id of the social post
"post_type": "youtube-video", // The type of social post
"post_title": "Promises Kept. Always.", // The title text of the social post
"post_description": "CZ (Changpeng Zhao)'s BNB holdings are substantial, representing the majority of his net worth, with reports from mid-2025 showing his personal stash valued in the tens of billions of dollars, potentially over $70 billion, as BNB tokens hit record highs, though exact figures are speculative due to private holdings, with estimates placing his stake in circulating supply as high as 64%. He confirmed in early 2025 that 98% of his portfolio was BNB, with only 1.32% Bitcoin, underscoring his significant, almost exclusive, bet on the native token of Binance.", // The larger text description or body of the social post if available
"post_created": 1781440725, // The unix timestamp of our best indication of when the post was created
"post_sentiment": 3.07, // The sentiment of the post is a score between 1 and 5 with 1 being very negative, 3 being neutral, and 5 being very positive. A score of 3.5 is considered slightly positive.
"creator_id": "youtube::UC7wrEJ5FtgLz4R-0_X8pkOw", // The [network]::[unique_id] for the influencer
"creator_name": "yzilabscn", // The unique screen name for the influencer
"creator_display_name": "YZi Labs", // The chosen display name for the influencer if available
"creator_followers": 119000, // number of followers the account has
"creator_avatar": "https://yt3.ggpht.com/unPWAoUCyyxRnNpHxXCozNd30CpkXKxx38UNAWsLsRZzE73HnfHeL94yxcBzHAncUEwXpUfx=s88-c-k-c0x00ffffff-no-rj", // The URL to the avatar for the creator
"interactions_24h": 50350, // Number of interactions in the last 24 hours
"interactions_total": 50350 // Number of total interactions
}
]
}
Schema:
https://lunarcrush.com/api4/public/category/:category/news/v1
Get the top news posts for a category. Top news is determined by the metrics related to the social posts that mention the news posts.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/category/cryptocurrencies/news/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"category": "cryptocurrencies", // LunarCrush social category. Can only includes letters, numbers and spaces
"type": "topic", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
"id": "_cryptocurrencies", // LunarCrush internal ID for the asset
"topic": "_cryptocurrencies", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"generated": 1781447090 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"id": "theguardian.com-622011072", // LunarCrush internal ID for the asset
"post_type": "news", // The type of social post
"post_title": "UFC to pay White House fighters in crypto issued by Trump company | Trump administration | The Guardian", // The title text of the social post
"post_description": "Some fighters will receive bonuses in ‘stablecoins’ issued by Trump family business World Liberty Financial", // The larger text description or body of the social post if available
"post_link": "https://www.theguardian.com/us-news/2026/jun/14/white-house-ufc-fighters-crypto", // The URL to view the social post on the social network
"post_image": "https://i.guim.co.uk/img/media/28981dac6963fc574a1b4e70dfd6d038be12464c/652_0_6523_5218/master/6523.jpg?width=1200&height=630&quality=85&auto=format&fit=crop&precrop=40:21,offset-x50,offset-y0&overlay-align=bottom%2Cleft&overlay-width=100p&overlay-base64=L2ltZy9zdGF0aWMvb3ZlcmxheXMvdGctZGVmYXVsdC5wbmc&enable=upscale&s=853365a0829c1712db887bee607da3b4", // The URL to the primary image for the post if available
"post_created": 1781440863, // The unix timestamp of our best indication of when the post was created
"post_sentiment": 2.94, // The sentiment of the post is a score between 1 and 5 with 1 being very negative, 3 being neutral, and 5 being very positive. A score of 3.5 is considered slightly positive.
"creator_id": "twitter::87818409", // The [network]::[unique_id] for the influencer
"creator_name": "guardian", // The unique screen name for the influencer
"creator_display_name": "The Guardian", // The chosen display name for the influencer if available
"creator_followers": 10467523, // number of followers the account has
"creator_avatar": "https://pbs.twimg.com/profile_images/1175141826870861825/K2qKoGla_200x200.png", // The URL to the avatar for the creator
"interactions_24h": 574, // Number of interactions in the last 24 hours
"interactions_total": 575 // Number of total interactions
}
]
}
Schema:
https://lunarcrush.com/api4/public/category/:category/creators/v1
Get the top creators for a social category
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/category/musicians/creators/v1
Example response:
{
"data": [
{
"creator_id": "youtube::UC5fbutHyWw4n6DRro2c51WQ", // The [network]::[unique_id] for the influencer
"creator_name": "inzu_shorts", // The unique screen name for the influencer
"creator_avatar": "https://yt3.ggpht.com/e6nezKYqBbbWqK6UO24QdS4I52zkEcTB6GV4gj2q_flUqQEajwuR8mTUFeyHLvyN8K_4588KEA=s88-c-k-c0x00ffffff-no-rj", // The URL to the avatar for the creator
"creator_followers": 14200000, // number of followers the account has
"creator_rank": 1, // ranking based on all posts in the last 24 hours that have interactions
"interactions_24h": 36789700 // Number of interactions in the last 24 hours
}
]
}
Schema:
https://lunarcrush.com/api4/public/categories/list/v1
Get a list of trending social categories.
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/categories/list/v1
Example response:
{
"data": [
{
"category": "automotive brands", // LunarCrush social category. Can only includes letters, numbers and spaces
"title": "Automotive Brands", // The case sensitive title of the topic or category
"category_rank": 10, // LunarCrush metric for ranking a social topic relative to all other social topics
"category_rank_1h_previous": 10, // The topic rank from 1 hour ago
"category_rank_24h_previous": 11, // The topic rank from 24 hours ago
"num_contributors": 310505, // The number of unique social contributors to the topic
"social_dominance": 2.448811408903175, // The percent of the total social volume that this topic represents
"num_posts": 571772, // Total number of posts with interactions on this topic in the last 24 hours
"interactions_24h": 1596477782 // Number of interactions in the last 24 hours
}
]
}
Schema:
https://lunarcrush.com/api4/public/creators/list/v1
Get a list of trending social creators over all of social based on interactions. To get lists of creators by category or topic see the topics and categories endpoints.
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/creators/list/v1
Example response:
{
"data": [
{
"creator_name": "fifaworldcup", // The unique screen name for the influencer
"creator_display_name": "FIFA World Cup", // The chosen display name for the influencer if available
"creator_id": "7059636734342038534", // The [network]::[unique_id] for the influencer
"creator_network": "tiktok", // The social network for the post or influencer. We still refer to x as twitter out of developer preference.
"creator_avatar": "https://p16-common-sign.tiktokcdn.com/tos-useast2a-avt-0068-euttp/d260685754e3ae8139f47e7ec9fda7e9~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=ae59b68c&x-expires=1781528400&x-signature=KLrxgPYsXOKX3IiqV04yfsTlSf8%3D&t=4d5b0474&ps=13740610&shp=d05b14bd&shcp=34ff8df6&idc=sg1", // The URL to the avatar for the creator
"creator_followers": 62723619, // number of followers the account has
"creator_posts": 437, // total number of posts with interactions in the last 24 hours
"creator_rank": 1, // ranking based on all posts in the last 24 hours that have interactions
"interactions_24h": 241125909 // Number of interactions in the last 24 hours
}
]
}
Schema:
https://lunarcrush.com/api4/public/creator/:network/:id/v1
Get detail information on a specific creator
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/creator/twitter/elonmusk/v1
Example response:
{
"data": {
"creator_id": "twitter::44196397", // The [network]::[unique_id] for the influencer
"creator_name": "elonmusk", // The unique screen name for the influencer
"creator_display_name": "Elon Musk", // The chosen display name for the influencer if available
"creator_avatar": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_200x200.jpg", // The URL to the avatar for the creator
"creator_followers": 240244754, // number of followers the account has
"creator_rank": 13, // ranking based on all posts in the last 24 hours that have interactions
"interactions_24h": 95775717, // Number of interactions in the last 24 hours
"topic_influence": [ // an array of social topics and the creators ranking on each topic
{
"topic": "spacex", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"count": 38,
"percent": 5.73,
"rank": 1
}
],
"top_community": [ // an array of the top accounts that have recently mentioned this creator or that this creator has mentioned
{
"creator_name": "gadsaad", // The unique screen name for the influencer
"creator_display_name": "Gad Saad", // The chosen display name for the influencer if available
"creator_avatar": "https://pbs.twimg.com/profile_images/979192426660327424/4B9g75QR_200x200.jpg", // The URL to the avatar for the creator
"count": 22
}
]
}
}
Schema:
https://lunarcrush.com/api4/public/creator/:network/:id/time-series/v1
Get time series data on a creator.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/creator/twitter/lunarcrush/time-series/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"network": "twitter", // The social network for the post or influencer. We still refer to x as twitter out of developer preference.
"influencer_id": "twitter::988992203568562176",
"interval": "1w", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc
"start": 1780790400, // Start/from unix timestamp (in seconds)
"end": 1781481600, // End/to unix timestamp (in seconds)
"bucket": "hour", // Data is generally bucketed into hours or days
"name": "LunarCrush", // The full name of the asset
"generated": 1781447090 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"time": 1780790400, // A unix timestamp (in seconds)
"followers": 303135, // The number of publicly displayed followers the creator has
"interactions": 132, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)
"posts_active": 12 // number of unique social posts with interactions
}
]
}
Schema:
https://lunarcrush.com/api4/public/creator/:network/:id/posts/v1
Get the top posts for a specific creator. 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 24 hours.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/creator/twitter/elonmusk/posts/v1
Example response:
{
"data": [
{
"id": "161660285659267072", // Unique id of the social post
"post_type": "tweet", // The type of social post
"post_title": "Design completed for bringing rocket back to launchpad using only thrusters. Yay. Wings r just dead weight in space.", // The title text of the social post
"post_created": 1327377790, // The unix timestamp of our best indication of when the post was created
"post_sentiment": 3, // The sentiment of the post is a score between 1 and 5 with 1 being very negative, 3 being neutral, and 5 being very positive. A score of 3.5 is considered slightly positive.
"post_link": "https://x.com/elonmusk/status/161660285659267072", // The URL to view the social post on the social network
"creator_id": "twitter::44196397", // The [network]::[unique_id] for the influencer
"creator_name": "elonmusk", // The unique screen name for the influencer
"creator_display_name": "Elon Musk", // The chosen display name for the influencer if available
"creator_followers": 240181991, // number of followers the account has
"creator_avatar": "https://pbs.twimg.com/profile_images/2053244804520427520/m8mdWZCG_200x200.jpg", // The URL to the avatar for the creator
"interactions_24h": 0, // Number of interactions in the last 24 hours
"interactions_total": 853 // Number of total interactions
}
]
}
Schema:
https://lunarcrush.com/api4/public/posts/:post_type/:post_id/v1
Get details of a post
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/posts/tweet/1756378079893782591/v1
Example response:
{
"type": "tweet", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
"id": "1756378079893782591", // Unique id of the social post
"title": "Social activity is 👆 across the board today. \n\n🤔 What are y'all talking about? \n🫡 We've got you covered.\n\n👩💻 Technology\n💬 Social Networks\n👨🎤 Musicians\n🕺 Celebrities\n🌏 Countries\n🎮 Gaming\n🏖️ Travel\n🚗 Automotive\n🥷 Cryptocurrencies\n🇺🇸 US Election\n\n🚀 https://t.co/AI5yuZEyi7 https://t.co/T0mqJBiyx0", // Title of the social post
"description": null, // Explanation of the change and the potential impact
"extraText": "https://lunarcrush.com/categories?rpp=300&page=1&cols=topic_rank%2Ccontributors_active%2Cposts_active%2Caverage_sentiment%2Cinteractions_24h%2Cinteractions_trend", // Extra text for the post for search matching like the retweet text or text included in the video
"metrics": { // Comma separated list of metrics to include or that are included
"bookmarks": 1,
"favorites": 18,
"retweets": 3,
"replies": 12,
"views": 13009
},
"image": { // Provides the url/src width and height of a the image in the post if available
"src": "https://pbs.twimg.com/media/GF_n3GQaoAA23sT.jpg",
"width": 2048,
"height": 989
},
"video": null, // Provides the url/src width and height of a the video in the post if available
"images": null, // Provides the url/src width and height of a the images in the post if available
"creator_id": "twitter::988992203568562176", // The [network]::[unique_id] for the influencer
"creator_name": "LunarCrush", // The unique screen name for the influencer
"creator_display_name": "LunarCrush", // The chosen display name for the influencer if available
"creator_avatar": "https://pbs.twimg.com/profile_images/1958717678476304384/CbzjwJvB_200x200.png", // The URL to the avatar for the creator
"topics": [
"lunarcrush"
],
"categories": [] // an array of categories this topic aggregates into
}
Schema:
https://lunarcrush.com/api4/public/posts/:post_type/:post_id/time-series/v1
Get interactions over time for a post. If a post is older than 365 days the time series will be returned as daily interactions, otherwise it hourly interactions
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/posts/tweet/1756378079893782591/time-series/v1
Example response:
{
"data": [
{
"time": "1707523200", // A unix timestamp (in seconds)
"interactions": 853 // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)
}
]
}
Schema:
https://lunarcrush.com/api4/public/coins/list/v2
Get a general snapshot of LunarCrush metrics on the entire list of tracked coins. It is designed as a lightweight mechanism for monitoring the universe of available assets, either in aggregate or relative to each other. Metrics include Galaxy Score™, AltRank™, price, volatility, 24h percent change, market cap, social mentions, social interactions, social contributors, social dominance, and categories.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/coins/list/v2
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"sort": "market_cap_rank",
"desc": true,
"limit": 0,
"page": 0,
"total_rows": 5831,
"generated": 1781447090 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"id": 1, // LunarCrush internal ID for the asset
"symbol": "BTC", // The symbol for the asset
"name": "Bitcoin", // The full name of the asset
"price": 64235.863662046875, // Current price in USD
"price_btc": 1, // Current price in BTC
"volume_24h": 16585697421.63, // Volume in USD for 24 hours up to this data point
"volatility": 0.0057, // Volatility is calculated as the standard deviation of the price.
"circulating_supply": 20042612, // 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
"max_supply": 21000000, // The maximum supply of the asset if available
"percent_change_1h": -0.074851407687, // Percent change in price since 1 hour ago
"percent_change_24h": 0.228987563423, // Percent change in price since 24 hours ago
"percent_change_7d": 3.584315275162, // Percent change in price since 7 days ago
"market_cap": 1288585340431, // Total dollar market value of all circulating supply or outstanding shares
"market_cap_rank": 1, // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.
"interactions_24h": 86201249, // Number of interactions in the last 24 hours
"social_volume_24h": 100797, // Total number of posts with interactions on this topic in the last 24 hours
"social_dominance": 28.321560429556452, // The percent of the total social volume that this topic represents
"market_dominance": 58.81863880169011, // The percent of the total market cap that this asset represents
"market_dominance_prev": 58.82832832974712,
"galaxy_score": 59.5, // 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
"galaxy_score_previous": 52, // The galaxy score from the previous 24 hours
"alt_rank": 140, // A proprietary score based on how an asset is performing relative to all other assets supported
"alt_rank_previous": 106, // The alt rank from the previous 24 hours
"sentiment": 79, // % of posts (weighted by interactions) that are positive. 100% means all posts are positive, 50% is half positive and half negative, and 0% is all negative posts.
"categories": "layer-1,bitcoin-ecosystem,pow", // A comma delimited string of sub categories/sectors this asset belongs to
"blockchains": [ // An array of blockchains that the asset is part of including the contract address and decimals if applicable
{
"type": "layer1", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
"network": "bitcoin", // The name of the blockchain or network
"address": null, // The contract address, zero or null means it is a layer 1
"decimals": null
}
],
"percent_change_30d": -18.900206060758, // Percent change in price since 30 days ago
"last_updated_price": 1781447082,
"last_updated_price_by": "cmc_stream",
"topic": "btc bitcoin", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"logo": "https://cdn.lunarcrush.com/bitcoin.png" // The URL to the logo for the asset, topic, or category
}
]
}
Schema:
https://lunarcrush.com/api4/public/coins/list/v1
Get a general snapshot of LunarCrush metrics on the entire list of tracked coins. This version is heavily cached and up to 1 hour behind. It is designed as a lightweight mechanism for monitoring the universe of available assets, either in aggregate or relative to each other. Metrics include Galaxy Score™, AltRank™, price, volatility, 24h percent change, market cap, social mentions, social interactions, social contributors, social dominance, and categories. Use the coins/list/v2 endpoint for data updated every few seconds.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/coins/list/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"sort": "market_cap_rank",
"desc": true,
"limit": 0,
"page": 0,
"total_rows": 5831,
"generated": 1781447091 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"id": 1, // LunarCrush internal ID for the asset
"symbol": "BTC", // The symbol for the asset
"name": "Bitcoin", // The full name of the asset
"price": 64235.863662046875, // Current price in USD
"price_btc": 1, // Current price in BTC
"volume_24h": 16585697421.63, // Volume in USD for 24 hours up to this data point
"volatility": 0.0057, // Volatility is calculated as the standard deviation of the price.
"circulating_supply": 20042612, // 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
"max_supply": 21000000, // The maximum supply of the asset if available
"percent_change_1h": -0.074851407687, // Percent change in price since 1 hour ago
"percent_change_24h": 0.228987563423, // Percent change in price since 24 hours ago
"percent_change_7d": 3.584315275162, // Percent change in price since 7 days ago
"market_cap": 1288585340431, // Total dollar market value of all circulating supply or outstanding shares
"market_cap_rank": 1, // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.
"interactions_24h": 86201249, // Number of interactions in the last 24 hours
"social_volume_24h": 100797, // Total number of posts with interactions on this topic in the last 24 hours
"social_dominance": 28.321560429556452, // The percent of the total social volume that this topic represents
"market_dominance": 58.81863880169011, // The percent of the total market cap that this asset represents
"market_dominance_prev": 58.82832832974712,
"galaxy_score": 59.5, // 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
"galaxy_score_previous": 52, // The galaxy score from the previous 24 hours
"alt_rank": 140, // A proprietary score based on how an asset is performing relative to all other assets supported
"alt_rank_previous": 106, // The alt rank from the previous 24 hours
"sentiment": 79, // % of posts (weighted by interactions) that are positive. 100% means all posts are positive, 50% is half positive and half negative, and 0% is all negative posts.
"categories": "layer-1,bitcoin-ecosystem,pow", // A comma delimited string of sub categories/sectors this asset belongs to
"blockchains": [ // An array of blockchains that the asset is part of including the contract address and decimals if applicable
{
"type": "layer1", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
"network": "bitcoin", // The name of the blockchain or network
"address": null, // The contract address, zero or null means it is a layer 1
"decimals": null
}
],
"percent_change_30d": -18.900206060758, // Percent change in price since 30 days ago
"last_updated_price": 1781447082,
"last_updated_price_by": "cmc_stream",
"topic": "btc bitcoin", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"logo": "https://cdn.lunarcrush.com/bitcoin.png" // The URL to the logo for the asset, topic, or category
}
]
}
Schema:
https://lunarcrush.com/api4/public/coins/:coin/v1
Get market data on a coin or token. Specify the coin to be queried by providing the numeric ID or the symbol of the coin in the input parameter, which can be found by calling the /coins/list endpoint.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/coins/2/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"id": "coins:2", // LunarCrush internal ID for the asset
"_self_call": true,
"name": "Ethereum", // The full name of the asset
"symbol": "ETH", // The symbol for the asset
"topic": "ethereum", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"generated": 1781447091 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": {
"id": 2, // LunarCrush internal ID for the asset
"name": "Ethereum", // The full name of the asset
"symbol": "ETH", // The symbol for the asset
"price": 1666.4738941162823, // Current price in USD
"price_btc": 0.02594564840884439, // Current price in BTC
"market_cap": 201019186066, // Total dollar market value of all circulating supply or outstanding shares
"percent_change_24h": -0.69209153363, // Percent change in price since 24 hours ago
"percent_change_7d": 2.344899458182, // Percent change in price since 7 days ago
"percent_change_30d": -24.998454393833, // Percent change in price since 30 days ago
"volume_24h": 5770406369.09, // Volume in USD for 24 hours up to this data point
"max_supply": null, // The maximum supply of the asset if available
"circulating_supply": 120684209.11, // 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": 1666.4738941162823, // Close price for the time period
"galaxy_score": 54.3, // 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
"alt_rank": 130, // A proprietary score based on how an asset is performing relative to all other assets supported
"volatility": 0.0038, // Volatility is calculated as the standard deviation of the price.
"market_cap_rank": 2 // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.
}
}
Schema:
https://lunarcrush.com/api4/public/coins/:coin/time-series/v2
Get market time series data on a coin or token. Specify the coin to be queried by providing the numeric ID or the symbol of the coin in the input parameter, which can be found by calling the /coins/list endpoint.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/coins/2/time-series/v2
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"coin": "2",
"topic": "ethereum", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"id": "coins:2", // LunarCrush internal ID for the asset
"_self_call": true,
"name": "Ethereum", // The full name of the asset
"symbol": "ETH", // The symbol for the asset
"interval": "1w", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc
"start": 1780790400, // Start/from unix timestamp (in seconds)
"end": 1781454291, // End/to unix timestamp (in seconds)
"bucket": "hour", // Data is generally bucketed into hours or days
"metrics": [], // Comma separated list of metrics to include or that are included
"generated": 1781447091 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"time": 1780790400, // A unix timestamp (in seconds)
"contributors_active": 26334, // number of unique social accounts with posts that have interactions
"contributors_created": 409, // number of unique social accounts that created new posts
"interactions": 1381428, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)
"posts_active": 46371, // number of unique social posts with interactions
"posts_created": 725, // number of unique social posts created
"sentiment": 68, // % of posts (weighted by interactions) that are positive. 100% means all posts are positive, 50% is half positive and half negative, and 0% is all negative posts.
"spam": 4955, // The number of posts created that are considered spam
"alt_rank": 340, // A proprietary score based on how an asset is performing relative to all other assets supported
"circulating_supply": 120684554, // 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": 1564.7954, // Close price for the time period
"galaxy_score": 51, // 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": 1564.32, // Higest price fo rthe time period
"low": 1561.07, // Lowest price for the time period
"market_cap": 188881264263, // Total dollar market value of all circulating supply or outstanding shares
"market_dominance": 9.0134, // The percent of the total market cap that this asset represents
"open": 1561.07, // Open price for the time period
"social_dominance": 10.5694, // The percent of the total social volume that this topic represents
"volume_24h": 18231884427 // Volume in USD for 24 hours up to this data point
}
]
}
Schema:
https://lunarcrush.com/api4/public/coins/:coin/meta/v1
Get meta information for a cryptocurrency project. This includes information such as the website, social media links, and other information.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/coins/2/meta/v1
Example response:
{
"data": {
"id": 2, // LunarCrush internal ID for the asset
"name": "Ethereum", // The full name of the asset
"symbol": "ETH", // The symbol for the asset
"market_categories": "layer-1",
"updated": 1741059248, // Timestamp of when the data was last updated
"blockchain": [
{
"type": "layer1", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer
"network": "ethereum", // The social network for the post or influencer. We still refer to x as twitter out of developer preference.
"address": null,
"decimals": null
}
],
"short_summary": "Ethereum is open access to digital money and data-friendly services for everyone – no matter your background or location. It's a community-built technology behind the cryptocurrency ether (ETH) and thousands of applications you can use today.",
"description": "Ethereum is a technology that lets you send cryptocurrency to anyone for a small fee. It also powers applications that everyone can use and no one can take down.\n\nIt's the world's programmable blockchain.\n\nEthereum builds on Bitcoin's innovation, with some big differences.\n\nBoth let you use digital money without payment providers or banks. But Ethereum is programmable, so you can also use it for lots of different digital assets – even Bitcoin!\n\nThis also means Ethereum is for more than payments. It's a marketplace of financial services, games and apps that can't steal your data or censor you.", // Explanation of the change and the potential impact
"github_link": "https://github.com/ethereum",
"website_link": "https://www.ethereum.org/",
"whitepaper_link": "https://ethereum.org/en/whitepaper",
"twitter_link": "https://twitter.com/ethereum",
"reddit_link": "https://www.reddit.com/r/ethereum/",
"header_image": "headers/ethereum.png",
"header_text": "The foundation for our digital future",
"videos": "https://www.youtube.com/watch?v=GQR1xjQn5Pg",
"coingecko_link": "https://www.coingecko.com/en/coins/ethereum",
"coinmarketcap_link": "https://coinmarketcap.com/currencies/ethereum/"
},
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"coin": "2",
"generated": 1781447091 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
}
}
Schema:
https://lunarcrush.com/api4/public/stocks/list/v2
Get a general snapshot of LunarCrush metrics on the entire list of tracked stocks. It is designed as a lightweight mechanism for monitoring the universe of available assets, either in aggregate or relative to each other. Metrics include Galaxy Score™, AltRank™, floor price, 24h percent change, market cap, social mentions, social interactions, social contributors, social dominance, and categories.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/stocks/list/v2
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"limit": 0,
"sort": "market_cap_rank",
"desc": true,
"page": 0,
"total_rows": 4070,
"generated": 1781447091 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"id": 7056, // LunarCrush internal ID for the asset
"symbol": "NVDA", // The symbol for the asset
"name": "NVIDIA Corp.", // The full name of the asset
"price": 205.19, // Current price in USD
"volume_24h": 0, // Volume in USD for 24 hours up to this data point
"percent_change_24h": 0.1562, // Percent change in price since 24 hours ago
"market_cap": 4969906990000, // Total dollar market value of all circulating supply or outstanding shares
"market_cap_rank": 1, // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.
"interactions_24h": 83738789, // Number of interactions in the last 24 hours
"social_volume_24h": 22570, // Total number of posts with interactions on this topic in the last 24 hours
"social_dominance": 2.3184124267727846, // The percent of the total social volume that this topic represents
"market_dominance": 5.123529553620532, // The percent of the total market cap that this asset represents
"market_dominance_prev": 5.142913265949797,
"galaxy_score": 52.4, // 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
"galaxy_score_previous": 76, // The galaxy score from the previous 24 hours
"alt_rank": 939, // A proprietary score based on how an asset is performing relative to all other assets supported
"alt_rank_previous": 405, // The alt rank from the previous 24 hours
"sentiment": 92, // % of posts (weighted by interactions) that are positive. 100% means all posts are positive, 50% is half positive and half negative, and 0% is all negative posts.
"categories": "technology", // an array of categories this topic aggregates into
"topic": "nvda nvidia corp", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"logo": "https://cdn.lunarcrush.com/stocks/nvda.png" // The URL to the logo for the asset, topic, or category
}
]
}
Schema:
https://lunarcrush.com/api4/public/stocks/list/v1
Lists all stocks supported by LunarCrush. Includes the "topic" endpoint to use to get social data from this asset as a social topic.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/stocks/list/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"sort": "market_cap_rank",
"desc": true,
"limit": 0,
"page": 0,
"total_rows": 4070,
"generated": 1781447091 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"id": 7056, // LunarCrush internal ID for the asset
"symbol": "NVDA", // The symbol for the asset
"name": "NVIDIA Corp.", // The full name of the asset
"price": 205.19, // Current price in USD
"volume_24h": 0, // Volume in USD for 24 hours up to this data point
"percent_change_24h": 0.1562, // Percent change in price since 24 hours ago
"market_cap": 4969906990000, // Total dollar market value of all circulating supply or outstanding shares
"market_cap_rank": 1, // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.
"interactions_24h": 83738789, // Number of interactions in the last 24 hours
"social_volume_24h": 22570, // Total number of posts with interactions on this topic in the last 24 hours
"social_dominance": 2.3184124267727846, // The percent of the total social volume that this topic represents
"market_dominance": 5.123529553620532, // The percent of the total market cap that this asset represents
"market_dominance_prev": 5.142913265949797,
"galaxy_score": 52.4, // 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
"galaxy_score_previous": 76, // The galaxy score from the previous 24 hours
"alt_rank": 939, // A proprietary score based on how an asset is performing relative to all other assets supported
"alt_rank_previous": 405, // The alt rank from the previous 24 hours
"sentiment": 92, // % of posts (weighted by interactions) that are positive. 100% means all posts are positive, 50% is half positive and half negative, and 0% is all negative posts.
"categories": "technology", // an array of categories this topic aggregates into
"topic": "nvda nvidia corp", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"logo": "https://cdn.lunarcrush.com/stocks/nvda.png" // The URL to the logo for the asset, topic, or category
}
]
}
Schema:
https://lunarcrush.com/api4/public/stocks/:stock/v1
Get market data on a stock. Specify the coin to be queried by providing the numeric ID or the symbol of the coin in the input parameter, which can be found by calling the /coins/list endpoint.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/stocks/7056/v1
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"id": "stocks:7056", // LunarCrush internal ID for the asset
"_self_call": true,
"name": "NVIDIA Corp.", // The full name of the asset
"symbol": "NVDA", // The symbol for the asset
"topic": "$nvda", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"generated": 1781447091 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": {
"id": 7056, // LunarCrush internal ID for the asset
"name": "NVIDIA Corp.", // The full name of the asset
"symbol": "NVDA", // The symbol for the asset
"price": 205.19, // Current price in USD
"market_cap": 4969906990000, // Total dollar market value of all circulating supply or outstanding shares
"percent_change_24h": 0.1562, // Percent change in price since 24 hours ago
"volume_24h": 0, // Volume in USD for 24 hours up to this data point
"close": 205.19, // Close price for the time period
"market_cap_rank": 1 // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.
}
}
Schema:
https://lunarcrush.com/api4/public/stocks/:stock/time-series/v2
Get market time series data on a stock. Specify the stock to be queried by providing the numeric ID or the symbol of the stock in the input parameter, which can be found by calling the /stocks/list endpoint.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/stocks/7056/time-series/v2
Example response:
{
"config": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
"stock": "7056",
"topic": "$nvda", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
"id": "stocks:7056", // LunarCrush internal ID for the asset
"_self_call": true,
"name": "NVIDIA Corp.", // The full name of the asset
"symbol": "NVDA", // The symbol for the asset
"interval": "1w", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc
"start": 1780790400, // Start/from unix timestamp (in seconds)
"end": 1781454291, // End/to unix timestamp (in seconds)
"bucket": "hour", // Data is generally bucketed into hours or days
"metrics": [], // Comma separated list of metrics to include or that are included
"generated": 1781447091 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data
},
"data": [
{
"time": 1780790400, // A unix timestamp (in seconds)
"contributors_active": 18470, // number of unique social accounts with posts that have interactions
"contributors_created": 193, // number of unique social accounts that created new posts
"interactions": 2927356, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)
"posts_active": 28653, // number of unique social posts with interactions
"posts_created": 276, // number of unique social posts created
"sentiment": 76, // % of posts (weighted by interactions) that are positive. 100% means all posts are positive, 50% is half positive and half negative, and 0% is all negative posts.
"spam": 2518, // The number of posts created that are considered spam
"alt_rank": 428, // A proprietary score based on how an asset is performing relative to all other assets supported
"close": 205.1, // Close price for the time period
"galaxy_score": 51, // 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": 205.1, // Higest price fo rthe time period
"low": 205.1, // Lowest price for the time period
"market_cap": 4967727100000, // Total dollar market value of all circulating supply or outstanding shares
"market_dominance": 5.2955, // The percent of the total market cap that this asset represents
"open": 205.1, // Open price for the time period
"social_dominance": 2.9259 // The percent of the total social volume that this topic represents
}
]
}
Schema:
https://lunarcrush.com/api4/public/searches/search
Get recently popular social posts matching a single search term or phrase. Optionally configure and test a custom search configuration.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/searches/search
Example response:
{
"error": "Error: search_json object requires at least 1 valid search term"
}
Schema:
https://lunarcrush.com/api4/public/searches/list
List all custom search aggregations.
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/searches/list
Example response:
{
"data": [
{
"id": "lc1s5M27Jq", // LunarCrush internal ID for the asset
"name": "Pump.fun Leaderboard", // The full name of the asset
"search_json": {
"terms": [],
"rollups": [
"solanatqj8yfmagrg7oorpqkvgyr52r96rftamvwfth9bpump"
]
},
"priority": true,
"created": 1749064987
}
]
}
Schema:
https://lunarcrush.com/api4/public/searches/create
Create a custom search aggregation of topics and search terms. Fine tune the posts that get included or excluded. Search terms and configuration cannot be changed once created. If successful returns the new id/slug and the processed search config. Note that search terms will be adjusted and simplified for optimized search and matching.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/searches/create
Example response:
{
"error": "Error: name is required"
}
Schema:
https://lunarcrush.com/api4/public/searches/:slug/update
Update a custom search aggregation name or priority. Search terms and configuration cannot be changed once created.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/searches/:slug/update
Example response:
{
"error": "Error: search_json is required"
}
Schema:
https://lunarcrush.com/api4/public/searches/:slug/delete
Delete a custom search aggregation.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/searches/:slug/delete
Example response:
{
"error": "Error: That item does not exist"
}
Schema:
https://lunarcrush.com/api4/public/searches/:slug
See the summary output of a custom search aggregation.
input parameters:
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/searches/:slug
Example response:
{
"error": "Use the topics endpoints to get the latest data like /public/topic/:slug/v1"
}
Schema:
https://lunarcrush.com/api4/public/system/changes
Updates to potential changes to historical time series data. Search term changes only impact the most recent 72 hours (hourly) or 3 days (daily) data. "full historical" is a change that may impact the full history of data. Each change provides a description of what is impacted and why.
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/system/changes
Example response:
{
"data": [
{
"asset_type": "coins", // One of coins, nfts, stocks, topic or category
"asset_id": 162898, // The id of the asset (coin, nft, stock, topic, or category)
"asset_name": "Woke Mind Virus (WOKE)", // The descriptive name of the asset to help identify it
"change": "search terms established", // The type of change that occurred
"description": "search criteria initially set for this asset for the purposes of tracking changes over time", // Explanation of the change and the potential impact
"time": 1781436504 // A unix timestamp (in seconds)
}
]
}
Schema: