Package com.qtsurfer.api.client.model

Class LiveRunDetail

java.lang.Object
com.qtsurfer.api.client.model.LiveRunDetail
@Generated(value="org.openapitools.codegen.languages.JavaClientCodegen", comments="Generator version: 7.24.0") public class LiveRunDetail extends Object
A run as returned by `GET /live/{runId}`, the full state of `LiveRun` plus when it last changed.

  • Field Details

  • Constructor Details

    • LiveRunDetail

      public LiveRunDetail()

  • Method Details

    • strategyId

      public LiveRunDetail strategyId(@Nonnull String strategyId)

    • getStrategyId

      @Nonnull public String getStrategyId()
      Unique identifier for a compiled strategy, derived from the source itself: the same code always yields the same id, for every caller. How much formatting the id ignores depends on the language — see `POST /strategy` for exactly which rewrites preserve it and which do not.
      Returns:
      strategyId

    • setStrategyId

      public void setStrategyId(@Nonnull String strategyId)

    • runId

      public LiveRunDetail runId(@Nonnull String runId)

    • getRunId

      @Nonnull public String getRunId()
      This run's own id — its canonical identity for `PATCH`/`PUT .../params` and for `GET /live/public`.
      Returns:
      runId

    • setRunId

      public void setRunId(@Nonnull String runId)

    • name

      public LiveRunDetail name(@Nullable String name)

    • getName

      @Nullable public String getName()
      Get name
      Returns:
      name

    • setName

      public void setName(@Nullable String name)

    • description

      public LiveRunDetail description(@Nullable String description)

    • getDescription

      @Nullable public String getDescription()
      Get description
      Returns:
      description

    • setDescription

      public void setDescription(@Nullable String description)

    • visibility

      public LiveRunDetail visibility(@Nonnull LiveRunDetail.VisibilityEnum visibility)

    • getVisibility

      @Nonnull public LiveRunDetail.VisibilityEnum getVisibility()
      Get visibility
      Returns:
      visibility

    • setVisibility

      public void setVisibility(@Nonnull LiveRunDetail.VisibilityEnum visibility)

    • stage

      public LiveRunDetail stage(@Nonnull LiveRunDetail.StageEnum stage)

    • getStage

      @Nonnull public LiveRunDetail.StageEnum getStage()
      A new run starts `SANDBOX`, a 24-hour trial in which it is compared against a second execution and checked for resource use and stability. A run that passes moves to `LIVE` automatically when the 24 hours are up. A run of a strategy that an earlier run of yours already took through the trial starts `LIVE`, unless you started it with `sandbox: true`.
      Returns:
      stage

    • setStage

      public void setStage(@Nonnull LiveRunDetail.StageEnum stage)

    • state

      public LiveRunDetail state(@Nonnull String state)

    • getState

      @Nonnull public String getState()
      The run's health right now: `STARTING` (no runner has reported on it yet), `RUNNING`, `LAGGING` (behind the market data, usually while catching up; clears by itself), `HUNG` (stuck inside one strategy call for longer than allowed; clears when it returns), `DEGRADED` (its independent executions produced different signals), `FAILED` (refused, could not start or failed while running; `reason` says why) or `STOPPED`. `LAGGING`, `HUNG` and `DEGRADED` come and go on a running run. The set may grow: read an unknown value as a running run with something to look at. See the Live execution guide.
      Returns:
      state

    • setState

      public void setState(@Nonnull String state)

    • desired

      public LiveRunDetail desired(@Nonnull LiveRunDetail.DesiredEnum desired)

    • getDesired

      @Nonnull public LiveRunDetail.DesiredEnum getDesired()
      What you last asked for. `state` can lag this briefly after `DELETE`.
      Returns:
      desired

    • setDesired

      public void setDesired(@Nonnull LiveRunDetail.DesiredEnum desired)

    • reason

      public LiveRunDetail reason(@Nullable String reason)

    • getReason

      @Nullable public String getReason()
      Why the run stopped or failed, when there is something to say; absent otherwise. It is never a stack trace or an internal message. Either `resource: ...` (the platform stopped the run for exceeding its resource allowance; the text says which limit) or one of a fixed set of sentences for a `FAILED` run: the strategy cannot consume the source type the run was started with, the run's definition was refused, the pool address of a `dex` run is not a pool of its protocol on its chain, the platform has no room to follow the pool of a `dex` run, the run could not start after several attempts, the strategy failed while processing data, the run lost its data feed, or the generic `The run failed.`. The set may grow: read an unrecognised sentence as a failure and do not parse it. A `FAILED` run usually stays `desired: RUNNING` until you stop it, and counts as active (`409` on a new start, and toward your live-run limit) until then; one that cannot run, and will not by waiting, because its strategy cannot consume its source type or because the pool of a `dex` run is not a pool or has no room to be followed, is stopped by the platform itself (`desired: STOPPED`), so it holds no place.
      Returns:
      reason

    • setReason

      public void setReason(@Nullable String reason)

    • sources

      public LiveRunDetail sources(@Nonnull List<LiveSource> sources)

    • addSourcesItem

      public LiveRunDetail addSourcesItem(LiveSource sourcesItem)

    • getSources

      @Nonnull public List<LiveSource> getSources()
      Get sources
      Returns:
      sources

    • setSources

      public void setSources(@Nonnull List<LiveSource> sources)

    • params

      public LiveRunDetail params(@Nonnull Map<String,Object> params)

    • putParamsItem

      public LiveRunDetail putParamsItem(String key, Object paramsItem)

    • getParams

      @Nonnull public Map<String,Object> getParams()
      Get params
      Returns:
      params

    • setParams

      public void setParams(@Nonnull Map<String,Object> params)

    • paramsVersion

      public LiveRunDetail paramsVersion(@Nonnull Integer paramsVersion)

    • getParamsVersion

      @Nonnull public Integer getParamsVersion()
      Increments on every accepted `PUT .../params` call, including one that resends the current values.
      Returns:
      paramsVersion

    • setParamsVersion

      public void setParamsVersion(@Nonnull Integer paramsVersion)

    • relay

      public LiveRunDetail relay(@Nonnull Boolean relay)

    • getRelay

      @Nonnull public Boolean getRelay()
      Whether this run's signals are relayed over the WebSocket channel described in the \"Live execution\" guide. It is the value requested at start, in either stage.
      Returns:
      relay

    • setRelay

      public void setRelay(@Nonnull Boolean relay)

    • startedAtMs

      public LiveRunDetail startedAtMs(@Nonnull Long startedAtMs)

    • getStartedAtMs

      @Nonnull public Long getStartedAtMs()
      Epoch milliseconds.
      Returns:
      startedAtMs

    • setStartedAtMs

      public void setStartedAtMs(@Nonnull Long startedAtMs)

    • gate

      public LiveRunDetail gate(@Nullable Map<String,Object> gate)

    • putGateItem

      public LiveRunDetail putGateItem(String key, Object gateItem)

    • getGate

      @Nullable public Map<String,Object> getGate()
      The sandbox trial's promotion verdict. Absent for the whole 24-hour trial and present once it ends, so an absent `gate` means the trial has not finished. A run that started in `LIVE` without a trial has it from the start: the verdict of the earlier run it relies on, with `inheritedFrom` naming that run. `passed` is the verdict; the rest is diagnostic detail whose shape is not yet stabilized as public API: treat it as opaque.
      Returns:
      gate

    • setGate

      public void setGate(@Nullable Map<String,Object> gate)

    • paper

      public LiveRunDetail paper(@Nullable LivePaperConfig paper)

    • getPaper

      @Nullable public LivePaperConfig getPaper()
      The run's paper trading configuration as accepted at start, normalised. Absent when the run has no paper trading.
      Returns:
      paper

    • setPaper

      public void setPaper(@Nullable LivePaperConfig paper)

    • stats

      public LiveRunDetail stats(@Nullable LiveRunStats stats)

    • getStats

      @Nullable public LiveRunStats getStats()
      The run's latest counters. Returned by the two reads, `GET /strategy/{strategyId}/live` and `GET /live/{runId}`; never by starting or stopping a run. Absent until the first snapshot exists (a run that has just started), and absent is not zero.
      Returns:
      stats

    • setStats

      public void setStats(@Nullable LiveRunStats stats)

    • warmFrom

      public LiveRunDetail warmFrom(@Nullable Integer warmFrom)

    • getWarmFrom

      @Nullable public Integer getWarmFrom()
      The `warmFrom` in effect for this run, in seconds: the one requested when the run was started or, when none was, the one the platform chose (the distance from the run's start back to the start of the current 15-minute block, 0 to 900). It is never `null`. It is present on every run started since the field exists and absent from a run started before it existed. It never changes while the run exists. minimum: 0 maximum: 3600
      Returns:
      warmFrom

    • setWarmFrom

      public void setWarmFrom(@Nullable Integer warmFrom)

    • updatedAtMs

      public LiveRunDetail updatedAtMs(@Nonnull Long updatedAtMs)

    • getUpdatedAtMs

      @Nonnull public Long getUpdatedAtMs()
      Epoch milliseconds of the run's last change, from any cause. It only moves forward, so of two reads of the same run the one with the larger value is the newer.
      Returns:
      updatedAtMs

    • setUpdatedAtMs

      public void setUpdatedAtMs(@Nonnull Long updatedAtMs)

    • equals

      public boolean equals(Object o)
      Return true if this LiveRunDetail object is equal to o.
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object

    • toString

      public String toString()
      Overrides:
      toString in class Object

    • toUrlQueryString

      public String toUrlQueryString()
      Convert the instance into URL query string.
      Returns:
      URL query string

    • toUrlQueryString

      public String toUrlQueryString(String prefix)
      Convert the instance into URL query string.
      Parameters:
      prefix - prefix of the query string
      Returns:
      URL query string