get_range_contract_coins_market_chart
Read-only
Retrieve historical cryptocurrency price, market cap, and volume data for specific token contracts within a defined time range using the CoinGecko MCP Server.
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
{
$ref: '#/$defs/market_chart_get_range_response',
$defs: {
market_chart_get_range_response: {
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
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| contract_address | Yes | ||
| from | Yes | starting date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. **use ISO date string for best compatibility** | |
| to | Yes | ending date in ISO date string (`YYYY-MM-DD` or `YYYY-MM-DDTHH:MM`) or UNIX timestamp. **use ISO date string for best compatibility** | |
| vs_currency | Yes | target currency of market data *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies). | |
| interval | No | data interval, leave empty for auto granularity | |
| precision | No | decimal place for currency price value | |
| 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/). |