[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	social_dominance
2025-07-24 21:00	XXXXXX
2025-07-24 22:00	XXXXXX
2025-07-24 23:00	XXXXXX
2025-07-25 00:00	XXXXXX
2025-07-25 01:00	XXXXXX
2025-07-25 02:00	XXXXXX
2025-07-25 03:00	XXXXXX
2025-07-25 04:00	XXXXXX
2025-07-25 05:00	XXXXXX
2025-07-25 06:00	XXXXXX
2025-07-25 07:00	XXXXXX
2025-07-25 08:00	XXXXXX
2025-07-25 09:00	XXXXXX
2025-07-25 10:00	XXXXXX
2025-07-25 11:00	XXXXXX
2025-07-25 12:00	XXXXXX
2025-07-25 13:00	XXXXXX
2025-07-25 14:00	XXXXXX
2025-07-25 15:00	XXXXXX
2025-07-25 16:00	XXXXXX
2025-07-25 17:00	XXXXXX
2025-07-25 18:00	XXXXXX
2025-07-25 19:00	XXXXXX
2025-07-25 20:00	
2025-07-25 21:00	
2025-07-25 22:00	
2025-07-25 23:00	
2025-07-26 00:00	
2025-07-26 01:00	
2025-07-26 02:00	
2025-07-26 03:00	
2025-07-26 04:00	
2025-07-26 05:00	
2025-07-26 06:00	
2025-07-26 07:00	
2025-07-26 08:00	
2025-07-26 09:00	
2025-07-26 10:00	
2025-07-26 11:00	
2025-07-26 12:00	
2025-07-26 13:00	
2025-07-26 14:00	
2025-07-26 15:00	
2025-07-26 16:00	
2025-07-26 17:00	
2025-07-26 18:00	
2025-07-26 19:00	
2025-07-26 20:00	
2025-07-26 21:00	
2025-07-26 22:00	
2025-07-26 23:00	
2025-07-27 00:00	
2025-07-27 01:00	
2025-07-27 02:00	
2025-07-27 03:00	
2025-07-27 04:00	
2025-07-27 05:00	
2025-07-27 06:00	
2025-07-27 07:00	
2025-07-27 08:00	
2025-07-27 09:00	
2025-07-27 10:00	
2025-07-27 11:00	
2025-07-27 12:00	
2025-07-27 13:00	
2025-07-27 14:00	
2025-07-27 15:00	
2025-07-27 16:00	
2025-07-27 17:00	
2025-07-27 18:00	
2025-07-27 19:00	
2025-07-27 20:00	
2025-07-27 21:00	
2025-07-27 22:00	
2025-07-27 23:00	
2025-07-28 00:00	
2025-07-28 01:00	
2025-07-28 02:00	
2025-07-28 03:00	
2025-07-28 04:00	
2025-07-28 05:00	
2025-07-28 06:00	
2025-07-28 07:00	XXXXXX
2025-07-28 08:00	
2025-07-28 09:00	
2025-07-28 10:00	
2025-07-28 11:00	
2025-07-28 12:00	
2025-07-28 13:00	
2025-07-28 14:00	
2025-07-28 15:00	XXXXXX
2025-07-28 16:00	XXXXXX
2025-07-28 17:00	XXXXXX
2025-07-28 18:00	XXXXXX
2025-07-28 19:00	XXXXXX
2025-07-28 20:00	XXXXXX
2025-07-28 21:00	XXXXXX
2025-07-28 22:00	XXXXXX
2025-07-28 23:00	XXXXXX
2025-07-29 00:00	XXXXXX
2025-07-29 01:00	XXXXXX
2025-07-29 02:00	XXXXXX
2025-07-29 03:00	XXXXXX
2025-07-29 04:00	XXXXXX
2025-07-29 05:00	XXXXXXX
2025-07-29 06:00	XXXXXXX
2025-07-29 07:00	XXXXXXX
2025-07-29 08:00	XXXXXXX
2025-07-29 09:00	XXXXXXX
2025-07-29 10:00	XXXXXXX
2025-07-29 11:00	XXXXXXX
2025-07-29 12:00	XXXXXXX
2025-07-29 13:00	XXXXXXX
2025-07-29 14:00	XXXXXXX
2025-07-29 15:00	XXXXXXX
2025-07-29 16:00	XXXXXXX
2025-07-29 17:00	XXXXXXX
2025-07-29 18:00	
2025-07-29 19:00	
2025-07-29 20:00	
2025-07-29 21:00	
2025-07-29 22:00	
2025-07-29 23:00	
2025-07-30 00:00	
2025-07-30 01:00	
2025-07-30 02:00	
2025-07-30 03:00	
2025-07-30 04:00	
2025-07-30 05:00	
2025-07-30 06:00	
2025-07-30 07:00	
2025-07-30 08:00	
2025-07-30 09:00	
2025-07-30 10:00	
2025-07-30 11:00	
2025-07-30 12:00	
2025-07-30 13:00	
2025-07-30 14:00	
2025-07-30 15:00	
2025-07-30 16:00	
2025-07-30 17:00	
2025-07-30 18:00	
2025-07-30 19:00	
2025-07-30 20:00	
2025-07-30 21:00	
2025-07-30 22:00	
2025-07-30 23:00	
2025-07-31 00:00	
2025-07-31 01:00	
2025-07-31 02:00	
2025-07-31 03:00	
2025-07-31 04:00	
2025-07-31 05:00	
2025-07-31 06:00	
2025-07-31 07:00	
2025-07-31 08:00	
2025-07-31 09:00	
2025-07-31 10:00	
2025-07-31 11:00	
2025-07-31 12:00	
2025-07-31 13:00	
2025-07-31 14:00	
2025-07-31 15:00	
2025-07-31 16:00	
2025-07-31 17:00	
2025-07-31 18:00	
2025-07-31 19:00	
2025-07-31 20:00	
2025-07-31 21:00	
2025-07-31 22:00	
2025-07-31 23:00	
2025-08-01 00:00	
2025-08-01 01:00	
2025-08-01 02:00	
2025-08-01 03:00	
2025-08-01 04:00	
2025-08-01 05:00	
2025-08-01 06:00	
2025-08-01 07:00	
2025-08-01 08:00	
2025-08-01 09:00	
2025-08-01 10:00	
2025-08-01 11:00	
2025-08-01 12:00	
2025-08-01 13:00	XXXXXX
2025-08-01 14:00	
2025-08-01 15:00	
2025-08-01 16:00	
2025-08-01 17:00	
2025-08-01 18:00	
2025-08-01 19:00	
2025-08-01 20:00	XXXXXX
2025-08-01 21:00	XXXXXXXXXXXXXXXXXXXXXX

### 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 <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v2
```



Example response:

```json
{
  "config": {
    "topic": "bitcoin",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1750896000,
    "end": 1751559896,
    "bucket": "hour",
    "metrics": [],
    "generated": 1751552696
  },
  "data": [
    {
      "time": 1750896000,
      "contributors_active": 22916,
      "contributors_created": 1375,
      "interactions": 3979171,
      "posts_active": 46549,
      "posts_created": 1920,
      "sentiment": 77,
      "spam": 771,
      "alt_rank": 35,
      "circulating_supply": 19883512,
      "close": 107427,
      "galaxy_score": 72,
      "high": 107427,
      "low": 107324.55,
      "market_cap": 2136184884191,
      "market_dominance": 64.9097,
      "open": 107375.07,
      "social_dominance": 25.1594,
      "volume_24h": 51567717214
    }
  ]
}
```

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:

```bash
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topic/bitcoin/time-series/v1
```



Example response:

```json
{
  "config": {
    "topic": "bitcoin",
    "id": "bitcoin",
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1750896000,
    "end": 1751559896,
    "bucket": "hour",
    "metrics": [],
    "generated": 1751552696
  },
  "data": [
    {
      "time": 1750896000,
      "contributors_active": 22916,
      "contributors_created": 1375,
      "interactions": 3979171,
      "posts_active": 46549,
      "posts_created": 1920,
      "sentiment": 77,
      "spam": 771,
      "alt_rank": 35,
      "circulating_supply": 19883512,
      "close": 107427,
      "galaxy_score": 72,
      "high": 107427,
      "low": 107324.55,
      "market_cap": 2136184884191,
      "market_dominance": 64.9097,
      "open": 107375.07,
      "social_dominance": 25.1594,
      "volume_24h": 51567717214
    }
  ]
}
```

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




---

### 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 <API_KEY>" https://lunarcrush.com/api4/public/category/musicians/topics/v1
```



Example response:

```json
{
  "data": [
    {
      "topic": 3038,
      "title": "Aerosmith",
      "topic_rank": 1740,
      "topic_rank_1h_previous": 1894,
      "topic_rank_24h_previous": 1742,
      "num_contributors": 1351,
      "social_dominance": 0.17210620600552226,
      "num_posts": 1825,
      "interactions_24h": 3203522
    }
  ]
}
```

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
+ **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 XX hours
+ **interactions_24h**: Number of interactions in the last XX hours




---

### Topics List

https://lunarcrush.com/api4/public/topics/list/v1

Get a list of trending social topics.

Example request:

```bash
curl -H "Authorization: Bearer <API_KEY>" https://lunarcrush.com/api4/public/topics/list/v1
```



Example response:

```json
{
  "data": [
    {
      "topic": "youtube",
      "title": "YouTube",
      "topic_rank": 1,
      "topic_rank_1h_previous": 1,
      "topic_rank_24h_previous": 1,
      "num_contributors": 412953,
      "num_posts": 836638,
      "interactions_24h": 3573313797
    }
  ]
}
```

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




---