Get historical price, market cap, and volume data for a specific coin over time. Returns arrays of timestamp-value pairs for charting. Use this to draw price charts or analyze historical trends. Supports multiple time ranges (1 day to max/all available data). The `interval` parameter can be set to 'daily' for daily aggregated data.
From spec: Get historical market data include price, market cap, and 24h volume (granularity auto). Minutely data will be used for duration within 1 day, Hourly data will be used for duration between 1 day and 90 days, Daily data will be used for duration above 90 days.
Usage Tips
- `days` parameter accepts: 1, 7, 14, 30, 90, 180, 365, or 'max' for all data
- Returns [timestamp, value] arrays — timestamps are in milliseconds since epoch
- Three arrays in response: prices, market_caps, total_volumes
- Set `interval=daily` for daily granularity (reduces data points for long ranges)
- Data granularity is automatic: shorter ranges have more frequent data points
Parameters (3)
days(string, query, required)
Data up to number of days ago (1, 14, 30, max, etc.)
id(string, path, required)
Coin id
vs_currency(string, query, required)
The target currency of market data
Examples (2)
Get Coin Market Chartopenapi-spec
Get 30 days of historical price and volume data for Bitcoin in USD
import zingu_apis
api = zingu_apis.api("coingecko")
result = api.fetch("coins/{id}/market_chart", vs_currency="usd", days=7)
for item in result:
print(item)
const resp = await fetch("https://api.coingecko.com/api/v3/coins/bitcoin/market_chart?vs_currency=usd&days=7");
const data = await resp.json();
import zingu_apis
api = zingu_apis.api("coingecko")
result = api.fetch("coins/{id}/market_chart", vs_currency="usd", days=1)
for item in result:
print(item)
const resp = await fetch("https://api.coingecko.com/api/v3/coins/bitcoin/market_chart?vs_currency=usd&days=1");
const data = await resp.json();