qs-backtest-server 0.4.1

Transport-neutral retained-job backtest service and CLI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

# Backtest Server — Example Configuration
#
# Copy this file to config.toml and adjust paths for your environment.

[server]
# Logical service endpoint. SHM is the default local deployment; Unix sockets and
# loopback TCP are also supported, for example unix:///tmp/backtest.sock or
# tcp://127.0.0.1:41001. TCP has no built-in authentication or TLS.
endpoint = "shm://backtest"

# Per-client SHM buffer size in bytes (default: 16 MB).
# Increase if FutureQuoteV1 results or artifacts exceed the buffer.
# run_backtest, submit_backtest, and run_backtest_multi use the same
# server/SHM settings; version-suffixed execution methods are not registered.
shm_buffer_size = 16777216

[database]
# Root directory for Parquet-partitioned market data.
# Must be populated via `data-preprocess input` before use.
data_dir = "market_data"

[symbols]
# Path to the qs-symbols registry TOML.
registry_path = "crates/symbols/symbols.toml"

[instruments]
# Optional strict instrument catalog document. When omitted, supported entries in the
# qs-symbols registry compile into an immutable compatibility catalog.
# catalog_path = "instrument-catalog.toml"
# Optional broker, exchange, or repository-owned alias-resolution default. A trading platform
# such as CTrader is not a listing venue. Explicit catalogs may omit this when aliases are unique.
# Compatibility catalogs use repository-default when it is omitted.
# default_listing_venue = "ic-markets"
# Identity of the historical data source. This is separate from listing and execution venues.
market_data_source = "local-parquet"
# Optional physical dataset selection when several aliases identify the same symbol.
# [instruments.source_symbols]
# us100 = "USTEC"

# Operator-selected linear simulations, not verified broker specifications.
# Use these instead of catalog_path; ordinary guarded registry instruments are retained.
[[instruments.linear_instruments]]
symbol = "BTCUSD"
contract_multiplier = "1"
price_step = "0.01"
display_scale = 2
quantity_step = "0.01"
minimum = "0.01"
maximum = "10"

[[instruments.linear_instruments]]
symbol = "ETHUSD"
contract_multiplier = "1"
price_step = "0.01"
display_scale = 2
quantity_step = "0.01"
minimum = "0.01"
maximum = "10"

[profiles]
# Path to the qs-backtest management profiles TOML.
# Profiles should include explicit target_selection. Existing serialized profiles with
# only use_targets remain readable. Dynamic RPC additions are not persisted.
profiles_path = "crates/backtest/profiles.toml"

[jobs]
# Retain completed, failed, and cancelled jobs for one hour.
retention_secs = 3600
# Periodically remove expired terminal jobs.
cleanup_interval_secs = 60
# Hard bound across queued, running, and retained terminal jobs/results.
max_retained_jobs = 1000

[artifacts]
# Filesystem directory for complete result JSON artifacts.
directory = "backtest-artifacts"
# Results up to 12 MiB can be returned inline while preserving the 16 MiB transport.
inline_limit_bytes = 12582912
# Raw bytes returned per base64-encoded chunk RPC.
chunk_size = 1048576
# Retain artifacts for one hour unless they are deleted after download.
retention_secs = 3600
# Bound total retained artifact storage to 1 GiB.
max_total_bytes = 1073741824

[strategies]
# Largest accepted strategy, template, or space document, measured as JSON.
max_document_bytes = 262144
# Largest total retained history one configured or portfolio run may bind across its sources, in bars.
max_retained_bars = 200000
# Most worker threads one parameter search may use; requests asking for more are capped.
max_search_workers = 4
# Most parameter combinations one search may enumerate before constraints.
max_search_generation_points = 100000
# Most runs, admitted points times symbols times windows, one search may schedule.
max_search_runs = 20000
# Most configured strategy instances one portfolio run may replay against one account; max_retained_bars bounds their combined history.
max_portfolio_instances = 16

[logging]
# Log level: "trace", "debug", "info", "warn", "error"
level = "info"