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:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/creator/twitter/elonmusk/v1
Example response:
{
"data": {
"creator_id": "twitter::44196397",
"creator_name": "elonmusk",
"creator_display_name": "Elon Musk",
"creator_avatar": "https://pbs.twimg.com/profile_images/2008546467615580160/57KcqsTA_200x200.jpg",
"creator_followers": 234296337,
"creator_rank": 2,
"interactions_24h": 318539577,
"topic_influence": [
{
"topic": "in the",
"count": 294,
"percent": 5.88,
"rank": [--]
}
],
"top_community": [
{
"creator_name": "grok",
"creator_display_name": "Grok",
"creator_avatar": "https://pbs.twimg.com/profile_images/1893219113717342208/Vgg2hEPa_200x200.jpg",
"count": [---]
}
]
}
}
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 [--] hours that have interactions
- interactions_24h: Number of interactions in the last [--] 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 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 [--] 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:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/creator/twitter/elonmusk/posts/v1
Example response:
{
"data": [
{
"id": "2016130284664598584",
"post_type": "tweet",
"post_title": "Troubling",
"post_created": 1769517892,
"post_sentiment": 3.15,
"post_link": "https://x.com/elonmusk/status/2016130284664598584",
"post_image": null,
"creator_id": "twitter::44196397",
"creator_name": "elonmusk",
"creator_display_name": "Elon Musk",
"creator_followers": 234295932,
"creator_avatar": "https://pbs.twimg.com/profile_images/2008546467615580160/57KcqsTA_200x200.jpg",
"interactions_24h": 0,
"interactions_total": [--------]
}
]
}
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 [--] and [--] with [--] being very negative, [--] being neutral, and [--] being very positive. A score of [---] is considered slightly positive.
- 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
- 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 [--] hours
- interactions_total: Number of total interactions
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 [--] 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 [--] maximum is [----] 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:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/coins/list/v1
Example response:
{
"config": {
"sort": "market_cap_rank",
"desc": true,
"limit": 0,
"page": 0,
"total_rows": 6643,
"generated": [----------]
},
"data": [
{
"id": 1,
"symbol": "BTC",
"name": "Bitcoin",
"price": 70488.52984241374,
"price_btc": 1,
"volume_24h": 54284138746.04592,
"volatility": 0.0112,
"circulating_supply": 19986896,
"max_supply": 21000000,
"percent_change_1h": 0.29358032,
"percent_change_24h": -2.01962055,
"percent_change_7d": -10.35961453,
"market_cap": 1408846915153.22,
"market_cap_rank": 1,
"interactions_24h": 176830299,
"social_volume_24h": 233002,
"social_dominance": 21.30872882177459,
"market_dominance": 58.79913531549883,
"market_dominance_prev": 58.494523565646205,
"galaxy_score": 47,
"galaxy_score_previous": 60,
"alt_rank": 860,
"alt_rank_previous": 23,
"sentiment": 77,
"categories": "layer-1,bitcoin-ecosystem,pow",
"blockchains": [
{
"type": "layer1",
"network": "bitcoin",
"address": null,
"decimals": null
}
],
"topic": "btc bitcoin",
"logo": "https://cdn.lunarcrush.com/bitcoin.png"
}
]
}
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 [--] 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 [--] hour ago
- percent_change_24h: Percent change in price since [--] hours ago
- percent_change_7d: Percent change in price since [--] 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 [--] hours
- social_volume_24h: Total number of posts with interactions on this topic in the last [--] 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 [--] 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 [--] 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 [--]
- topic: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
- logo: The URL to the logo for the asset, topic, or category
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:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/creators/v1
Example response:
{
"data": [
{
"creator_id": "twitter::1605310254085980161",
"creator_name": "Bitcoin_Teddy",
"creator_avatar": "https://pbs.twimg.com/profile_images/1739753415134138368/FrWHMAnb_200x200.jpg",
"creator_followers": 74293,
"creator_rank": 1,
"interactions_24h": [-------]
}
]
}
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 [--] hours that have interactions
- interactions_24h: Number of interactions in the last [--] hours
Limited data mode. Full metrics available with subscription: lunarcrush.com/pricing