Coin OHLC candles

OHLC candles for a coin: days 1 (30-min candles), 7 or 14 (4-hour), 30 / 90 / 180 / 365 (daily), in any vs currency. Returns aligned {time, open, high, low, close} bars plus the window's high/low/first/last and % change. The candle sibling of crypto-history, which returns close-only points: use OHLC for technical indicators, range/volatility work and charting. Cached in-process for 60 seconds.

TRY IN PLAYGROUND →

Input

Example output

{
  "source": "coingecko",
  "fetchedAt": "2026-08-22T13:20:00.000Z",
  "cached": false,
  "coin": "bitcoin",
  "currency": "usd",
  "days": 7,
  "count": 42,
  "granularity": "4h",
  "summary": {
    "first": 66120.4,
    "last": 68210,
    "high": 69850,
    "low": 64995.9,
    "changePct": 3.16
  },
  "bars": [
    {
      "time": "2026-08-15T16:00:00.000Z",
      "open": 66120.4,
      "high": 66500.1,
      "low": 65900,
      "close": 66210.3
    }
  ]
}

Try it - see the 402 challenge (free)

curl -i "https://agent402.tools/api/coin-ohlc?coin=bitcoin&days=7&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-ohlc?coin=bitcoin&days=7&currency=usd");

Related tools