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

### ![API3](https://lunarcrush.com/gi/w:26/t:$api3.png) API3 Top Creators  

| Creator                                              | Rank | Followers | Posts | Engagements |
| -------                                              | ---- | --------- | ----- | ----------- |
| [@Najam76400935](/creator/twitter/Najam76400935)     | X    | 10.8K     | X     | XXX         |
| [@aicryptopattern](/creator/twitter/aicryptopattern) | X    | 5217      | X     | XXX         |
| [@AltwolfCrypto](/creator/twitter/AltwolfCrypto)     | X    | 3955      | X     | XXX         |

### Creators List

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

Get 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.

Example request:

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



Example response:

```json
{
  "data": [
    {
      "creator_name": "FoxNews",
      "creator_display_name": "Fox News",
      "creator_id": "1367531",
      "creator_network": "twitter",
      "creator_avatar": "https://pbs.twimg.com/profile_images/1591278197844414464/O6Fp0hFB_200x200.jpg",
      "creator_followers": 26725655,
      "creator_posts": 2639,
      "creator_rank": 1,
      "interactions_24h": 378298216
    }
  ]
}
```

Schema:

+ **creator_name**: The unique screen name for the influencer
+ **creator_display_name**: The chosen display name for the influencer if available
+ **creator_id**: The [network]::[unique_id] for the influencer
+ **creator_network**: The social network for the post or influencer. We still refer to x as twitter out of developer preference.
+ **creator_avatar**: The URL to the avatar for the creator
+ **creator_followers**: number of followers the account has
+ **creator_posts**: total number of posts with interactions in the last XX hours
+ **creator_rank**: ranking based on all posts in the last XX hours that have interactions
+ **interactions_24h**: Number of interactions in the last XX hours




---

### Coins List v2

https://lunarcrush.com/api4/public/coins/list/v2

Get 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.

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 XX maximum is 1000 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:

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



Example response:

