---
title: "Crypto OHLC Candles ($0.005/call)"
method: GET
path: "/candles"
tags: ["crypto", "ohlc", "candles", "technical-analysis", "backtesting", "market-data", "trading", "bitcoin"]
---

# Crypto OHLC Candles ($0.005/call)

`GET /candles`

## Request

- Base URL: `https://x402.shizu.me`
- URL: `https://x402.shizu.me/candles`
- Auth: none declared

Historical OHLC candles for a crypto pair (e.g. BTC-USD) — for technical analysis and backtesting. Query: pair; granularity (1m, 5m, 15m, 1h, 6h, 1d — default 1h); limit (1-300, default 100) for the latest window, OR start & end (ISO8601 or unix secs) for a backtest range paginated server-side up to 3000 candles — months of history in one call. Returns candles oldest->newest, each {t, o, h, l, c, v}. Real-time from Coinbase.

Paid endpoint: $0.005 per call via the x402 protocol (USDC on Base). An unpaid request returns 402 with payment requirements in the PAYMENT-REQUIRED response header; attach payment and retry.

## Query parameters

- `pair` string
- `granularity` string
- `start` string
- `end` string

## Response `200`

Paid result (JSON)

## Other responses

- `402`: Payment required — x402 requirements in the PAYMENT-REQUIRED response header

---

[API](https://skmtc.dev/shizu/apis/scrape402.md) · [All operations](https://skmtc.dev/shizu/apis/scrape402/llms.txt) · [OpenAPI document](https://skmtc.dev/shizu/apis/scrape402/revisions/0852d74798b8?raw)