Get a dataset by id

Opaque id, returned by POST /datasets.

Unique among your datasets.

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.

Exchange instrument identifier (e.g. a currency pair)

When the dataset was created.

The id of the most recently finalized, successfully ingested version. Absent until at least one upload has finished ingesting.

When you deleted this dataset. Only ever present in GET /datasets?includeDeleted=true, and only on datasets you have deleted.

When currentVersionId last changed. Absent until it has a value.

Start of currentVersionId's own data range, as discovered at ingest time. Absent until a version exists.

End of currentVersionId's own data range, as discovered at ingest time. Absent until a version exists.

currentVersionId's own discovered cadence — a fixed grid (e.g. 1s, 1m, 1h) or rt (see DatasetVersion.cadence). Absent until a version exists.

currentVersionId's own timestamp unit (see DatasetVersion.timestampUnit) — decode the timestamp column of dataUrl's file accordingly. Present only when status is ready.

• 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).

Size of currentVersionId's own stored file. Present only when status is ready — see DatasetVersion.bytes for what it measures exactly.

currentVersionId's own row count. Present only when status is ready.

currentVersionId's own gap count at its discovered cadence. Present only when status is ready.

currentVersionId's own largest gap, in units of its discovered cadence step. Present only when status is ready.

A human-readable reason the most recent upload/import attempt failed. Present only when status is failed.

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.

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.