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 a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is 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 →

Request contract

  • Method and path: GET /apis/v1/coingecko/coins/{id}/contract/{contract_address}/market_chart/range
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/coingecko/coins/{id}/contract/{contract_address}/market_chart/range
  • contract_address: path; required
  • id: path; required
  • from: query; required
  • interval: query; optional
  • precision: query; optional
  • to: query; required
  • vs_currency: query; required
Complete OpenAPI definition Effective request declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.008 USD per successful request. Your account price may differ; use a request quote where supported.

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

market_caps
number[][]
required

Market cap data points as [timestamp, market_cap] pairs

prices
number[][]
required

Price data points as [timestamp, price] pairs

total_volumes
number[][]
required

Total volume data points as [timestamp, volume] pairs