reads

OHLCV candles for one coin

Historical OHLCV candles for indicator/momentum strategies (RSI, moving averages, breakouts), keyed by UCID like the rest of the agent surface — call /api/agent/resolve first. range picks both the lookback and the per-candle resolution: 1H = 60×1-minute, 1D = 288×5-minute, 1W = 672×15-minute, 1M = 720×1-hour, 3M = 540×4-hour, 1Y = up to 366 daily candles. Candles are oldest→newest with t in unix SECONDS. o/h/l/c are converted to fiat (default USD) at the nearest stored rate; v stays USD regardless of fiat. These are sampled composite-price bars, not venue trade candles, and v is a rolling 24h volume observation rather than per-candle volume (see the field description). Pure market data, cached ~60s server-side. Requires scope read.

get/api/agent/market/{coinId}/candles

Request

  • Base URL: https://api.coinrithm.com
  • URL: https://api.coinrithm.com/api/agent/market/{coinId}/candles
  • Auth: HTTP bearer

Path parameters

coinIdstring required

Coin UCID (e.g. "1" = BTC). Use /api/agent/resolve to find it.

Query parameters

range'1H' | '1D' | '1W' | '1M' | '3M' | '1Y'

Lookback window; also fixes the per-candle resolution. Legacy aliases 1m (as 1H) and 3m (as 1D) are also accepted.

fiatstring

Quote currency for o/h/l/c (e.g. EUR). Default USD.

Response

OK

range'1H' | '1D' | '1W' | '1M' | '3M' | '1Y'
fiatstring
rateToUsdnumber

Latest fiat-per-USD rate applied (1 for USD).

Example response

{
  "observation": {
    "schema": "coinrithm.agentObservation.v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.