Get OHLCV candles
get_candlesRead-only
Get OHLCV candle data for technical analysis and momentum trading strategies. Select a range to determine lookback and per-candle resolution.
Instructions
OHLCV candles for indicator/momentum strategies (RSI, moving averages, breakouts) — resolve_symbol first to get the coinId. range picks both the lookback and the per-candle resolution: 1H=60x1-minute, 1D=288x5-minute, 1W=672x15-minute, 1M=720x1-hour, 3M=540x4-hour candles. Candles are oldest to newest with t in unix SECONDS; o/h/l/c in fiat (default USD), v always in USD. Paper trading only — virtual funds (50,000 mUSD). Not financial advice.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| coinId | Yes | Coin UCID (e.g. "1" = BTC). Use resolve_symbol to find it. | |
| range | No | Lookback + resolution (default 1D = 288 five-minute candles). | |
| fiat | No | Quote currency for o/h/l/c (default USD). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| httpStatus | Yes | HTTP status returned by CoinRithm, or 0 for network errors. | |
| ok | Yes | True when CoinRithm returned a successful 2xx response. | |
| body | No | Parsed CoinRithm response body, or raw text when the response is not JSON. |