get_timeframe_tokens_networks_onchain_ohlcv

Retrieve OHLCV data (Open, High, Low, Close, Volume) for a token's price history on a specific network using a token address. Customize results with timeframe, aggregation, and filtering for efficient data analysis.

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 OHLCV chart (Open, High, Low, Close, Volume) of a token based on the provided token address on a network

Response Schema

{
  type: 'object',
  properties: {
    data: {
      type: 'object',
      properties: {
        id: {
          type: 'string'
        },
        attributes: {
          type: 'object',
          properties: {
            ohlcv_list: {
              type: 'array',
              items: {
                type: 'array',
                items: {
                  type: 'number'
                }
              }
            }
          }
        },
        type: {
          type: 'string'
        }
      }
    },
    meta: {
      type: 'object',
      properties: {
        base: {
          type: 'object',
          properties: {
            address: {
              type: 'string'
            },
            coingecko_coin_id: {
              type: 'string'
            },
            name: {
              type: 'string'
            },
            symbol: {
              type: 'string'
            }
          }
        },
        quote: {
          type: 'object',
          properties: {
            address: {
              type: 'string'
            },
            coingecko_coin_id: {
              type: 'string'
            },
            name: {
              type: 'string'
            },
            symbol: {
              type: 'string'
            }
          }
        }
      }
    }
  }
}

Input Schema

Name	Required	Description
`aggregate`	No	time period to aggregate each OHLCV <br> Available values (day): `1` <br> Available values (hour): `1` , `4` , `12` <br> Available values (minute): `1` , `5` , `15` <br> Default value: 1
`before_timestamp`	No	return OHLCV data before this timestamp (integer seconds since epoch)
`currency`	No	return OHLCV in USD or quote token <br> Default value: usd
`include_empty_intervals`	No	include empty intervals with no trade data, default: false
`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/).
`limit`	No	number of OHLCV results to return, maximum 1000 <br> Default value: 100
`network`	Yes
`timeframe`	Yes
`token_address`	Yes

Input Schema (JSON Schema)

{
  "properties": {
    "aggregate": {
      "description": "time period to aggregate each OHLCV <br> Available values (day): `1` <br> Available values (hour): `1` , `4` , `12` <br> Available values (minute): `1` , `5` , `15` <br> Default value: 1",
      "type": "string"
    },
    "before_timestamp": {
      "description": "return OHLCV data before this timestamp (integer seconds since epoch)",
      "type": "integer"
    },
    "currency": {
      "description": "return OHLCV in USD or quote token <br> Default value: usd",
      "enum": [
        "usd",
        "token"
      ],
      "type": "string"
    },
    "include_empty_intervals": {
      "description": "include empty intervals with no trade data, default: false",
      "type": "boolean"
    },
    "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"
    },
    "limit": {
      "description": "number of OHLCV results to return, maximum 1000 <br> Default value: 100",
      "type": "integer"
    },
    "network": {
      "type": "string"
    },
    "timeframe": {
      "enum": [
        "day",
        "hour",
        "minute"
      ],
      "type": "string"
    },
    "token_address": {
      "type": "string"
    }
  },
  "required": [
    "network",
    "token_address",
    "timeframe"
  ],
  "type": "object"
}

CoinGecko MCP Server

get_timeframe_tokens_networks_onchain_ohlcv

Instructions

Response Schema

Input Schema

Input Schema (JSON Schema)

Other Tools from CoinGecko MCP Server

Related Tools

MCP directory API