TOOL API

get_coins_markets

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 ```json { $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' } } } } } } ```

finance1 credits

Call information

Tool slug
coingecko-demo.get_coins_markets
Provider
CoinGecko
Average response
0 ms
Calls in 7 days
0

Input parameters

vs_currencyrequired

target currency of coins and market data *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).

category

filter based on coins' category *refers to [`/coins/categories/list`](/reference/coins-categories-list).

ids

coins' IDs, comma-separated if querying more than 1 coin. *refers to [`/coins/list`](/reference/coins-list).

include_tokens

for `symbols` lookups, specify `all` to include all matching tokens Default `top` returns top-ranked tokens (by market cap or volume)

locale

language background, default: en

names

coins' names, comma-separated if querying more than 1 coin.

order

sort result by field, default: market_cap_desc

page

page through results, default: 1

per_page

total results per page, default: 100 Valid values: 1...250

precision

decimal place for currency price value

price_change_percentage

include price change percentage timeframe, comma-separated if query more than 1 timeframe Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y

sparkline

include sparkline 7 days data, default: false

symbols

coins' symbols, comma-separated if querying more than 1 coin.

jq_filter

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/).