Description
Ranked market data (price, market cap, 24h high/low, volume, ATH/ATL, supply) for coins in a given currency.
Parameters
{
"order": {
"description": "Sort order, e.g. market_cap_desc.",
"example": "market_cap_desc",
"required": false,
"type": "string"
},
"page": {
"description": "Page number.",
"example": "1",
"required": false,
"type": "integer"
},
"per_page": {
"description": "Results per page (1-250).",
"example": "10",
"required": false,
"type": "integer"
},
"vs_currency": {
"description": "Target currency for prices/market cap.",
"example": "usd",
"required": true,
"type": "string"
}
}
Response schema
{
"description": "One object per coin, ordered by market cap rank.",
"items": {
"properties": {
"ath": {
"type": "number"
},
"circulating_supply": {
"type": "number"
},
"current_price": {
"type": "number"
},
"id": {
"type": "string"
},
"market_cap": {
"type": "number"
},
"market_cap_rank": {
"type": "integer"
},
"max_supply": {
"type": [
"number",
"null"
]
},
"name": {
"type": "string"
},
"price_change_percentage_24h": {
"type": "number"
},
"symbol": {
"type": "string"
},
"total_volume": {
"type": "number"
}
},
"type": "object"
},
"type": "array"
}
Example response
[
{
"ath": 126080,
"circulating_supply": 20051143,
"current_price": 61739,
"high_24h": 62060,
"id": "bitcoin",
"low_24h": 59540,
"market_cap": 1237823142839,
"market_cap_rank": 1,
"max_supply": 21000000,
"name": "Bitcoin",
"price_change_percentage_24h": 2.79,
"symbol": "btc",
"total_volume": 43436698617
}
]