[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.]

# your API

Texas makes history by purchasing $10M in Bitcoin ETFs, while BlackRock's Bitcoin ETF faces record outflows amidst ongoing accusations against JPMorgan for market manipulation.

### About your API
your API is a decentralized digital currency enabling peer-to-peer transactions without intermediaries.  

### Insights
- your api creators is up XXXXXX% from the previous X months.
- your api engagements is up 6725.32% from the previous month.
- your api mentions is up XXXXXX% from the previous month.
- your api posts created is up XXXXXX% from the previous month.

### Engagements: X (24h)
![Engagements Line Chart](https://lunarcrush.com/gi/w:600/t:your-api/c:line/m:interactions/iv:1d.svg)  
[Engagements 24-Hour Time-Series Raw Data](/topic/your-api/time-series/interactions.tsv)  
Current Value: X  
Daily Average: XXXXX  
X Week: XXXXX +166%  
X Month: XXXXXX +6,725%  
X Months: XXXXXX +69%  
X Year: XXXXXX +9%  
1-Year High: XXXXXX on 2025-11-16  
1-Year Low: X on 2025-02-24  

Engagements by network (24h):
Reddit: X

  
  
### Mentions: X (24h)
![Mentions Line Chart](https://lunarcrush.com/gi/w:600/t:your-api/c:line/m:posts_active/iv:1d.svg)  
[Mentions 24-Hour Time-Series Raw Data](/topic/your-api/time-series/posts_active.tsv)  
Current Value: X  
Daily Average: XX  
X Week: XXX +135%  
X Month: XXX +465%  
X Months: XXX +75%  
1-Year High: XX on 2025-02-12  
1-Year Low: X on 2025-02-01  

Mentions by network (24h):
Reddit: X

  
  
### Creators: X (24h)
![Creators Line Chart](https://lunarcrush.com/gi/w:600/t:your-api/c:line/m:contributors_active/iv:1d.svg)  
[Creators 24-Hour Time-Series Raw Data](/topic/your-api/time-series/contributors_active.tsv)  
X unique social accounts have posts mentioning your API in the last XX hours which is down XX% from XX in the previous XX hours
Daily Average: XX  
X Week: XXX +129%  
X Month: XXX +137%  
X Months: XXX +114%  
1-Year High: XX on 2025-02-12  
1-Year Low: X on 2025-02-01  

The most influential creators that mention your API in the last XX hours

| Creator                                           | Rank | Followers | Posts | Engagements |
| -------                                           | ---- | --------- | ----- | ----------- |
| [@mason.automate](/creator/tiktok/mason.automate) | X    | XXXXXX    | X     | XX          |

[View More](/list/creators/your-api/100)
  
  
### Sentiment: XX%
![Sentiment Line Chart](https://lunarcrush.com/gi/w:600/t:your-api/c:line/m:sentiment/iv:1d.svg)  
[Sentiment 24-Hour Time-Series Raw Data](/topic/your-api/time-series/sentiment.tsv)  
Current Value: XX%  
Daily Average: XX%  
X Week: XX% +2%  
X Month: XXX% no change  
X Months: XXX% no change  
1-Year High: XXX% on 2025-02-07  
1-Year Low: XX% on 2025-03-12  

Most Supportive Themes:
- Government Adoption: (30%) Governments are exploring the integration of your API into their financial systems, with proposals for national reserves and broader adoption.
  
Most Critical Themes:
- Price Volatility and Whale Activity: (40%) Concerns exist about potential price drops due to large holders selling and short-term market consolidation, despite positive inflows.
  

### Top your API Social Posts
Top posts by engagements in the last XX hours

*Showing only X posts for non-authenticated requests. Use your API key in requests for full results.*

"GitHub - andronov04/airena: Client-side AI arena for comparing 1000+ models across 68+ providers. No backend your API keys stay private"  
[Reddit Link](https://redd.it/1pfp7t8) [@Foreign_Lion_3575](/creator/reddit/Foreign_Lion_3575) 2025-12-06T13:25Z X followers, XX engagements

### 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": 302315,
      "num_posts": 302315,
      "interactions_24h": 3766865315
    }
  ]
}
```

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 Whatsup

https://lunarcrush.com/api4/public/topic/:topic/whatsup/v1

Generate an AI summary of the hottest news and social posts for a specific topic

input parameters:

+ **topic**: _Provide the topic to get a summary 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/topic/bitcoin/whatsup/v1
```



Example response:

```json
{
  "config": {
    "id": "bitcoin",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "topic": "bitcoin",
    "generated": 1764111936
  },
  "summary": "Texas makes history by purchasing $10M in Bitcoin ETFs, while BlackRock's Bitcoin ETF faces record outflows amidst ongoing accusations against JPMorgan for market manipulation.",
  "supportive": [
    {
      "title": "Texas Buys Bitcoin ETF",
      "description": "Texas becomes the first state to invest in a Bitcoin ETF, allocating $XX million to its strategic reserve.",
      "percent": XX
    }
  ],
  "critical": [
    {
      "title": "JPMorgan Accusations",
      "description": "JPMorgan is accused of manipulating the market, shorting MSTR, and spreading FUD, leading to calls for boycotts and investigations.",
      "percent": XX
    }
  ]
}
```

Schema:

+ **config**: This includes the inputs for the request processed by the server and may include additional hints about the request and response information.
+ **id**: LunarCrush internal ID for the asset
+ **name**: The full name of the asset
+ **symbol**: The symbol for the asset
+ **topic**: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
+ **generated**: A unix timestamp (in seconds) when the data was generated to understand possibly stale data
+ **supportive**: An array of supportive themes with a title, description, and an estimate of the percent of the circulating conversations on social around this theme.
+ **title**: The case sensitive title of the topic or category
+ **description**: Explanation of the change and the potential impact
+ **critical**: An array of critical themes with a title, description, and an estimate of the percent of the circulating conversations on social around this theme.




---

### 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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1763424000,
    "end": 1764115200,
    "bucket": "hour",
    "metrics": [],
    "generated": 1764112845
  },
  "data": [
    {
      "time": 1763424000,
      "alt_rank": 150,
      "circulating_supply": 19950215,
      "close": 91913,
      "galaxy_score": 53,
      "high": 91913,
      "low": 91161.89,
      "market_cap": 1831844921030,
      "market_dominance": 58.7325,
      "open": 91913,
      "social_dominance": 37.7476,
      "volume_24h": 94214589868,
      "contributors_active": 31448,
      "contributors_created": 2314,
      "interactions": 5075541,
      "posts_active": 61441,
      "posts_created": 3505,
      "sentiment": 75,
      "spam": 5990
    }
  ]
}
```

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)
+ **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
+ **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




---

### 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",
    "_self_call": true,
    "name": "Bitcoin",
    "symbol": "BTC",
    "interval": "1w",
    "start": 1763424000,
    "end": 1764115200,
    "bucket": "hour",
    "metrics": [],
    "generated": 1764112845
  },
  "data": [
    {
      "time": 1763424000,
      "alt_rank": 150,
      "circulating_supply": 19950215,
      "close": 91913,
      "galaxy_score": 53,
      "high": 91913,
      "low": 91161.89,
      "market_cap": 1831844921030,
      "market_dominance": 58.7325,
      "open": 91913,
      "social_dominance": 37.7476,
      "volume_24h": 94214589868,
      "contributors_active": 31448,
      "contributors_created": 2314,
      "interactions": 5075541,
      "posts_active": 61441,
      "posts_created": 3505,
      "sentiment": 75,
      "spam": 5990
    }
  ]
}
```

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)
+ **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
+ **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




---