OHLC candles for any XRPL token.

The price-history series behind a candlestick chart: open, high, low, close and volume per interval for any XRPL DEX/AMM pair. Choose the interval (5m, 15m, 1h, 4h, daily, weekly) and how many bars, quoted in XRP or converted to USD. It's what a trading or research agent charts against, and what powers the live chart on every Cerberus token dashboard. Unknown pair or source down returns ok:false with a reason — never invented prices.

MCP tool: get_token_ohlc Price: $0.004 / call

Parameters

ParamDescription
issuerXRPL issuer address (r...)
currency3-char code or 40-char hex
interval5 | 15 | 60 | 240 | D | W (minutes, or Day/Week) — default 60
barsnumber of candles, newest last (default 168, max 1000)
fxoptional: 'USD' to convert prices from XRP to USD

Example

Call (MCP tools/call arguments):

{
  "issuer": "rsoLo2S1kiGeCcn6hCUXVrCpGMWLrRrLZz",
  "currency": "534F4C4F00000000000000000000000000000000",
  "interval": "D",
  "bars": 3
}

Result:

{
  "ok": true,
  "interval": "D",
  "quote": "XRP",
  "count": 3,
  "candles": [
    {
      "t": 1785283200,
      "o": 0.013677,
      "h": 0.013677,
      "l": 0.012808,
      "c": 0.013,
      "v": 39934.07
    }
  ]
}

FAQ

Where does the XRPL OHLC data come from?

From XRPL DEX and AMM trade history, aggregated into candles by OnTheDex. Prices are quoted in XRP by default (the native pair); pass fx=USD to convert to US dollars.

What intervals and how much history can I get?

Intervals are 5, 15, 60 and 240 minutes plus daily (D) and weekly (W). Request up to 1000 bars per call; page further back with the source's marker if you need more.

What happens if a token has no market?

You get ok:false with a reason (unknown pair, or source unreachable) and an empty candle list — never fabricated prices. Honesty is the product: no market means no chart.

Related tools

resolve_assetResolve an XRPL token's real cross-chain identity: is it the canonical asset (legitimately deployed across chains) or an impostor verify_priceValidate an XRPL token's price against its canonical cross-chain value: is a stablecoin still pegged, has the price diverged from token_holdersHolder distribution and concentration risk for any XRP Ledger token: holder count, top-1 and top-10 share of circulating supply, A get_new_poolsFeed of newly created XRPL AMM pools with initial liquidity, trading fee, and safety-signal scores from launch-time screening. quote_ammQuote an XRP-to-token swap against a live XLS-30 AMM pool: tokens out, spot vs effective price, price impact, pool depth, and trad

Browse the full tool suite →

Connect via MCP at https://cerberusindex.com/mcp — see the quickstart. Payment is automatic for x402-aware clients. Verdicts are informational risk signals, not financial advice.