[GUEST ACCESS MODE: Data is scrambled or limited to provide examples. Make requests using your API key to unlock full data. Check https://lunarcrush.ai/auth for authentication information.] LunarCrush is a social intelligence platform that provides real-time insights and analytics on cryptocurrencies, stocks, and social media trends. LunarCrush can be used to provide an instant snapshot of the current global narrative, sentiment and popularity of any topic as well as the historical context to identify trends and patterns. - LLM Friendly website: - Human Friendly (HTML): - Markdown/HTML: - MCP Server (SSE): - MCP Server (Streamable HTTP): - Websocket Server: - Authentication: ## Categories A category is an aggregation of multiple topics related to the category. You can sort and filter categories by available metrics. [Cryptocurrencies](/list/cryptocurrencies/percent_change_24h/100) and [Stocks](/list/stocks.percent_change_24h/100) categories offer additional market metrics for sorting and the topics within the category also include additional market data. URL Structure: /list/{category}/{sort}/{limit} A {category} slug is the full name of the category in lower case with spaces replaced by dashes to make it URL friendly. Sorting metrics for Cryptocurrencies and Stocks are [`alt_rank`, `galaxy_score`, `close`, `percent_change_1h`, `percent_change_24h`, `percent_change_7d`, `interactions`, `posts_active`, `contributors_active`, `sentiment`, `social_dominance`, `market_cap`, `market_dominance`, `volume`, `circulating_supply`, `topic_rank`] All other categories will only have social metrics available for sorting: [`interactions`, `posts_active`, `contributors_active`, `sentiment`] Examples: [Top Automotive Brands by unique Creators](/list/automotive-brands/contributors_active) and [Top NFL Teams by # Mentions](/list/nfl/posts_active) Limit the number of rows by adding any numeric value equal to or less than 1000 in the URL as a limiter. Examples: [Top 10 Cryptocurrencies by AltRank™](/list/cryptocurrencies/alt_rank/10) and [Top 100 Stocks by Price % Change](/list/stocks/percent_change_24h/100) Categories are also available as a topic detail by prefixing the category slug with an underscore "_" for example: [Cryptocurrencies Detail](/topic/_cryptocurrencies) and [Stocks Detail](/topic/_stocks) - [Musicians](/list/musicians/100) - [MLB](/list/mlb/100) - [NCAA Basketball](/list/ncaa-basketball/100) - [Celebrities](/list/celebrities/100) - [PGA Golfers](/list/pga-golfers/100) - [Luxury Brands](/list/luxury-brands/100) - [Technology Brands](/list/technology-brands/100) - [NBA](/list/nba/100) - [Social Networks](/list/social-networks/100) - [Formula 1](/list/formula-1/100) - [Events](/list/events/100) - [NFL](/list/nfl/100) - [Fashion Brands](/list/fashion-brands/100) - [Cryptocurrencies](/list/cryptocurrencies/100) - [Exchanges](/list/exchanges/100) - [Countries](/list/countries/100) - [Premier League](/list/premier-league/100) - [NASCAR](/list/nascar/100) - [UFC](/list/ufc/100) - [Gaming](/list/gaming/100) - [Finance](/list/finance/100) - [Automotive Brands](/list/automotive-brands/100) - [NFTs](/list/nfts/100) - [MLS](/list/mls/100) - [Liga MX](/list/liga-mx/100) - [Travel Destinations](/list/travel-destinations/100) - [La Liga](/list/la-liga/100) - [Stocks](/list/stocks/100) - [Bundesliga](/list/bundesliga/100) - [NHL](/list/nhl/100) - [VC Firms](/list/vc-firms/100) - [Currencies](/list/currencies/100) - [Agencies](/list/agencies/100) - [NCAA Football](/list/ncaa-football/100) ## Topics A topic is an aggregation of social posts that impact or mention a specific social topic, cryptocurrency, or stock. Topic metrics and insights can also be merged with available market data if available to provide corelation and additional metrics such as the AltRank™ and Galaxy Score™ metrics. A topic does not need to be listed in a category to be tracked. You can use any keyword, phrase, $cashtag, or #hashtag to track a topic. Upon attempting to access a topic that is not currently tracked LunarCrush will automatically begin tracking that topic and trigger a full-historical aggregation to generate the longer time-frame metrics. Any topic listed in a category will be continuously tracked and updated. A topic that is not listed in a category will automatically be tracked if a user with an active subscription has the topic as a favorite. The [API](/api/public/searches/search) offers a way to create custom search aggregations that allow for multiple search terms as well as more granular rules such as "must include" or "must not include" a specific word or phrase. - [YouTube](/topic/youtube) - [United States of America](/topic/united-states) - [Roblox](/topic/roblox) - [ytshorts](/topic/ytshorts) - [Instagram](/topic/instagram) - [Donald Trump](/topic/donald-trump) - [India](/topic/india) - [generated](/topic/generated) - [Minecraft](/topic/minecraft) - [diy](/topic/diy) - [Bitcoin](/topic/bitcoin) - [Ethereum](/topic/ethereum) - [Elon Musk](/topic/elon-musk) - [LunarCrush](/topic/lunarcrush) - [Stacks Ecosystem](/topic/stacks-ecosystem) - [LeBron James](/topic/lebron-james) - [nVidia](/topic/$nvda) - [Fartcoin](/topic/$fartcoin) ## Creators A unique social account that is the creator of a social post. Creator metrics and insights are available as an aggregation of all social posts by the account. LunarCrush enables a quick understanding of current and historical follower count, posts and engagement metrics. See the topics and categories the creator mentions the most. You can get the top creators for any category by using the URL structure: /list/creators/_{category}/{sort}/{limit} where _{category} is the slug of the category prefixed with an underscore. Examples: [Top 10 Creators in Cryptocurrencies](/list/creators/_cryptocurrencies) and [Top 100 Creators in Stocks by # Posts](/list/creators/_stocks/mentions/100) You can get the top creators for any topic by using the URL structure: /list/creators/{topic}/{sort}/{limit} where {topic} is the slug of the topic. Examples: [Top 10 Creators in Bitcoin](/list/creators/bitcoin) and [Top 100 Creators in Ethereum by # Posts](/list/creators/ethereum/mentions/100) - [FoxNews](/creator/twitter/1367531) - [elonmusk](/creator/twitter/44196397) - [jaymondy](/creator/youtube/UCQFw803mpk_UHcgIdf1wcOA) - [coolitemsofficial916](/creator/youtube/UCyGlHNYIsiXV47jUbvYA5DQ) - [mrbeast](/creator/youtube/UCX6OQ3DkcsbYNE6H8uQQuVA) - [cadelandmia](/creator/youtube/UCGvGMmyEWp9hxDqmfLJbpkQ) - [ShamsCharania](/creator/twitter/178580925) - [Double_Date](/creator/youtube/UCoJ5osZ535ar2kzHwQMnLsA) - [espn](/creator/twitter/2557521) - [Village_gear](/creator/youtube/UC5Jy_XkAzzAPYhbUIB2a38Q) ## Posts A social post is content in the form of text, images, or video that has publicly available metrics to help determine the scale of influence the content at any point in time. Browse the most popular social posts from the last 24 hours. Browse the most popular posts within a specific topic: /topic/bitcoin/posts [vg0sd6X1EiE](/post/youtube-video/vg0sd6X1EiE) by [cred_club](/creator/youtube/UCxccMFkBeBi0oaQW6WVeo4g) pre-rush rush | The Coin Rush ... [1940395221835268233](/post/tweet/1940395221835268233) by [ChelseaFC](/creator/twitter/22910295) The boy from Brazil. 🇧🇷 ... [7522455376327937302](/post/tiktok-video/7522455376327937302) by [fcbarcelona](/creator/tiktok/6594121926820872197) The future is in your hands #fcbarcelona #raphinha #lamineyamal #pedri ... [7522452955983826183](/post/tiktok-video/7522452955983826183) by [bts_official_bighit](/creator/tiktok/6737188750352401410) Outside vibes. Killin’ it #ENHYPEN! #jhope_KillinItGirl #jhope #제이홉 @hobipower #JAKE #JUNGWON @enhyp... [l8t5FX2MohU](/post/youtube-video/l8t5FX2MohU) by [capitalface007](/creator/youtube/UCMGd-niwiojaUhwvxsc5sNg) big snake live #snakelive#cobra#snake😱😱 ... [1940367401532772707](/post/tweet/1940367401532772707) by [ErlingHaaland](/creator/twitter/2157651508) Didn’t go our way this time around. Congrats to Al Hilal and best of luck ahead 🙏🏻 ... [1940365859844915671](/post/tweet/1940365859844915671) by [imbrakoby](/creator/twitter/1292774848851251200) This is sad 💔 ... [ttqYSUEWXrU](/post/youtube-video/ttqYSUEWXrU) by [boxofvengeance](/creator/youtube/UCLGHEUaREx_FtNrqfJ8gXIA) POOJA BALL 🪔🪷⚾ #shorts #youtubeshorts #cricket #unboxing #ball ... [7522361982175989048](/post/tiktok-video/7522361982175989048) by [zoromiaw](/creator/tiktok/7222603550403216386) Teteh geulis pisan uyy🫦🤏🏻 #masyaallahtabarakkallah #kucingislami #kucing #catlover #catslovers #b... [1940284799966695914](/post/tweet/1940284799966695914) by [Starlink](/creator/twitter/1330170106501079041) Starlink's high-speed, low-latency internet is now available in Sri Lanka! 🛰️🇱🇰❤️ → ... ## Metrics Metrics are the numerical statistics that are tracked over time. Social metrics are continuously aggregated into a rolling 24-hour period and historically archived into hourly and daily intervals. For more detailed explanations how our social data is collected and structured please see our FAQ [Why Only Hourly And Daily Aggregations?](/faq/why-only-hourly-and-daily-aggregations) and [Can Historical Data Change Over Time?](faq/can-historical-data-change-over-time) This is a list of available metrics. Note that each metric has a name and the associated data key as [key] when using it in URLs and in the API output. **AltRank™** [alt_rank] AltRank™ evaluates both market and social data. This ranking system assesses an asset's price movement alongside its social activity indicators, offering a comprehensive view of its current standing in the crypto market. **Galaxy Score™** [galaxy_score] Galaxy Score™ assesses the health of an asset against itself. It evaluates an asset's performance by analyzing a combination of market and social indicators, providing a comprehensive view of its current standing. **Price** [close] Price calculates the amount of money expected, required, or given in payment for an asset. **1h %** [percent_change_1h] Percentage change in price over the last hour. **24h %** [percent_change_24h] Percentage change in price over the last 24 hours. **7d %** [percent_change_7d] Percentage change in price over the last 7 days. **Engagements** [interactions] LunarCrush monitors social engagements by aggregating and analyzing data from various social media platforms. Engagements tracked include views, likes, comments, retweets, and upvotes. **Mentions** [posts_active] Mentions measure the number of total posts that mention specific assets or topics over the last 24-hour timeframe. Mentions are measured continuously to monitor trends over longer timeframes. **Creators** [contributors_active] Creators measures the unique number of creators that have posts that are active and have received engagements. **Sentiment** [sentiment] Sentiment is the % of posts that are positive weighted by engagements. A score of 100% means all posts were positive and 0% means all posts were negative. **Social Dominance** [social_dominance] Social Dominance measures the "share of voice" across social media data of an asset relative to the categories that asset resides in and is calculated on a rolling 24-hour timeframe. **Market Cap** [market_cap] Market Capitalization shows how much a company, coin, or token is worth as determined by the total market value of all outstanding shares, coins, or tokens. **Market Dominance** [market_dominance] Market Dominance tracks the relative market cap of an asset vs. the entire market. Market Dominance is calculated as a relative percentage of 100%. **Trading Volume** [volume] Trading Volume is the number of shares, coins, or tokens traded in a particular period of time. **Circulating Supply** [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. **TopicRank™** [topic_rank] TopicRank™ ranks every topic on LunarCrush based on the number of engagements and mentions over the last 24 hours. Topics are tracked across all categories as well as topics that do not reside in any category at all. **CreatorRank™** [influencer_rank] CreatorRank™ tracks the relative ranking of a creator based on all tracked creators overall or within a specific category or topic. **Followers** [followers] The number of followers on of the creator account. ## Developers API The base URL for the LunarCrush API is https://lunarcrush.com/api4 The full documentation website for humans is available at [https://lunarcrush.com/developers/api/endpoints](https://lunarcrush.com/developers/api/endpoints) The full documentation in markdown for fast LLM access is available at [/api](/api) To gain access to the API you will need to create a LunarCrush account and subscribe to any plan. You can manage your API keys in the [Authentication](https://lunarcrush.com/developers/api/authentication) section of the developer docs. [Topics List](/api/public/topics/list/v1) - /public/topics/list/v1 - Get a list of trending social topics. [Topic Whatsup](/api/public/topic/:topic/whatsup/v1) - /public/topic/:topic/whatsup/v1 - Generate an AI summary of the hottest news and social posts for a specific topic [Topic](/api/public/topic/:topic/v1) - /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. [Topic Time Series v2](/api/public/topic/:topic/time-series/v2) - /public/topic/:topic/time-series/v2 - Get historical time series data for a social topic [Topic Time Series](/api/public/topic/:topic/time-series/v1) - /public/topic/:topic/time-series/v1 - Get historical time series data for a social topic [Topic Posts](/api/public/topic/:topic/posts/v1) - /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. [Topic News](/api/public/topic/:topic/news/v1) - /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. [Topic Creators](/api/public/topic/:topic/creators/v1) - /public/topic/:topic/creators/v1 - Get the top creators for a social topic [Category](/api/public/category/:category/v1) - /public/category/:category/v1 - Get summary information for a social category [Category Topics](/api/public/category/:category/topics/v1) - /public/category/:category/topics/v1 - Get the top topics for a social category [Category Time Series](/api/public/category/:category/time-series/v1) - /public/category/:category/time-series/v1 - Get historical time series data for a social category [Category Posts](/api/public/category/:category/posts/v1) - /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. [Category News](/api/public/category/:category/news/v1) - /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. [Category Creators](/api/public/category/:category/creators/v1) - /public/category/:category/creators/v1 - Get the top creators for a social category [Categories List](/api/public/categories/list/v1) - /public/categories/list/v1 - Get a list of trending social categories. [Creators List](/api/public/creators/list/v1) - /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. [Creator](/api/public/creator/:network/:id/v1) - /public/creator/:network/:id/v1 - Get detail information on a specific creator [Creator Time Series](/api/public/creator/:network/:id/time-series/v1) - /public/creator/:network/:id/time-series/v1 - Get time series data on a creator. [Creator Posts](/api/public/creator/:network/:id/posts/v1) - /public/creator/:network/:id/posts/v1 - Get the top posts for a specific creator. [Posts](/api/public/posts/:post_type/:post_id/v1) - /public/posts/:post_type/:post_id/v1 - Get details of a post [Posts Time Series](/api/public/posts/:post_type/:post_id/time-series/v1) - /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 [Coins List v2](/api/public/coins/list/v2) - /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. [Coins List](/api/public/coins/list/v1) - /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. [Coins](/api/public/coins/:coin/v1) - /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. [Coins Time Series](/api/public/coins/:coin/time-series/v2) - /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. [Coins Meta](/api/public/coins/:coin/meta/v1) - /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. [Stocks List v2](/api/public/stocks/list/v2) - /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. [Stocks List](/api/public/stocks/list/v1) - /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. [Stocks](/api/public/stocks/:stock/v1) - /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. [Stocks Time Series](/api/public/stocks/:stock/time-series/v2) - /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. [Searches Search](/api/public/searches/search) - /public/searches/search - Get recently popular social posts matching a single search term or phrase. Optionally configure and test a custom search configuration. [Searches List](/api/public/searches/list) - /public/searches/list - List all custom search aggregations. [Searches Create](/api/public/searches/create) - /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. [Searches Update](/api/public/searches/:slug/update) - /public/searches/:slug/update - Update a custom search aggregation name or priority. Search terms and configuration cannot be changed once created. [Searches Delete](/api/public/searches/:slug/delete) - /public/searches/:slug/delete - Delete a custom search aggregation. [Searches](/api/public/searches/:slug) - /public/searches/:slug - See the summary output of a custom search aggregation. [System Changes](/api/public/system/changes) - /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.