get_coins_markets
Read-only
Query cryptocurrency market data including prices, market caps, volumes, and related metrics for analysis and tracking.
Instructions
When using this tool, always use the jq_filter parameter to reduce the response size and improve performance.
Only omit if you're sure you don't need the data.
This endpoint allows you to query all the supported coins with price, market cap, volume and market related data
Response Schema
{
$ref: '#/$defs/market_get_response',
$defs: {
market_get_response: {
type: 'array',
items: {
type: 'object',
properties: {
id: {
type: 'string',
description: 'coin ID'
},
ath: {
type: 'number',
description: 'coin all time high (ATH) in currency'
},
ath_change_percentage: {
type: 'number',
description: 'coin all time high (ATH) change in percentage'
},
ath_date: {
type: 'string',
description: 'coin all time high (ATH) date',
format: 'date-time'
},
atl: {
type: 'number',
description: 'coin all time low (atl) in currency'
},
atl_change_percentage: {
type: 'number',
description: 'coin all time low (atl) change in percentage'
},
atl_date: {
type: 'string',
description: 'coin all time low (atl) date',
format: 'date-time'
},
circulating_supply: {
type: 'number',
description: 'coin circulating supply'
},
current_price: {
type: 'number',
description: 'coin current price in currency'
},
fully_diluted_valuation: {
type: 'number',
description: 'coin fully diluted valuation (fdv) in currency'
},
high_24h: {
type: 'number',
description: 'coin 24hr price high in currency'
},
image: {
type: 'string',
description: 'coin image url'
},
last_updated: {
type: 'string',
description: 'coin last updated timestamp',
format: 'date-time'
},
low_24h: {
type: 'number',
description: 'coin 24hr price low in currency'
},
market_cap: {
type: 'number',
description: 'coin market cap in currency'
},
market_cap_change_24h: {
type: 'number',
description: 'coin 24hr market cap change in currency'
},
market_cap_change_percentage_24h: {
type: 'number',
description: 'coin 24hr market cap change in percentage'
},
market_cap_rank: {
type: 'number',
description: 'coin rank by market cap'
},
max_supply: {
type: 'number',
description: 'coin max supply'
},
name: {
type: 'string',
description: 'coin name'
},
price_change_24h: {
type: 'number',
description: 'coin 24hr price change in currency'
},
price_change_percentage_24h: {
type: 'number',
description: 'coin 24hr price change in percentage'
},
roi: {
type: 'object',
description: 'return on investment data',
properties: {
currency: {
type: 'string',
description: 'ROI currency'
},
percentage: {
type: 'number',
description: 'ROI percentage'
},
times: {
type: 'number',
description: 'ROI multiplier'
}
},
required: [ 'currency',
'percentage',
'times'
]
},
symbol: {
type: 'string',
description: 'coin symbol'
},
total_supply: {
type: 'number',
description: 'coin total supply'
},
total_volume: {
type: 'number',
description: 'coin total trading volume in currency'
}
}
}
}
}
}Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vs_currency | Yes | target currency of coins and market data *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies). | |
| category | No | filter based on coins' category *refers to [`/coins/categories/list`](/reference/coins-categories-list). | |
| ids | No | coins' IDs, comma-separated if querying more than 1 coin. *refers to [`/coins/list`](/reference/coins-list). | |
| include_tokens | No | for `symbols` lookups, specify `all` to include all matching tokens Default `top` returns top-ranked tokens (by market cap or volume) | |
| locale | No | language background, default: en | |
| names | No | coins' names, comma-separated if querying more than 1 coin. | |
| order | No | sort result by field, default: market_cap_desc | |
| page | No | page through results, default: 1 | |
| per_page | No | total results per page, default: 100 Valid values: 1...250 | |
| precision | No | decimal place for currency price value | |
| price_change_percentage | No | include price change percentage timeframe, comma-separated if query more than 1 timeframe Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y | |
| sparkline | No | include sparkline 7 days data, default: false | |
| symbols | No | coins' symbols, comma-separated if querying more than 1 coin. | |
| jq_filter | No | A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available. For example: to include only the `name` field in every object of a results array, you can provide ".results[].name". For more information, see the [jq documentation](https://jqlang.org/manual/). |