New: Stream Prices over Server-Sent Events

Crypto OHLCV API

Open, high, low, close and volume for 2.4M+ coins at seven intervals from one minute to one month, with minute history back to December 2018. Growth plan, 30-day free trial.

10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.

$99/month · 30-day free trial · https://api.coinranking.com/v2/coin/:uuid/ohlcv

Latest candles
# The last 200 hourly candles for Bitcoin, in US dollars
curl 'https://api.coinranking.com/v2/coin/Qwsogvtv82FCd/ohlcv?interval=hour&limit=200' \
  -H 'x-access-token: YOUR_KEY'

Any Range, Gapless, Cacheable

The same window always returns the same candles, pages never overlap, and completed windows cache for an hour.

  • Up to 1,440 candles per response, one day of minutes. Drive paging from data.paging.next, never from the candle count: a short page can still have a next.
  • Minute candles back to December 2018. All seven intervals accept from and to, so hour, day, week and month windows page the same way.
  • Historical windows return Cache-Control: max-age=3600; windows that touch the present return max-age=60.
  • Deep-history requests share a daily fair-use quota. Exceeding it returns a 429 with TOO_MANY_REQUESTS; back off and resume from the same cursor.
  • Old candles are honest about their gaps: avg is null in deep history, and where only a close survived, open, high and low equal it. The docs list every case.

Candles for Spot and for Futures

One candle shape for aggregated spot and for perpetual futures.

Endpoints marked Growth have production access on Growth and higher. Free, Basic and Startup can make five successful preview requests per eligible endpoint, per account, each UTC day. Normal usage and plan limits apply. How previews work.

What Developers Build on OHLCV Data

Candles are the input to almost everything quantitative.

Candlestick Charts

Seven intervals map to seven chart buttons. Start and end timestamps per candle, no alignment code.

Backtests

Minute candles since December 2018, paged in 1,440-candle blocks that an HTTP cache can hold.

Strategy Signals

Build the live candle from WebSocket rates and close it against the last OHLCV candle.

Data Warehouses

Deterministic windows make backfills idempotent: rerun a range and get identical rows.

OHLCV by Plan

The OHLCV endpoint needs the Growth plan; price history without candles is on every plan.

Coinranking API plans and limits
FreeBasicStartupGrowthProfessional
Monthly price$0$24$49$99$199
Monthly credits10,000500,0001,000,0002,000,0005,000,000
REST rate limit5 / second1,000 / minute2,000 / minute4,000 / minute6,000 / minute
API keys1125Unlimited
Historical window, where supported1 year5 yearsAll time (from 2010)All time (from 2010)All time (from 2010)
Maximum results per response1005,0005,0005,0005,000
Standard endpoints on this page5 successful previews / endpoint / UTC day5 successful previews / endpoint / UTC day5 successful previews / endpoint / UTC dayProduction accessProduction access

Endpoint-specific limits may be lower. Preview allowances are shared across every API key on your account. Every paid plan offers a 30-day free trial. Compare all features.

OHLCV Questions

Get the OHLCV Candles

Seven intervals and minute history to 2018, free for 30 days on Growth.

10,000 credits a month, no credit card. WebSocket and SSE streaming are available on all plans.

    Crypto OHLCV API: 1-Minute to 1-Month Candles | Coinranking