GET
/
coins
Get comprehensive data about all cryptocurrencies
curl --request GET \
  --url https://openapiv1.coinstats.app/coins \
  --header 'X-API-KEY: <api-key>'
{
  "meta": {
    "page": 1,
    "limit": 20,
    "itemCount": 150,
    "pageCount": 8,
    "hasPreviousPage": false,
    "hasNextPage": true
  },
  "result": [
    {
      "id": "ethereum",
      "icon": "https://static.coinstats.app/coins/ethereum_32.png",
      "name": "Ethereum",
      "symbol": "ETH",
      "rank": 2,
      "price": 2680.45,
      "priceBtc": 0.062,
      "volume": 8520000000,
      "marketCap": 322100000000,
      "availableSupply": 120280000,
      "totalSupply": 120280000,
      "fullyDilutedValuation": 322100000000,
      "priceChange1h": -0.25,
      "priceChange1d": 1.85,
      "priceChange1w": 3.42,
      "websiteUrl": "https://ethereum.org",
      "redditUrl": "https://reddit.com/r/ethereum",
      "twitterUrl": "https://twitter.com/ethereum",
      "contractAddress": null,
      "contractAddresses": [],
      "decimals": 18,
      "explorers": [
        "https://etherscan.io"
      ],
      "liquidityScore": 88.7,
      "volatilityScore": 38.9,
      "marketCapScore": 92.1,
      "riskScore": 18.5,
      "avgChange": 2.14
    }
  ]
}
2 credits per request

Authorizations

​
X-API-KEY
string
header
required

API key needed to access the endpoints. Example: 'demo-api-key'

Query Parameters

​
page
number

Page number to retrieve (1-based indexing)

Example:

1

​
limit
number

Number of items to return per page

Example:

20

​
coinIds
string

Filter coins by specific coin IDs. Use comma-separated values to specify multiple coins. Each coin ID should be the unique identifier for the cryptocurrency.

Example:

"bitcoin,ethereum,solana"

​
currency
string
default:USD

The currency to display coin prices and market data in.

Example:

"USD"

​
name
string

Search for coins by their name. Supports partial matching - you can search for "bit" to find "Bitcoin" and other coins containing that substring.

Example:

"bitcoin"

​
symbol
string

Filter coins by their ticker symbol. Use the standard trading symbol for the cryptocurrency (e.g., BTC for Bitcoin, ETH for Ethereum).

Example:

"BTC"

​
blockchains
string

Filter coins by blockchain networks. Use comma-separated values to specify multiple blockchains. Common values include ethereum, solana, binance-smart-chain, polygon, avalanche.

Example:

"ethereum,solana,binance-smart-chain"

​
includeRiskScore
string
default:false

Include risk score data in the response. Set to "true" to include risk assessment metrics, or "false" to exclude them.

Example:

"true"

​
categories
string

Filter coins by categories. Use comma-separated values to specify multiple categories. Common categories include defi, memecoins, gaming, nft, metaverse, layer-1, layer-2.

Example:

"defi,memecoins,gaming"

​
sortBy
enum<string>
default:rank

Field to sort results by.

Available options:
rank,
marketCap,
price,
volume,
priceChange1h,
priceChange1d,
priceChange7d,
name,
symbol
Example:

"marketCap"

​
sortDir
enum<string>
default:desc

Sort direction for the results. Use "asc" for ascending order or "desc" for descending order.

Available options:
asc,
desc
Example:

"desc"

​
marketCap~greaterThan
number

Filter coins with market capitalization greater than the specified value (in USD). Example: 1000000000 for coins with market cap above $1 billion.

Example:

"1000000000"

​
marketCap~equals
number

Filter coins with market capitalization equal to the specified value (in USD). Exact matches are rare due to constant price fluctuations.

Example:

"500000000"

​
marketCap~lessThan
number

Filter coins with market capitalization less than the specified value (in USD). Example: 100000000 for coins with market cap below $100 million.

Example:

"100000000"

​
fullyDilutedValuation~greaterThan
number

Filter coins with fully diluted valuation greater than the specified value (in USD). FDV represents the theoretical market cap if all tokens were in circulation.

Example:

"2000000000"

​
fullyDilutedValuation~equals
number

Filter coins with fully diluted valuation equal to the specified value (in USD). FDV = total supply × current price.

Example:

"1500000000"

​
fullyDilutedValuation~lessThan
number

Filter coins with fully diluted valuation less than the specified value (in USD). Useful for finding smaller cap projects with growth potential.

Example:

"500000000"

​
volume~greaterThan
number

