Charts

Both endpoints use https://api.tokens.xyz/v1 with an x-api-key header and the assets:read scope; see Authentication. {assetId} accepts an id, alias, mint or solana-<mint> and must resolve to a registered asset.

Candles and rangesCopy Anchor Link

Both endpoints share the candle shape and the range rules.

type Interval = '1m' | '5m' | '15m' | '1H' | '4H' | '1D' | '1W';

interface Candle {
  time: number;    // unix seconds, bucket start; ascending
  open: number;    // USD
  high: number;
  low: number;
  close: number;
  volume: number;  // USD
}

• from and to are unix seconds. The default window is the last 7 days; there are no named ranges, so always pass from for anything else.
• from must not be after to, and not before 2010-01-01 (400 with details.minFrom). to is clamped to five minutes in the future.
• At most 10,000 candles per request, counted as (to - from) / interval + 1. Exceeding it returns 400 with details.intervalSeconds, details.maxCandles and details.requestedCandles. A year fits at 1H and above; page by from/to for finer intervals.
• Buckets with no trades have no candle, so gaps are normal for illiquid mints. Do not treat a missing bucket as a zero.
• The response echoes from and to after clamping.

Stored on-chain history per interval, for mints that have traded that long:

GET /v1/assets/{assetId}/ohlcvCopy Anchor Link

On-chain candles for one Solana mint.

Query paramsCopy Anchor Link

ResponseCopy Anchor Link

interface AssetOhlcvResponse {
  assetId: string;
  mint: string;
  interval: Interval;
  from: number;      // unix seconds
  to: number;        // unix seconds
  candles: Candle[];
}

NotesCopy Anchor Link

• Cached for one minute. A mint you have never requested may return few or no candles while the cache warms; retry in a few minutes.

ExampleCopy Anchor Link

NOW=$(date +%s)
curl -sS "$API_BASE_URL/v1/assets/solana/ohlcv?interval=1D&from=$((NOW - 90*86400))&to=$NOW" \
  -H "x-api-key: $API_KEY"

GET /v1/assets/{assetId}/price-chartCopy Anchor Link

The canonical price series for the asset as a whole, rather than one mint.

Query paramsCopy Anchor Link

ResponseCopy Anchor Link

interface AssetPriceChartResponse {
  assetId: string;
  interval: Interval;
  from: number;      // unix seconds
  to: number;        // unix seconds
  candles: Candle[];
}

NotesCopy Anchor Link

The series comes from the first source that has data:

1. Stock-market candles for mapped public equities, ETFs and commodities. gold is the GLD benchmark, so it is a share price, not a per-ounce token price; use /ohlcv?mint= for a specific gold token.
2. Provider candles for crypto assets with an external listing. Daily history goes back a year for established assets.
3. On-chain candles for the primary variant, or for mint when passed. Equities pick the primary with the stock_redeemability strategy here.

The response does not say which source won. Cached for one minute.

ExampleCopy Anchor Link

NOW=$(date +%s)
curl -sS "$API_BASE_URL/v1/assets/tesla/price-chart?interval=1D&from=$((NOW - 365*86400))&to=$NOW" \
  -H "x-api-key: $API_KEY"