---
title: "Coin Historical Chart Data by Token Address"
method: GET
path: "/coins/{id}/contract/{contract_address}/market_chart"
---

# Coin Historical Chart Data by Token Address

`GET /coins/{id}/contract/{contract_address}/market_chart`

## Request

- Base URL: `https://api.coingecko.com/api/v3`
- URL: `https://api.coingecko.com/api/v3/coins/{id}/contract/{contract_address}/market_chart`
- Auth: one of:
  - API key in header `x-cg-pro-api-key`
  - API key in query parameter `x_cg_pro_api_key`

To get the historical chart data including time in UNIX, price, market cap and 24hrs volume based on asset platform and particular token contract address

## Path parameters

- `id` string, required
- `contract_address` string, required

## Query parameters

- `vs_currency` string, required
- `days` string, required
- `interval` '5m' | 'hourly' | 'daily'
- `precision` 'full' | '0' | '1' | '2' | '3' | '4' | '5' | '6' | '7' | '8' | '9' | '10' | '11' | '12' | '13' | '14' | '15' | '16' | '17' | '18'

## Response `200`

Coin historical chart data by token address

- CoinsMarketChart
  - `prices` array[], required: Price data points as [timestamp, price] pairs
    - number[]
  - `market_caps` array[], required: Market cap data points as [timestamp, market_cap] pairs
    - number[]
  - `total_volumes` array[], required: Total volume data points as [timestamp, volume] pairs
    - number[]

---

[API](https://skmtc.dev/coingecko/apis/coingecko-demo-api.md) - [All operations](https://skmtc.dev/coingecko/apis/coingecko-demo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coingecko/apis/coingecko-demo-api/revisions/d62c9c579f3a?raw)