Method - get_candles
Returns historical OHLCV bars in UTC, same interval strings as the in-app chart.
Contract (arguments)
| Argument | Required | Default | Notes |
|---|---|---|---|
exchange | yes | — | |
market | yes | — | spot or futures |
symbol | yes | — | |
interval | yes | — | Same strings as the chart, e.g. 1m, 5m, 1h |
limit | no | 100 | 1–1000 (exchange REST limits may return fewer bars) |
Response shape
JSON array of CandleBarDto: time_utc, open, high, low, close, volume (quote notional when the exchange provides it, else base volume).
Example tools/call
json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_candles",
"arguments": {
"exchange": "Binance",
"market": "spot",
"symbol": "BTCUSDT",
"interval": "1h",
"limit": 3
}
}
}Example success
json
[
{
"time_utc": "2026-04-25T12:00:00Z",
"open": 98000,
"high": 98500,
"low": 97800,
"close": 98234.5,
"volume": 12345.67
}
]