LunarCrush API — Social Intelligence for Markets
analyticscryptosocial-media
About
Production REST API turning 30-50M social posts/hour from X, Reddit, TikTok, YouTube, Instagram, and 10K+ news sources into structured signals across 5,000+ cryptocurrencies and 8,000+ equities. Proprietary metrics (Galaxy Score, AltRank, TopicRank) built for quantitative and qualitative use. 5+ years historical depth. <60s latency for real-time, 5 min for hourly aggregates. Single bearer auth, JSON throughout. Used by hedge funds, fintech, and autonomous agents.
Endpoints
Endpoints (37)
GET
/categories/list/v1Get a list of trending social categories.GET
/category/{category}/creators/v1Get the top creators for a social category.GET
/category/{category}/news/v1Get the top news posts for a category. Top news is determined by the metrics related to the social posts that mention the news posts.GET
/category/{category}/posts/v1Get 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.GET
/category/{category}/time-series/v1Get historical time series data for a social category.GET
/category/{category}/topics/v1Get the top topics for a social category.GET
/category/{category}/v1Get summary information for a social category.GET
/coins/{coin}/meta/v1Get meta information for a cryptocurrency project. This includes information such as the website, social media links, and other information.GET
/coins/{coin}/time-series/v2Get 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.GET
/coins/{coin}/v1Get 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.GET
/coins/list/v1Get 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. Use the coins/list/v2 endpoint for data updated every few seconds.GET
/coins/list/v2Get 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.GET
/creator/{network}/{id}/posts/v1Get 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.GET
/creator/{network}/{id}/time-series/v1Get time series data on a creator.GET
/creator/{network}/{id}/v1Get detail information on a specific creator.GET
/creators/list/v1Get 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.GET
/posts/{post_type}/{post_id}/time-series/v1Get 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.GET
/posts/{post_type}/{post_id}/v1Get details of a post.GET
/searches/{slug}See the summary output of a custom search aggregation.GET
/searches/{slug}/deleteDelete a custom search aggregation.GET
/searches/{slug}/updateUpdate a custom search aggregation name or priority. Search terms and configuration cannot be changed once created.GET
/searches/createCreate 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.GET
/searches/listList all custom search aggregations.GET
/searches/searchGet recently popular social posts matching a single search term or phrase. Optionally configure and test a custom search configuration.GET
/stocks/{stock}/time-series/v2Get 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.GET
/stocks/{stock}/v1Get market 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.GET
/stocks/list/v1Lists all stocks supported by LunarCrush. Includes the topic endpoint to use to get social data from this asset as a social topic.GET
/stocks/list/v2Get 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.GET
/system/changesUpdates 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.GET
/topic/{topic}/creators/v1Get the top creators for a social topic.GET
/topic/{topic}/news/v1Get 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.GET
/topic/{topic}/posts/v1Get 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.GET
/topic/{topic}/time-series/v1Get historical time series data for a social topic.GET
/topic/{topic}/time-series/v2Get historical time series data for a social topic.GET
/topic/{topic}/v1Get 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.GET
/topic/{topic}/whatsup/v1Generate an AI summary of the hottest news and social posts for a specific topic.GET
/topics/list/v1Get a list of trending social topics.