CoinGecko Coin Historical Chart Data by Token Address

https://api.sandbase.ai/v1/api/coingecko/coins-contract-market-chart

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

Price
$0.01USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
4 required · 2 optional
Production route

Try the model

Playground

Open playground
Input
The contract address of token.
Asset platform ID. *refers to [`/asset_platforms`](/reference/asset-platforms-list).
Data up to number of days ago. You may use any integer or `max` for number of days.
Data interval, leave empty for auto granularity. Allowed values: 1m, 5m, hourly, daily.
Decimal place for currency price value. Allowed values: full, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18.
Target currency of market data. *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies).
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.01 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

contract_address
string · required
id
string · required
days
string · required
vs_currency
string · required
interval
string (1m, 5m, hourly, daily) · optional
precision
string (full, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18) · optional

Access

Provider
CoinGecko
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/coingecko/coins-contract-market-chart
Authentication
Bearer API key

API README

CoinGecko Coin Historical Chart Data by Token Address API

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

The response is the official CoinGecko API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "coingecko/coins-contract-market-chart", "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "id": "ethereum", "days": "1", "vs_currency": "usd"}'

Parameters

NameTypeRequiredDescription
contract_addressstringYesThe contract address of token.
idstringYesAsset platform ID. *refers to /asset_platforms.
daysstringYesData up to number of days ago. You may use any integer or max for number of days.
intervalstringNoData interval, leave empty for auto granularity.
precisionstringNoDecimal place for currency price value.
vs_currencystringYesTarget currency of market data. *refers to /simple/supported_vs_currencies.

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/coingecko/coins-contract-market-chart
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/coingecko/coins-contract-market-chart" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "id": "ethereum",
  "days": "1",
  "vs_currency": "usd",
  "contract_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
CoinGecko$0.01 per callJSONOct 30, 2026
CoinGecko$0.01 per callJSONOct 30, 2026
CoinGecko$0.01 per callJSONOct 30, 2026
CoinGecko$0.01 per callJSONOct 30, 2026
CoinGecko$0.01 per callJSONOct 30, 2026
CoinGecko$0.01 per callJSONOct 30, 2026

Questions

FAQ

How do I use the CoinGecko Coin Historical Chart Data by Token Address API?

Send a POST request to https://api.sandbase.ai/v1/api/coingecko/coins-contract-market-chart with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the CoinGecko Coin Historical Chart Data by Token Address API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the CoinGecko Coin Historical Chart Data by Token Address API accept?

Required: contract_address (string), id (string), days (string) and vs_currency (string). Optional: interval (one of 1m, 5m, hourly, daily) and precision (one of full, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18). The Parameters table and the Playground on this page list every field.

What does the CoinGecko Coin Historical Chart Data by Token Address API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a CoinGecko developer account or API key?

No. CoinGecko Coin Historical Chart Data by Token Address runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for CoinGecko API access separately.