Skip to main content
GET
Coin Historical Chart Data within Time Range by ID
Historical series for one coin between two explicit points in time. from and to are Unix timestamps in seconds, while the timestamps inside the response are in milliseconds — the two are not the same unit, which is the usual source of empty or misaligned results. Returns prices, market_caps and total_volumes as timestamp-and-value pairs; CoinGecko picks granularity from the window length. Use it to line a series up with a known event window. For a trailing window ending now, get_coingecko_coins_id_market_chart takes a days count instead.
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}/market_chart/range
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/coingecko/coins/{id}/market_chart/range
  • 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

id
string
default:bitcoin
required

Coin ID. *refers to /coins/list.

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

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