get_range_contract_coins_market_chart

Retrieve historical price, market cap, and 24hr volume data for a specific token contract address within a defined time range using UNIX timestamps. Optimize response size with the jq_filter parameter.

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 get the historical chart data within certain time range in UNIX along with price, market cap and 24hr volume based on asset platform and particular token contract address

Response Schema

{
  type: 'object',
  properties: {
    market_caps: {
      type: 'array',
      items: {
        type: 'array',
        items: {
          type: 'number'
        }
      }
    },
    prices: {
      type: 'array',
      items: {
        type: 'array',
        items: {
          type: 'number'
        }
      }
    },
    total_volumes: {
      type: 'array',
      items: {
        type: 'array',
        items: {
          type: 'number'
        }
      }
    }
  }
}

Input Schema

Name	Required	Description
`contract_address`	Yes
`from`	Yes	starting date in UNIX timestamp
`id`	Yes
`interval`	No	data interval, leave empty for auto granularity
`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/).
`precision`	No	decimal place for currency price value
`to`	Yes	ending date in UNIX timestamp
`vs_currency`	Yes	target currency of market data <br> *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).

Input Schema (JSON Schema)

{
  "properties": {
    "contract_address": {
      "type": "string"
    },
    "from": {
      "description": "starting date in UNIX timestamp",
      "type": "number"
    },
    "id": {
      "type": "string"
    },
    "interval": {
      "description": "data interval, leave empty for auto granularity",
      "enum": [
        "5m",
        "hourly",
        "daily"
      ],
      "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"
    },
    "precision": {
      "description": "decimal place for currency price value",
      "enum": [
        "full",
        "0",
        "1",
        "2",
        "3",
        "4",
        "5",
        "6",
        "7",
        "8",
        "9",
        "10",
        "11",
        "12",
        "13",
        "14",
        "15",
        "16",
        "17",
        "18"
      ],
      "type": "string"
    },
    "to": {
      "description": "ending date in UNIX timestamp",
      "type": "number"
    },
    "vs_currency": {
      "description": "target currency of market data <br> *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).",
      "type": "string"
    }
  },
  "required": [
    "id",
    "contract_address",
    "from",
    "to",
    "vs_currency"
  ],
  "type": "object"
}

CoinGecko MCP Server

get_range_contract_coins_market_chart

Instructions

Response Schema

Input Schema

Input Schema (JSON Schema)

Other Tools from CoinGecko MCP Server

Related Tools

MCP directory API