get_coins_markets
Retrieve comprehensive market data for all supported cryptocurrencies, including price, market cap, volume, and historical trends. Filter results using jq_filter
to optimize response size and performance.
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
Input Schema
Name | Required | Description | Default |
---|---|---|---|
category | No | filter based on coins' category <br> *refers to [`/coins/categories/list`](/reference/coins-categories-list). | |
ids | No | coins' IDs, comma-separated if querying more than 1 coin. <br> *refers to [`/coins/list`](/reference/coins-list). | |
include_tokens | No | for `symbols` lookups, specify `all` to include all matching tokens <br> Default `top` returns top-ranked tokens (by market cap or volume) | |
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/). | |
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 <br> 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 price change percentage timeframe <br> 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. | |
vs_currency | Yes | target currency of coins and market data <br> *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies). |