{ "openapi": "3.0.0", "info": { "title": "LunarCrush API v4 overview", "version": "4.0.0" }, "servers": { "url": "https://lunarcrush.com/api4" }, "paths": { "/public/topics/list/v1": { "get": { "description": "Get a list of trending social topics.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": [ { "topic": "if you", "title": "if you", "topic_rank": 1, "topic_rank_1h_previous": 2, "topic_rank_24h_previous": 1, "num_contributors": 392220, "num_posts": 542306, "interactions_24h": 1328354854 } ] }, "description": "```jsonc\n{\n \"data\": [\n {\n \"topic\": \"if you\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"title\": \"if you\", // The case sensitive title of the topic or category\n \"topic_rank\": 1, // LunarCrush metric for ranking a social topic relative to all other social topics\n \"topic_rank_1h_previous\": 2, // The topic rank from 1 hour ago\n \"topic_rank_24h_previous\": 1, // The topic rank from 24 hours ago\n \"num_contributors\": 392220, // The number of unique social contributors to the topic\n \"num_posts\": 542306, // Total number of posts with interactions on this topic in the last 24 hours\n \"interactions_24h\": 1328354854 // Number of interactions in the last 24 hours\n }\n ]\n}\n```" } } } } } }, "parameters": [] } }, "/public/topic/:topic/whatsup/v1": { "get": { "description": "Generate an AI summary of the hottest news and social posts for a specific topic", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "id": "bitcoin", "name": "Bitcoin", "symbol": "BTC", "asset": "coins:1", "topic": "bitcoin", "generated": 1793720476 }, "summary": "Bitcoin price drops as Binance hack prompts mass sell-off; Binance CEO confirms $3.3B hack, users demand refunds", "supportive": [ { "title": "Bitcoin Halves Every 4 Years, This Time is Different", "description": "Users argue that Bitcoin's halving event every 4 years makes it a reliable store of value, unlike traditional currencies that can be printed indefinitely.", "percent": 35 } ], "critical": [ { "title": "Bitcoin Volatility and Risk", "description": "Users express concern over Bitcoin's price volatility and the risk of investing in a highly speculative asset.", "percent": 30 } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"id\": \"bitcoin\", // LunarCrush internal ID for the asset\n \"name\": \"Bitcoin\", // The full name of the asset\n \"symbol\": \"BTC\", // The symbol for the asset\n \"asset\": \"coins:1\",\n \"topic\": \"bitcoin\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"generated\": 1793720476 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"summary\": \"Bitcoin price drops as Binance hack prompts mass sell-off; Binance CEO confirms $3.3B hack, users demand refunds\",\n \"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.\n {\n \"title\": \"Bitcoin Halves Every 4 Years, This Time is Different\", // The case sensitive title of the topic or category\n \"description\": \"Users argue that Bitcoin's halving event every 4 years makes it a reliable store of value, unlike traditional currencies that can be printed indefinitely.\", // Explanation of the change and the potential impact\n \"percent\": 35\n }\n ],\n \"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.\n {\n \"title\": \"Bitcoin Volatility and Risk\", // The case sensitive title of the topic or category\n \"description\": \"Users express concern over Bitcoin's price volatility and the risk of investing in a highly speculative asset.\", // Explanation of the change and the potential impact\n \"percent\": 30\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/topic/:topic/v1": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "id": "bitcoin", "name": "Bitcoin", "symbol": "BTC", "asset": "coins:1", "topic": "bitcoin", "generated": 1793731462 }, "data": { "topic": "bitcoin", "title": "Bitcoin", "topic_rank": 111, "related_topics": [ "crypto" ], "types_count": { "news": 258, "instagram-post": 465, "reddit-post": 789, "tiktok-video": 8340, "youtube-video": 18498, "tweet": 116702 }, "types_interactions": { "news": 165876, "instagram-post": 156107, "reddit-post": 88740, "tiktok-video": 13377058, "youtube-video": 32719537, "tweet": 94328989 }, "types_sentiment": { "news": 45, "instagram-post": 70, "reddit-post": 68, "tiktok-video": 59, "youtube-video": 72, "tweet": 70 }, "types_sentiment_detail": { "news": { "negative": 89, "neutral": 96, "positive": 73 }, "instagram-post": { "negative": 59, "neutral": 285, "positive": 121 }, "reddit-post": { "negative": 137, "neutral": 407, "positive": 248 }, "tiktok-video": { "negative": 1211, "neutral": 5548, "positive": 1583 }, "youtube-video": { "negative": 2465, "neutral": 10820, "positive": 5211 }, "tweet": { "negative": 17163, "neutral": 67406, "positive": 32133 } }, "interactions_24h": 140836307, "num_contributors": 56110, "num_posts": 145052, "categories": [ "Cryptocurrencies" ], "trend": "flat" } }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"id\": \"bitcoin\", // LunarCrush internal ID for the asset\n \"name\": \"Bitcoin\", // The full name of the asset\n \"symbol\": \"BTC\", // The symbol for the asset\n \"asset\": \"coins:1\",\n \"topic\": \"bitcoin\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"generated\": 1793731462 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": {\n \"topic\": \"bitcoin\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"title\": \"Bitcoin\", // The case sensitive title of the topic or category\n \"topic_rank\": 111, // LunarCrush metric for ranking a social topic relative to all other social topics\n \"related_topics\": [ // an array of related topics\n \"crypto\"\n ],\n \"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\n \"news\": 258,\n \"instagram-post\": 465,\n \"reddit-post\": 789,\n \"tiktok-video\": 8340,\n \"youtube-video\": 18498,\n \"tweet\": 116702\n },\n \"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\n \"news\": 165876,\n \"instagram-post\": 156107,\n \"reddit-post\": 88740,\n \"tiktok-video\": 13377058,\n \"youtube-video\": 32719537,\n \"tweet\": 94328989\n },\n \"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.\n \"news\": 45,\n \"instagram-post\": 70,\n \"reddit-post\": 68,\n \"tiktok-video\": 59,\n \"youtube-video\": 72,\n \"tweet\": 70\n },\n \"types_sentiment_detail\": { // An object with the breakdown of positive, neutral, and negative posts by 24h interactions for each social network\n \"news\": {\n \"negative\": 89,\n \"neutral\": 96,\n \"positive\": 73\n },\n \"instagram-post\": {\n \"negative\": 59,\n \"neutral\": 285,\n \"positive\": 121\n },\n \"reddit-post\": {\n \"negative\": 137,\n \"neutral\": 407,\n \"positive\": 248\n },\n \"tiktok-video\": {\n \"negative\": 1211,\n \"neutral\": 5548,\n \"positive\": 1583\n },\n \"youtube-video\": {\n \"negative\": 2465,\n \"neutral\": 10820,\n \"positive\": 5211\n },\n \"tweet\": {\n \"negative\": 17163,\n \"neutral\": 67406,\n \"positive\": 32133\n }\n },\n \"interactions_24h\": 140836307, // Number of interactions in the last 24 hours\n \"num_contributors\": 56110, // The number of unique social contributors to the topic\n \"num_posts\": 145052, // Total number of posts with interactions on this topic in the last 24 hours\n \"categories\": [ // an array of categories this topic aggregates into\n \"Cryptocurrencies\"\n ],\n \"trend\": \"flat\" // One of up, down or flat to represent the general trend in interactions\n }\n}\n```" } } } } } }, "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/topic/:topic/time-series/v2": { "get": { "description": "Get historical time series data for a social topic", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "topic": "bitcoin", "id": "bitcoin", "name": "Bitcoin", "symbol": "BTC", "asset": "coins:1", "interval": "1w", "start": 1793059200, "end": 1793738662, "bucket": "hour", "metrics": [], "generated": 1793731462 }, "data": [ { "time": 1793059200, "contributors_active": 25500, "contributors_created": 790, "interactions": 5080139, "posts_active": 51467, "posts_created": 1542, "sentiment": 68, "spam": 3643, "alt_rank": 100, "circulating_supply": 20103946, "close": 80202, "galaxy_score": 56.6, "high": 80239.09, "low": 79982.35, "market_cap": 1612379334478, "market_dominance": 60.1741, "open": 80006.65, "social_dominance": 27.3611, "volume_24h": 27050824244 } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"topic\": \"bitcoin\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"id\": \"bitcoin\", // LunarCrush internal ID for the asset\n \"name\": \"Bitcoin\", // The full name of the asset\n \"symbol\": \"BTC\", // The symbol for the asset\n \"asset\": \"coins:1\",\n \"interval\": \"1w\", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc\n \"start\": 1793059200, // Start/from unix timestamp (in seconds)\n \"end\": 1793738662, // End/to unix timestamp (in seconds)\n \"bucket\": \"hour\", // Data is generally bucketed into hours or days\n \"metrics\": [], // Comma separated list of metrics to include or that are included\n \"generated\": 1793731462 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"time\": 1793059200, // A unix timestamp (in seconds)\n \"contributors_active\": 25500, // number of unique social accounts with posts that have interactions\n \"contributors_created\": 790, // number of unique social accounts that created new posts\n \"interactions\": 5080139, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)\n \"posts_active\": 51467, // number of unique social posts with interactions\n \"posts_created\": 1542, // number of unique social posts created\n \"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.\n \"spam\": 3643, // The number of posts created that are considered spam\n \"alt_rank\": 100, // A proprietary score based on how an asset is performing relative to all other assets supported\n \"circulating_supply\": 20103946, // 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\n \"close\": 80202, // Close price for the time period\n \"galaxy_score\": 56.6, // 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\n \"high\": 80239.09, // Higest price fo rthe time period\n \"low\": 79982.35, // Lowest price for the time period\n \"market_cap\": 1612379334478, // Total dollar market value of all circulating supply or outstanding shares\n \"market_dominance\": 60.1741, // The percent of the total market cap that this asset represents\n \"open\": 80006.65, // Open price for the time period\n \"social_dominance\": 27.3611, // The percent of the total social volume that this topic represents\n \"volume_24h\": 27050824244 // Volume in USD for 24 hours up to this data point\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "bucket", "in": "query", "required": false, "schema": { "type": "string" } } ] } }, "/public/topic/:topic/time-series/v1": { "get": { "description": "Get historical time series data for a social topic", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "topic": "bitcoin", "id": "bitcoin", "name": "Bitcoin", "symbol": "BTC", "asset": "coins:1", "interval": "1w", "start": 1793059200, "end": 1793738662, "bucket": "hour", "metrics": [], "generated": 1793731462 }, "data": [ { "time": 1793059200, "contributors_active": 25500, "contributors_created": 790, "interactions": 5080139, "posts_active": 51467, "posts_created": 1542, "sentiment": 68, "spam": 3643, "alt_rank": 100, "circulating_supply": 20103946, "close": 80202, "galaxy_score": 56.6, "high": 80239.09, "low": 79982.35, "market_cap": 1612379334478, "market_dominance": 60.1741, "open": 80006.65, "social_dominance": 27.3611, "volume_24h": 27050824244 } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"topic\": \"bitcoin\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"id\": \"bitcoin\", // LunarCrush internal ID for the asset\n \"name\": \"Bitcoin\", // The full name of the asset\n \"symbol\": \"BTC\", // The symbol for the asset\n \"asset\": \"coins:1\",\n \"interval\": \"1w\", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc\n \"start\": 1793059200, // Start/from unix timestamp (in seconds)\n \"end\": 1793738662, // End/to unix timestamp (in seconds)\n \"bucket\": \"hour\", // Data is generally bucketed into hours or days\n \"metrics\": [], // Comma separated list of metrics to include or that are included\n \"generated\": 1793731462 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"time\": 1793059200, // A unix timestamp (in seconds)\n \"contributors_active\": 25500, // number of unique social accounts with posts that have interactions\n \"contributors_created\": 790, // number of unique social accounts that created new posts\n \"interactions\": 5080139, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)\n \"posts_active\": 51467, // number of unique social posts with interactions\n \"posts_created\": 1542, // number of unique social posts created\n \"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.\n \"spam\": 3643, // The number of posts created that are considered spam\n \"alt_rank\": 100, // A proprietary score based on how an asset is performing relative to all other assets supported\n \"circulating_supply\": 20103946, // 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\n \"close\": 80202, // Close price for the time period\n \"galaxy_score\": 56.6, // 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\n \"high\": 80239.09, // Higest price fo rthe time period\n \"low\": 79982.35, // Lowest price for the time period\n \"market_cap\": 1612379334478, // Total dollar market value of all circulating supply or outstanding shares\n \"market_dominance\": 60.1741, // The percent of the total market cap that this asset represents\n \"open\": 80006.65, // Open price for the time period\n \"social_dominance\": 27.3611, // The percent of the total social volume that this topic represents\n \"volume_24h\": 27050824244 // Volume in USD for 24 hours up to this data point\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "bucket", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "interval", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": false, "schema": { "type": "timestamp" } }, { "name": "end", "in": "query", "required": false, "schema": { "type": "timestamp" } } ] } }, "/public/topic/:topic/posts/v1": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "topic": "bitcoin", "type": "topic", "id": "bitcoin", "name": "Bitcoin", "symbol": "BTC", "asset": "coins:1", "generated": 1793731462 }, "data": [ { "id": "t3_1xmv5g2", "post_type": "reddit-post", "post_title": "Following the #1 copy trader for 6 months turned $10k into $237. Holding BTC and ETH: $10,316. I tracked all 9,470 copy trading vaults on Hyperliquid.", "post_description": "Copy trading gets sold as \"find someone good, press copy, earn what they earn.\" I wanted to see what that actually looks like, so I pulled every copy trading vault Hyperliquid has ever had and simulated what people really do with $10k.\n\n**What $10k became after 6 months**\n\nEach run starts on the 1st of a month (23 starts, July 2024 to May 2026) and only uses what the leaderboard showed that day. \"Following the #1\" means putting everything in whichever vault was top by 30 day return and moving to the new #1 each month. All results are after the leader's 10% profit share.\n\n|What the copier did|$10k after 6 months (median)|\n|:-|:-|\n|All in the #1 vault, switch monthly|$237|\n|Split across the top 10, re-pick monthly|$4,611|\n|Split across the top 10, never switch|$7,758|\n|Split across the 10 biggest vaults, re-pick monthly|$9,759|\n|Just hold BTC + ETH|$10,316|\n||\n|||\n\nOver a full year it's the same story, just worse. From 16 start dates, the #1 chaser ended at $25 at best, the re-picked top 10 at a median $691 and holding at $8,682\n\n**Why Hyperliquid**\n\nMost platforms only show the lead trader's own return, so you never see what happened to the people who copied or to the traders who blew up and disappeared. Hyperliquid's copy trading runs through vaults and every vault's balance, profit and followers are onchain, including the ones that closed. That's 9,470 vaults opened through Oct 30 and I used all of them.\n\n**Time works for holders, against copiers**\n\nWith holding, the longer you stay, the better your odds. Half BTC and half ETH from any day since 2018 made money 64% of the time after 1 year, 70% after 2, 97% after 3 and 100% after 4.\n\nCopy trading on Hyperliquid runs the other way. Of followers still in a vault today, 52% of those in for 3 to 6 months are in profit, 20% of those in for 1 to 2 years, and 5% of those in for more than 2 years. (Followers who cashed out aren't in this data, so it's a snapshot, not every start date.)\n\n**The exception**\n\nSome vaults did hold up: the ones with a year or more of history, small drops and steady weeks. None of the ones still open was near the top of the 30 day board. A split across vaults like that (1+ year record, worst drop under 30%, up over the last 6 months) beat holding from 10 of 12 one year start dates. But only 1 to 4 vaults a month qualified before Sept 2025, so take that one with a grain of salt.\n\n**How I measured it-** [full report and method](https://botsfolio.com/blog/does-copy-trading-work)\n\nCryptoCurrency", "post_link": "https://redd.it/1xmv5g2", "post_created": 1793717883, "post_sentiment": 3.04, "creator_id": "reddit::t2_lwhmattv", "creator_name": "Mr_Hodlerr", "creator_display_name": "Mr_Hodlerr", "creator_followers": 1576, "creator_avatar": "https://styles.redditmedia.com/t5_67rdqh/styles/profileIcon_snoo5d5db3f8-d0c7-472b-944c-67d2c4ece99c-headshot.png?width=256&height=256&crop=256:256,smart&s=ba5638e71e06e2c474e1b7d6478450cd59fe6055", "interactions_24h": 392, "interactions_total": 392 } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"topic\": \"bitcoin\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"type\": \"topic\", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer\n \"id\": \"bitcoin\", // Unique id of the social post\n \"name\": \"Bitcoin\", // The full name of the asset\n \"symbol\": \"BTC\", // The symbol for the asset\n \"asset\": \"coins:1\",\n \"generated\": 1793731462 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"id\": \"t3_1xmv5g2\", // Unique id of the social post\n \"post_type\": \"reddit-post\", // The type of social post\n \"post_title\": \"Following the #1 copy trader for 6 months turned $10k into $237. Holding BTC and ETH: $10,316. I tracked all 9,470 copy trading vaults on Hyperliquid.\", // The title text of the social post\n \"post_description\": \"Copy trading gets sold as \\\"find someone good, press copy, earn what they earn.\\\" I wanted to see what that actually looks like, so I pulled every copy trading vault Hyperliquid has ever had and simulated what people really do with $10k.\\n\\n**What $10k became after 6 months**\\n\\nEach run starts on the 1st of a month (23 starts, July 2024 to May 2026) and only uses what the leaderboard showed that day. \\\"Following the #1\\\" means putting everything in whichever vault was top by 30 day return and moving to the new #1 each month. All results are after the leader's 10% profit share.\\n\\n|What the copier did|$10k after 6 months (median)|\\n|:-|:-|\\n|All in the #1 vault, switch monthly|$237|\\n|Split across the top 10, re-pick monthly|$4,611|\\n|Split across the top 10, never switch|$7,758|\\n|Split across the 10 biggest vaults, re-pick monthly|$9,759|\\n|Just hold BTC + ETH|$10,316|\\n||\\n|||\\n\\nOver a full year it's the same story, just worse. From 16 start dates, the #1 chaser ended at $25 at best, the re-picked top 10 at a median $691 and holding at $8,682\\n\\n**Why Hyperliquid**\\n\\nMost platforms only show the lead trader's own return, so you never see what happened to the people who copied or to the traders who blew up and disappeared. Hyperliquid's copy trading runs through vaults and every vault's balance, profit and followers are onchain, including the ones that closed. That's 9,470 vaults opened through Oct 30 and I used all of them.\\n\\n**Time works for holders, against copiers**\\n\\nWith holding, the longer you stay, the better your odds. Half BTC and half ETH from any day since 2018 made money 64% of the time after 1 year, 70% after 2, 97% after 3 and 100% after 4.\\n\\nCopy trading on Hyperliquid runs the other way. Of followers still in a vault today, 52% of those in for 3 to 6 months are in profit, 20% of those in for 1 to 2 years, and 5% of those in for more than 2 years. (Followers who cashed out aren't in this data, so it's a snapshot, not every start date.)\\n\\n**The exception**\\n\\nSome vaults did hold up: the ones with a year or more of history, small drops and steady weeks. None of the ones still open was near the top of the 30 day board. A split across vaults like that (1+ year record, worst drop under 30%, up over the last 6 months) beat holding from 10 of 12 one year start dates. But only 1 to 4 vaults a month qualified before Sept 2025, so take that one with a grain of salt.\\n\\n**How I measured it-** [full report and method](https://botsfolio.com/blog/does-copy-trading-work)\\n\\nCryptoCurrency\", // The larger text description or body of the social post if available\n \"post_link\": \"https://redd.it/1xmv5g2\", // The URL to view the social post on the social network\n \"post_created\": 1793717883, // The unix timestamp of our best indication of when the post was created\n \"post_sentiment\": 3.04, // 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.\n \"creator_id\": \"reddit::t2_lwhmattv\", // The [network]::[unique_id] for the influencer\n \"creator_name\": \"Mr_Hodlerr\", // The unique screen name for the influencer\n \"creator_display_name\": \"Mr_Hodlerr\", // The chosen display name for the influencer if available\n \"creator_followers\": 1576, // number of followers the account has\n \"creator_avatar\": \"https://styles.redditmedia.com/t5_67rdqh/styles/profileIcon_snoo5d5db3f8-d0c7-472b-944c-67d2c4ece99c-headshot.png?width=256&height=256&crop=256:256,smart&s=ba5638e71e06e2c474e1b7d6478450cd59fe6055\", // The URL to the avatar for the creator\n \"interactions_24h\": 392, // Number of interactions in the last 24 hours\n \"interactions_total\": 392 // Number of total interactions\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": false, "schema": { "type": "timestamp" } }, { "name": "end", "in": "query", "required": false, "schema": { "type": "timestamp" } } ] } }, "/public/topic/:topic/news/v1": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "topic": "bitcoin", "type": "topic", "id": "bitcoin", "name": "Bitcoin", "symbol": "BTC", "asset": "coins:1", "generated": 1793731462 }, "data": [ { "id": "coingeek.com-1397352207", "post_type": "news", "post_title": "Brazil, Thailand, India clarify crypto’s place in law, finance", "post_description": "Itaú Unibanco leads Brazil’s crypto compliance, as Thailand recognizes Bitcoin as property, and India advances programmable CBDCs for welfare payments.", "post_link": "https://coingeek.com/brazil-thailand-india-clarify-cryptos-place-in-law-finance/", "post_created": 1793700668, "post_sentiment": 3.34, "creator_id": "twitter::900507789017075712", "creator_name": "RealCoinGeek", "creator_display_name": "CoinGeek", "creator_followers": 34891, "creator_avatar": "https://pbs.twimg.com/profile_images/1841482546065948672/AQ-bdEaN_200x200.jpg", "interactions_24h": 297, "interactions_total": 296, "post_image": "https://coingeek.com/wp-content/uploads/2026/11/bitcoin-as-payment.webp" } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"topic\": \"bitcoin\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"type\": \"topic\", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer\n \"id\": \"bitcoin\", // LunarCrush internal ID for the asset\n \"name\": \"Bitcoin\", // The full name of the asset\n \"symbol\": \"BTC\", // The symbol for the asset\n \"asset\": \"coins:1\",\n \"generated\": 1793731462 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"id\": \"coingeek.com-1397352207\", // LunarCrush internal ID for the asset\n \"post_type\": \"news\", // The type of social post\n \"post_title\": \"Brazil, Thailand, India clarify crypto’s place in law, finance\", // The title text of the social post\n \"post_description\": \"Itaú Unibanco leads Brazil’s crypto compliance, as Thailand recognizes Bitcoin as property, and India advances programmable CBDCs for welfare payments.\", // The larger text description or body of the social post if available\n \"post_link\": \"https://coingeek.com/brazil-thailand-india-clarify-cryptos-place-in-law-finance/\", // The URL to view the social post on the social network\n \"post_created\": 1793700668, // The unix timestamp of our best indication of when the post was created\n \"post_sentiment\": 3.34, // 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.\n \"creator_id\": \"twitter::900507789017075712\", // The [network]::[unique_id] for the influencer\n \"creator_name\": \"RealCoinGeek\", // The unique screen name for the influencer\n \"creator_display_name\": \"CoinGeek\", // The chosen display name for the influencer if available\n \"creator_followers\": 34891, // number of followers the account has\n \"creator_avatar\": \"https://pbs.twimg.com/profile_images/1841482546065948672/AQ-bdEaN_200x200.jpg\", // The URL to the avatar for the creator\n \"interactions_24h\": 297, // Number of interactions in the last 24 hours\n \"interactions_total\": 296, // Number of total interactions\n \"post_image\": \"https://coingeek.com/wp-content/uploads/2026/11/bitcoin-as-payment.webp\" // The URL to the primary image for the post if available\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/topic/:topic/creators/v1": { "get": { "description": "Get the top creators for a social topic", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": [ { "creator_id": "youtube::UCQANb2YPwAtK-IQJrLaaUFw", "creator_name": "briantylercohen", "creator_avatar": "https://yt3.ggpht.com/P49fez73t1RPPGWT9ZWx_LSho_O8i49XrcpVwxRk3GQfzEQBTUs3gH0ZLUHdzuNxQpRYuLAfSQ=s88-c-k-c0x00ffffff-no-rj", "creator_followers": 5300000, "creator_rank": 1, "interactions_24h": 2903026 } ] }, "description": "```jsonc\n{\n \"data\": [\n {\n \"creator_id\": \"youtube::UCQANb2YPwAtK-IQJrLaaUFw\", // The [network]::[unique_id] for the influencer\n \"creator_name\": \"briantylercohen\", // The unique screen name for the influencer\n \"creator_avatar\": \"https://yt3.ggpht.com/P49fez73t1RPPGWT9ZWx_LSho_O8i49XrcpVwxRk3GQfzEQBTUs3gH0ZLUHdzuNxQpRYuLAfSQ=s88-c-k-c0x00ffffff-no-rj\", // The URL to the avatar for the creator\n \"creator_followers\": 5300000, // number of followers the account has\n \"creator_rank\": 1, // ranking based on all posts in the last 24 hours that have interactions\n \"interactions_24h\": 2903026 // Number of interactions in the last 24 hours\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/category/:category/v1": { "get": { "description": "Get summary information for a social category", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": { "topic": "_musicians", "title": "Musicians", "category_rank": 8, "related_topics": [ "aerosmith" ], "types_count": { "news": 765, "instagram-post": 3754, "reddit-post": 5888, "tiktok-video": 97470, "youtube-video": 65100, "tweet": 326346 }, "types_interactions": { "news": 4248549, "instagram-post": 4981498, "reddit-post": 1703429, "tiktok-video": 759218588, "youtube-video": 540193428, "tweet": 983906635 }, "types_sentiment": { "news": 87, "instagram-post": 76, "reddit-post": 79, "tiktok-video": 66, "youtube-video": 76, "tweet": 61 }, "types_sentiment_detail": { "news": { "negative": 174, "neutral": 281, "positive": 310 }, "instagram-post": { "negative": 331, "neutral": 1942, "positive": 1494 }, "reddit-post": { "negative": 745, "neutral": 3009, "positive": 2129 }, "tiktok-video": { "negative": 12172, "neutral": 54197, "positive": 31099 }, "youtube-video": { "negative": 9364, "neutral": 31721, "positive": 24005 }, "tweet": { "negative": 51121, "neutral": 185083, "positive": 90142 } }, "interactions_24h": 2294252127, "num_contributors": 280253, "num_posts": 499323, "trend": "up" } }, "description": "```jsonc\n{\n \"data\": {\n \"topic\": \"_musicians\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"title\": \"Musicians\", // The case sensitive title of the topic or category\n \"category_rank\": 8, // LunarCrush metric for ranking a social topic relative to all other social topics\n \"related_topics\": [ // an array of related topics\n \"aerosmith\"\n ],\n \"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\n \"news\": 765,\n \"instagram-post\": 3754,\n \"reddit-post\": 5888,\n \"tiktok-video\": 97470,\n \"youtube-video\": 65100,\n \"tweet\": 326346\n },\n \"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\n \"news\": 4248549,\n \"instagram-post\": 4981498,\n \"reddit-post\": 1703429,\n \"tiktok-video\": 759218588,\n \"youtube-video\": 540193428,\n \"tweet\": 983906635\n },\n \"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.\n \"news\": 87,\n \"instagram-post\": 76,\n \"reddit-post\": 79,\n \"tiktok-video\": 66,\n \"youtube-video\": 76,\n \"tweet\": 61\n },\n \"types_sentiment_detail\": { // An object with the breakdown of positive, neutral, and negative posts by 24h interactions for each social network\n \"news\": {\n \"negative\": 174,\n \"neutral\": 281,\n \"positive\": 310\n },\n \"instagram-post\": {\n \"negative\": 331,\n \"neutral\": 1942,\n \"positive\": 1494\n },\n \"reddit-post\": {\n \"negative\": 745,\n \"neutral\": 3009,\n \"positive\": 2129\n },\n \"tiktok-video\": {\n \"negative\": 12172,\n \"neutral\": 54197,\n \"positive\": 31099\n },\n \"youtube-video\": {\n \"negative\": 9364,\n \"neutral\": 31721,\n \"positive\": 24005\n },\n \"tweet\": {\n \"negative\": 51121,\n \"neutral\": 185083,\n \"positive\": 90142\n }\n },\n \"interactions_24h\": 2294252127, // Number of interactions in the last 24 hours\n \"num_contributors\": 280253, // The number of unique social contributors to the topic\n \"num_posts\": 499323, // Total number of posts with interactions on this topic in the last 24 hours\n \"trend\": \"up\" // One of up, down or flat to represent the general trend in interactions\n }\n}\n```" } } } } } }, "parameters": [ { "name": "category", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/category/:category/topics/v1": { "get": { "description": "Get the top topics for a social category", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": [ { "topic": 3038, "title": "Aerosmith", "topic_rank": 1629, "topic_rank_1h_previous": 1630, "topic_rank_24h_previous": 1616, "num_contributors": 2051, "social_dominance": 0.18448091276763087, "num_posts": 2938, "interactions_24h": 4512817 } ] }, "description": "```jsonc\n{\n \"data\": [\n {\n \"topic\": 3038, // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"title\": \"Aerosmith\", // The case sensitive title of the topic or category\n \"topic_rank\": 1629, // LunarCrush metric for ranking a social topic relative to all other social topics\n \"topic_rank_1h_previous\": 1630, // The topic rank from 1 hour ago\n \"topic_rank_24h_previous\": 1616, // The topic rank from 24 hours ago\n \"num_contributors\": 2051, // The number of unique social contributors to the topic\n \"social_dominance\": 0.18448091276763087, // The percent of the total social volume that this topic represents\n \"num_posts\": 2938, // Total number of posts with interactions on this topic in the last 24 hours\n \"interactions_24h\": 4512817 // Number of interactions in the last 24 hours\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "category", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/category/:category/time-series/v1": { "get": { "description": "Get historical time series data for a social category", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "category": "cryptocurrencies", "topic": "_cryptocurrencies", "type": "topic", "id": "_cryptocurrencies", "interval": "1w", "start": 1793059200, "end": 1793738663, "bucket": "hour", "metrics": [], "generated": 1793731463 }, "data": [ { "time": 1793059200, "contributors_active": 77514, "contributors_created": 4224, "interactions": 12989607, "posts_active": 188103, "posts_created": 6299, "sentiment": 75, "spam": 16321, "market_cap": 2679522849436, "volume_24h": 68220432840 } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"category\": \"cryptocurrencies\", // LunarCrush social category. Can only includes letters, numbers and spaces\n \"topic\": \"_cryptocurrencies\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"type\": \"topic\", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer\n \"id\": \"_cryptocurrencies\", // LunarCrush internal ID for the asset\n \"interval\": \"1w\", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc\n \"start\": 1793059200, // Start/from unix timestamp (in seconds)\n \"end\": 1793738663, // End/to unix timestamp (in seconds)\n \"bucket\": \"hour\", // Data is generally bucketed into hours or days\n \"metrics\": [], // Comma separated list of metrics to include or that are included\n \"generated\": 1793731463 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"time\": 1793059200, // A unix timestamp (in seconds)\n \"contributors_active\": 77514, // number of unique social accounts with posts that have interactions\n \"contributors_created\": 4224, // number of unique social accounts that created new posts\n \"interactions\": 12989607, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)\n \"posts_active\": 188103, // number of unique social posts with interactions\n \"posts_created\": 6299, // number of unique social posts created\n \"sentiment\": 75, // % 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.\n \"spam\": 16321, // The number of posts created that are considered spam\n \"market_cap\": 2679522849436, // Total dollar market value of all circulating supply or outstanding shares\n \"volume_24h\": 68220432840 // Volume in USD for 24 hours up to this data point\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "category", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "bucket", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "interval", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": false, "schema": { "type": "timestamp" } }, { "name": "end", "in": "query", "required": false, "schema": { "type": "timestamp" } } ] } }, "/public/category/:category/posts/v1": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "category": "cryptocurrencies", "type": "topic", "id": "_cryptocurrencies", "topic": "_cryptocurrencies", "generated": 1793731463 }, "data": [ { "id": "t3_1xmxo2q", "post_type": "reddit-post", "post_title": "Swiss Engineers Develops Collision-Resistant Flexible Drone", "post_description": "Researchers at ETH Zurich have developed FlexiQuad, a soft, ring-shaped quadcopter with a flexible frame that deforms on impact, absorbing collision energy while remaining airborne. Unlike conventional rigid drones, it can withstand collisions at speeds of up to 25 km/h and fly at speeds reaching 80 km/h. Its innovative design could enable safer operations in confined and hazardous environments, including collapsed buildings, ship inspections and dense forests. Researchers are also exploring its use in capturing unwanted drones: [https://ethz.ch/en/news-and-events/eth-news/news/2026/11/new-flexible-drone-can-withstand-collisions.html](https://ethz.ch/en/news-and-events/eth-news/news/2026/11/new-flexible-drone-can-withstand-collisions.html)\n\nVideo: [https://www.youtube.com/watch?v=Lvwp56\\_RPAI](https://www.youtube.com/watch?v=Lvwp56_RPAI)\n\nSTEW_ScTecEngWorld", "post_created": 1793723497, "post_sentiment": 2.79, "creator_id": "reddit::t2_hsqrqn1w", "creator_name": "Zee2A", "creator_display_name": "Zee2A", "creator_followers": 739493, "creator_avatar": "https://styles.redditmedia.com/t5_6eefve/styles/profileIcon_snoo-nftv2_bmZ0X2VpcDE1NToxMzdfYzhkM2EzYTgzYmRlNWRhZDA2ZDQzNjY5NGUzZTIyYWMzZTY0ZDU3N180ODkyODMz_rare_368b714c-0d7d-4086-b996-e25cb4812e9e-headshot.png?width=256&height=256&crop=256:256,smart&s=3abb4d6f847fb335179c1fc50c7708a0c11dc58b", "interactions_24h": 1496, "interactions_total": 1494 } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"category\": \"cryptocurrencies\", // LunarCrush social category. Can only includes letters, numbers and spaces\n \"type\": \"topic\", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer\n \"id\": \"_cryptocurrencies\", // Unique id of the social post\n \"topic\": \"_cryptocurrencies\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"generated\": 1793731463 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"id\": \"t3_1xmxo2q\", // Unique id of the social post\n \"post_type\": \"reddit-post\", // The type of social post\n \"post_title\": \"Swiss Engineers Develops Collision-Resistant Flexible Drone\", // The title text of the social post\n \"post_description\": \"Researchers at ETH Zurich have developed FlexiQuad, a soft, ring-shaped quadcopter with a flexible frame that deforms on impact, absorbing collision energy while remaining airborne. Unlike conventional rigid drones, it can withstand collisions at speeds of up to 25 km/h and fly at speeds reaching 80 km/h. Its innovative design could enable safer operations in confined and hazardous environments, including collapsed buildings, ship inspections and dense forests. Researchers are also exploring its use in capturing unwanted drones: [https://ethz.ch/en/news-and-events/eth-news/news/2026/11/new-flexible-drone-can-withstand-collisions.html](https://ethz.ch/en/news-and-events/eth-news/news/2026/11/new-flexible-drone-can-withstand-collisions.html)\\n\\nVideo: [https://www.youtube.com/watch?v=Lvwp56\\\\_RPAI](https://www.youtube.com/watch?v=Lvwp56_RPAI)\\n\\nSTEW_ScTecEngWorld\", // The larger text description or body of the social post if available\n \"post_created\": 1793723497, // The unix timestamp of our best indication of when the post was created\n \"post_sentiment\": 2.79, // 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.\n \"creator_id\": \"reddit::t2_hsqrqn1w\", // The [network]::[unique_id] for the influencer\n \"creator_name\": \"Zee2A\", // The unique screen name for the influencer\n \"creator_display_name\": \"Zee2A\", // The chosen display name for the influencer if available\n \"creator_followers\": 739493, // number of followers the account has\n \"creator_avatar\": \"https://styles.redditmedia.com/t5_6eefve/styles/profileIcon_snoo-nftv2_bmZ0X2VpcDE1NToxMzdfYzhkM2EzYTgzYmRlNWRhZDA2ZDQzNjY5NGUzZTIyYWMzZTY0ZDU3N180ODkyODMz_rare_368b714c-0d7d-4086-b996-e25cb4812e9e-headshot.png?width=256&height=256&crop=256:256,smart&s=3abb4d6f847fb335179c1fc50c7708a0c11dc58b\", // The URL to the avatar for the creator\n \"interactions_24h\": 1496, // Number of interactions in the last 24 hours\n \"interactions_total\": 1494 // Number of total interactions\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "category", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": false, "schema": { "type": "timestamp" } }, { "name": "end", "in": "query", "required": false, "schema": { "type": "timestamp" } } ] } }, "/public/category/:category/news/v1": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "category": "cryptocurrencies", "type": "topic", "id": "_cryptocurrencies", "topic": "_cryptocurrencies", "generated": 1793731463 }, "data": [ { "id": "cryptobriefing.com-982829822", "post_type": "news", "post_title": "Citrini Research favors AAVE, UNI, ETHFI, PENDLE, and ONDO in tokenization bet", "post_description": "Citrini Research's 79-page report backs AAVE, UNI, ETHFI, PENDLE, and ONDO as tokenization plays over a simple Bitcoin or Ether bet.", "post_link": "https://cryptobriefing.com/citrini-research-tokenization-aave-uni-ethfi-pendle/", "post_image": "https://static.cryptobriefing.com/wp-content/uploads/2026/10/08223147/library-citrini-research-favors-aave-uni-ethfi-pendle-and-ondo-i-800x450.png", "post_created": 1793700198, "post_sentiment": 3.18, "creator_id": "twitter::911716127365042177", "creator_name": "Crypto_Briefing", "creator_display_name": "Crypto Briefing", "creator_followers": 63713, "creator_avatar": "https://pbs.twimg.com/profile_images/1346106979605995520/BcuRRkze_200x200.jpg", "interactions_24h": 2158, "interactions_total": 2158 } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"category\": \"cryptocurrencies\", // LunarCrush social category. Can only includes letters, numbers and spaces\n \"type\": \"topic\", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer\n \"id\": \"_cryptocurrencies\", // LunarCrush internal ID for the asset\n \"topic\": \"_cryptocurrencies\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"generated\": 1793731463 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"id\": \"cryptobriefing.com-982829822\", // LunarCrush internal ID for the asset\n \"post_type\": \"news\", // The type of social post\n \"post_title\": \"Citrini Research favors AAVE, UNI, ETHFI, PENDLE, and ONDO in tokenization bet\", // The title text of the social post\n \"post_description\": \"Citrini Research's 79-page report backs AAVE, UNI, ETHFI, PENDLE, and ONDO as tokenization plays over a simple Bitcoin or Ether bet.\", // The larger text description or body of the social post if available\n \"post_link\": \"https://cryptobriefing.com/citrini-research-tokenization-aave-uni-ethfi-pendle/\", // The URL to view the social post on the social network\n \"post_image\": \"https://static.cryptobriefing.com/wp-content/uploads/2026/10/08223147/library-citrini-research-favors-aave-uni-ethfi-pendle-and-ondo-i-800x450.png\", // The URL to the primary image for the post if available\n \"post_created\": 1793700198, // The unix timestamp of our best indication of when the post was created\n \"post_sentiment\": 3.18, // 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.\n \"creator_id\": \"twitter::911716127365042177\", // The [network]::[unique_id] for the influencer\n \"creator_name\": \"Crypto_Briefing\", // The unique screen name for the influencer\n \"creator_display_name\": \"Crypto Briefing\", // The chosen display name for the influencer if available\n \"creator_followers\": 63713, // number of followers the account has\n \"creator_avatar\": \"https://pbs.twimg.com/profile_images/1346106979605995520/BcuRRkze_200x200.jpg\", // The URL to the avatar for the creator\n \"interactions_24h\": 2158, // Number of interactions in the last 24 hours\n \"interactions_total\": 2158 // Number of total interactions\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "category", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/category/:category/creators/v1": { "get": { "description": "Get the top creators for a social category", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": [ { "creator_id": "twitter::1940200488932110336", "creator_name": "laligaa_neews", "creator_avatar": "https://pbs.twimg.com/profile_images/2013546454321664000/ZGVUyS4T_200x200.jpg", "creator_followers": 6514, "creator_rank": 1, "interactions_24h": 116393492 } ] }, "description": "```jsonc\n{\n \"data\": [\n {\n \"creator_id\": \"twitter::1940200488932110336\", // The [network]::[unique_id] for the influencer\n \"creator_name\": \"laligaa_neews\", // The unique screen name for the influencer\n \"creator_avatar\": \"https://pbs.twimg.com/profile_images/2013546454321664000/ZGVUyS4T_200x200.jpg\", // The URL to the avatar for the creator\n \"creator_followers\": 6514, // number of followers the account has\n \"creator_rank\": 1, // ranking based on all posts in the last 24 hours that have interactions\n \"interactions_24h\": 116393492 // Number of interactions in the last 24 hours\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "category", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/categories/list/v1": { "get": { "description": "Get a list of trending social categories.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": [ { "category": "world cup", "title": "World Cup", "category_rank": 31, "category_rank_1h_previous": 99999, "category_rank_24h_previous": 99999, "num_contributors": 6215, "social_dominance": 0.09379772138196513, "num_posts": 11330, "interactions_24h": 49365811 } ] }, "description": "```jsonc\n{\n \"data\": [\n {\n \"category\": \"world cup\", // LunarCrush social category. Can only includes letters, numbers and spaces\n \"title\": \"World Cup\", // The case sensitive title of the topic or category\n \"category_rank\": 31, // LunarCrush metric for ranking a social topic relative to all other social topics\n \"category_rank_1h_previous\": 99999, // The topic rank from 1 hour ago\n \"category_rank_24h_previous\": 99999, // The topic rank from 24 hours ago\n \"num_contributors\": 6215, // The number of unique social contributors to the topic\n \"social_dominance\": 0.09379772138196513, // The percent of the total social volume that this topic represents\n \"num_posts\": 11330, // Total number of posts with interactions on this topic in the last 24 hours\n \"interactions_24h\": 49365811 // Number of interactions in the last 24 hours\n }\n ]\n}\n```" } } } } } }, "parameters": [] } }, "/public/creators/list/v1": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": [ { "creator_name": "Starlink", "creator_display_name": "Starlink", "creator_id": "1330170106501079041", "creator_network": "twitter", "creator_avatar": "https://pbs.twimg.com/profile_images/1720501511271383040/FXz_jiJu_200x200.jpg", "creator_followers": 1887014, "creator_posts": 571, "creator_rank": 1, "interactions_24h": 159874336 } ] }, "description": "```jsonc\n{\n \"data\": [\n {\n \"creator_name\": \"Starlink\", // The unique screen name for the influencer\n \"creator_display_name\": \"Starlink\", // The chosen display name for the influencer if available\n \"creator_id\": \"1330170106501079041\", // The [network]::[unique_id] for the influencer\n \"creator_network\": \"twitter\", // The social network for the post or influencer. We still refer to x as twitter out of developer preference.\n \"creator_avatar\": \"https://pbs.twimg.com/profile_images/1720501511271383040/FXz_jiJu_200x200.jpg\", // The URL to the avatar for the creator\n \"creator_followers\": 1887014, // number of followers the account has\n \"creator_posts\": 571, // total number of posts with interactions in the last 24 hours\n \"creator_rank\": 1, // ranking based on all posts in the last 24 hours that have interactions\n \"interactions_24h\": 159874336 // Number of interactions in the last 24 hours\n }\n ]\n}\n```" } } } } } }, "parameters": [] } }, "/public/creator/:network/:id/v1": { "get": { "description": "Get detail information on a specific creator", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": { "creator_id": "twitter::44196397", "creator_name": "elonmusk", "creator_display_name": "Elon Musk", "creator_avatar": "https://pbs.twimg.com/profile_images/2103567689515954176/aR-Kjpp4_200x200.jpg", "creator_followers": 241504743, "creator_rank": "19", "interactions_24h": 58453908, "topic_influence": [], "top_community": [ { "creator_name": "bot", "creator_display_name": "Grok Bot", "creator_avatar": "https://pbs.twimg.com/profile_images/2087219239275069440/KW6C403V_200x200.jpg", "count": 97 } ] } }, "description": "```jsonc\n{\n \"data\": {\n \"creator_id\": \"twitter::44196397\", // The [network]::[unique_id] for the influencer\n \"creator_name\": \"elonmusk\", // The unique screen name for the influencer\n \"creator_display_name\": \"Elon Musk\", // The chosen display name for the influencer if available\n \"creator_avatar\": \"https://pbs.twimg.com/profile_images/2103567689515954176/aR-Kjpp4_200x200.jpg\", // The URL to the avatar for the creator\n \"creator_followers\": 241504743, // number of followers the account has\n \"creator_rank\": \"19\", // ranking based on all posts in the last 24 hours that have interactions\n \"interactions_24h\": 58453908, // Number of interactions in the last 24 hours\n \"topic_influence\": [], // an array of social topics and the creators ranking on each topic\n \"top_community\": [ // an array of the top accounts that have recently mentioned this creator or that this creator has mentioned\n {\n \"creator_name\": \"bot\", // The unique screen name for the influencer\n \"creator_display_name\": \"Grok Bot\", // The chosen display name for the influencer if available\n \"creator_avatar\": \"https://pbs.twimg.com/profile_images/2087219239275069440/KW6C403V_200x200.jpg\", // The URL to the avatar for the creator\n \"count\": 97\n }\n ]\n }\n}\n```" } } } } } }, "parameters": [ { "name": "network", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/creator/:network/:id/time-series/v1": { "get": { "description": "Get time series data on a creator.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "network": "twitter", "influencer_id": "twitter::988992203568562176", "interval": "1w", "start": 1793059200, "end": 1793750400, "bucket": "hour", "name": "LunarCrush", "generated": 1793731463 }, "data": [ { "time": 1793059200, "followers": 297674, "interactions": 5163, "posts_active": 22, "posts_created": 1, "creator_rank": 257349 } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"network\": \"twitter\", // The social network for the post or influencer. We still refer to x as twitter out of developer preference.\n \"influencer_id\": \"twitter::988992203568562176\",\n \"interval\": \"1w\", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc\n \"start\": 1793059200, // Start/from unix timestamp (in seconds)\n \"end\": 1793750400, // End/to unix timestamp (in seconds)\n \"bucket\": \"hour\", // Data is generally bucketed into hours or days\n \"name\": \"LunarCrush\", // The full name of the asset\n \"generated\": 1793731463 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"time\": 1793059200, // A unix timestamp (in seconds)\n \"followers\": 297674, // The number of publicly displayed followers the creator has\n \"interactions\": 5163, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)\n \"posts_active\": 22, // number of unique social posts with interactions\n \"posts_created\": 1, // number of unique social posts created\n \"creator_rank\": 257349 // ranking based on all posts in the last 24 hours that have interactions\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "network", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "bucket", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "interval", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": false, "schema": { "type": "timestamp" } }, { "name": "end", "in": "query", "required": false, "schema": { "type": "timestamp" } } ] } }, "/public/creator/:network/:id/posts/v1": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": [ { "id": "2117666899844866098", "post_type": "tweet", "post_title": "🤨", "post_description": "Democrat Nominee for U.S. Senate in Michigan Abdul El-Sayed wants open borders and no deportations:\n\n“We as a country, I believe, owe it to the world to open our doors.”\n\nGet out and VOTE Republican against this. https://t.co/5b1GAqoQA9", "post_created": 1793726107, "post_sentiment": 3.05, "post_link": "https://x.com/elonmusk/status/2117666899844866098", "creator_id": "twitter::44196397", "creator_name": "elonmusk", "creator_display_name": "Elon Musk", "creator_followers": 241482078, "creator_avatar": "https://pbs.twimg.com/profile_images/2103567689515954176/aR-Kjpp4_200x200.jpg", "interactions_24h": 851940, "interactions_total": 851940 } ] }, "description": "```jsonc\n{\n \"data\": [\n {\n \"id\": \"2117666899844866098\", // Unique id of the social post\n \"post_type\": \"tweet\", // The type of social post\n \"post_title\": \"🤨\", // The title text of the social post\n \"post_description\": \"Democrat Nominee for U.S. Senate in Michigan Abdul El-Sayed wants open borders and no deportations:\\n\\n“We as a country, I believe, owe it to the world to open our doors.”\\n\\nGet out and VOTE Republican against this. https://t.co/5b1GAqoQA9\", // The larger text description or body of the social post if available\n \"post_created\": 1793726107, // The unix timestamp of our best indication of when the post was created\n \"post_sentiment\": 3.05, // 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.\n \"post_link\": \"https://x.com/elonmusk/status/2117666899844866098\", // The URL to view the social post on the social network\n \"creator_id\": \"twitter::44196397\", // The [network]::[unique_id] for the influencer\n \"creator_name\": \"elonmusk\", // The unique screen name for the influencer\n \"creator_display_name\": \"Elon Musk\", // The chosen display name for the influencer if available\n \"creator_followers\": 241482078, // number of followers the account has\n \"creator_avatar\": \"https://pbs.twimg.com/profile_images/2103567689515954176/aR-Kjpp4_200x200.jpg\", // The URL to the avatar for the creator\n \"interactions_24h\": 851940, // Number of interactions in the last 24 hours\n \"interactions_total\": 851940 // Number of total interactions\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "network", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": false, "schema": { "type": "timestamp" } }, { "name": "end", "in": "query", "required": false, "schema": { "type": "timestamp" } } ] } }, "/public/posts/:post_type/:post_id/v1": { "get": { "description": "Get details of a post", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "type": "tweet", "id": "1756378079893782591", "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", "description": null, "extraText": "https://lunarcrush.com/categories?rpp=300&page=1&cols=topic_rank%2Ccontributors_active%2Cposts_active%2Caverage_sentiment%2Cinteractions_24h%2Cinteractions_trend", "metrics": { "bookmarks": 1, "favorites": 18, "retweets": 3, "replies": 12, "views": 13009 }, "image": { "src": "https://pbs.twimg.com/media/GF_n3GQaoAA23sT.jpg", "width": 2048, "height": 989 }, "video": null, "images": null, "creator_id": "twitter::988992203568562176", "creator_name": "LunarCrush", "creator_display_name": "LunarCrush", "creator_avatar": "https://pbs.twimg.com/profile_images/1958717678476304384/CbzjwJvB_200x200.png", "topics": [ "lunarcrush" ], "categories": [] }, "description": "```jsonc\n{\n \"type\": \"tweet\", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer\n \"id\": \"1756378079893782591\", // Unique id of the social post\n \"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\n \"description\": null, // Explanation of the change and the potential impact\n \"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\n \"metrics\": { // Comma separated list of metrics to include or that are included\n \"bookmarks\": 1,\n \"favorites\": 18,\n \"retweets\": 3,\n \"replies\": 12,\n \"views\": 13009\n },\n \"image\": { // Provides the url/src width and height of a the image in the post if available\n \"src\": \"https://pbs.twimg.com/media/GF_n3GQaoAA23sT.jpg\",\n \"width\": 2048,\n \"height\": 989\n },\n \"video\": null, // Provides the url/src width and height of a the video in the post if available\n \"images\": null, // Provides the url/src width and height of a the images in the post if available\n \"creator_id\": \"twitter::988992203568562176\", // The [network]::[unique_id] for the influencer\n \"creator_name\": \"LunarCrush\", // The unique screen name for the influencer\n \"creator_display_name\": \"LunarCrush\", // The chosen display name for the influencer if available\n \"creator_avatar\": \"https://pbs.twimg.com/profile_images/1958717678476304384/CbzjwJvB_200x200.png\", // The URL to the avatar for the creator\n \"topics\": [\n \"lunarcrush\"\n ],\n \"categories\": [] // an array of categories this topic aggregates into\n}\n```" } } } } } }, "parameters": [ { "name": "post_type", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "post_id", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/posts/:post_type/:post_id/time-series/v1": { "get": { "description": "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", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": [ { "time": "1707523200", "interactions": 853 } ] }, "description": "```jsonc\n{\n \"data\": [\n {\n \"time\": \"1707523200\", // A unix timestamp (in seconds)\n \"interactions\": 853 // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "post_type", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "post_id", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/coins/list/v2": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "sort": "market_cap_rank", "desc": true, "limit": 0, "page": 0, "total_rows": 5521, "generated": 1793731463 }, "data": [ { "id": 1, "symbol": "BTC", "name": "Bitcoin", "price": 77638.56998481245, "price_btc": 1, "volume_24h": 23844739842.88, "volatility": 0.0081, "circulating_supply": 20105365, "max_supply": 21000000, "percent_change_1h": 0.085111550999, "percent_change_24h": 1.113605943623, "percent_change_7d": -3.633585133351, "market_cap": 1563425850324, "market_cap_rank": 1, "interactions_24h": 140836307, "social_volume_24h": 145052, "social_dominance": 29.971774643463746, "market_dominance": 60.052968107199625, "market_dominance_prev": 60.527444876835524, "galaxy_score": 38.3, "galaxy_score_previous": 44, "alt_rank": 153, "alt_rank_previous": 89, "sentiment": 70, "categories": "layer-1,bitcoin-ecosystem,pow", "blockchains": [ { "type": "layer1", "network": "bitcoin", "address": null, "decimals": null } ], "percent_change_30d": -9.011015795409, "last_updated_price": 1793731463, "last_updated_price_by": "cmc_stream", "topic": "btc bitcoin", "logo": "https://cdn.lunarcrush.com/bitcoin.png" } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"sort\": \"market_cap_rank\",\n \"desc\": true,\n \"limit\": 0,\n \"page\": 0,\n \"total_rows\": 5521,\n \"generated\": 1793731463 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"id\": 1, // LunarCrush internal ID for the asset\n \"symbol\": \"BTC\", // The symbol for the asset\n \"name\": \"Bitcoin\", // The full name of the asset\n \"price\": 77638.56998481245, // Current price in USD\n \"price_btc\": 1, // Current price in BTC\n \"volume_24h\": 23844739842.88, // Volume in USD for 24 hours up to this data point\n \"volatility\": 0.0081, // Volatility is calculated as the standard deviation of the price.\n \"circulating_supply\": 20105365, // 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\n \"max_supply\": 21000000, // The maximum supply of the asset if available\n \"percent_change_1h\": 0.085111550999, // Percent change in price since 1 hour ago\n \"percent_change_24h\": 1.113605943623, // Percent change in price since 24 hours ago\n \"percent_change_7d\": -3.633585133351, // Percent change in price since 7 days ago\n \"market_cap\": 1563425850324, // Total dollar market value of all circulating supply or outstanding shares\n \"market_cap_rank\": 1, // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.\n \"interactions_24h\": 140836307, // Number of interactions in the last 24 hours\n \"social_volume_24h\": 145052, // Total number of posts with interactions on this topic in the last 24 hours\n \"social_dominance\": 29.971774643463746, // The percent of the total social volume that this topic represents\n \"market_dominance\": 60.052968107199625, // The percent of the total market cap that this asset represents\n \"market_dominance_prev\": 60.527444876835524,\n \"galaxy_score\": 38.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\n \"galaxy_score_previous\": 44, // The galaxy score from the previous 24 hours\n \"alt_rank\": 153, // A proprietary score based on how an asset is performing relative to all other assets supported\n \"alt_rank_previous\": 89, // The alt rank from the previous 24 hours\n \"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.\n \"categories\": \"layer-1,bitcoin-ecosystem,pow\", // A comma delimited string of sub categories/sectors this asset belongs to\n \"blockchains\": [ // An array of blockchains that the asset is part of including the contract address and decimals if applicable\n {\n \"type\": \"layer1\", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer\n \"network\": \"bitcoin\", // The name of the blockchain or network\n \"address\": null, // The contract address, zero or null means it is a layer 1\n \"decimals\": null\n }\n ],\n \"percent_change_30d\": -9.011015795409, // Percent change in price since 30 days ago\n \"last_updated_price\": 1793731463,\n \"last_updated_price_by\": \"cmc_stream\",\n \"topic\": \"btc bitcoin\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"logo\": \"https://cdn.lunarcrush.com/bitcoin.png\" // The URL to the logo for the asset, topic, or category\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "desc", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "page", "in": "query", "required": false, "schema": {} } ] } }, "/public/coins/list/v1": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "sort": "market_cap_rank", "desc": true, "limit": 0, "page": 0, "total_rows": 5521, "generated": 1793731463 }, "data": [ { "id": 1, "symbol": "BTC", "name": "Bitcoin", "price": 77638.56998481245, "price_btc": 1, "volume_24h": 23844739842.88, "volatility": 0.0081, "circulating_supply": 20105365, "max_supply": 21000000, "percent_change_1h": 0.085111550999, "percent_change_24h": 1.113605943623, "percent_change_7d": -3.633585133351, "market_cap": 1563425850324, "market_cap_rank": 1, "interactions_24h": 140836307, "social_volume_24h": 145052, "social_dominance": 29.971774643463746, "market_dominance": 60.052968107199625, "market_dominance_prev": 60.527444876835524, "galaxy_score": 38.3, "galaxy_score_previous": 44, "alt_rank": 153, "alt_rank_previous": 89, "sentiment": 70, "categories": "layer-1,bitcoin-ecosystem,pow", "blockchains": [ { "type": "layer1", "network": "bitcoin", "address": null, "decimals": null } ], "percent_change_30d": -9.011015795409, "last_updated_price": 1793731463, "last_updated_price_by": "cmc_stream", "topic": "btc bitcoin", "logo": "https://cdn.lunarcrush.com/bitcoin.png" } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"sort\": \"market_cap_rank\",\n \"desc\": true,\n \"limit\": 0,\n \"page\": 0,\n \"total_rows\": 5521,\n \"generated\": 1793731463 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"id\": 1, // LunarCrush internal ID for the asset\n \"symbol\": \"BTC\", // The symbol for the asset\n \"name\": \"Bitcoin\", // The full name of the asset\n \"price\": 77638.56998481245, // Current price in USD\n \"price_btc\": 1, // Current price in BTC\n \"volume_24h\": 23844739842.88, // Volume in USD for 24 hours up to this data point\n \"volatility\": 0.0081, // Volatility is calculated as the standard deviation of the price.\n \"circulating_supply\": 20105365, // 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\n \"max_supply\": 21000000, // The maximum supply of the asset if available\n \"percent_change_1h\": 0.085111550999, // Percent change in price since 1 hour ago\n \"percent_change_24h\": 1.113605943623, // Percent change in price since 24 hours ago\n \"percent_change_7d\": -3.633585133351, // Percent change in price since 7 days ago\n \"market_cap\": 1563425850324, // Total dollar market value of all circulating supply or outstanding shares\n \"market_cap_rank\": 1, // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.\n \"interactions_24h\": 140836307, // Number of interactions in the last 24 hours\n \"social_volume_24h\": 145052, // Total number of posts with interactions on this topic in the last 24 hours\n \"social_dominance\": 29.971774643463746, // The percent of the total social volume that this topic represents\n \"market_dominance\": 60.052968107199625, // The percent of the total market cap that this asset represents\n \"market_dominance_prev\": 60.527444876835524,\n \"galaxy_score\": 38.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\n \"galaxy_score_previous\": 44, // The galaxy score from the previous 24 hours\n \"alt_rank\": 153, // A proprietary score based on how an asset is performing relative to all other assets supported\n \"alt_rank_previous\": 89, // The alt rank from the previous 24 hours\n \"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.\n \"categories\": \"layer-1,bitcoin-ecosystem,pow\", // A comma delimited string of sub categories/sectors this asset belongs to\n \"blockchains\": [ // An array of blockchains that the asset is part of including the contract address and decimals if applicable\n {\n \"type\": \"layer1\", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer\n \"network\": \"bitcoin\", // The name of the blockchain or network\n \"address\": null, // The contract address, zero or null means it is a layer 1\n \"decimals\": null\n }\n ],\n \"percent_change_30d\": -9.011015795409, // Percent change in price since 30 days ago\n \"last_updated_price\": 1793731463,\n \"last_updated_price_by\": \"cmc_stream\",\n \"topic\": \"btc bitcoin\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"logo\": \"https://cdn.lunarcrush.com/bitcoin.png\" // The URL to the logo for the asset, topic, or category\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "filter", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "desc", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "page", "in": "query", "required": false, "schema": {} } ] } }, "/public/coins/:coin/v1": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "id": "coins:2", "name": "Ethereum", "symbol": "ETH", "asset": "coins:2", "topic": "ethereum", "generated": 1793731463 }, "data": { "id": 2, "name": "Ethereum", "symbol": "ETH", "price": 2294.4288935608124, "price_btc": 0.029552693899561073, "market_cap": 280888185302, "percent_change_24h": 2.166746824009, "percent_change_7d": -2.112085643357, "percent_change_30d": -15.069599543406, "volume_24h": 7884003034.59, "max_supply": null, "circulating_supply": 122186161.86556138, "close": 2294.4288935608124, "galaxy_score": 73.8, "alt_rank": 23, "volatility": 0.0082, "market_cap_rank": 2 } }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"id\": \"coins:2\", // LunarCrush internal ID for the asset\n \"name\": \"Ethereum\", // The full name of the asset\n \"symbol\": \"ETH\", // The symbol for the asset\n \"asset\": \"coins:2\",\n \"topic\": \"ethereum\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"generated\": 1793731463 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": {\n \"id\": 2, // LunarCrush internal ID for the asset\n \"name\": \"Ethereum\", // The full name of the asset\n \"symbol\": \"ETH\", // The symbol for the asset\n \"price\": 2294.4288935608124, // Current price in USD\n \"price_btc\": 0.029552693899561073, // Current price in BTC\n \"market_cap\": 280888185302, // Total dollar market value of all circulating supply or outstanding shares\n \"percent_change_24h\": 2.166746824009, // Percent change in price since 24 hours ago\n \"percent_change_7d\": -2.112085643357, // Percent change in price since 7 days ago\n \"percent_change_30d\": -15.069599543406, // Percent change in price since 30 days ago\n \"volume_24h\": 7884003034.59, // Volume in USD for 24 hours up to this data point\n \"max_supply\": null, // The maximum supply of the asset if available\n \"circulating_supply\": 122186161.86556138, // 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\n \"close\": 2294.4288935608124, // Close price for the time period\n \"galaxy_score\": 73.8, // 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\n \"alt_rank\": 23, // A proprietary score based on how an asset is performing relative to all other assets supported\n \"volatility\": 0.0082, // Volatility is calculated as the standard deviation of the price.\n \"market_cap_rank\": 2 // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.\n }\n}\n```" } } } } } }, "parameters": [ { "name": "coin", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/coins/:coin/time-series/v2": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "coin": "2", "topic": "ethereum", "id": "coins:2", "name": "Ethereum", "symbol": "ETH", "asset": "coins:2", "interval": "1w", "start": 1793059200, "end": 1793738663, "bucket": "hour", "metrics": [], "generated": 1793731463 }, "data": [ { "time": 1793059200, "contributors_active": 11372, "contributors_created": 420, "interactions": 1428268, "posts_active": 18988, "posts_created": 700, "sentiment": 74, "spam": 2068, "alt_rank": 113, "circulating_supply": 122164245, "close": 2325.36, "galaxy_score": 58.6, "high": 2327.57, "low": 2319.2, "market_cap": 284075670052, "market_dominance": 10.6017, "open": 2320.28, "social_dominance": 10.0945, "volume_24h": 9767071142 } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"coin\": \"2\",\n \"topic\": \"ethereum\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"id\": \"coins:2\", // LunarCrush internal ID for the asset\n \"name\": \"Ethereum\", // The full name of the asset\n \"symbol\": \"ETH\", // The symbol for the asset\n \"asset\": \"coins:2\",\n \"interval\": \"1w\", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc\n \"start\": 1793059200, // Start/from unix timestamp (in seconds)\n \"end\": 1793738663, // End/to unix timestamp (in seconds)\n \"bucket\": \"hour\", // Data is generally bucketed into hours or days\n \"metrics\": [], // Comma separated list of metrics to include or that are included\n \"generated\": 1793731463 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"time\": 1793059200, // A unix timestamp (in seconds)\n \"contributors_active\": 11372, // number of unique social accounts with posts that have interactions\n \"contributors_created\": 420, // number of unique social accounts that created new posts\n \"interactions\": 1428268, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)\n \"posts_active\": 18988, // number of unique social posts with interactions\n \"posts_created\": 700, // number of unique social posts created\n \"sentiment\": 74, // % 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.\n \"spam\": 2068, // The number of posts created that are considered spam\n \"alt_rank\": 113, // A proprietary score based on how an asset is performing relative to all other assets supported\n \"circulating_supply\": 122164245, // 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\n \"close\": 2325.36, // Close price for the time period\n \"galaxy_score\": 58.6, // 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\n \"high\": 2327.57, // Higest price fo rthe time period\n \"low\": 2319.2, // Lowest price for the time period\n \"market_cap\": 284075670052, // Total dollar market value of all circulating supply or outstanding shares\n \"market_dominance\": 10.6017, // The percent of the total market cap that this asset represents\n \"open\": 2320.28, // Open price for the time period\n \"social_dominance\": 10.0945, // The percent of the total social volume that this topic represents\n \"volume_24h\": 9767071142 // Volume in USD for 24 hours up to this data point\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "coin", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "bucket", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "interval", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": false, "schema": { "type": "timestamp" } }, { "name": "end", "in": "query", "required": false, "schema": { "type": "timestamp" } } ] } }, "/public/coins/:coin/meta/v1": { "get": { "description": "Get meta information for a cryptocurrency project. This includes information such as the website, social media links, and other information.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": { "id": 2, "name": "Ethereum", "symbol": "ETH", "market_categories": "layer-1", "updated": 1741059248, "blockchain": [ { "type": "layer1", "network": "ethereum", "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.", "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": { "coin": "2", "generated": 1793731463 } }, "description": "```jsonc\n{\n \"data\": {\n \"id\": 2, // LunarCrush internal ID for the asset\n \"name\": \"Ethereum\", // The full name of the asset\n \"symbol\": \"ETH\", // The symbol for the asset\n \"market_categories\": \"layer-1\",\n \"updated\": 1741059248, // Timestamp of when the data was last updated\n \"blockchain\": [\n {\n \"type\": \"layer1\", // Type of item or social network of item e.g. tweet, youtube-video, tiktok, x, youtube, category, topic, creator/influencer\n \"network\": \"ethereum\", // The social network for the post or influencer. We still refer to x as twitter out of developer preference.\n \"address\": null,\n \"decimals\": null\n }\n ],\n \"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.\",\n \"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\n \"github_link\": \"https://github.com/ethereum\",\n \"website_link\": \"https://www.ethereum.org/\",\n \"whitepaper_link\": \"https://ethereum.org/en/whitepaper\",\n \"twitter_link\": \"https://twitter.com/ethereum\",\n \"reddit_link\": \"https://www.reddit.com/r/ethereum/\",\n \"header_image\": \"headers/ethereum.png\",\n \"header_text\": \"The foundation for our digital future\",\n \"videos\": \"https://www.youtube.com/watch?v=GQR1xjQn5Pg\",\n \"coingecko_link\": \"https://www.coingecko.com/en/coins/ethereum\",\n \"coinmarketcap_link\": \"https://coinmarketcap.com/currencies/ethereum/\"\n },\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"coin\": \"2\",\n \"generated\": 1793731463 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n }\n}\n```" } } } } } }, "parameters": [ { "name": "coin", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/stocks/list/v2": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "limit": 0, "sort": "market_cap_rank", "desc": true, "page": 0, "total_rows": 4335, "generated": 1793731464 }, "data": [ { "id": 7056, "symbol": "NVDA", "name": "NVIDIA Corporation", "price": 208, "volume_24h": 44132814, "percent_change_24h": 2.93972, "market_cap": 5012800000000, "market_cap_rank": 1, "interactions_24h": 72588947, "social_volume_24h": 33518, "social_dominance": 3.3296147767425643, "market_dominance": 5.128782259080154, "market_dominance_prev": 5.088412592692227, "galaxy_score": 56.2, "galaxy_score_previous": 56, "alt_rank": 110, "alt_rank_previous": 388, "sentiment": 84, "categories": "technology", "topic": "nvda nvidia corporation", "logo": "https://cdn.lunarcrush.com/stocks/nvda.png" } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"limit\": 0,\n \"sort\": \"market_cap_rank\",\n \"desc\": true,\n \"page\": 0,\n \"total_rows\": 4335,\n \"generated\": 1793731464 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"id\": 7056, // LunarCrush internal ID for the asset\n \"symbol\": \"NVDA\", // The symbol for the asset\n \"name\": \"NVIDIA Corporation\", // The full name of the asset\n \"price\": 208, // Current price in USD\n \"volume_24h\": 44132814, // Volume in USD for 24 hours up to this data point\n \"percent_change_24h\": 2.93972, // Percent change in price since 24 hours ago\n \"market_cap\": 5012800000000, // Total dollar market value of all circulating supply or outstanding shares\n \"market_cap_rank\": 1, // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.\n \"interactions_24h\": 72588947, // Number of interactions in the last 24 hours\n \"social_volume_24h\": 33518, // Total number of posts with interactions on this topic in the last 24 hours\n \"social_dominance\": 3.3296147767425643, // The percent of the total social volume that this topic represents\n \"market_dominance\": 5.128782259080154, // The percent of the total market cap that this asset represents\n \"market_dominance_prev\": 5.088412592692227,\n \"galaxy_score\": 56.2, // 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\n \"galaxy_score_previous\": 56, // The galaxy score from the previous 24 hours\n \"alt_rank\": 110, // A proprietary score based on how an asset is performing relative to all other assets supported\n \"alt_rank_previous\": 388, // The alt rank from the previous 24 hours\n \"sentiment\": 84, // % 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.\n \"categories\": \"technology\", // an array of categories this topic aggregates into\n \"topic\": \"nvda nvidia corporation\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"logo\": \"https://cdn.lunarcrush.com/stocks/nvda.png\" // The URL to the logo for the asset, topic, or category\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "desc", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "page", "in": "query", "required": false, "schema": {} } ] } }, "/public/stocks/list/v1": { "get": { "description": "Lists all stocks supported by LunarCrush. Includes the \"topic\" endpoint to use to get social data from this asset as a social topic.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "sort": "market_cap_rank", "desc": true, "limit": 0, "page": 0, "total_rows": 4335, "generated": 1793731464 }, "data": [ { "id": 7056, "symbol": "NVDA", "name": "NVIDIA Corporation", "price": 208, "volume_24h": 44132814, "percent_change_24h": 2.93972, "market_cap": 5012800000000, "market_cap_rank": 1, "interactions_24h": 72588947, "social_volume_24h": 33518, "social_dominance": 3.3296147767425643, "market_dominance": 5.128782259080154, "market_dominance_prev": 5.088412592692227, "galaxy_score": 56.2, "galaxy_score_previous": 56, "alt_rank": 110, "alt_rank_previous": 388, "sentiment": 84, "categories": "technology", "topic": "nvda nvidia corporation", "logo": "https://cdn.lunarcrush.com/stocks/nvda.png" } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"sort\": \"market_cap_rank\",\n \"desc\": true,\n \"limit\": 0,\n \"page\": 0,\n \"total_rows\": 4335,\n \"generated\": 1793731464 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"id\": 7056, // LunarCrush internal ID for the asset\n \"symbol\": \"NVDA\", // The symbol for the asset\n \"name\": \"NVIDIA Corporation\", // The full name of the asset\n \"price\": 208, // Current price in USD\n \"volume_24h\": 44132814, // Volume in USD for 24 hours up to this data point\n \"percent_change_24h\": 2.93972, // Percent change in price since 24 hours ago\n \"market_cap\": 5012800000000, // Total dollar market value of all circulating supply or outstanding shares\n \"market_cap_rank\": 1, // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.\n \"interactions_24h\": 72588947, // Number of interactions in the last 24 hours\n \"social_volume_24h\": 33518, // Total number of posts with interactions on this topic in the last 24 hours\n \"social_dominance\": 3.3296147767425643, // The percent of the total social volume that this topic represents\n \"market_dominance\": 5.128782259080154, // The percent of the total market cap that this asset represents\n \"market_dominance_prev\": 5.088412592692227,\n \"galaxy_score\": 56.2, // 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\n \"galaxy_score_previous\": 56, // The galaxy score from the previous 24 hours\n \"alt_rank\": 110, // A proprietary score based on how an asset is performing relative to all other assets supported\n \"alt_rank_previous\": 388, // The alt rank from the previous 24 hours\n \"sentiment\": 84, // % 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.\n \"categories\": \"technology\", // an array of categories this topic aggregates into\n \"topic\": \"nvda nvidia corporation\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"logo\": \"https://cdn.lunarcrush.com/stocks/nvda.png\" // The URL to the logo for the asset, topic, or category\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "number" } }, { "name": "desc", "in": "query", "required": false, "schema": { "type": "boolean" } }, { "name": "page", "in": "query", "required": false, "schema": {} } ] } }, "/public/stocks/:stock/v1": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "id": "stocks:7056", "name": "NVIDIA Corporation", "symbol": "NVDA", "asset": "stocks:7056", "isin": "US67066G1040", "topic": "$nvda", "generated": 1793731464 }, "data": { "id": 7056, "name": "NVIDIA Corporation", "symbol": "NVDA", "price": 208, "market_cap": 5012800000000, "percent_change_24h": 2.93972, "volume_24h": 44132814, "close": 208, "market_cap_rank": 1 } }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"id\": \"stocks:7056\", // LunarCrush internal ID for the asset\n \"name\": \"NVIDIA Corporation\", // The full name of the asset\n \"symbol\": \"NVDA\", // The symbol for the asset\n \"asset\": \"stocks:7056\",\n \"isin\": \"US67066G1040\",\n \"topic\": \"$nvda\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"generated\": 1793731464 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": {\n \"id\": 7056, // LunarCrush internal ID for the asset\n \"name\": \"NVIDIA Corporation\", // The full name of the asset\n \"symbol\": \"NVDA\", // The symbol for the asset\n \"price\": 208, // Current price in USD\n \"market_cap\": 5012800000000, // Total dollar market value of all circulating supply or outstanding shares\n \"percent_change_24h\": 2.93972, // Percent change in price since 24 hours ago\n \"volume_24h\": 44132814, // Volume in USD for 24 hours up to this data point\n \"close\": 208, // Close price for the time period\n \"market_cap_rank\": 1 // The rank of the asset by market cap with additional filtering to remove outliers and bad market data.\n }\n}\n```" } } } } } }, "parameters": [ { "name": "stock", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/stocks/:stock/time-series/v2": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "config": { "stock": "7056", "topic": "$nvda", "id": "stocks:7056", "name": "NVIDIA Corporation", "symbol": "NVDA", "asset": "stocks:7056", "isin": "US67066G1040", "interval": "1w", "start": 1793059200, "end": 1793738664, "bucket": "hour", "metrics": [], "generated": 1793731464 }, "data": [ { "time": 1793059200, "contributors_active": 11298, "contributors_created": 258, "interactions": 3905404, "posts_active": 16797, "posts_created": 385, "sentiment": 80, "spam": 1585, "alt_rank": 411, "close": 216, "galaxy_score": 68.8, "high": 216, "low": 216, "market_cap": 5271968600000, "market_dominance": 5.2528, "open": 216, "social_dominance": 3.4913 } ] }, "description": "```jsonc\n{\n \"config\": { // This includes the inputs for the request processed by the server and may include additional hints about the request and response information.\n \"stock\": \"7056\",\n \"topic\": \"$nvda\", // LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $\n \"id\": \"stocks:7056\", // LunarCrush internal ID for the asset\n \"name\": \"NVIDIA Corporation\", // The full name of the asset\n \"symbol\": \"NVDA\", // The symbol for the asset\n \"asset\": \"stocks:7056\",\n \"isin\": \"US67066G1040\",\n \"interval\": \"1w\", // Typically used for specifying time intervals like 1w = 1 week, 1m = 1 month etc\n \"start\": 1793059200, // Start/from unix timestamp (in seconds)\n \"end\": 1793738664, // End/to unix timestamp (in seconds)\n \"bucket\": \"hour\", // Data is generally bucketed into hours or days\n \"metrics\": [], // Comma separated list of metrics to include or that are included\n \"generated\": 1793731464 // A unix timestamp (in seconds) when the data was generated to understand possibly stale data\n },\n \"data\": [\n {\n \"time\": 1793059200, // A unix timestamp (in seconds)\n \"contributors_active\": 11298, // number of unique social accounts with posts that have interactions\n \"contributors_created\": 258, // number of unique social accounts that created new posts\n \"interactions\": 3905404, // number of all publicly measurable interactions on a social post (views, likes, comments, thumbs up, upvote, share etc)\n \"posts_active\": 16797, // number of unique social posts with interactions\n \"posts_created\": 385, // number of unique social posts created\n \"sentiment\": 80, // % 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.\n \"spam\": 1585, // The number of posts created that are considered spam\n \"alt_rank\": 411, // A proprietary score based on how an asset is performing relative to all other assets supported\n \"close\": 216, // Close price for the time period\n \"galaxy_score\": 68.8, // 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\n \"high\": 216, // Higest price fo rthe time period\n \"low\": 216, // Lowest price for the time period\n \"market_cap\": 5271968600000, // Total dollar market value of all circulating supply or outstanding shares\n \"market_dominance\": 5.2528, // The percent of the total market cap that this asset represents\n \"open\": 216, // Open price for the time period\n \"social_dominance\": 3.4913 // The percent of the total social volume that this topic represents\n }\n ]\n}\n```" } } } } } }, "parameters": [ { "name": "stock", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "bucket", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "interval", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "start", "in": "query", "required": false, "schema": { "type": "timestamp" } }, { "name": "end", "in": "query", "required": false, "schema": { "type": "timestamp" } } ] } }, "/public/searches/search": { "get": { "description": "Get recently popular social posts matching a single search term or phrase. Optionally configure and test a custom search configuration.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "error": "Error: search_json object requires at least 1 valid search term" }, "description": "```jsonc\n{\n \"error\": \"Error: search_json object requires at least 1 valid search term\"\n}\n```" } } } } } }, "parameters": [ { "name": "term", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "search_json", "in": "query", "required": false, "schema": { "type": "string" } } ] } }, "/public/searches/list": { "get": { "description": "List all custom search aggregations.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": [ { "id": "lc1s5M27Jq", "name": "Pump.fun Leaderboard", "search_json": { "terms": [], "rollups": [ "58mwi7czpsrjrdsv61bn1ynpnloghubxaueec141pump" ] }, "priority": true, "created": 1749064987 } ] }, "description": "```jsonc\n{\n \"data\": [\n {\n \"id\": \"lc1s5M27Jq\", // LunarCrush internal ID for the asset\n \"name\": \"Pump.fun Leaderboard\", // The full name of the asset\n \"search_json\": {\n \"terms\": [],\n \"rollups\": [\n \"58mwi7czpsrjrdsv61bn1ynpnloghubxaueec141pump\"\n ]\n },\n \"priority\": true,\n \"created\": 1749064987\n }\n ]\n}\n```" } } } } } }, "parameters": [] } }, "/public/searches/create": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "error": "Error: name is required" }, "description": "```jsonc\n{\n \"error\": \"Error: name is required\"\n}\n```" } } } } } }, "parameters": [ { "name": "name", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "search_json", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "priority", "in": "query", "required": false, "schema": { "type": "boolean" } } ] } }, "/public/searches/:slug/update": { "get": { "description": "Update a custom search aggregation name or priority. Search terms and configuration cannot be changed once created.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "error": "Error: search_json is required" }, "description": "```jsonc\n{\n \"error\": \"Error: search_json is required\"\n}\n```" } } } } } }, "parameters": [ { "name": "slug", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "name", "in": "query", "required": false, "schema": { "type": "string" } }, { "name": "search_json", "in": "query", "required": true, "schema": { "type": "string" } }, { "name": "priority", "in": "query", "required": false, "schema": { "type": "boolean" } } ] } }, "/public/searches/:slug/delete": { "get": { "description": "Delete a custom search aggregation.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "error": "Error: That item does not exist" }, "description": "```jsonc\n{\n \"error\": \"Error: That item does not exist\"\n}\n```" } } } } } }, "parameters": [ { "name": "slug", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/searches/:slug": { "get": { "description": "See the summary output of a custom search aggregation.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "error": "Use the topics endpoints to get the latest data like /public/topic/:slug/v1" }, "description": "```jsonc\n{\n \"error\": \"Use the topics endpoints to get the latest data like /public/topic/:slug/v1\"\n}\n```" } } } } } }, "parameters": [ { "name": "slug", "in": "query", "required": true, "schema": { "type": "string" } } ] } }, "/public/system/changes": { "get": { "description": "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.", "responses": { "200": { "description": "200 successful", "content": { "application/json": { "examples": { "default": { "summary": "Example response", "value": { "data": [ { "asset_type": "coins", "asset_id": 163874, "asset_name": "SNOWMOON (SNOWMOON)", "change": "search terms established", "description": "search criteria initially set for this asset for the purposes of tracking changes over time", "time": 1793727920 } ] }, "description": "```jsonc\n{\n \"data\": [\n {\n \"asset_type\": \"coins\", // One of coins, nfts, stocks, topic or category\n \"asset_id\": 163874, // The id of the asset (coin, nft, stock, topic, or category)\n \"asset_name\": \"SNOWMOON (SNOWMOON)\", // The descriptive name of the asset to help identify it\n \"change\": \"search terms established\", // The type of change that occurred\n \"description\": \"search criteria initially set for this asset for the purposes of tracking changes over time\", // Explanation of the change and the potential impact\n \"time\": 1793727920 // A unix timestamp (in seconds)\n }\n ]\n}\n```" } } } } } }, "parameters": [] } } } }