Download Minute-Candle History Archive
download_history_archiveBulk-download minute candle history for entire years as a single CSV file via the REST archive endpoint, reducing costs compared to individual candle queries.
Instructions
Bulk-download MINUTE candles for whole years via the REST archive endpoint (1 HTTP request = 1 year) and merge them into a single CSV file in the output root. Far cheaper than get_candles for long minute history. Columns: instrumentUid;timeUtc;open;close;high;low;volume. Archives are rebuilt nightly (no current day). Years with no data are skipped and listed in the summary. Takes the instrument UID only. Check available years first with get_history_archive_years.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"instrumentId": "<instrumentId>",
"yearFrom": "<yearFrom>"
},
"name": "download_history_archive"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| yearTo | No | Last year (default: current year) | |
| yearFrom | Yes | First year to download | |
| outputPath | No | Target CSV path relative to the output root (default: history_1min_<uid>_<years>.csv) | |
| instrumentId | Yes | Instrument UID (uuid) from find_instrument; FIGI/ticker are not accepted |