All Classes and Interfaces
Class
Description
Turns a generated api-client call into an SDK call: the checked
ApiException becomes the QTSError subclass the calling stage
is defined in terms of, with the HTTP status and response body folded into
the message.An api-client invocation, which may fail with the generated checked exception.
Authenticated SDK session.
Configuration for
AuthenticatedClient.Handle for a running backtest execution.
Execution lifecycle as observed by the SDK.
Tuning knobs for a
backtest invocation.What the platform has to say about a backtest run right now — read by
QTSurfer.backtestResult(String, String) for a job the calling
process did not necessarily start.The run was cancelled.
The run finished and produced its numbers.
The run finished badly.
The platform knows this job but has nothing final to report yet.
Reads an execute-result response as one of the four answers a standalone
read can get.
Emitted at stage transitions and after each poll with known size.
A single-instrument backtest request.
The three stages of a backtest workflow.
Orchestrates compile → prepare → execute over
com.qtsurfer:api-client.Normalized bounded sweep-run curve independent of the generated response model.
Compilation metadata discovered without constructing a strategy.
Transfers dataset bytes to presigned upload targets without an API-auth interceptor.
Wire format for hourly tickers/klines downloads.
One normalized absolute point from a bounded equity curve.
Default
StrategyCompileClient backed by the api-client's shared
ApiClient (HttpClient, ObjectMapper, base URI, request interceptor).Default
TokenStore — holds the most recent token in a single
in-memory slot.One strategy property and the values a sweep should try for it: either a
numeric
ParamAxis.Range, or an explicit ParamAxis.Values list.A numeric range walked in fixed steps,
from through to.An explicit list of values.
Factory helpers that build Failsafe policies shared by every workflow stage.
The single polling loop every workflow stage runs on, on top of
Policies.stagePoller(java.time.Duration, java.time.Duration, java.time.Duration, java.util.function.Predicate<T>): interrupt handling, the per-attempt callback,
and the mapping from Failsafe's failures onto the SDK error hierarchy.The prepare stage, shared by every workflow that needs a dataset before it
can execute anything.
Thrown when the
authenticate() helper cannot mint a JWT — typically because
no API key was supplied (neither argument nor QTSURFER_APIKEY
environment variable), or the API key exchange returned 401 / a non-success
status from POST /v1/auth/token.Thrown when the workflow is canceled by the caller (e.g.
Raised when an hourly tickers/klines download fails — wraps the underlying
ApiException (HTTP 4xx/5xx, transport error).Root of the QTSurfer SDK exception hierarchy.
Thrown when the execute stage of a run this SDK is performing fails: the
platform rejected the submission, reported the run as failed, or the poll
driving it could not reach the platform.
Thrown when the data preparation stage fails (e.g.
Thrown when a strategy fails to compile server-side.
Thrown when a stage exceeds its configured timeout.
Failure while transferring bytes to a presigned dataset upload target.
High-level SDK for the QTSurfer platform.
Configuration for a
QTSurfer client.Maps the raw backend job status (which in the live API is lowercase —
queued, started, completed, failed, …)
to a stable enum so the rest of the SDK reasons about it without caring
about OpenAPI spec drift or generator casing.A compiled strategy handle returned by
QTSurfer.compile(java.lang.String).Backend-facing client for the strategy compile step.
Handle for a running parameter sweep.
Sweep lifecycle as observed by the SDK.
The metric a sweep optimizes, and the one its leaderboard and its
sensitivity surfaces are read against.
Tuning knobs for a
sweep
invocation.Fluent builder for
SweepOptions.Which view of a sweep's rows to read: the display leaderboard, or every row
in a stable order.
Emitted at stage transitions and after each poll of a running sweep.
How the leaderboard is ordered.
A parameter sweep over one instrument and one window: the same strategy run
once per parameter vector, scored and ranked against a single objective.
Fluent builder for
SweepRequest.How the parameter grid is turned into the list of vectors that actually run.
Orchestrates compile → prepare → executeSweep over
com.qtsurfer:api-client, and polls the leaderboard until the sweep
stops advancing.Pluggable token persistence strategy for
AuthenticatedClient.Builds a live-parameter update without exposing the generated untyped request field.
What a call to validate a strategy did — which is a different
question from what the platform currently thinks of the strategy.
This call queued nothing, because the platform already accounts for
the current compilation.
This call queued a check, which has not answered yet.
Reads the queued-or-not distinction off the HTTP status of a validation
request.
Opt a sweep into walk-forward validation.