Package com.qtsurfer.api.client.model

Class DatasetWithLinks

java.lang.Object
com.qtsurfer.api.client.model.DatasetWithLinks
@Generated(value="org.openapitools.codegen.languages.JavaClientCodegen", comments="Generator version: 7.14.0") public class DatasetWithLinks extends Object
A `Dataset` plus a self link. Returned by `GET /datasets/{datasetId}`.

  • Field Details

  • Constructor Details

    • DatasetWithLinks

      public DatasetWithLinks()

  • Method Details

    • datasetId

      public DatasetWithLinks datasetId(@Nonnull String datasetId)

    • getDatasetId

      @Nonnull public String getDatasetId()
      Opaque id, returned by `POST /datasets`.
      Returns:
      datasetId

    • setDatasetId

      public void setDatasetId(@Nonnull String datasetId)

    • name

      public DatasetWithLinks name(@Nonnull String name)

    • getName

      @Nonnull public String getName()
      Unique among your datasets.
      Returns:
      name

    • setName

      public void setName(@Nonnull String name)

    • type

      public DatasetWithLinks type(@Nonnull DatasetWithLinks.TypeEnum type)

    • getType

      @Nonnull public DatasetWithLinks.TypeEnum getType()
      `ticker` for an upload or a `dex` import with no `cadence` requested (native per-trade data). `klines` for a `dex` import that requested a candle `cadence` — pre-aggregated bars rather than raw ticks. Purely informational; both shapes are read the same way.
      Returns:
      type

    • setType

      public void setType(@Nonnull DatasetWithLinks.TypeEnum type)

    • instrument

      public DatasetWithLinks instrument(@Nonnull String instrument)

    • getInstrument

      @Nonnull public String getInstrument()
      Exchange instrument identifier (e.g. a currency pair)
      Returns:
      instrument

    • setInstrument

      public void setInstrument(@Nonnull String instrument)

    • createdAt

      public DatasetWithLinks createdAt(@Nonnull OffsetDateTime createdAt)

    • getCreatedAt

      @Nonnull public OffsetDateTime getCreatedAt()
      When the dataset was created.
      Returns:
      createdAt

    • setCreatedAt

      public void setCreatedAt(@Nonnull OffsetDateTime createdAt)

    • currentVersionId

      public DatasetWithLinks currentVersionId(@Nullable String currentVersionId)

    • getCurrentVersionId

      @Nullable public String getCurrentVersionId()
      The id of the most recently finalized, successfully ingested version. Absent until at least one upload has finished ingesting.
      Returns:
      currentVersionId

    • setCurrentVersionId

      public void setCurrentVersionId(@Nullable String currentVersionId)

    • updatedAt

      public DatasetWithLinks updatedAt(@Nullable OffsetDateTime updatedAt)

    • getUpdatedAt

      @Nullable public OffsetDateTime getUpdatedAt()
      When `currentVersionId` last changed. Absent until it has a value.
      Returns:
      updatedAt

    • setUpdatedAt

      public void setUpdatedAt(@Nullable OffsetDateTime updatedAt)

    • from

      public DatasetWithLinks from(@Nullable OffsetDateTime from)

    • getFrom

      @Nullable public OffsetDateTime getFrom()
      Start of `currentVersionId`'s own data range, as discovered at ingest time. Absent until a version exists.
      Returns:
      from

    • setFrom

      public void setFrom(@Nullable OffsetDateTime from)

    • to

      public DatasetWithLinks to(@Nullable OffsetDateTime to)

    • getTo

      @Nullable public OffsetDateTime getTo()
      End of `currentVersionId`'s own data range, as discovered at ingest time. Absent until a version exists.
      Returns:
      to

    • setTo

      public void setTo(@Nullable OffsetDateTime to)

    • cadence

      public DatasetWithLinks cadence(@Nullable String cadence)

    • getCadence

      @Nullable public String getCadence()
      `currentVersionId`'s own discovered cadence — a fixed grid (e.g. `1s`, `1m`, `1h`) or `rt` (see `DatasetVersion.cadence`). Absent until a version exists.
      Returns:
      cadence

    • setCadence

      public void setCadence(@Nullable String cadence)

    • timestampUnit

      public DatasetWithLinks timestampUnit(@Nullable DatasetWithLinks.TimestampUnitEnum timestampUnit)

    • getTimestampUnit

      @Nullable public DatasetWithLinks.TimestampUnitEnum getTimestampUnit()
      `currentVersionId`'s own timestamp unit (see `DatasetVersion.timestampUnit`) — decode the `timestamp` column of `dataUrl`'s file accordingly. Present only when `status` is `ready`.
      Returns:
      timestampUnit

    • setTimestampUnit

      public void setTimestampUnit(@Nullable DatasetWithLinks.TimestampUnitEnum timestampUnit)

    • status

      public DatasetWithLinks status(@Nonnull DatasetWithLinks.StatusEnum status)

    • getStatus

      @Nonnull public DatasetWithLinks.StatusEnum getStatus()
      * `ready` — `currentVersionId` is set; `from`/`to`/`cadence`/`bytes`/`rows`/`gaps`/ `largestGapSteps` describe it. * `failed` — the most recent upload/import attempt failed. `currentVersionId` and the fields above are absent — there is nothing to read yet. See `error`. * `pending` — nothing has ever been attempted (just created, or an upload was never finalized).
      Returns:
      status

    • setStatus

      public void setStatus(@Nonnull DatasetWithLinks.StatusEnum status)

    • bytes

      public DatasetWithLinks bytes(@Nullable Integer bytes)

    • getBytes

      @Nullable public Integer getBytes()
      Size of `currentVersionId`'s own stored file. Present only when `status` is `ready` — see `DatasetVersion.bytes` for what it measures exactly.
      Returns:
      bytes

    • setBytes

      public void setBytes(@Nullable Integer bytes)

    • rows

      public DatasetWithLinks rows(@Nullable Integer rows)

    • getRows

      @Nullable public Integer getRows()
      `currentVersionId`'s own row count. Present only when `status` is `ready`.
      Returns:
      rows

    • setRows

      public void setRows(@Nullable Integer rows)

    • gaps

      public DatasetWithLinks gaps(@Nullable Integer gaps)

    • getGaps

      @Nullable public Integer getGaps()
      `currentVersionId`'s own gap count at its discovered cadence. Present only when `status` is `ready`.
      Returns:
      gaps

    • setGaps

      public void setGaps(@Nullable Integer gaps)

    • largestGapSteps

      public DatasetWithLinks largestGapSteps(@Nullable Integer largestGapSteps)

    • getLargestGapSteps

      @Nullable public Integer getLargestGapSteps()
      `currentVersionId`'s own largest gap, in units of its discovered cadence step. Present only when `status` is `ready`.
      Returns:
      largestGapSteps

    • setLargestGapSteps

      public void setLargestGapSteps(@Nullable Integer largestGapSteps)

    • error

      public DatasetWithLinks error(@Nullable String error)

    • getError

      @Nullable public String getError()
      A human-readable reason the most recent upload/import attempt failed. Present only when `status` is `failed`.
      Returns:
      error

    • setError

      public void setError(@Nullable String error)

    • dataUrl

      public DatasetWithLinks dataUrl(@Nullable String dataUrl)

    • getDataUrl

      @Nullable public String getDataUrl()
      Presigned GET URL to the current version's stored file — see `dataFormat` for which format it's actually in. Present only once the current version's status is `ready`. Long-lived (day-scale, not permanent): a DuckDB-WASM/`lastra-ts`-style reader issues HTTP range requests against it lazily over an extended viewing session, not in one shot like a browser upload.
      Returns:
      dataUrl

    • setDataUrl

      public void setDataUrl(@Nullable String dataUrl)

    • dataFormat

      public DatasetWithLinks dataFormat(@Nullable DatasetWithLinks.DataFormatEnum dataFormat)

    • getDataFormat

      @Nullable public DatasetWithLinks.DataFormatEnum getDataFormat()
      Which format `dataUrl` is actually in — check this rather than assuming it matches how you uploaded it. `lastra` — our native columnar format — for a CSV (or gzip/zip of one) upload, always converted on ingest, or for a lastra upload, stored as-is (the value alone doesn't tell you which). `parquet` for a parquet upload, also stored as-is today.
      Returns:
      dataFormat

    • setDataFormat

      public void setDataFormat(@Nullable DatasetWithLinks.DataFormatEnum dataFormat)

    • links

      public DatasetWithLinks links(@Nullable DatasetWithLinksAllOfLinks links)

    • getLinks

      @Nullable public DatasetWithLinksAllOfLinks getLinks()
      Get links
      Returns:
      links

    • setLinks

      public void setLinks(@Nullable DatasetWithLinksAllOfLinks links)

    • equals

      public boolean equals(Object o)
      Return true if this DatasetWithLinks 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