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