Skip to main content
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
  • Price, market cap, and volume
  • Price changes (1h, 24h, 7d)
  • Supply information
  • Trading metrics
  • Social links and metadata
  • currency: Price display currency
  • limit & skip: Pagination controls
  • includeRiskScore: Add risk analysis data
  • categories: Filter by coin categories
  • blockchains: Filter by blockchain networks
  • sortBy: rank, price, volume, etc.
  • sortDir: asc or desc

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
page
number
Example:
​
limit
number
Example:
​
coinIds
string
Example:
​
currency
string
Example:
​
name
string
Example:
​
symbol
string
Example:
​
blockchains
string
Example:
​
includeRiskScore
string
Example:
​
categories
string
Example:
​
sortBy
enum<string>
Available options:
rank,
marketCap,
price,
volume,
priceChange1h,
priceChange1d,
priceChange7d,
name,
symbol
Example:
​
sortDir
enum<string>
Available options:
asc,
desc
Example:
​
marketCap~greaterThan
number
Example:
​
marketCap~equals
number
Example:
​
marketCap~lessThan
number
Example:
​
fullyDilutedValuation~greaterThan
number
Example:
​
fullyDilutedValuation~equals
number
Example:
​
fullyDilutedValuation~lessThan
number
Example:
​
volume~greaterThan
number
Example:
​
volume~equals
number
Example:
​
volume~lessThan
number
Example:
​
priceChange1h~greaterThan
number
Example:
​
priceChange1h~equals
number
Example:
​
priceChange1h~lessThan
number
Example:
​
priceChange1d~greaterThan
number
Example:
​
priceChange1d~equals
number
Example:
​
priceChange1d~lessThan
number
Example:
​
priceChange7d~greaterThan
number
Example:
​
priceChange7d~equals
number
Example:
​
priceChange7d~lessThan
number
Example:
​
availableSupply~greaterThan
number
Example:
​
availableSupply~equals
number
Example:
​
availableSupply~lessThan
number
Example:
​
totalSupply~greaterThan
number
Example:
​
totalSupply~equals
number
Example:
​
totalSupply~lessThan
number
Example:
​
rank~greaterThan
number
Example:
​
rank~equals
number
Example:
​
rank~lessThan
number
Example:
​
price~greaterThan
number
Example:
​
price~equals
number
Example:
​
price~lessThan
number
Example:
​
riskScore~greaterThan
number
Required range: 0 <= x <= 100
Example:
​
riskScore~equals
number
Required range: 0 <= x <= 100
Example:
​
riskScore~lessThan
number
Required range: 0 <= x <= 100
Example:

Response

​
meta
object
required
Example:
​
result
object[]
required
Example: