[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.]
time interactions
2025-10-16 00:00 4912
2025-10-16 01:00 5851
2025-10-16 02:00 5774
2025-10-16 03:00 5587
2025-10-16 04:00 5757
2025-10-16 05:00 6933
2025-10-16 06:00 8118
2025-10-16 07:00 9149
2025-10-16 08:00 7770
2025-10-16 09:00 7372
2025-10-16 10:00 7949
2025-10-16 11:00 9336
2025-10-16 12:00 6755
2025-10-16 13:00 7978
2025-10-16 14:00 5094
2025-10-16 15:00 4251
2025-10-16 16:00 28555
2025-10-16 17:00 6626
2025-10-16 18:00 7902
2025-10-16 19:00 6237
2025-10-16 20:00 5230
2025-10-16 21:00 4434
2025-10-16 22:00 4825
2025-10-16 23:00 6745
2025-10-17 00:00 7328
2025-10-17 01:00 8933
2025-10-17 02:00 9998
2025-10-17 03:00 10725
2025-10-17 04:00 11662
2025-10-17 05:00 12316
2025-10-17 06:00 12040
2025-10-17 07:00 11214
2025-10-17 08:00 12338
2025-10-17 09:00 9147
2025-10-17 10:00 11323
2025-10-17 11:00 21608
2025-10-17 12:00 29790
2025-10-17 13:00 92794
2025-10-17 14:00 137338
2025-10-17 15:00 159411
2025-10-17 16:00 227868
2025-10-17 17:00 220837
2025-10-17 18:00 75077
2025-10-18 04:00 82184
2025-10-18 05:00 101984
2025-10-18 06:00 152513
2025-10-18 07:00 197608
2025-10-18 08:00 166078
2025-10-18 09:00 162733
2025-10-18 10:00 159774
2025-10-18 11:00 142049
2025-10-18 12:00 152759
2025-10-18 13:00 117942
2025-10-18 14:00 118172
2025-10-18 15:00 98418
2025-10-18 16:00 62271
2025-10-18 17:00 55749
2025-10-18 18:00 47052
2025-10-18 19:00 24920
2025-10-18 20:00 27146
2025-10-18 21:00 22804
2025-10-18 22:00 14137
2025-10-18 23:00 9379
2025-10-19 00:00 6661
2025-10-19 01:00 5397
2025-10-19 02:00 3902
2025-10-19 03:00 3889
2025-10-19 04:00 3299
2025-10-19 05:00 4397
2025-10-19 06:00 4303
2025-10-19 07:00 4757
2025-10-19 08:00 4787
2025-10-19 09:00 3756
2025-10-19 10:00 3864
2025-10-19 11:00 3613
2025-10-19 12:00 3364
2025-10-19 13:00 5606
2025-10-19 14:00 3278
2025-10-19 15:00 2003
2025-10-19 16:00 2583
2025-10-19 17:00 2754
2025-10-19 18:00 2686
2025-10-19 19:00 2582
2025-10-19 20:00 2856
2025-10-19 21:00 2489
2025-10-19 22:00 1571
2025-10-19 23:00 1862
2025-10-20 00:00 2663
2025-10-20 01:00 2045
2025-10-20 02:00 2227
2025-10-20 03:00 1392
2025-10-20 14:00 3129
2025-10-20 15:00 1420
2025-10-20 16:00 XXX
2025-10-21 00:00 35197
2025-10-21 01:00 34550
2025-10-21 02:00 34806
2025-10-21 03:00 26594
2025-10-21 04:00 30952
2025-10-21 05:00 38864
2025-10-21 06:00 32540
2025-10-21 07:00 40708
2025-10-21 08:00 37538
2025-10-21 09:00 23600
2025-10-21 10:00 25899
2025-10-21 11:00 22230
2025-10-21 12:00 21776
2025-10-21 13:00 24033
2025-10-21 14:00 22148
2025-10-21 15:00 24623
2025-10-21 16:00 24784
2025-10-21 17:00 20109
2025-10-21 18:00 14967
2025-10-21 19:00 6302
2025-10-21 20:00 87912
2025-10-21 21:00 XXX
2025-10-21 22:00 XX
2025-10-22 00:00 6113
2025-10-22 01:00 XXX
2025-10-22 02:00 XX
2025-10-22 03:00 XXX
2025-10-22 04:00 1351
2025-10-22 05:00 XX
2025-10-22 07:00 5913
2025-10-22 08:00 1235
2025-10-22 09:00 XX
Topics List
https://lunarcrush.com/api4/public/topics/list/v1
Get a list of trending social topics.
Example request:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topics/list/v1
Example response:
{
"data": [
{
"topic": "youtube",
"title": "YouTube",
"topic_rank": 1,
"topic_rank_1h_previous": 1,
"topic_rank_24h_previous": 1,
"num_contributors": 335952,
"num_posts": 733220,
"interactions_24h": 3296046298
}
]
}
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 X hour ago
- topic_rank_24h_previous: The topic rank from XX 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 XX hours
- interactions_24h: Number of interactions in the last XX hours
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:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v2
Example response:
{
"config": {
"topic": "bitcoin",
"id": "bitcoin",
"name": "Bitcoin",
"symbol": "BTC",
"interval": "1w",
"start": 1759968000,
"end": 1760654918,
"bucket": "hour",
"metrics": [],
"generated": 1760647718
},
"data": [
{
"time": 1759968000,
"contributors_active": 30745,
"contributors_created": 1810,
"interactions": 3972578,
"posts_active": 62957,
"posts_created": 2440,
"sentiment": 78,
"spam": 339,
"alt_rank": 198,
"circulating_supply": 19931834,
"close": 123004.71,
"galaxy_score": 56,
"high": 123004.71,
"low": 122931.87,
"market_cap": 2453542301616,
"market_dominance": 58.0797,
"open": 123004.71,
"social_dominance": 30.3039,
"volume_24h": 62979418928
}
]
}
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 = X week, 1m = X 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. XXX% means all posts are positive, XX% is half positive and half negative, and X% 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 XX hours up to this data point
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:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v1
Example response:
{
"config": {
"topic": "bitcoin",
"id": "bitcoin",
"name": "Bitcoin",
"symbol": "BTC",
"interval": "1w",
"start": 1759968000,
"end": 1760654918,
"bucket": "hour",
"metrics": [],
"generated": 1760647718
},
"data": [
{
"time": 1759968000,
"contributors_active": 30745,
"contributors_created": 1810,
"interactions": 3972578,
"posts_active": 62957,
"posts_created": 2440,
"sentiment": 78,
"spam": 339,
"alt_rank": 198,
"circulating_supply": 19931834,
"close": 123004.71,
"galaxy_score": 56,
"high": 123004.71,
"low": 122931.87,
"market_cap": 2453542301616,
"market_dominance": 58.0797,
"open": 123004.71,
"social_dominance": 30.3039,
"volume_24h": 62979418928
}
]
}
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 = X week, 1m = X 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. XXX% means all posts are positive, XX% is half positive and half negative, and X% 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 XX hours up to this data point
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 XX 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:
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/posts/v1
Example response:
{
"config": {
"topic": "bitcoin",
"type": "topic",
"id": "bitcoin",
"name": "Bitcoin",
"symbol": "BTC",
"generated": 1760647718
},
"data": [
{
"id": "t3_1o7u058",
"post_type": "reddit-post",
"post_title": "Made this bitcoin shadow box. Not sure if I'm crazy about this design but it's something",
"post_link": "https://redd.it/1o7u058",
"post_image": null,
"post_created": 1760646307,
"post_sentiment": 3.2,
"creator_id": "reddit::t2_kszqkqvk",
"creator_name": "Outrageous-Garage179",
"creator_display_name": "Outrageous-Garage179",
"creator_avatar": "https://styles.redditmedia.com/t5_60m8fu/styles/profileIcon_63j7drb563fa1.png?width=256&height=256&crop=256:256,smart&s=9b79b5074a344e0e8cf39a127dcfa5c2f4b5ecf3",
"interactions_24h": 1683,
"interactions_total": 1683
}
]
}
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_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 X and X with X being very negative, X being neutral, and X being very positive. A score of XXX 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_avatar: The URL to the avatar for the creator
- interactions_24h: Number of interactions in the last XX hours
- interactions_total: Number of total interactions