```json
{
  "config": {
    "sort": "market_cap_rank",
    "desc": true,
    "limit": 0,
    "page": 0,
    "total_rows": 6838,
    "generated": 1751552702
  },
  "data": [
    {
      "id": 1,
      "symbol": "BTC",
      "name": "Bitcoin",
      "price": 110359.20914399876,
      "price_btc": 1,
      "volume_24h": 61032811904.88,
      "volatility": 0.0145,
      "circulating_supply": 19886959,
      "max_supply": 21000000,
      "percent_change_1h": 0.895221505959,
      "percent_change_24h": 2.3744465093,
      "percent_change_7d": 3.116412781926,
      "market_cap": 2194709067519.13,
      "market_cap_rank": 1,
      "interactions_24h": 91167247,
      "social_volume_24h": 201410,
      "social_dominance": 23.49338916721587,
      "market_dominance": 64.35165905885069,
      "market_dominance_prev": 66.33535723787728,
      "galaxy_score": 55.6,
      "galaxy_score_previous": 62,
      "alt_rank": 1,
      "alt_rank_previous": 139,
      "sentiment": 80,
      "categories": "layer-1,bitcoin-ecosystem,pow",
      "blockchains": [
        {
          "type": "layer1",
          "network": "bitcoin",
          "address": null,
          "decimals": null
        }
      ],
      "percent_change_30d": 4.317920606659,
      "last_updated_price": 1751552693,
      "last_updated_price_by": "cmc_stream",
      "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 XX 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 X hour ago
+ **percent_change_24h**: Percent change in price since XX hours ago
+ **percent_change_7d**: Percent change in price since X 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 XX hours
+ **social_volume_24h**: Total number of posts with interactions on this topic in the last XX 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 XX 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 XX hours
+ **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.
+ **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 X
+ **percent_change_30d**: Percent change in price since XX days ago
+ **topic**: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
+ **logo**: The URL to the logo for the asset, topic, or category




---

### 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 X 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 XX maximum is 1000 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:

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



Example response:

```json
{
  "config": {
    "sort": "market_cap_rank",
    "desc": true,
    "limit": 0,
    "page": 0,
    "total_rows": 6838,
    "generated": 1751552703
  },
  "data": [
    {
      "id": 1,
      "symbol": "BTC",
      "name": "Bitcoin",
      "price": 110359.20914399876,
      "price_btc": 1,
      "volume_24h": 61032811904.88,
      "volatility": 0.0145,
      "circulating_supply": 19886959,
      "max_supply": 21000000,
      "percent_change_1h": 0.895221505959,
      "percent_change_24h": 2.3744465093,
      "percent_change_7d": 3.116412781926,
      "market_cap": 2194709067519.13,
      "market_cap_rank": 1,
      "interactions_24h": 91167247,
      "social_volume_24h": 201410,
      "social_dominance": 23.49338916721587,
      "market_dominance": 64.35165905885069,
      "market_dominance_prev": 66.33535723787728,
      "galaxy_score": 55.6,
      "galaxy_score_previous": 62,
      "alt_rank": 1,
      "alt_rank_previous": 139,
      "sentiment": 80,
      "categories": "layer-1,bitcoin-ecosystem,pow",
      "blockchains": [
        {
          "type": "layer1",
          "network": "bitcoin",
          "address": null,
          "decimals": null
        }
      ],
      "percent_change_30d": 4.317920606659,
      "last_updated_price": 1751552693,
      "last_updated_price_by": "cmc_stream",
      "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 XX 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 X hour ago
+ **percent_change_24h**: Percent change in price since XX hours ago
+ **percent_change_7d**: Percent change in price since X 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 XX hours
+ **social_volume_24h**: Total number of posts with interactions on this topic in the last XX 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 XX 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 XX hours
+ **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.
+ **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 X
+ **percent_change_30d**: Percent change in price since XX days ago
+ **topic**: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
+ **logo**: The URL to the logo for the asset, topic, or category




---

### Stocks List v2

https://lunarcrush.com/api4/public/stocks/list/v2

Get 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.

input parameters:

+ **sort**: _sort the output by metric_ 
+ **limit**: _limit the number of results. Default is XX maximum is XXX 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:

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



Example response:

```json
{
  "config": {
    "limit": 0,
    "sort": "market_cap_rank",
    "desc": true,
    "page": 0,
    "total_rows": 2178,
    "generated": 1751552703
  },
  "data": [
    {
      "id": 568,
      "symbol": "AMZN",
      "name": "Amazon.com, Inc.",
      "price": 221.66,
      "volume_24h": 5074540143.03,
      "percent_change_24h": 0.7346762459076046,
      "market_cap": "2351911605480.00",
      "market_cap_rank": 1,
      "interactions_24h": 2424879,
      "social_volume_24h": 15743,
      "social_dominance": 2.8675147355613357,
      "market_dominance": 2.948556105203988,
      "market_dominance_prev": 3.2972828581535456,
      "galaxy_score": 60.5,
      "galaxy_score_previous": 61,
      "alt_rank": 208,
      "alt_rank_previous": 2,
      "sentiment": 94,
      "categories": "consumer-cyclical",
      "last_updated_price": 1751552693,
      "last_updated_price_by": "polygon_market",
      "topic": "amzn amazoncom inc",
      "logo": "https://cdn.lunarcrush.com/stocks/amzn.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
+ **volume_24h**: Volume in USD for XX hours up to this data point
+ **percent_change_24h**: Percent change in price since XX hours 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 XX hours
+ **social_volume_24h**: Total number of posts with interactions on this topic in the last XX 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 XX 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 XX hours
+ **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.
+ **categories**: an array of categories this topic aggregates into
+ **topic**: LunarCrush social topic. Can only includes letters, numbers, spaces, #, and $
+ **logo**: The URL to the logo for the asset, topic, or category




---