Live Execution

Change a running strategy's parameters

Changed on

Updates one or more parameters of a run while it stays live — unlike params on POST /strategy/{strategyId}/live, which only sets the starting values. Owner only.

Every key in params must be one your strategy declares (see declaredProperties on POST /strategy) as of the compilation this run is executing — recompiling the strategy later never changes what an already-running instance accepts; start a new run for that.

The change does not take effect the instant this call returns: effectiveAtMs is the earliest moment it is guaranteed to apply, a few seconds out, so both the REST and WebSocket paths to this same update (see the "Live execution" guide) land on the exact same value at the exact same moment.

put/live/{runId}/params

Request

  • Base URL: https://api.qtsurfer.net/v1
  • URL: https://api.qtsurfer.net/v1/live/{runId}/params
  • Auth: HTTP bearer

Path parameters

runIdstring required

Request body

paramsobject required

Must be non-empty; every key must be a property your strategy declares.

Response

Accepted

runIdstring required
paramsVersioninteger required
effectiveAtMsinteger required

Epoch milliseconds — the earliest moment the new values are guaranteed to be in effect.

Changes