get_coins_top_gainers_losers

Retrieve the top 30 cryptocurrencies with the largest price gains and losses over a specified time duration. Use the jq_filter parameter to customize and optimize the response data for better 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 the top 30 coins with largest price gain and loss by a specific time duration

Response Schema

{
  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_1y_change: {
        type: 'number',
        description: 'coin 1 year change in USD'
      },
      usd_24h_vol: {
        type: 'number',
        description: 'coin 24hr volume in USD'
      }
    }
  }
}

Input Schema

Name	Required	Description
`duration`	No	filter result by time range <br> Default value: `24h`
`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/).
`top_coins`	No	filter result by market cap ranking (top 300 to 1000) or all coins (including coins that do not have market cap) <br> Default value: `1000`
`vs_currency`	Yes	target currency of coins <br> *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).

Input Schema (JSON Schema)

{
  "properties": {
    "duration": {
      "description": "filter result by time range <br> Default value: `24h`",
      "enum": [
        "1h",
        "24h",
        "7d",
        "14d",
        "30d",
        "60d",
        "1y"
      ],
      "type": "string"
    },
    "jq_filter": {
      "description": "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.\n\nFor example: to include only the `name` field in every object of a results array, you can provide \".results[].name\".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).",
      "title": "jq Filter",
      "type": "string"
    },
    "top_coins": {
      "description": "filter result by market cap ranking (top 300 to 1000) or all coins (including coins that do not have market cap) <br> Default value: `1000`",
      "enum": [
        "300",
        "500",
        "1000",
        "all"
      ],
      "type": "string"
    },
    "vs_currency": {
      "description": "target currency of coins <br> *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).",
      "type": "string"
    }
  },
  "required": [
    "vs_currency"
  ],
  "type": "object"
}

CoinGecko MCP Server

get_coins_top_gainers_losers

Instructions

Response Schema

Input Schema

Input Schema (JSON Schema)

Other Tools from CoinGecko MCP Server

Related Tools

MCP directory API