get_candles
Retrieve OHLCV candles for a specific instrument. Get historical price data with configurable interval and count.
Instructions
Get OHLCV candles for one instrument.
Returns {"instrumentId": int, "interval": str, "candles": [{"time": ISO-8601 period start, "open": float, "high": float, "low": float, "close": float, "volume": float}]}. Prices are in the instrument's quote currency; the newest bar can be the still-forming session.
History depth is capped at about 1000 bars per interval — there is no way to page further back in time (no from/to parameters exist), so at OneDay one request covers roughly four years; use a coarser interval such as OneWeek for deeper history. 'direction' only changes ordering: asc and desc return the same most-recent window, oldest-first vs newest-first. An unknown instrument id yields no candle data and this tool raises an error rather than returning an empty series.
Rate limit: shares the market-data pool of 120 requests per 60 seconds.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | Number of candles, maximum 1000. | |
| interval | No | Candle interval: OneMinute, FiveMinutes, TenMinutes, FifteenMinutes, ThirtyMinutes, OneHour, FourHours, OneDay, or OneWeek. | OneDay |
| direction | No | 'asc' = oldest first, 'desc' = newest first. | asc |
| instrument_id | Yes | Instrument id, e.g. 1001 for AAPL. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||