Coin market chart for a time window

Price, market cap and volume series for a coin over an ARBITRARY time window: `from`/`to` as unix seconds or ISO dates, or `lookback` ("6h", "3d", "2w") ending now. Granularity is automatic upstream: 5-minute points for a window of 1 day or less, hourly up to 90 days, daily beyond. The windowed sibling of crypto-history (which counts days back from now): use it to align with a specific event, a filing date or another series. Window must lie within the past 365 days on this plan, enforced before the call. Cached in-process for 60 seconds.

TRY IN PLAYGROUND →

Input

Example output

{
  "source": "coingecko",
  "fetchedAt": "2026-08-22T13:20:00.000Z",
  "cached": false,
  "coin": "ethereum",
  "currency": "usd",
  "from": "2026-08-19T13:20:00.000Z",
  "to": "2026-08-22T13:20:00.000Z",
  "count": 73,
  "granularity": "1h",
  "summary": {
    "first": 2380.1,
    "last": 2424.5,
    "high": 2480.1,
    "low": 2350,
    "changePct": 1.87
  },
  "points": [
    {
      "time": "2026-08-19T14:00:00.000Z",
      "price": 2380.1,
      "marketCap": 287000000000,
      "volume": 13800000000
    }
  ]
}

Try it - see the 402 challenge (free)

curl -i "https://agent402.tools/api/coin-market-chart-range?coin=ethereum&lookback=3d&currency=usd"

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/coin-market-chart-range?coin=ethereum&lookback=3d&currency=usd");

Related tools