Skip to article
XTester Help
XTester Studio

Download Data

Choose a source, market, symbols and period, then queue a candle download.

Reviewed: Applies to: 1.0.0-preview.1

Exchange, market, and symbol

Where to open

Data → Download Data… or the XTester: Download Data… command.

Steps
  1. Select the asset class, source and market.
  2. Choose a preset set or select the required symbols in the list.
  3. Use Add to Selection or Replace Selection to apply a preset to the selected symbols.
  4. In Period, choose a history depth or a custom range.
  5. Review the selection and use Queue to add the job. Follow its progress in Downloads.
Application screenshotXTester 1.0.0-preview.1
Choosing a source, market and symbol preset before queuing a download.Interface screenshot · XTester 1.0.0-preview.1
  1. Set the asset class, source and market.
  2. A preset previews its proposed symbols.
  3. Add the preset to the selection or replace the current selection.

Choose the provider or exchange, market, and symbol in the download panel. A spot instrument and a futures instrument with the same ticker are separate data series. Available choices come from EngineHost.

If a symbol is missing, refresh the Data view and verify the selected provider and market before entering another ticker.

Download and update

Use Download Data to request the required history. Watch the queue and status messages; an engine operation can delay a queued download. Use the offered cancellation action when necessary and wait for the task to report its final state. The final summary counts updated, failed, and cancelled datasets separately. If a download fails, the message includes the first error; Open Log shows the details for every dataset.

Application screenshotXTester 1.0.0-preview.1
Choose an instrument, set Range…, and review the preview. This example queues one pair: Binance Spot BTCUSDT.Interface screenshot · XTester 1.0.0-preview.1
  1. Download boundaries.
  2. Review the instrument list.
  3. Queue the selection.

The Data view provides update-tail and full-history actions where supported. Right-click a pair, market, exchange or asset-class branch: candle operations apply to all pairs inside that branch, including pairs without downloaded history. Overlapping selected branches and pairs are processed once.

Memory and startup-memory settings, charts, import/export and deletion use the same branch scope; deletion retains its confirmation of the exact pair list. Integrity verification retains its group audit. Empty branches never fall back to other data. Downloads depend on the source’s history depth, connectivity, rate limits, and EngineHost capabilities.

Help loads from the XTester website; reading an article does not start a market-data download.

Check coverage before a run

Inspect the available first and last candle dates and choose a simulation interval inside the downloaded range. Higher timeframes are derived from available history; gaps or insufficient warm-up data can affect indicators and results.

Application screenshotXTester 1.0.0-preview.1
The report checked 60 expected minute slots and found 60 usable. It measures local history structure; it does not certify price accuracy or execution quality.Interface screenshot · XTester 1.0.0-preview.1
  1. Coverage score for the selected interval.

In Simulation Settings, choose Check data quality to report on the selected interval. It reads local minute candles and counts usable and missing minute slots. A score of 100/100 means complete structural coverage for this interval; it does not certify price accuracy or execution.

The data integrity check in the Data tree can download missing history. Follow it in Downloads. Stopping the queue preserves data already saved.

Deleting history removes local data for the selected instrument. Refreshing the view does not restore deleted data. Download it again if you still need it.

Source capabilities: history and live

Use get_market_data_capabilities in MCP/Copilot, optionally filtering by exchange, market or providerId. Without filters it returns the complete catalog. C# strategies use MarketDataSourceCatalog.Find; get_strategy_api_doc returns the exact signatures.

History and live are independent: range downloads, a recent batch or daily archives; minute-candle streams or polling. Archive input resolution is separate from the resolution delivered by the current adapter. Existing sub-minute archives currently import into minute candles.

HostAvailable means implementation code is included in the current host. It does not verify connectivity, period coverage or credentials. Discovery neither downloads data nor authorizes emulation. C# strategies can request refinement of a closed interval with context.DataRefinement().Require. Confirmed no-trade intervals do not require fabricated candles.

Related commands

Command Palette reference
Command nameIdentifier

Find these actions by name in the Command Palette; availability depends on the current project and operation state.

Verify data integrityxtester.dataCheckGaps
Verify data integrityxtester.dataCoverageAudit
Delete Data…xtester.dataDelete
Do Not Load When the Application Startsxtester.dataDisableStartupMemory
Download All Historyxtester.dataDownloadFull
Download Latest Dataxtester.dataDownloadTail
Load When the Application Startsxtester.dataEnableStartupMemory
Export history…xtester.dataExportHistory
Import history…xtester.dataImportHistory
Load into Memoryxtester.dataLoadToMemory
Refresh Data Listxtester.dataRefresh
Verify data integrityxtester.dataRepairGaps
Sync Dataxtester.dataSyncAll
Unload from Memoryxtester.dataUnloadFromMemory
Verify data integrityxtester.dataVerifyCoverage
Download Data…xtester.downloadData
Show Download Progressxtester.showDownloadProgress