Skip to main content
GET
Coin Historical Chart Data within Time Range by Token Address
Historical series between two explicit points in time for a token identified by contract address. id is the asset platform and contract_address the token; from and to are Unix timestamps in seconds while response timestamps are in milliseconds. Returns prices, market_caps and total_volumes as timestamp-and-value pairs. Use it when you have an address and a fixed window. For a trailing window use get_coingecko_token_market_chart; if you hold a CoinGecko id rather than an address use get_coingecko_coins_id_market_chart_range.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through five tools: search, list_categories and get_details are free, use and batch_use are billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Cost and request rules

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.008
  • Declared unit rate (USD): 0.0
  • Billing unit: provider_credit
  • Cost contract: plan_units
  • Settlement evidence source: request_snapshot

Declared request billing units

  • Units: 1

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

contract_address
string
default:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
required

The contract address of token.

id
string
default:ethereum
required

Asset platform ID. *refers to /asset_platforms.

Query Parameters

from
string
default:2025-12-22
required

Starting date in ISO date string (YYYY-MM-DD or YYYY-MM-DDTHH:MM) or UNIX timestamp. Use ISO date string for best compatibility.

interval
enum<string>

Data interval, leave empty for auto granularity.

Available options:
1m,
5m,
hourly,
daily
precision
enum<string>

Decimal place for currency price value.

Available options:
full,
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18
to
string
default:2025-12-31
required

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
string
default:usd
required

Target currency of market data. *refers to /simple/supported_vs_currencies.

Response

Coin historical chart data within time range by token address

prices
number[][]
required

Price data points as [timestamp, price] pairs

market_caps
number[][]
required

Market cap data points as [timestamp, market_cap] pairs

total_volumes
number[][]
required

Total volume data points as [timestamp, volume] pairs