工具 API

get_coins_top_gainers_losers

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 the top 30 coins with largest price gain and loss by a specific time duration** # Response Schema ```json { $ref: '#/$defs/top_gainers_loser_get_response', $defs: { top_gainers_loser_get_response: { type: 'object', properties: { top_gainers: { type: 'array', items: { type: 'object', properties: { id: { type: 'string', description: 'coin ID' }, image: { type: 'string', description: 'coin image url' }, market_cap_rank: { type: 'number', description: 'coin rank by market cap' }, name: { type: 'string', description: 'coin name' }, symbol: { type: 'string', description: 'coin symbol' }, usd: { type: 'number', description: 'coin price in USD' }, usd_14d_change: { type: 'number', description: 'coin 14 day change percentage in USD' }, usd_1h_change: { type: 'number', description: 'coin 1hr change percentage in USD' }, usd_1y_change: { type: 'number', description: 'coin 1 year change percentage in USD' }, usd_200d_change: { type: 'number', description: 'coin 200 day change percentage in USD' }, usd_24h_change: { type: 'number', description: 'coin 24hr change percentage in USD' }, usd_24h_vol: { type: 'number', description: 'coin 24hr volume in USD' }, usd_30d_change: { type: 'number', description: 'coin 30 day change percentage in USD' }, usd_7d_change: { type: 'number', description: 'coin 7 day change percentage in USD' } } } }, top_losers: { type: 'array', items: { type: 'object', properties: { id: { type: 'string', description: 'coin ID' }, image: { type: 'string', description: 'coin image url' }, market_cap_rank: { type: 'number', description: 'coin rank by market cap' }, name: { type: 'string', description: 'coin name' }, symbol: { type: 'string', description: 'coin symbol' }, usd: { type: 'number', description: 'coin price in USD' }, usd_14d_change: { type: 'number', description: 'coin 14 day change percentage in USD' }, usd_1h_change: { type: 'number', description: 'coin 1hr change percentage in USD' }, usd_1y_change: { type: 'number', description: 'coin 1 year change percentage in USD' }, usd_200d_change: { type: 'number', description: 'coin 200 day change percentage in USD' }, usd_24h_change: { type: 'number', description: 'coin 24hr change percentage in USD' }, usd_24h_vol: { type: 'number', description: 'coin 24hr volume in USD' }, usd_30d_change: { type: 'number', description: 'coin 30 day change percentage in USD' }, usd_7d_change: { type: 'number', description: 'coin 7 day change percentage in USD' } } } } } } } } ```