CRIUS

OHLCV API

Robinhood Chain OHLCV candles API

Crius serves OHLCV candles for every token on Robinhood Chain at nine intervals, from 1 second to 1 day, with full history back to the chain's first block. Candles merge a token's real markets, filter dust and one-off spikes, and come in a compact columnar shape that maps straight onto charting libraries.

Get a free API key API reference
  • History from block 0
  • REST + WebSocket
  • Free plan: 1M credits / month
  • Robinhood Chain · chain ID 4663

Try it

A real request and its response

Captured from the live API, trimmed for length. Replace $CRIUS_API_KEY with your key; calls without that header work keyless at 2 requests a second.

Three hourly candles for TSLA Real response, trimmed
Request 
curl "https://api.crius.sh/v1/robinhood/token/0x322f0929c4625ed5bad873c95208d54e1c003b2d/candles?interval=1h&limit=3"
Response 
{
  "data": {
    "interval": "1h",
    "currency": "usd",
    "t": [
      1792832400000,
      1792836000000,
      1792839600000
    ],
    "o": [
      373.486,
      371.239,
      370.268
    ],
    "h": [
      373.488,
      372.938,
      371.14
    ],
    "l": [
      369.085,
      369.888,
      370.268
    ],
    "c": [
      371.239,
      370.268,
      371.14
    ],
    "v": [
      23648.5,
      13459.2,
      2.35779
    ],
    "bv": [
      4598.04,
      10643.7,
      2.35779
    ],
    "n": [
      107,
      81,
      1
    ],
    "mc": [
      4349056,
      4337675,
      4347895
    ]
  },
  "meta": {
    "block": 96714191,
    "block_ts": 1792839655000,
    "finalized_block": 96703786,
    "lag_ms": 35,
    "safe_block": 96707359
  }
}

Columnar arrays aligned by index: t bucket start (unix ms), o h l c, v USD volume, bv buy volume, n trades, mc market cap at close. The newest bucket is the live, still-forming candle.

What you get

Built for Robinhood Chain, not bolted on

  • 1-second to 1-day

    Nine intervals from the same index: scalping charts and daily backtests read the same data.

  • Clean wicks

    Dust trades never set a price, pools must agree with the token's price to be merged, and isolated off-market prints under $1k are left out of highs and lows.

  • Real markets merged

    USD candles combine the token's real pools (at least $1k or 2% of its liquidity) plus its launch curve. pool=main, a single pool or pool=all are one parameter away.

  • Continuous and gap-filled

    Each candle opens at the previous close; fill=true adds flat candles for empty buckets so the time axis stays even.

  • History from block one

    from_ts / to_ts reach back to the start of the chain, not just the last few days.

  • Live candles over WebSocket

    candles:: pushes the forming candle as trades land.

Endpoints

The calls behind it

Base URL https://api.crius.sh, chain segment robinhood (or 4663). Every response is {data, meta} with the block it reflects.

EndpointReturnsPlanCredits
GET /v1/{chain}/token/{address}/candles Candles: 1s, 30s, 1m, 5m, 15m, 1h, 4h, 6h, 1d; up to 1,500 per call Any (no key) 2
GET /v1/{chain}/token/{address}/trades The trades behind the candles Any (no key) 2
GET /v1/{chain}/volume Chain-wide volume per hour or day Any (no key) 1

Use cases

  • TradingView-style charts
  • Backtesting strategies
  • Volatility and volume screens
  • Indicators (RSI, VWAP, moving averages)
  • Research notebooks

Plans and limits

Candles cost 2 credits per call and are available on every plan, including keyless calls at 2 requests/second.

See pricing Plans, limits & credits

Questions about the OHLCV candles API

What intervals are supported?

1s, 30s, 1m, 5m, 15m, 1h, 4h, 6h and 1d, up to 1,500 candles per request.

Why don't the candles show the huge wicks I see elsewhere?

Swaps of a few raw units (for example 1 wei for 1 wei) and isolated small prints in thin side pools produce meaningless prices. Crius keeps them in volume but out of the price, so the chart shows what the market actually traded.

Is there a chart example?

Yes, a complete TradingView Lightweight Charts integration is in the docs at /docs/examples/chart/.

How far back does the history go?

To the first block of Robinhood Chain. The index was backfilled from genesis, so a token's candles start at its first trade.

Can I get candles in the quote token instead of USD?

Yes: currency=quote returns prices in the main pool's quote token (for example ETH or USDG).

Related APIs

Guides and articles

Documentation

Trades & candles reference →Chart example → All Robinhood Chain APIs → Compare providers →

Start with the free plan

1,000,000 credits a month, no card. Your key in under a minute.

Get a free API key Try the playground