Filter coins with 24-hour trading volume greater than the specified value (in USD). Higher volume indicates more liquidity and trading activity.

Example:

"10000000"

​
volume~equals
number

Filter coins with 24-hour trading volume equal to the specified value (in USD). Exact matches are uncommon due to constant trading activity.

Example:

"5000000"

​
volume~lessThan
number

Filter coins with 24-hour trading volume less than the specified value (in USD). Useful for finding less traded or emerging coins.

Example:

"1000000"

​
priceChange1h~greaterThan
number

Filter coins with 1-hour price change greater than the specified percentage. Example: 5 for coins with more than 5% gain in the last hour.

Example:

"5"

​
priceChange1h~equals
number

Filter coins with 1-hour price change equal to the specified percentage. Useful for finding stable coins in short timeframes.

Example:

"0"

​
priceChange1h~lessThan
number

Filter coins with 1-hour price change less than the specified percentage. Example: -2 for coins declining more than 2% in the last hour.

Example:

"-2"

​
priceChange1d~greaterThan
number

Filter coins with 24-hour price change greater than the specified percentage. Example: 10 for coins with more than 10% daily gain.

Example:

"10"

​
priceChange1d~equals
number

Filter coins with 24-hour price change equal to the specified percentage. Useful for finding stable coins over a day.

Example:

"0"

​
priceChange1d~lessThan
number

Filter coins with 24-hour price change less than the specified percentage. Example: -5 for coins declining more than 5% today.

Example:

"-5"

​
priceChange7d~greaterThan
number

Filter coins with 7-day price change greater than the specified percentage. Example: 20 for coins with more than 20% weekly gain.

Example:

"20"

​
priceChange7d~equals
number

Filter coins with 7-day price change equal to the specified percentage. Useful for finding coins with stable weekly performance.

Example:

"0"

​
priceChange7d~lessThan
number

Filter coins with 7-day price change less than the specified percentage. Example: -10 for coins declining more than 10% this week.

Example:

"-10"

​
availableSupply~greaterThan
number

Filter coins with circulating supply greater than the specified amount. This represents tokens currently available for trading in the market.

Example:

"1000000"

​
availableSupply~equals
number

Filter coins with circulating supply equal to the specified amount. Example: 21000000 for Bitcoin's maximum supply.

Example:

"21000000"

​
availableSupply~lessThan
number

Filter coins with circulating supply less than the specified amount. Useful for finding scarce or limited supply tokens.

Example:

"100000"

​
totalSupply~greaterThan
number

Filter coins with total supply greater than the specified amount. Total supply includes all minted tokens, including locked and vested ones.

Example:

"10000000"

​
totalSupply~equals
number

Filter coins with total supply equal to the specified amount. Useful for finding tokens with specific supply characteristics.

Example:

"1000000000"

​
totalSupply~lessThan
number

Filter coins with total supply less than the specified amount. Great for finding ultra-scarce tokens with limited total supply.

Example:

"500000"

​
rank~greaterThan
number

Filter coins with market cap rank greater than the specified number. Example: 100 to exclude top 100 coins and find smaller cap projects.

Example:

"100"

​
rank~equals
number

Filter coins with market cap rank equal to the specified number. Example: 10 to find the 10th largest cryptocurrency by market cap.

Example:

"10"

​
rank~lessThan
number

Filter coins with market cap rank less than the specified number. Example: 50 to show only top 50 cryptocurrencies.

Example:

"50"

​
price~greaterThan
number

Filter coins with current price greater than the specified value (in the selected currency). Example: 100 for coins priced above $100.

Example:

"100"

​
price~equals
number

Filter coins with current price equal to the specified value. Useful for finding stablecoins or coins at specific price points.

Example:

"1"

​
price~lessThan
number

Filter coins with current price less than the specified value. Example: 0.01 for coins under 1 cent, often called "penny coins".

Example:

"0.01"

​
riskScore~greaterThan
number

Filter coins with risk score greater than the specified value (0-100 scale). Higher scores indicate higher risk. Only available when includeRiskScore=true.

Required range: 0 <= x <= 100
Example:

"70"

​
riskScore~equals
number

Filter coins with risk score equal to the specified value (0-100 scale). Useful for finding coins with specific risk profiles. Only available when includeRiskScore=true.

Required range: 0 <= x <= 100
Example:

"50"

​
riskScore~lessThan
number

Filter coins with risk score less than the specified value (0-100 scale). Lower scores indicate lower risk investments. Only available when includeRiskScore=true.

Required range: 0 <= x <= 100
Example:

"30"

Response

200
application/json

Get coins list

The response is of type object.