@qtsurfer/api-client 0.15.0 → 0.16.0

package/dist/index.d.ts

@@ -96,6 +96,107 @@ type HalLink = {
      */
     templated?: boolean;
 };
+/**
+ * Your identity and tier limits. No database call behind this one — safe to fetch on every
+ * page load. Live usage against these limits is a separate resource, `GET /account/usage`,
+ * deliberately: usage changes on every upload/execution and costs a query to compute, this
+ * one doesn't.
+ *
+ */
+type Account = {
+    /**
+     * Your account id — the JWT `sub` claim.
+     */
+    userId: string;
+    /**
+     * Your current subscription tier.
+     */
+    tier: string;
+    /**
+     * Maximum number of active datasets your tier allows.
+     */
+    maxDatasets: number;
+    /**
+     * Maximum size, in bytes, of a single dataset version.
+     */
+    maxDatasetBytes: number;
+    /**
+     * Maximum combined storage, in bytes, across every dataset, strategy-execution signal,
+     * and registered strategy on your account — one shared pool, not a separate cap per
+     * resource type, since they all compete for the same underlying storage. See `GET
+     * /account/usage`'s `storageBytesUsed` for your current usage against this number.
+     *
+     */
+    maxTotalStorageBytes: number;
+    _links: AccountLinks;
+};
+/**
+ * HAL `_links` for `GET /account`
+ */
+type AccountLinks = {
+    /**
+     * Link to this resource.
+     */
+    self: HalLink;
+    /**
+     * Link to your live usage, `GET /account/usage`.
+     */
+    usage: HalLink;
+};
+/**
+ * Your live usage of the shared storage pool `GET /account`'s `maxTotalStorageBytes` caps.
+ * Not guaranteed real-time — a just-completed upload or strategy execution may take a short
+ * moment to be reflected here.
+ *
+ */
+type AccountUsage = {
+    /**
+     * Active datasets counted — the same set `GET /account`'s `maxDatasets` limits.
+     */
+    datasetsUsed: number;
+    /**
+     * Combined bytes of every active dataset's current version.
+     */
+    datasetBytesUsed: number;
+    /**
+     * Recorded strategy-execution signal uploads.
+     */
+    signalsUsed: number;
+    /**
+     * Combined bytes of every recorded signal upload.
+     */
+    signalBytesUsed: number;
+    /**
+     * Registered strategies (see `GET /strategies`).
+     */
+    strategiesUsed: number;
+    /**
+     * Combined bytes of each registered strategy's source plus its latest compiled
+     * bytecode. Superseded (non-latest) compilations aren't counted.
+     *
+     */
+    strategyBytesUsed: number;
+    /**
+     * `datasetBytesUsed + signalBytesUsed + strategyBytesUsed` — the number checked
+     * against `GET /account`'s `maxTotalStorageBytes`.
+     *
+     */
+    storageBytesUsed: number;
+    _links: AccountUsageLinks;
+};
+/**
+ * HAL `_links` for `GET /account/usage`
+ */
+type AccountUsageLinks = {
+    /**
+     * Link to this resource.
+     */
+    self: HalLink;
+    /**
+     * Link to your tier limits, `GET /account`.
+     */
+    account: HalLink;
+};
 /**
  * Exchange instrument with per-data-type coverage and market info
  */
@@ -1117,9 +1218,10 @@ type StrategyState = {
  * A dataset's own metadata — not its data. `currentVersionId` is what a prepare against
  * `exchangeId: user` reads by default; see `DatasetVersion` for what a version carries.
  *
- * `from`/`to`/`cadence` mirror that current version's own discovered range and cadence, so
- * you don't need a second call to `GET /datasets/{datasetId}/uploads/{uploadId}` just to see
- * what a dataset covers. Absent until a version exists.
+ * `from`/`to`/`cadence`/`timestampUnit`/`bytes`/`rows`/`gaps`/`largestGapSteps` mirror that
+ * current version's own discovered range, cadence, timestamp unit and metrics, so you don't
+ * need a second call to `GET /datasets/{datasetId}/uploads/{uploadId}` just to see what a
+ * dataset covers.
  *
  */
 type Dataset = {
@@ -1171,6 +1273,47 @@ type Dataset = {
      *
      */
     cadence?: string;
+    /**
+     * `currentVersionId`'s own timestamp unit (see `DatasetVersion.timestampUnit`) — decode
+     * the `timestamp` column of `dataUrl`'s file accordingly. Present only when `status` is
+     * `ready`.
+     *
+     */
+    timestampUnit?: "iso" | "s" | "ms" | "us";
+    /**
+     * * `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).
+     *
+     */
+    status: "ready" | "failed" | "pending";
+    /**
+     * Size of `currentVersionId`'s own stored file. Present only when `status` is `ready` —
+     * see `DatasetVersion.bytes` for what it measures exactly.
+     *
+     */
+    bytes?: number;
+    /**
+     * `currentVersionId`'s own row count. Present only when `status` is `ready`.
+     */
+    rows?: number;
+    /**
+     * `currentVersionId`'s own gap count at its discovered cadence. Present only when `status` is `ready`.
+     */
+    gaps?: number;
+    /**
+     * `currentVersionId`'s own largest gap, in units of its discovered cadence step. Present only when `status` is `ready`.
+     */
+    largestGapSteps?: number;
+    /**
+     * A human-readable reason the most recent upload/import attempt failed. Present only
+     * when `status` is `failed`.
+     *
+     */
+    error?: string;
 };
 /**
  * A `Dataset` plus a self link. Returned by `GET /datasets/{datasetId}`.
@@ -1188,8 +1331,9 @@ type DatasetWithLinks = Dataset & {
     /**
      * 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. `parquet` for a parquet
-     * upload, stored as-is today.
+     * 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.
      *
      */
     dataFormat?: "lastra" | "parquet";
@@ -1306,8 +1450,9 @@ type DatasetVersion = {
     /**
      * 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. `parquet` for a parquet upload, stored
-     * as-is today.
+     * 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.
      *
      */
     dataFormat?: "lastra" | "parquet";
@@ -1542,6 +1687,32 @@ type AuthenticateResponses = {
     200: AuthTokenResponse;
 };
 type AuthenticateResponse = AuthenticateResponses[keyof AuthenticateResponses];
+type GetAccountData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: "/account";
+};
+type GetAccountResponses = {
+    /**
+     * Your account
+     */
+    200: Account;
+};
+type GetAccountResponse = GetAccountResponses[keyof GetAccountResponses];
+type GetAccountUsageData = {
+    body?: never;
+    path?: never;
+    query?: never;
+    url: "/account/usage";
+};
+type GetAccountUsageResponses = {
+    /**
+     * Your current usage
+     */
+    200: AccountUsage;
+};
+type GetAccountUsageResponse = GetAccountUsageResponses[keyof GetAccountUsageResponses];
 type ListExchangesData = {
     body?: never;
     path?: never;
@@ -2504,6 +2675,12 @@ type FinalizeDatasetUploadErrors = {
      * The uploaded file exceeds your tier's size limit for a dataset.
      */
     413: ResponseError;
+    /**
+     * Your account's total storage limit (`GET /account`'s `maxTotalStorageBytes`) is
+     * reached or would be exceeded. Delete a dataset to free space, or upgrade.
+     *
+     */
+    429: ResponseError;
 };
 type FinalizeDatasetUploadError = FinalizeDatasetUploadErrors[keyof FinalizeDatasetUploadErrors];
 type FinalizeDatasetUploadResponses = {
@@ -2573,7 +2750,10 @@ type ImportDatasetErrors = {
      */
     409: ResponseError;
     /**
-     * Your tier's dataset count limit is reached. Delete one, or upgrade.
+     * Your tier's dataset count limit is reached, or your account's total storage limit
+     * (`GET /account`'s `maxTotalStorageBytes`) is already reached. Delete a dataset to free
+     * a slot or space, or upgrade.
+     *
      */
     429: ResponseError;
 };
@@ -2645,6 +2825,24 @@ type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean
  *
  */
 declare const authenticate: <ThrowOnError extends boolean = false>(options?: Options<AuthenticateData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AuthTokenResponse, unknown, ThrowOnError>;
+/**
+ * Get your account's identity and tier limits
+ * Your userId, current tier, and that tier's limits — no database call, safe to fetch on
+ * every page load. For live usage against these limits, see `_links.usage`
+ * (`GET /account/usage`).
+ *
+ */
+declare const getAccount: <ThrowOnError extends boolean = false>(options?: Options<GetAccountData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<Account, unknown, ThrowOnError>;
+/**
+ * Get your live storage usage
+ * How much of your account's shared storage pool (`GET /account`'s `maxTotalStorageBytes`)
+ * you're currently using. Datasets, strategy-execution signals, and registered strategies
+ * all count against the same total — they compete for the same underlying storage, so
+ * there's one number to watch, not one per resource type. Not guaranteed real-time — a
+ * just-completed upload or strategy execution may take a short moment to be reflected here.
+ *
+ */
+declare const getAccountUsage: <ThrowOnError extends boolean = false>(options?: Options<GetAccountUsageData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<AccountUsage, unknown, ThrowOnError>;
 /**
  * List the available exchanges
  */
@@ -3029,16 +3227,21 @@ declare const listDatasets: <ThrowOnError extends boolean = false>(options?: Opt
  * response. `instrument` must be a plain spot pair (`BASE/QUOTE`, exactly one `/`); derivative
  * forms (e.g. `BTC/USDT:USDT`) are rejected.
  *
- * **Upload format.** A CSV with a header row, or a parquet file with the same columns by
- * name. Required: `timestamp` (ISO-8601, or numeric epoch seconds/millis/micros — detected
- * from the first row, then enforced for every later row), `close`. Optional: `open`, `high`,
- * `low`, `volume`, `quoteVolume`, `bid`, `bidSize`, `ask`, `askSize`. Cadence and timestamp
- * unit are discovered from the data, not declared.
+ * **Upload format.** A CSV with a header row, a parquet file with the same columns by
+ * name, or a lastra file — our own native columnar format, the same one a dataset's
+ * `dataUrl` hands back by default, so a downloaded dataset can be handed to another user to
+ * upload with no conversion in between. For CSV/parquet, required: `timestamp` (ISO-8601, or
+ * numeric epoch seconds/millis/micros — detected from the first row, then enforced for every
+ * later row), `close`. Optional: `open`, `high`, `low`, `volume`, `quoteVolume`, `bid`,
+ * `bidSize`, `ask`, `askSize`. A lastra upload carries its own fixed column set instead and
+ * only needs a timestamp series and a close series present. Cadence and timestamp unit are
+ * discovered from the data, not declared, for all three.
  *
  * A CSV upload is converted to our native columnar format (`lastra`) for storage. A parquet
- * upload is stored as-is today. Either way, always check `dataFormat` on
+ * or lastra upload is stored as-is today. Either way, always check `dataFormat` on
  * `GET /datasets/{datasetId}` and `GET /datasets/{datasetId}/uploads/{uploadId}` for which
- * one `dataUrl` actually is, rather than assuming from how you uploaded it.
+ * one `dataUrl` actually is, rather than assuming from how you uploaded it (a converted CSV
+ * and an uploaded lastra file both report `dataFormat: "lastra"`).
  *
  * The bytes PUT to `upload.url` may be that file directly, gzipped (`.gz`), or zipped
  * (`.zip`, exactly one file inside — a dataset is one file regardless of how it travels).
@@ -3137,4 +3340,4 @@ declare const getDatasetImport: <ThrowOnError extends boolean = false>(options:
 
 declare const client: _hey_api_client_fetch.Client;
 
-export { type AcceptedJob, type AuthTokenError, type AuthTokenResponse, type AuthenticateData, type AuthenticateError, type AuthenticateErrors, type AuthenticateResponse, type AuthenticateResponses, type BacktestJobResult, type CancelBacktestData, type CancelBacktestError, type CancelBacktestErrors, type CancelBacktestResponse, type CancelBacktestResponses, type CancelSweepData, type CancelSweepError, type CancelSweepErrors, type CancelSweepResponse, type CancelSweepResponses, type ClientOptions, type CompileStrategyData, type CompileStrategyError, type CompileStrategyErrors, type CompileStrategyResponse, type CompileStrategyResponses, type CoverageWindow, type CreateDatasetData, type CreateDatasetError, type CreateDatasetErrors, type CreateDatasetResponse, type CreateDatasetResponses, type DataSourceType, type Dataset, type DatasetCreated, type DatasetImportCreated, type DatasetImportDexRequest, type DatasetImportRequest, type DatasetImportState, type DatasetUploadSession, type DatasetUploadState, type DatasetUploadTarget, type DatasetVersion, type DatasetWithLinks, type DeclaredProperty, type DeleteDatasetData, type DeleteDatasetError, type DeleteDatasetErrors, type DeleteDatasetResponse, type DeleteDatasetResponses, type DeleteStrategyData, type DeleteStrategyError, type DeleteStrategyErrors, type DeleteStrategyResponse, type DeleteStrategyResponses, type DownloadKlinesData, type DownloadKlinesError, type DownloadKlinesErrors, type DownloadKlinesResponse, type DownloadKlinesResponses, type DownloadTickersData, type DownloadTickersError, type DownloadTickersErrors, type DownloadTickersResponse, type DownloadTickersResponses, type EquityCurveMeta, type EquityCurveOptions, type EquityCurveOutMode, type EquityCurveRequest, type EquityCurveResult, type EquityPoint, type Exchange, type ExecuteBacktestData, type ExecuteBacktestError, type ExecuteBacktestErrors, type ExecuteBacktestResponse, type ExecuteBacktestResponses, type ExecuteSweepAccepted, type ExecuteSweepData, type ExecuteSweepError, type ExecuteSweepErrors, type ExecuteSweepRequest, type ExecuteSweepResponse, type ExecuteSweepResponses, type ExecuteSweepResult, type FinalizeDatasetUploadData, type FinalizeDatasetUploadError, type FinalizeDatasetUploadErrors, type FinalizeDatasetUploadResponse, type FinalizeDatasetUploadResponses, type GetBacktestResultData, type GetBacktestResultError, type GetBacktestResultErrors, type GetBacktestResultResponse, type GetBacktestResultResponses, type GetDatasetData, type GetDatasetError, type GetDatasetErrors, type GetDatasetImportData, type GetDatasetImportError, type GetDatasetImportErrors, type GetDatasetImportResponse, type GetDatasetImportResponses, type GetDatasetResponse, type GetDatasetResponses, type GetDatasetUploadData, type GetDatasetUploadError, type GetDatasetUploadErrors, type GetDatasetUploadResponse, type GetDatasetUploadResponses, type GetPrepareStatusData, type GetPrepareStatusError, type GetPrepareStatusErrors, type GetPrepareStatusResponse, type GetPrepareStatusResponses, type GetStrategyCodeData, type GetStrategyCodeError, type GetStrategyCodeErrors, type GetStrategyCodeResponse, type GetStrategyCodeResponses, type GetStrategyData, type GetStrategyError, type GetStrategyErrors, type GetStrategyResponse, type GetStrategyResponses, type GetSweepResultData, type GetSweepResultError, type GetSweepResultErrors, type GetSweepResultResponse, type GetSweepResultResponses, type GetSweepRunEquityCurveData, type GetSweepRunEquityCurveError, type GetSweepRunEquityCurveErrors, type GetSweepRunEquityCurveResponse, type GetSweepRunEquityCurveResponses, type GetSweepSensitivityData, type GetSweepSensitivityError, type GetSweepSensitivityErrors, type GetSweepSensitivityResponse, type GetSweepSensitivityResponses, type HalLink, type ImportDatasetData, type ImportDatasetError, type ImportDatasetErrors, type ImportDatasetResponse, type ImportDatasetResponses, type Instrument, type InstrumentCoverage, type InstrumentDetail, type InstrumentLinks, type InstrumentListMeta, type InstrumentListResponse, type JobState, type ListDatasetsData, type ListDatasetsResponse, type ListDatasetsResponses, type ListExchangesData, type ListExchangesResponse, type ListExchangesResponses, type ListInstrumentsData, type ListInstrumentsError, type ListInstrumentsErrors, type ListInstrumentsResponse, type ListInstrumentsResponses, type ListSegmentInstrumentsData, type ListSegmentInstrumentsError, type ListSegmentInstrumentsErrors, type ListSegmentInstrumentsResponse, type ListSegmentInstrumentsResponses, type ListStrategiesData, type ListStrategiesResponse, type ListStrategiesResponses, type Notice, type OpenDatasetUploadData, type OpenDatasetUploadError, type OpenDatasetUploadErrors, type OpenDatasetUploadResponse, type OpenDatasetUploadResponses, type Options, type PrepareBacktestData, type PrepareBacktestError, type PrepareBacktestErrors, type PrepareBacktestResponse, type PrepareBacktestResponses, type PrepareJobState, type PrepareRequest, type ResponseError, type ResultMap, type ScalarStrategyParamValue, type StrategyId, type StrategyLinks, type StrategyState, type StrategySummary, type SweepAxis, type SweepBaseConfig, type SweepHeatmap, type SweepHeatmapCell, type SweepMarginal, type SweepMarginalPoint, type SweepProgress, type SweepRunRow, type SweepSensitivity, type SweepSpecRequest, type ValidateStrategyData, type ValidateStrategyError, type ValidateStrategyErrors, type ValidateStrategyResponse, type ValidateStrategyResponses, type WalkForwardAccepted, type WalkForwardFold, type WalkForwardRequest, type WalkForwardResult, authenticate, cancelBacktest, cancelSweep, client, compileStrategy, createDataset, deleteDataset, deleteStrategy, downloadKlines, downloadTickers, executeBacktest, executeSweep, finalizeDatasetUpload, getBacktestResult, getDataset, getDatasetImport, getDatasetUpload, getPrepareStatus, getStrategy, getStrategyCode, getSweepResult, getSweepRunEquityCurve, getSweepSensitivity, importDataset, listDatasets, listExchanges, listInstruments, listSegmentInstruments, listStrategies, openDatasetUpload, prepareBacktest, validateStrategy };
+export { type AcceptedJob, type Account, type AccountLinks, type AccountUsage, type AccountUsageLinks, type AuthTokenError, type AuthTokenResponse, type AuthenticateData, type AuthenticateError, type AuthenticateErrors, type AuthenticateResponse, type AuthenticateResponses, type BacktestJobResult, type CancelBacktestData, type CancelBacktestError, type CancelBacktestErrors, type CancelBacktestResponse, type CancelBacktestResponses, type CancelSweepData, type CancelSweepError, type CancelSweepErrors, type CancelSweepResponse, type CancelSweepResponses, type ClientOptions, type CompileStrategyData, type CompileStrategyError, type CompileStrategyErrors, type CompileStrategyResponse, type CompileStrategyResponses, type CoverageWindow, type CreateDatasetData, type CreateDatasetError, type CreateDatasetErrors, type CreateDatasetResponse, type CreateDatasetResponses, type DataSourceType, type Dataset, type DatasetCreated, type DatasetImportCreated, type DatasetImportDexRequest, type DatasetImportRequest, type DatasetImportState, type DatasetUploadSession, type DatasetUploadState, type DatasetUploadTarget, type DatasetVersion, type DatasetWithLinks, type DeclaredProperty, type DeleteDatasetData, type DeleteDatasetError, type DeleteDatasetErrors, type DeleteDatasetResponse, type DeleteDatasetResponses, type DeleteStrategyData, type DeleteStrategyError, type DeleteStrategyErrors, type DeleteStrategyResponse, type DeleteStrategyResponses, type DownloadKlinesData, type DownloadKlinesError, type DownloadKlinesErrors, type DownloadKlinesResponse, type DownloadKlinesResponses, type DownloadTickersData, type DownloadTickersError, type DownloadTickersErrors, type DownloadTickersResponse, type DownloadTickersResponses, type EquityCurveMeta, type EquityCurveOptions, type EquityCurveOutMode, type EquityCurveRequest, type EquityCurveResult, type EquityPoint, type Exchange, type ExecuteBacktestData, type ExecuteBacktestError, type ExecuteBacktestErrors, type ExecuteBacktestResponse, type ExecuteBacktestResponses, type ExecuteSweepAccepted, type ExecuteSweepData, type ExecuteSweepError, type ExecuteSweepErrors, type ExecuteSweepRequest, type ExecuteSweepResponse, type ExecuteSweepResponses, type ExecuteSweepResult, type FinalizeDatasetUploadData, type FinalizeDatasetUploadError, type FinalizeDatasetUploadErrors, type FinalizeDatasetUploadResponse, type FinalizeDatasetUploadResponses, type GetAccountData, type GetAccountResponse, type GetAccountResponses, type GetAccountUsageData, type GetAccountUsageResponse, type GetAccountUsageResponses, type GetBacktestResultData, type GetBacktestResultError, type GetBacktestResultErrors, type GetBacktestResultResponse, type GetBacktestResultResponses, type GetDatasetData, type GetDatasetError, type GetDatasetErrors, type GetDatasetImportData, type GetDatasetImportError, type GetDatasetImportErrors, type GetDatasetImportResponse, type GetDatasetImportResponses, type GetDatasetResponse, type GetDatasetResponses, type GetDatasetUploadData, type GetDatasetUploadError, type GetDatasetUploadErrors, type GetDatasetUploadResponse, type GetDatasetUploadResponses, type GetPrepareStatusData, type GetPrepareStatusError, type GetPrepareStatusErrors, type GetPrepareStatusResponse, type GetPrepareStatusResponses, type GetStrategyCodeData, type GetStrategyCodeError, type GetStrategyCodeErrors, type GetStrategyCodeResponse, type GetStrategyCodeResponses, type GetStrategyData, type GetStrategyError, type GetStrategyErrors, type GetStrategyResponse, type GetStrategyResponses, type GetSweepResultData, type GetSweepResultError, type GetSweepResultErrors, type GetSweepResultResponse, type GetSweepResultResponses, type GetSweepRunEquityCurveData, type GetSweepRunEquityCurveError, type GetSweepRunEquityCurveErrors, type GetSweepRunEquityCurveResponse, type GetSweepRunEquityCurveResponses, type GetSweepSensitivityData, type GetSweepSensitivityError, type GetSweepSensitivityErrors, type GetSweepSensitivityResponse, type GetSweepSensitivityResponses, type HalLink, type ImportDatasetData, type ImportDatasetError, type ImportDatasetErrors, type ImportDatasetResponse, type ImportDatasetResponses, type Instrument, type InstrumentCoverage, type InstrumentDetail, type InstrumentLinks, type InstrumentListMeta, type InstrumentListResponse, type JobState, type ListDatasetsData, type ListDatasetsResponse, type ListDatasetsResponses, type ListExchangesData, type ListExchangesResponse, type ListExchangesResponses, type ListInstrumentsData, type ListInstrumentsError, type ListInstrumentsErrors, type ListInstrumentsResponse, type ListInstrumentsResponses, type ListSegmentInstrumentsData, type ListSegmentInstrumentsError, type ListSegmentInstrumentsErrors, type ListSegmentInstrumentsResponse, type ListSegmentInstrumentsResponses, type ListStrategiesData, type ListStrategiesResponse, type ListStrategiesResponses, type Notice, type OpenDatasetUploadData, type OpenDatasetUploadError, type OpenDatasetUploadErrors, type OpenDatasetUploadResponse, type OpenDatasetUploadResponses, type Options, type PrepareBacktestData, type PrepareBacktestError, type PrepareBacktestErrors, type PrepareBacktestResponse, type PrepareBacktestResponses, type PrepareJobState, type PrepareRequest, type ResponseError, type ResultMap, type ScalarStrategyParamValue, type StrategyId, type StrategyLinks, type StrategyState, type StrategySummary, type SweepAxis, type SweepBaseConfig, type SweepHeatmap, type SweepHeatmapCell, type SweepMarginal, type SweepMarginalPoint, type SweepProgress, type SweepRunRow, type SweepSensitivity, type SweepSpecRequest, type ValidateStrategyData, type ValidateStrategyError, type ValidateStrategyErrors, type ValidateStrategyResponse, type ValidateStrategyResponses, type WalkForwardAccepted, type WalkForwardFold, type WalkForwardRequest, type WalkForwardResult, authenticate, cancelBacktest, cancelSweep, client, compileStrategy, createDataset, deleteDataset, deleteStrategy, downloadKlines, downloadTickers, executeBacktest, executeSweep, finalizeDatasetUpload, getAccount, getAccountUsage, getBacktestResult, getDataset, getDatasetImport, getDatasetUpload, getPrepareStatus, getStrategy, getStrategyCode, getSweepResult, getSweepRunEquityCurve, getSweepSensitivity, importDataset, listDatasets, listExchanges, listInstruments, listSegmentInstruments, listStrategies, openDatasetUpload, prepareBacktest, validateStrategy };

package/dist/index.js

@@ -22,6 +22,30 @@ var authenticate = (options) => {
     ...options
   });
 };
+var getAccount = (options) => {
+  return (options?.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/account",
+    ...options
+  });
+};
+var getAccountUsage = (options) => {
+  return (options?.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/account/usage",
+    ...options
+  });
+};
 var listExchanges = (options) => {
   return (options?.client ?? client).get({
     url: "/exchanges",
@@ -391,6 +415,8 @@ export {
   executeBacktest,
   executeSweep,
   finalizeDatasetUpload,
+  getAccount,
+  getAccountUsage,
   getBacktestResult,
   getDataset,
   getDatasetImport,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/generated/client.gen.ts","../src/generated/sdk.gen.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { ClientOptions } from \"./types.gen\";\nimport {\n  type Config,\n  type ClientOptions as DefaultClientOptions,\n  createClient,\n  createConfig,\n} from \"@hey-api/client-fetch\";\n\n/**\n * The `createClientConfig()` function will be called on client initialization\n * and the returned object will become the client's initial configuration.\n *\n * You may want to initialize your client this way instead of calling\n * `setConfig()`. This is useful for example if you're using Next.js\n * to ensure your client always has the correct values.\n */\nexport type CreateClientConfig<T extends DefaultClientOptions = ClientOptions> =\n  (\n    override?: Config<DefaultClientOptions & T>\n  ) => Config<Required<DefaultClientOptions> & T>;\n\nexport const client = createClient(\n  createConfig<ClientOptions>({\n    baseUrl: \"https://api.qtsurfer.net/v1\",\n  })\n);\n","// This file is auto-generated by @hey-api/openapi-ts\n\nimport type {\n  Options as ClientOptions,\n  TDataShape,\n  Client,\n} from \"@hey-api/client-fetch\";\nimport type {\n  AuthenticateData,\n  AuthenticateResponse,\n  AuthenticateError,\n  ListExchangesData,\n  ListExchangesResponse,\n  ListInstrumentsData,\n  ListInstrumentsResponse,\n  ListInstrumentsError,\n  ListSegmentInstrumentsData,\n  ListSegmentInstrumentsResponse,\n  ListSegmentInstrumentsError,\n  DownloadTickersData,\n  DownloadTickersResponse,\n  DownloadTickersError,\n  DownloadKlinesData,\n  DownloadKlinesResponse,\n  DownloadKlinesError,\n  ListStrategiesData,\n  ListStrategiesResponse,\n  CompileStrategyData,\n  CompileStrategyResponse,\n  CompileStrategyError,\n  ValidateStrategyData,\n  ValidateStrategyResponse,\n  ValidateStrategyError,\n  DeleteStrategyData,\n  DeleteStrategyResponse,\n  DeleteStrategyError,\n  GetStrategyData,\n  GetStrategyResponse,\n  GetStrategyError,\n  GetStrategyCodeData,\n  GetStrategyCodeResponse,\n  GetStrategyCodeError,\n  PrepareBacktestData,\n  PrepareBacktestResponse,\n  PrepareBacktestError,\n  GetPrepareStatusData,\n  GetPrepareStatusResponse,\n  GetPrepareStatusError,\n  ExecuteSweepData,\n  ExecuteSweepResponse,\n  ExecuteSweepError,\n  CancelSweepData,\n  CancelSweepResponse,\n  CancelSweepError,\n  GetSweepResultData,\n  GetSweepResultResponse,\n  GetSweepResultError,\n  GetSweepSensitivityData,\n  GetSweepSensitivityResponse,\n  GetSweepSensitivityError,\n  GetSweepRunEquityCurveData,\n  GetSweepRunEquityCurveResponse,\n  GetSweepRunEquityCurveError,\n  ExecuteBacktestData,\n  ExecuteBacktestResponse,\n  ExecuteBacktestError,\n  CancelBacktestData,\n  CancelBacktestResponse,\n  CancelBacktestError,\n  GetBacktestResultData,\n  GetBacktestResultResponse,\n  GetBacktestResultError,\n  ListDatasetsData,\n  ListDatasetsResponse,\n  CreateDatasetData,\n  CreateDatasetResponse,\n  CreateDatasetError,\n  DeleteDatasetData,\n  DeleteDatasetResponse,\n  DeleteDatasetError,\n  GetDatasetData,\n  GetDatasetResponse,\n  GetDatasetError,\n  OpenDatasetUploadData,\n  OpenDatasetUploadResponse,\n  OpenDatasetUploadError,\n  FinalizeDatasetUploadData,\n  FinalizeDatasetUploadResponse,\n  FinalizeDatasetUploadError,\n  GetDatasetUploadData,\n  GetDatasetUploadResponse,\n  GetDatasetUploadError,\n  ImportDatasetData,\n  ImportDatasetResponse,\n  ImportDatasetError,\n  GetDatasetImportData,\n  GetDatasetImportResponse,\n  GetDatasetImportError,\n} from \"./types.gen\";\nimport { client as _heyApiClient } from \"./client.gen\";\n\nexport type Options<\n  TData extends TDataShape = TDataShape,\n  ThrowOnError extends boolean = boolean\n> = ClientOptions<TData, ThrowOnError> & {\n  /**\n   * You can provide a client instance returned by `createClient()` instead of\n   * individual options. This might be also useful if you want to implement a\n   * custom client.\n   */\n  client?: Client;\n  /**\n   * You can pass arbitrary values through the `meta` object. This can be\n   * used to access values that aren't defined as part of the SDK function.\n   */\n  meta?: Record<string, unknown>;\n};\n\n/**\n * Exchange API key for a short-lived JWT\n * Exchanges a long-lived API key for a short-lived JWT used by every other\n * endpoint. This is the only endpoint that accepts an API key directly —\n * callers should obtain a JWT here, then send it as `Authorization: Bearer\n * <token>` to all other operations.\n *\n * The returned JWT carries the caller's subscription `tier` as a claim and\n * expires after `expires_in` seconds. Callers should refresh the token\n * before expiry (or on a `401` response) by calling this endpoint again.\n *\n */\nexport const authenticate = <ThrowOnError extends boolean = false>(\n  options?: Options<AuthenticateData, ThrowOnError>\n) => {\n  return (options?.client ?? _heyApiClient).post<\n    AuthenticateResponse,\n    AuthenticateError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        name: \"X-API-Key\",\n        type: \"apiKey\",\n      },\n    ],\n    url: \"/auth/token\",\n    ...options,\n  });\n};\n\n/**\n * List the available exchanges\n */\nexport const listExchanges = <ThrowOnError extends boolean = false>(\n  options?: Options<ListExchangesData, ThrowOnError>\n) => {\n  return (options?.client ?? _heyApiClient).get<\n    ListExchangesResponse,\n    unknown,\n    ThrowOnError\n  >({\n    url: \"/exchanges\",\n    ...options,\n  });\n};\n\n/**\n * List an exchange's instruments (default spot segment)\n * \"Give me binance instruments\" — returns the exchange's DEFAULT segment (`spot`)\n * in `data`, each instrument with per-data-type coverage and market info. `meta`\n * confirms the served `segment` (`spot`); HAL `_links` carry `self` plus the\n * `spot` / `futures` segment-discovery links.\n *\n */\nexport const listInstruments = <ThrowOnError extends boolean = false>(\n  options: Options<ListInstrumentsData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    ListInstrumentsResponse,\n    ListInstrumentsError,\n    ThrowOnError\n  >({\n    url: \"/exchange/{exchangeId}/instruments\",\n    ...options,\n  });\n};\n\n/**\n * List an exchange segment's instruments\n * Returns the instruments for one market segment of the exchange, each with\n * per-data-type coverage and market info. HAL `_links` carry `self` plus the\n * `spot` / `futures` segment-discovery links; the default-segment shortcut is\n * `GET /exchange/{exchangeId}/instruments` (spot).\n *\n */\nexport const listSegmentInstruments = <ThrowOnError extends boolean = false>(\n  options: Options<ListSegmentInstrumentsData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    ListSegmentInstrumentsResponse,\n    ListSegmentInstrumentsError,\n    ThrowOnError\n  >({\n    url: \"/exchange/{exchangeId}/{segment}/instruments\",\n    ...options,\n  });\n};\n\n/**\n * Download one hour of tickers for an instrument as a Lastra segment\n * Serves exactly one hour of raw ticker data for the given instrument on the\n * requested exchange. The payload is a native [Lastra](https://github.com/QTSurfer/lastra-java)\n * file — QTSurfer's columnar format for tick-precision timeseries — with\n * no JSON envelope.\n *\n * One segment = one hour, aligned to UTC. The `hour` query parameter selects\n * the segment and must match `YYYY-MM-DDTHH` (no minutes/seconds, no timezone\n * suffix). Example: `hour=2026-01-15T10` returns `h10.lastra` for\n * 2026-01-15, covering `[10:00:00Z, 11:00:00Z)`. Hours not yet available\n * return `404`.\n *\n * A `format=parquet` query parameter switches the response to on-the-fly\n * Parquet conversion via [lastra-convert](https://github.com/QTSurfer/lastra-convert)\n * for clients that don't yet read Lastra. Lastra is the primary format\n * and cheaper when the client can consume it.\n *\n * Clients:\n * - [lastra-java](https://github.com/QTSurfer/lastra-java) — reference\n * Java reader/writer with per-column codecs (ALP, Gorilla, delta-varint,\n * ZSTD) and CRC32 integrity.\n * - [lastra-ts](https://github.com/QTSurfer/lastra-ts) — TypeScript reader\n * (~4 kB bundle, browser + Node.js).\n * - [duckdb-lastra](https://github.com/QTSurfer/duckdb-lastra) — DuckDB\n * extension for ad-hoc SQL over Lastra files.\n * - [lastra-convert](https://github.com/QTSurfer/lastra-convert) — CLI + Java\n * API for converting to/from Parquet, Reef, and CSV.\n * - `curl -OJ` for offline dumps (the `Content-Disposition` header sets a\n * descriptive filename).\n *\n */\nexport const downloadTickers = <ThrowOnError extends boolean = false>(\n  options: Options<DownloadTickersData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    DownloadTickersResponse,\n    DownloadTickersError,\n    ThrowOnError\n  >({\n    url: \"/exchange/{exchangeId}/tickers/{base}/{quote}\",\n    ...options,\n  });\n};\n\n/**\n * Download one hour of klines for an instrument as a Lastra segment\n * Same shape and semantics as `/exchange/{exchangeId}/tickers/{base}/{quote}`,\n * but serves klines (aggregated bars) instead of raw ticks. One\n * [Lastra](https://github.com/QTSurfer/lastra-java) segment = one hour of\n * klines at the exchange's native kline cadence, aligned to UTC.\n *\n * Klines use the same columnar layout as tickers — readers that handle one\n * format read the other with the same code. Use this endpoint when a\n * per-tick payload would be too large for the window of interest.\n *\n */\nexport const downloadKlines = <ThrowOnError extends boolean = false>(\n  options: Options<DownloadKlinesData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    DownloadKlinesResponse,\n    DownloadKlinesError,\n    ThrowOnError\n  >({\n    url: \"/exchange/{exchangeId}/klines/{base}/{quote}\",\n    ...options,\n  });\n};\n\n/**\n * List your registered strategies\n * Every strategy you have registered and not deleted, most recently compiled first.\n *\n * Each entry carries the same provenance `GET /strategy/{strategyId}` does — `compiledAt`,\n * `requiredSources` — but not its validation state, so listing stays cheap regardless of how\n * many strategies you have. Check a specific strategy's validation with `GET\n * /strategy/{strategyId}`.\n *\n */\nexport const listStrategies = <ThrowOnError extends boolean = false>(\n  options?: Options<ListStrategiesData, ThrowOnError>\n) => {\n  return (options?.client ?? _heyApiClient).get<\n    ListStrategiesResponse,\n    unknown,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategies\",\n    ...options,\n  });\n};\n\n/**\n * Compile and register a strategy\n * Compiles raw strategy source and registers it, returning its `strategyId`.\n *\n * **This answers one question: is the source valid Java.** It compiles, registers, and hands\n * back the id — nothing more. Whether the class can actually run is\n * `POST /strategy/{strategyId}/validate`, and everything known about a strategy, validation\n * included, is read from `GET /strategy/{strategyId}`. One place to ask, so there is no second\n * answer to keep in step.\n *\n * The `strategyId` is derived from what the code *means*, not from how it is written. Adding a\n * comment, inserting a blank line, re-indenting, reordering imports, or moving a method around\n * all return the **same** id — you have not created a second strategy. Renaming a variable,\n * changing an identifier's case, reordering fields, or reordering statements inside a method\n * return a **different** one.\n *\n * Two rules follow, and they are worth designing around:\n *\n * - re-submitting a strategy you have only reformatted is free, and gives you back the id you\n * already had, along with any validation already recorded against it;\n * - the id says nothing about *behaviour*. Two sources that compute the same thing by\n * different means are two strategies, because deciding otherwise would mean deciding program\n * equivalence.\n *\n * The response also lists `declaredProperties` — the sweep/execute param keys this strategy\n * is known to accept, so a caller can catch a typo'd key before submitting a sweep instead of\n * only learning it from a rejected one. See `DeclaredProperty`: best-effort, not exhaustive.\n *\n */\nexport const compileStrategy = <ThrowOnError extends boolean = false>(\n  options: Options<CompileStrategyData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    CompileStrategyResponse,\n    CompileStrategyError,\n    ThrowOnError\n  >({\n    bodySerializer: null,\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategy\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"text/plain\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Check that a registered strategy can actually run\n * Instantiates the compiled class and drives it through a bounded synthetic series, so a wiring\n * fault surfaces here instead of at your first backtest. The verdict — pass or fail, plus any\n * engine notices — is recorded and served from `GET /strategy/{strategyId}`.\n *\n * **Idempotent.** If a verdict already exists for the current compilation it comes straight\n * back with `200` and nothing is queued. Otherwise the check is queued and this returns `202`;\n * poll `GET /strategy/{strategyId}` until `validation` is `passed` or `failed`.\n *\n * Recompiling supersedes a verdict, which makes this callable again — the old answer described\n * bytecode that is no longer what would run.\n *\n */\nexport const validateStrategy = <ThrowOnError extends boolean = false>(\n  options: Options<ValidateStrategyData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    ValidateStrategyResponse,\n    ValidateStrategyError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategy/{strategyId}/validate\",\n    ...options,\n  });\n};\n\n/**\n * Release a registered strategy\n * Removes a strategy from `GET /strategy/{strategyId}` and `GET /strategies`. This is not\n * undone by re-submitting the same source to `POST /strategy` — that registers a new\n * strategy, with a new id.\n *\n * **Backtests you already ran against this strategy are unaffected.** Deleting it stops it\n * from counting against your account and stops you from validating or re-running it under\n * this id — it does not erase what already happened.\n *\n * Only removes a strategy you registered yourself. If you copied someone else's strategy\n * (a shared/marketplace listing), deleting your copy never affects theirs, or anyone else's.\n *\n */\nexport const deleteStrategy = <ThrowOnError extends boolean = false>(\n  options: Options<DeleteStrategyData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).delete<\n    DeleteStrategyResponse,\n    DeleteStrategyError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategy/{strategyId}\",\n    ...options,\n  });\n};\n\n/**\n * Get a strategy by id, including its validation state\n * Reports that the strategy is registered — implied by a `200` at all — and what validating it\n * found.\n *\n * A `404` means one thing: no such registered strategy for this user. It is never a stale or\n * expired answer; registration and verdict are stored durably, not cached.\n *\n */\nexport const getStrategy = <ThrowOnError extends boolean = false>(\n  options: Options<GetStrategyData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetStrategyResponse,\n    GetStrategyError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategy/{strategyId}\",\n    ...options,\n  });\n};\n\n/**\n * Get a registered strategy's source, if you still have one to read\n * The exact source you last submitted for this id — the same text `POST /strategy` derives\n * `strategyId` from, whitespace and comments included.\n *\n * **\"If available\", not \"always\".** A strategy you resolve only through a shared/marketplace\n * listing you copied by reference carries no source of its own, and reads as a `404` here the\n * same as a `strategyId` you never registered — that is the honest answer either way, since\n * from this endpoint's point of view nothing is there to return.\n *\n */\nexport const getStrategyCode = <ThrowOnError extends boolean = false>(\n  options: Options<GetStrategyCodeData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetStrategyCodeResponse,\n    GetStrategyCodeError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategy/{strategyId}/code\",\n    ...options,\n  });\n};\n\n/**\n * Prepare backtest data\n * Enqueues a prepare task over the requested date range. Returns immediately with a `jobId`;\n * poll `GET /backtest/{exchangeId}/{type}/prepare/{jobId}` for completion.\n *\n * The same params always return the same `jobId` (idempotent). Repeated calls with identical\n * params do not enqueue duplicate work — they reuse the existing job.\n *\n * **`exchangeId: user` is reserved for your own uploaded data.** Instead of a managed\n * exchange, it prepares from a dataset you created via `POST /datasets` (see the **Dataset**\n * endpoints) — send `datasetId` in place of `instrument`. See `PrepareRequest` below for the\n * two request shapes.\n *\n */\nexport const prepareBacktest = <ThrowOnError extends boolean = false>(\n  options: Options<PrepareBacktestData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    PrepareBacktestResponse,\n    PrepareBacktestError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/prepare\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Get the status of a prepare job\n * Retrieves the current state of the prepare job identified by `jobId`.\n * Poll until `status` is `Completed`, `Failed`, or `Aborted`.\n *\n * For a dataset prepare (`exchangeId: user`), coverage is reported against the dataset's own\n * cadence grid instead of hours — see `cadence`/`gaps`/`largestGapSteps` on `PrepareJobState`.\n *\n */\nexport const getPrepareStatus = <ThrowOnError extends boolean = false>(\n  options: Options<GetPrepareStatusData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetPrepareStatusResponse,\n    GetPrepareStatusError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/prepare/{jobId}\",\n    ...options,\n  });\n};\n\n/**\n * Execute a parameter sweep over prepared data\n * Runs a parameter matrix over the single immutable dataset identified by `requestId`.\n * The backend expands and executes the matrix internally; clients poll the returned\n * `sweepId` for incremental results.\n *\n * Supplying `walkForward` runs the sweep in a different mode entirely. Instead of scoring\n * every parameter vector once over the whole range, the data is split into F sequential\n * folds; each fold optimizes the full grid on its own window and then scores only its winner\n * on the window immediately after — data that winner was not chosen on. It answers a harder\n * question than a leaderboard: not \"which parameters won\", but \"does re-optimizing this\n * periodically actually work\". Omit the block and nothing changes, including the response.\n *\n * The cost is the reason it is opt-in rather than always on: F folds × N vectors, so a\n * 4-fold run over a 500-point grid is 2004 backtests where the plain sweep is 500. The\n * request is rejected when `folds × totalRuns` exceeds the server's sweep budget.\n *\n */\nexport const executeSweep = <ThrowOnError extends boolean = false>(\n  options: Options<ExecuteSweepData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    ExecuteSweepResponse,\n    ExecuteSweepError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/executeSweep/{requestId}\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Cancel a running parameter sweep\n * Requests cancellation between parameter vectors. Completed rows remain readable.\n */\nexport const cancelSweep = <ThrowOnError extends boolean = false>(\n  options: Options<CancelSweepData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).delete<\n    CancelSweepResponse,\n    CancelSweepError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}\",\n    ...options,\n  });\n};\n\n/**\n * Get sweep progress and results\n * Returns incremental sweep progress. The default `ranked` view sorts and may truncate the\n * display leaderboard. `order=natural` returns every available row, untruncated, ordered by\n * deterministic `runIx`; use that view when materialising durable trial rows.\n *\n * The `ranked` view is ordered by **plateau score** by default, not by the raw objective. A\n * plateau score is the objective of the worst run in a parameter point's immediate\n * neighbourhood, so a point scores well only if the region around it also does — the highest\n * raw score is frequently a spike that does not survive the parameters moving slightly. Pass\n * `ranking=raw` for the unadjusted objective order.\n *\n * Rows in the `ranked` view carry `plateauScore` and `neighbourCount` when plateau ranking\n * applied. Read them together: `neighbourCount: 0` means the point had no neighbours to\n * compare against, so its plateau score is unevidenced rather than confirmed. Sweeps\n * submitted before plateau ranking existed have no stored parameter grid to rebuild a\n * neighbourhood from and are always ranked raw; the response's `ranking` field says which\n * ordering was actually used.\n *\n * A sweep submitted with `walkForward` answers in a different shape, and the `walkForward`\n * field on the response is what tells the two apart — it appears as soon as the sweep is\n * accepted, before any fold has finished, so it is safe to branch on while polling. There\n * the leaderboard is one row per completed fold: that fold's winner as it scored\n * **out-of-sample**, with `runIx` carrying the fold index rather than a grid position. The\n * in-sample runs behind those winners are not retained — they are an optimization's working\n * set, and only the winner survives its fold. `ranking` is always `raw` and no plateau, DSR\n * or PBO figure is reported: the out-of-sample scores are already the honest number, and\n * layering a certification computed over F observations on top of them would overstate what\n * was measured.\n *\n */\nexport const getSweepResult = <ThrowOnError extends boolean = false>(\n  options: Options<GetSweepResultData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetSweepResultResponse,\n    GetSweepResultError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}\",\n    ...options,\n  });\n};\n\n/**\n * Get sweep sensitivity surfaces\n * How the objective moves as each parameter moves — the question a leaderboard cannot answer.\n * A leaderboard says which point won; a sweep can spend its entire budget on an axis that\n * never moved the objective at all, and showing only the top rows hides that completely.\n *\n * A **marginal** takes one axis and collapses every other one: for each value of that axis,\n * it aggregates every run that used it, whatever the rest of the parameters were. A flat\n * marginal means the axis is irrelevant over the range swept. `best`, `mean` and `worst` are\n * all reported because them disagreeing is itself the signal — a value with a high `best` and\n * a poor `mean` works only in specific company, which is an interaction between parameters\n * and would be invisible behind a single number.\n *\n * A **heatmap** does the same over a pair of axes, where that interaction becomes visible\n * directly.\n *\n * Served from the sweep's stored rows: no re-run, no engine call, and it works on a sweep\n * still in flight — the aggregates then describe the runs finished so far. Aborted runs are\n * excluded throughout, since a run that threw measured nothing and counting it as a bad\n * outcome would invent evidence against a parameter value that was never really tested.\n *\n * This is a separate endpoint rather than extra fields on the result view because the\n * two-dimensional half is quadratic in the axis count (N axes give N(N-1)/2 surfaces, each\n * the product of two axes' value counts) and is not wanted on the poll that drives progress.\n *\n */\nexport const getSweepSensitivity = <ThrowOnError extends boolean = false>(\n  options: Options<GetSweepSensitivityData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetSweepSensitivityResponse,\n    GetSweepSensitivityError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}/sensitivity\",\n    ...options,\n  });\n};\n\n/**\n * Get one sweep trial's equity curve\n * The resource a leaderboard row's `equityCurve.url` points at — only reachable when that\n * trial's curve was actually selected (`equityCurve.mode: topN` or `topPct` on the sweep\n * submission, and this trial ranked among the winners). Returns the exact same\n * `{points|timestamps+equities, meta}` shape a plain backtest's inline `equityCurve` carries.\n *\n * Query params reshape the response the same way a plain backtest's `equityCurve` options do.\n * A param genuinely absent from the query string falls back to the `equityCurve` transform\n * preference the sweep was submitted with — a param\n * present but malformed does not fall back, it degrades the same way it always has. Above a\n * server-side size threshold, the shape is forced regardless of either — `meta.outMode` in\n * the response, not the query string or the submitted default, is the source of truth for\n * what shape actually came back.\n *\n */\nexport const getSweepRunEquityCurve = <ThrowOnError extends boolean = false>(\n  options: Options<GetSweepRunEquityCurveData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetSweepRunEquityCurveResponse,\n    GetSweepRunEquityCurveError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}/runs/{runIx}/equityCurve\",\n    ...options,\n  });\n};\n\n/**\n * Execute a compiled strategy against a prepared dataset\n * Enqueues an execute task that runs the strategy identified by `strategyId` over the data\n * prepared by the prepare job identified by `prepareJobId`. The instrument and date range are\n * recovered from the prepare job — they do not need to be sent again.\n *\n * Returns immediately with a `jobId`; poll `GET /backtest/{exchangeId}/{type}/execute/{jobId}`\n * for the result.\n *\n * Optionally takes `params`: strategy properties for this one run, applied without\n * recompiling. This is how a sweep leaderboard winner gets re-run for its `equityCurve` —\n * a sweep row carries the ten ranking metrics but never a curve, whatever its size. Compile\n * once, call this endpoint N times with different `params`, and each response is an ordinary\n * backtest result with the curve included.\n *\n * The same request (same `prepareJobId`, `strategyId`, `storeSignals`, `equityCurve`,\n * `baseConfig`, `params`) always returns the same `jobId` (idempotent) — a request that omits\n * `equityCurve`, `baseConfig` or `params` dedupes exactly as it did before those fields\n * existed. Two different `params` vectors over one prepare are two different jobs, and `9`\n * and `9.0` are the same one.\n *\n * The re-run is an independent execution rather than a replay of the sweep trial — the two\n * paths do not share a simulator — but they are pinned to agree: one vector run both ways\n * matches on every leaderboard metric, asserted as a regression test. Treat a difference as a\n * bug worth reporting, not as expected behaviour.\n *\n * Optionally takes `baseConfig`, the same `SweepBaseConfig` shape `executeSweep` accepts —\n * `initialFunding`, `feeRate`, `percentAmountToLock`, etc. — so the same object can be reused\n * against either endpoint. This endpoint has one effective fee rate rather than a sweep's\n * independent buy/sell legs: a `baseConfig` that resolves to different buy/sell rates, or sets\n * a non-default `feeLeg`, is rejected with `400` rather than silently collapsed to one side.\n *\n * Works unchanged for a dataset-backed prepare (`exchangeId: user`) — the request body is\n * identical either way, since the instrument and range are recovered from `prepareJobId`.\n *\n */\nexport const executeBacktest = <ThrowOnError extends boolean = false>(\n  options: Options<ExecuteBacktestData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    ExecuteBacktestResponse,\n    ExecuteBacktestError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/execute\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Cancel a running backtest execution\n * Requests cancellation of the specified execution. The execution\n * status will transition to `Aborted` once the cancellation is\n * processed. Cancellation is asynchronous — poll the GET endpoint\n * to confirm the final status.\n *\n */\nexport const cancelBacktest = <ThrowOnError extends boolean = false>(\n  options: Options<CancelBacktestData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).delete<\n    CancelBacktestResponse,\n    CancelBacktestError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/execute/{jobId}\",\n    ...options,\n  });\n};\n\n/**\n * Get the result of a backtest execution job\n * Retrieves the current state and results of the execute job identified by `jobId`.\n * Poll until `state.status` is `Completed`, `Failed`, or `Aborted`.\n *\n * A `202` means the result is not readable yet — keep polling. It is never a terminal\n * outcome, and it carries no `state`, so a poll loop that stops on a terminal status will\n * not stop on it.\n *\n */\nexport const getBacktestResult = <ThrowOnError extends boolean = false>(\n  options: Options<GetBacktestResultData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetBacktestResultResponse,\n    GetBacktestResultError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/execute/{jobId}\",\n    ...options,\n  });\n};\n\n/**\n * List your datasets\n * Every dataset you have created and not deleted, most recently created first. Never a `404`\n * — an empty array if you have none, same convention as `GET /strategies`.\n *\n */\nexport const listDatasets = <ThrowOnError extends boolean = false>(\n  options?: Options<ListDatasetsData, ThrowOnError>\n) => {\n  return (options?.client ?? _heyApiClient).get<\n    ListDatasetsResponse,\n    unknown,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets\",\n    ...options,\n  });\n};\n\n/**\n * Create a dataset and get a URL to upload it to\n * Creates a dataset AND its first upload session in one call — a presigned URL your client\n * PUTs the file to directly, no API credentials involved in that PUT. Call\n * `POST /datasets/{datasetId}/uploads/{uploadId}/finalize` once the upload completes to kick\n * off ingest.\n *\n * Losing this response loses nothing: calling this dataset's\n * `POST /datasets/{datasetId}/uploads` returns the very same upload session again rather than\n * opening a new one, as long as nothing has been finalized against it yet.\n *\n * v1 is ticker data only — `type` is not a request field, it is always `\"ticker\"` in the\n * response. `instrument` must be a plain spot pair (`BASE/QUOTE`, exactly one `/`); derivative\n * forms (e.g. `BTC/USDT:USDT`) are rejected.\n *\n * **Upload format.** A CSV with a header row, or a parquet file with the same columns by\n * name. Required: `timestamp` (ISO-8601, or numeric epoch seconds/millis/micros — detected\n * from the first row, then enforced for every later row), `close`. Optional: `open`, `high`,\n * `low`, `volume`, `quoteVolume`, `bid`, `bidSize`, `ask`, `askSize`. Cadence and timestamp\n * unit are discovered from the data, not declared.\n *\n * A CSV upload is converted to our native columnar format (`lastra`) for storage. A parquet\n * upload is stored as-is today. Either way, always check `dataFormat` on\n * `GET /datasets/{datasetId}` and `GET /datasets/{datasetId}/uploads/{uploadId}` for which\n * one `dataUrl` actually is, rather than assuming from how you uploaded it.\n *\n * The bytes PUT to `upload.url` may be that file directly, gzipped (`.gz`), or zipped\n * (`.zip`, exactly one file inside — a dataset is one file regardless of how it travels).\n * Format is detected from the decompressed content itself: there is no filename or\n * `Content-Type` anywhere in this flow for a client to declare it with, so nothing needs to\n * be sent besides the bytes.\n *\n */\nexport const createDataset = <ThrowOnError extends boolean = false>(\n  options: Options<CreateDatasetData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    CreateDatasetResponse,\n    CreateDatasetError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Delete a dataset\n * Soft-delete — the dataset stops appearing in `GET /datasets`/`GET /datasets/{datasetId}` and\n * can no longer be prepared from, but its object data is reclaimed later rather than purged\n * inline, so a backtest already running against one of its versions is not disrupted.\n *\n */\nexport const deleteDataset = <ThrowOnError extends boolean = false>(\n  options: Options<DeleteDatasetData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).delete<\n    DeleteDatasetResponse,\n    DeleteDatasetError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}\",\n    ...options,\n  });\n};\n\n/**\n * Get a dataset by id\n * Detail for one dataset, plus a self link.\n */\nexport const getDataset = <ThrowOnError extends boolean = false>(\n  options: Options<GetDatasetData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetDatasetResponse,\n    GetDatasetError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}\",\n    ...options,\n  });\n};\n\n/**\n * Open a new upload session for an existing dataset\n * Get a fresh presigned URL to upload a new version into a dataset you already have — a\n * corrected file, or the next chunk of history. Behaves the same way `POST /datasets` does\n * for a brand-new dataset's own upload: at most one upload session is open per dataset at a\n * time, so calling this again before finalizing just hands back that same session rather\n * than opening a second one — safe to call repeatedly if a response gets lost.\n *\n * Once a session has been finalized (successfully or not), the next call here opens a\n * genuinely new one for that dataset's next version.\n *\n */\nexport const openDatasetUpload = <ThrowOnError extends boolean = false>(\n  options: Options<OpenDatasetUploadData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    OpenDatasetUploadResponse,\n    OpenDatasetUploadError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}/uploads\",\n    ...options,\n  });\n};\n\n/**\n * Finalize an uploaded file and start ingest\n * Call once the file has been PUT to the `upload.url` from `POST /datasets` (or from\n * `POST /datasets/{datasetId}/uploads`). Enqueues ingest and returns immediately; poll\n * `GET /datasets/{datasetId}/uploads/{uploadId}` for the result.\n *\n * Idempotent while the upload is still open — a repeat finalize before it has produced a\n * version returns the same `jobId` rather than enqueueing a second ingest. Once it HAS\n * produced a version, `uploadId` is spent: finalizing it again is a `409`, even with\n * different bytes freshly PUT to the same URL — open a new upload session instead\n * (`POST /datasets/{datasetId}/uploads`) rather than reusing a spent one.\n *\n */\nexport const finalizeDatasetUpload = <ThrowOnError extends boolean = false>(\n  options: Options<FinalizeDatasetUploadData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    FinalizeDatasetUploadResponse,\n    FinalizeDatasetUploadError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}/uploads/{uploadId}/finalize\",\n    ...options,\n  });\n};\n\n/**\n * Get the state of an upload/ingest\n * Poll after `POST .../finalize` until `status` is `ready` or `failed`. Also reports\n * `uploading` (finalize not called yet, but the file was PUT) before you finalize at all.\n *\n */\nexport const getDatasetUpload = <ThrowOnError extends boolean = false>(\n  options: Options<GetDatasetUploadData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetDatasetUploadResponse,\n    GetDatasetUploadError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}/uploads/{uploadId}\",\n    ...options,\n  });\n};\n\n/**\n * Create a dataset by importing history instead of uploading it\n * A second way to get data into a dataset, alongside `POST /datasets`: instead of `PUT`ting a\n * file yourself, ask the API to go fetch history on your behalf. Creates the dataset and\n * starts the fetch in the same call — there is no separate upload step, and the result lands\n * as a dataset version indistinguishable from an uploaded one once it's ready. Poll\n * `GET /datasets/{datasetId}/imports/{importId}` for progress.\n *\n * `type` selects the source. `dex` — history over a pool/pair's own on-chain market — is the\n * only value today; other source types join this same endpoint later.\n *\n * A `dex` import has two data shapes, chosen by the top-level `cadence`:\n *\n * * Omitted/blank (default) — on-chain swap history, replayed directly from the pool/pair's\n * own chain. Cadence is native, not resampled: each swap keeps the timestamp it happened\n * at rather than being bucketed into candles, so the resulting version's `cadence` is `rt`\n * unless the swaps happen to sit on a fixed grid (see `DatasetVersion.cadence`).\n * * One of `1s` / `1m` / `5m` — pre-aggregated candles at that width instead of raw trades.\n * The resulting dataset's `type` is `klines`, not `ticker`. Not every network supports every\n * cadence yet — an unsupported combination fails asynchronously, same as an unresolvable\n * pool (see the `failed` status on the poll endpoint below).\n *\n */\nexport const importDataset = <ThrowOnError extends boolean = false>(\n  options: Options<ImportDatasetData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    ImportDatasetResponse,\n    ImportDatasetError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/imports\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Get the state of an import/ingest\n * Poll after `POST /datasets/imports` until `status` is `ready` or `failed`. An import spends\n * real time fetching from its source before anything is even staged — `fetching` is the one\n * status only an import ever reports; `ingesting`/`ready`/`failed` mean exactly what they do\n * on `GET /datasets/{datasetId}/uploads/{uploadId}`, since an import re-enters that same\n * ingest chain once it has fetched and staged its data.\n *\n */\nexport const getDatasetImport = <ThrowOnError extends boolean = false>(\n  options: Options<GetDatasetImportData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetDatasetImportResponse,\n    GetDatasetImportError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}/imports/{importId}\",\n    ...options,\n  });\n};\n"],"mappings":";AAGA;AAAA,EAGE;AAAA,EACA;AAAA,OACK;AAeA,IAAM,SAAS;AAAA,EACpB,aAA4B;AAAA,IAC1B,SAAS;AAAA,EACX,CAAC;AACH;;;ACuGO,IAAM,eAAe,CAC1B,YACG;AACH,UAAQ,SAAS,UAAU,QAAe,KAIxC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAKO,IAAM,gBAAgB,CAC3B,YACG;AACH,UAAQ,SAAS,UAAU,QAAe,IAIxC;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAUO,IAAM,kBAAkB,CAC7B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAUO,IAAM,yBAAyB,CACpC,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAkCO,IAAM,kBAAkB,CAC7B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAcO,IAAM,iBAAiB,CAC5B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAYO,IAAM,iBAAiB,CAC5B,YACG;AACH,UAAQ,SAAS,UAAU,QAAe,IAIxC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AA+BO,IAAM,kBAAkB,CAC7B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,KAIvC;AAAA,IACA,gBAAgB;AAAA,IAChB,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IACd;AAAA,EACF,CAAC;AACH;AAgBO,IAAM,mBAAmB,CAC9B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,KAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAgBO,IAAM,iBAAiB,CAC5B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,OAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAWO,IAAM,cAAc,CACzB,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAaO,IAAM,kBAAkB,CAC7B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAgBO,IAAM,kBAAkB,CAC7B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,KAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IACd;AAAA,EACF,CAAC;AACH;AAWO,IAAM,mBAAmB,CAC9B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAoBO,IAAM,eAAe,CAC1B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,KAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IACd;AAAA,EACF,CAAC;AACH;AAMO,IAAM,cAAc,CACzB,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,OAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAiCO,IAAM,iBAAiB,CAC5B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AA4BO,IAAM,sBAAsB,CACjC,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAkBO,IAAM,yBAAyB,CACpC,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAsCO,IAAM,kBAAkB,CAC7B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,KAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IACd;AAAA,EACF,CAAC;AACH;AAUO,IAAM,iBAAiB,CAC5B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,OAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAYO,IAAM,oBAAoB,CAC/B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAQO,IAAM,eAAe,CAC1B,YACG;AACH,UAAQ,SAAS,UAAU,QAAe,IAIxC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAmCO,IAAM,gBAAgB,CAC3B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,KAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IACd;AAAA,EACF,CAAC;AACH;AASO,IAAM,gBAAgB,CAC3B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,OAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAMO,IAAM,aAAa,CACxB,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAcO,IAAM,oBAAoB,CAC/B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,KAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAeO,IAAM,wBAAwB,CACnC,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,KAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAQO,IAAM,mBAAmB,CAC9B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;AAyBO,IAAM,gBAAgB,CAC3B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,KAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACP,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IACd;AAAA,EACF,CAAC;AACH;AAWO,IAAM,mBAAmB,CAC9B,YACG;AACH,UAAQ,QAAQ,UAAU,QAAe,IAIvC;AAAA,IACA,UAAU;AAAA,MACR;AAAA,QACE,QAAQ;AAAA,QACR,MAAM;AAAA,MACR;AAAA,IACF;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACL,CAAC;AACH;","names":[]}
+{"version":3,"sources":["../src/generated/client.gen.ts","../src/generated/sdk.gen.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { ClientOptions } from \"./types.gen\";\nimport {\n  type Config,\n  type ClientOptions as DefaultClientOptions,\n  createClient,\n  createConfig,\n} from \"@hey-api/client-fetch\";\n\n/**\n * The `createClientConfig()` function will be called on client initialization\n * and the returned object will become the client's initial configuration.\n *\n * You may want to initialize your client this way instead of calling\n * `setConfig()`. This is useful for example if you're using Next.js\n * to ensure your client always has the correct values.\n */\nexport type CreateClientConfig<T extends DefaultClientOptions = ClientOptions> =\n  (\n    override?: Config<DefaultClientOptions & T>\n  ) => Config<Required<DefaultClientOptions> & T>;\n\nexport const client = createClient(\n  createConfig<ClientOptions>({\n    baseUrl: \"https://api.qtsurfer.net/v1\",\n  })\n);\n","// This file is auto-generated by @hey-api/openapi-ts\n\nimport type {\n  Options as ClientOptions,\n  TDataShape,\n  Client,\n} from \"@hey-api/client-fetch\";\nimport type {\n  AuthenticateData,\n  AuthenticateResponse,\n  AuthenticateError,\n  GetAccountData,\n  GetAccountResponse,\n  GetAccountUsageData,\n  GetAccountUsageResponse,\n  ListExchangesData,\n  ListExchangesResponse,\n  ListInstrumentsData,\n  ListInstrumentsResponse,\n  ListInstrumentsError,\n  ListSegmentInstrumentsData,\n  ListSegmentInstrumentsResponse,\n  ListSegmentInstrumentsError,\n  DownloadTickersData,\n  DownloadTickersResponse,\n  DownloadTickersError,\n  DownloadKlinesData,\n  DownloadKlinesResponse,\n  DownloadKlinesError,\n  ListStrategiesData,\n  ListStrategiesResponse,\n  CompileStrategyData,\n  CompileStrategyResponse,\n  CompileStrategyError,\n  ValidateStrategyData,\n  ValidateStrategyResponse,\n  ValidateStrategyError,\n  DeleteStrategyData,\n  DeleteStrategyResponse,\n  DeleteStrategyError,\n  GetStrategyData,\n  GetStrategyResponse,\n  GetStrategyError,\n  GetStrategyCodeData,\n  GetStrategyCodeResponse,\n  GetStrategyCodeError,\n  PrepareBacktestData,\n  PrepareBacktestResponse,\n  PrepareBacktestError,\n  GetPrepareStatusData,\n  GetPrepareStatusResponse,\n  GetPrepareStatusError,\n  ExecuteSweepData,\n  ExecuteSweepResponse,\n  ExecuteSweepError,\n  CancelSweepData,\n  CancelSweepResponse,\n  CancelSweepError,\n  GetSweepResultData,\n  GetSweepResultResponse,\n  GetSweepResultError,\n  GetSweepSensitivityData,\n  GetSweepSensitivityResponse,\n  GetSweepSensitivityError,\n  GetSweepRunEquityCurveData,\n  GetSweepRunEquityCurveResponse,\n  GetSweepRunEquityCurveError,\n  ExecuteBacktestData,\n  ExecuteBacktestResponse,\n  ExecuteBacktestError,\n  CancelBacktestData,\n  CancelBacktestResponse,\n  CancelBacktestError,\n  GetBacktestResultData,\n  GetBacktestResultResponse,\n  GetBacktestResultError,\n  ListDatasetsData,\n  ListDatasetsResponse,\n  CreateDatasetData,\n  CreateDatasetResponse,\n  CreateDatasetError,\n  DeleteDatasetData,\n  DeleteDatasetResponse,\n  DeleteDatasetError,\n  GetDatasetData,\n  GetDatasetResponse,\n  GetDatasetError,\n  OpenDatasetUploadData,\n  OpenDatasetUploadResponse,\n  OpenDatasetUploadError,\n  FinalizeDatasetUploadData,\n  FinalizeDatasetUploadResponse,\n  FinalizeDatasetUploadError,\n  GetDatasetUploadData,\n  GetDatasetUploadResponse,\n  GetDatasetUploadError,\n  ImportDatasetData,\n  ImportDatasetResponse,\n  ImportDatasetError,\n  GetDatasetImportData,\n  GetDatasetImportResponse,\n  GetDatasetImportError,\n} from \"./types.gen\";\nimport { client as _heyApiClient } from \"./client.gen\";\n\nexport type Options<\n  TData extends TDataShape = TDataShape,\n  ThrowOnError extends boolean = boolean\n> = ClientOptions<TData, ThrowOnError> & {\n  /**\n   * You can provide a client instance returned by `createClient()` instead of\n   * individual options. This might be also useful if you want to implement a\n   * custom client.\n   */\n  client?: Client;\n  /**\n   * You can pass arbitrary values through the `meta` object. This can be\n   * used to access values that aren't defined as part of the SDK function.\n   */\n  meta?: Record<string, unknown>;\n};\n\n/**\n * Exchange API key for a short-lived JWT\n * Exchanges a long-lived API key for a short-lived JWT used by every other\n * endpoint. This is the only endpoint that accepts an API key directly —\n * callers should obtain a JWT here, then send it as `Authorization: Bearer\n * <token>` to all other operations.\n *\n * The returned JWT carries the caller's subscription `tier` as a claim and\n * expires after `expires_in` seconds. Callers should refresh the token\n * before expiry (or on a `401` response) by calling this endpoint again.\n *\n */\nexport const authenticate = <ThrowOnError extends boolean = false>(\n  options?: Options<AuthenticateData, ThrowOnError>\n) => {\n  return (options?.client ?? _heyApiClient).post<\n    AuthenticateResponse,\n    AuthenticateError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        name: \"X-API-Key\",\n        type: \"apiKey\",\n      },\n    ],\n    url: \"/auth/token\",\n    ...options,\n  });\n};\n\n/**\n * Get your account's identity and tier limits\n * Your userId, current tier, and that tier's limits — no database call, safe to fetch on\n * every page load. For live usage against these limits, see `_links.usage`\n * (`GET /account/usage`).\n *\n */\nexport const getAccount = <ThrowOnError extends boolean = false>(\n  options?: Options<GetAccountData, ThrowOnError>\n) => {\n  return (options?.client ?? _heyApiClient).get<\n    GetAccountResponse,\n    unknown,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/account\",\n    ...options,\n  });\n};\n\n/**\n * Get your live storage usage\n * How much of your account's shared storage pool (`GET /account`'s `maxTotalStorageBytes`)\n * you're currently using. Datasets, strategy-execution signals, and registered strategies\n * all count against the same total — they compete for the same underlying storage, so\n * there's one number to watch, not one per resource type. Not guaranteed real-time — a\n * just-completed upload or strategy execution may take a short moment to be reflected here.\n *\n */\nexport const getAccountUsage = <ThrowOnError extends boolean = false>(\n  options?: Options<GetAccountUsageData, ThrowOnError>\n) => {\n  return (options?.client ?? _heyApiClient).get<\n    GetAccountUsageResponse,\n    unknown,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/account/usage\",\n    ...options,\n  });\n};\n\n/**\n * List the available exchanges\n */\nexport const listExchanges = <ThrowOnError extends boolean = false>(\n  options?: Options<ListExchangesData, ThrowOnError>\n) => {\n  return (options?.client ?? _heyApiClient).get<\n    ListExchangesResponse,\n    unknown,\n    ThrowOnError\n  >({\n    url: \"/exchanges\",\n    ...options,\n  });\n};\n\n/**\n * List an exchange's instruments (default spot segment)\n * \"Give me binance instruments\" — returns the exchange's DEFAULT segment (`spot`)\n * in `data`, each instrument with per-data-type coverage and market info. `meta`\n * confirms the served `segment` (`spot`); HAL `_links` carry `self` plus the\n * `spot` / `futures` segment-discovery links.\n *\n */\nexport const listInstruments = <ThrowOnError extends boolean = false>(\n  options: Options<ListInstrumentsData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    ListInstrumentsResponse,\n    ListInstrumentsError,\n    ThrowOnError\n  >({\n    url: \"/exchange/{exchangeId}/instruments\",\n    ...options,\n  });\n};\n\n/**\n * List an exchange segment's instruments\n * Returns the instruments for one market segment of the exchange, each with\n * per-data-type coverage and market info. HAL `_links` carry `self` plus the\n * `spot` / `futures` segment-discovery links; the default-segment shortcut is\n * `GET /exchange/{exchangeId}/instruments` (spot).\n *\n */\nexport const listSegmentInstruments = <ThrowOnError extends boolean = false>(\n  options: Options<ListSegmentInstrumentsData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    ListSegmentInstrumentsResponse,\n    ListSegmentInstrumentsError,\n    ThrowOnError\n  >({\n    url: \"/exchange/{exchangeId}/{segment}/instruments\",\n    ...options,\n  });\n};\n\n/**\n * Download one hour of tickers for an instrument as a Lastra segment\n * Serves exactly one hour of raw ticker data for the given instrument on the\n * requested exchange. The payload is a native [Lastra](https://github.com/QTSurfer/lastra-java)\n * file — QTSurfer's columnar format for tick-precision timeseries — with\n * no JSON envelope.\n *\n * One segment = one hour, aligned to UTC. The `hour` query parameter selects\n * the segment and must match `YYYY-MM-DDTHH` (no minutes/seconds, no timezone\n * suffix). Example: `hour=2026-01-15T10` returns `h10.lastra` for\n * 2026-01-15, covering `[10:00:00Z, 11:00:00Z)`. Hours not yet available\n * return `404`.\n *\n * A `format=parquet` query parameter switches the response to on-the-fly\n * Parquet conversion via [lastra-convert](https://github.com/QTSurfer/lastra-convert)\n * for clients that don't yet read Lastra. Lastra is the primary format\n * and cheaper when the client can consume it.\n *\n * Clients:\n * - [lastra-java](https://github.com/QTSurfer/lastra-java) — reference\n * Java reader/writer with per-column codecs (ALP, Gorilla, delta-varint,\n * ZSTD) and CRC32 integrity.\n * - [lastra-ts](https://github.com/QTSurfer/lastra-ts) — TypeScript reader\n * (~4 kB bundle, browser + Node.js).\n * - [duckdb-lastra](https://github.com/QTSurfer/duckdb-lastra) — DuckDB\n * extension for ad-hoc SQL over Lastra files.\n * - [lastra-convert](https://github.com/QTSurfer/lastra-convert) — CLI + Java\n * API for converting to/from Parquet, Reef, and CSV.\n * - `curl -OJ` for offline dumps (the `Content-Disposition` header sets a\n * descriptive filename).\n *\n */\nexport const downloadTickers = <ThrowOnError extends boolean = false>(\n  options: Options<DownloadTickersData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    DownloadTickersResponse,\n    DownloadTickersError,\n    ThrowOnError\n  >({\n    url: \"/exchange/{exchangeId}/tickers/{base}/{quote}\",\n    ...options,\n  });\n};\n\n/**\n * Download one hour of klines for an instrument as a Lastra segment\n * Same shape and semantics as `/exchange/{exchangeId}/tickers/{base}/{quote}`,\n * but serves klines (aggregated bars) instead of raw ticks. One\n * [Lastra](https://github.com/QTSurfer/lastra-java) segment = one hour of\n * klines at the exchange's native kline cadence, aligned to UTC.\n *\n * Klines use the same columnar layout as tickers — readers that handle one\n * format read the other with the same code. Use this endpoint when a\n * per-tick payload would be too large for the window of interest.\n *\n */\nexport const downloadKlines = <ThrowOnError extends boolean = false>(\n  options: Options<DownloadKlinesData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    DownloadKlinesResponse,\n    DownloadKlinesError,\n    ThrowOnError\n  >({\n    url: \"/exchange/{exchangeId}/klines/{base}/{quote}\",\n    ...options,\n  });\n};\n\n/**\n * List your registered strategies\n * Every strategy you have registered and not deleted, most recently compiled first.\n *\n * Each entry carries the same provenance `GET /strategy/{strategyId}` does — `compiledAt`,\n * `requiredSources` — but not its validation state, so listing stays cheap regardless of how\n * many strategies you have. Check a specific strategy's validation with `GET\n * /strategy/{strategyId}`.\n *\n */\nexport const listStrategies = <ThrowOnError extends boolean = false>(\n  options?: Options<ListStrategiesData, ThrowOnError>\n) => {\n  return (options?.client ?? _heyApiClient).get<\n    ListStrategiesResponse,\n    unknown,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategies\",\n    ...options,\n  });\n};\n\n/**\n * Compile and register a strategy\n * Compiles raw strategy source and registers it, returning its `strategyId`.\n *\n * **This answers one question: is the source valid Java.** It compiles, registers, and hands\n * back the id — nothing more. Whether the class can actually run is\n * `POST /strategy/{strategyId}/validate`, and everything known about a strategy, validation\n * included, is read from `GET /strategy/{strategyId}`. One place to ask, so there is no second\n * answer to keep in step.\n *\n * The `strategyId` is derived from what the code *means*, not from how it is written. Adding a\n * comment, inserting a blank line, re-indenting, reordering imports, or moving a method around\n * all return the **same** id — you have not created a second strategy. Renaming a variable,\n * changing an identifier's case, reordering fields, or reordering statements inside a method\n * return a **different** one.\n *\n * Two rules follow, and they are worth designing around:\n *\n * - re-submitting a strategy you have only reformatted is free, and gives you back the id you\n * already had, along with any validation already recorded against it;\n * - the id says nothing about *behaviour*. Two sources that compute the same thing by\n * different means are two strategies, because deciding otherwise would mean deciding program\n * equivalence.\n *\n * The response also lists `declaredProperties` — the sweep/execute param keys this strategy\n * is known to accept, so a caller can catch a typo'd key before submitting a sweep instead of\n * only learning it from a rejected one. See `DeclaredProperty`: best-effort, not exhaustive.\n *\n */\nexport const compileStrategy = <ThrowOnError extends boolean = false>(\n  options: Options<CompileStrategyData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    CompileStrategyResponse,\n    CompileStrategyError,\n    ThrowOnError\n  >({\n    bodySerializer: null,\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategy\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"text/plain\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Check that a registered strategy can actually run\n * Instantiates the compiled class and drives it through a bounded synthetic series, so a wiring\n * fault surfaces here instead of at your first backtest. The verdict — pass or fail, plus any\n * engine notices — is recorded and served from `GET /strategy/{strategyId}`.\n *\n * **Idempotent.** If a verdict already exists for the current compilation it comes straight\n * back with `200` and nothing is queued. Otherwise the check is queued and this returns `202`;\n * poll `GET /strategy/{strategyId}` until `validation` is `passed` or `failed`.\n *\n * Recompiling supersedes a verdict, which makes this callable again — the old answer described\n * bytecode that is no longer what would run.\n *\n */\nexport const validateStrategy = <ThrowOnError extends boolean = false>(\n  options: Options<ValidateStrategyData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    ValidateStrategyResponse,\n    ValidateStrategyError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategy/{strategyId}/validate\",\n    ...options,\n  });\n};\n\n/**\n * Release a registered strategy\n * Removes a strategy from `GET /strategy/{strategyId}` and `GET /strategies`. This is not\n * undone by re-submitting the same source to `POST /strategy` — that registers a new\n * strategy, with a new id.\n *\n * **Backtests you already ran against this strategy are unaffected.** Deleting it stops it\n * from counting against your account and stops you from validating or re-running it under\n * this id — it does not erase what already happened.\n *\n * Only removes a strategy you registered yourself. If you copied someone else's strategy\n * (a shared/marketplace listing), deleting your copy never affects theirs, or anyone else's.\n *\n */\nexport const deleteStrategy = <ThrowOnError extends boolean = false>(\n  options: Options<DeleteStrategyData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).delete<\n    DeleteStrategyResponse,\n    DeleteStrategyError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategy/{strategyId}\",\n    ...options,\n  });\n};\n\n/**\n * Get a strategy by id, including its validation state\n * Reports that the strategy is registered — implied by a `200` at all — and what validating it\n * found.\n *\n * A `404` means one thing: no such registered strategy for this user. It is never a stale or\n * expired answer; registration and verdict are stored durably, not cached.\n *\n */\nexport const getStrategy = <ThrowOnError extends boolean = false>(\n  options: Options<GetStrategyData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetStrategyResponse,\n    GetStrategyError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategy/{strategyId}\",\n    ...options,\n  });\n};\n\n/**\n * Get a registered strategy's source, if you still have one to read\n * The exact source you last submitted for this id — the same text `POST /strategy` derives\n * `strategyId` from, whitespace and comments included.\n *\n * **\"If available\", not \"always\".** A strategy you resolve only through a shared/marketplace\n * listing you copied by reference carries no source of its own, and reads as a `404` here the\n * same as a `strategyId` you never registered — that is the honest answer either way, since\n * from this endpoint's point of view nothing is there to return.\n *\n */\nexport const getStrategyCode = <ThrowOnError extends boolean = false>(\n  options: Options<GetStrategyCodeData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetStrategyCodeResponse,\n    GetStrategyCodeError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/strategy/{strategyId}/code\",\n    ...options,\n  });\n};\n\n/**\n * Prepare backtest data\n * Enqueues a prepare task over the requested date range. Returns immediately with a `jobId`;\n * poll `GET /backtest/{exchangeId}/{type}/prepare/{jobId}` for completion.\n *\n * The same params always return the same `jobId` (idempotent). Repeated calls with identical\n * params do not enqueue duplicate work — they reuse the existing job.\n *\n * **`exchangeId: user` is reserved for your own uploaded data.** Instead of a managed\n * exchange, it prepares from a dataset you created via `POST /datasets` (see the **Dataset**\n * endpoints) — send `datasetId` in place of `instrument`. See `PrepareRequest` below for the\n * two request shapes.\n *\n */\nexport const prepareBacktest = <ThrowOnError extends boolean = false>(\n  options: Options<PrepareBacktestData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    PrepareBacktestResponse,\n    PrepareBacktestError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/prepare\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Get the status of a prepare job\n * Retrieves the current state of the prepare job identified by `jobId`.\n * Poll until `status` is `Completed`, `Failed`, or `Aborted`.\n *\n * For a dataset prepare (`exchangeId: user`), coverage is reported against the dataset's own\n * cadence grid instead of hours — see `cadence`/`gaps`/`largestGapSteps` on `PrepareJobState`.\n *\n */\nexport const getPrepareStatus = <ThrowOnError extends boolean = false>(\n  options: Options<GetPrepareStatusData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetPrepareStatusResponse,\n    GetPrepareStatusError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/prepare/{jobId}\",\n    ...options,\n  });\n};\n\n/**\n * Execute a parameter sweep over prepared data\n * Runs a parameter matrix over the single immutable dataset identified by `requestId`.\n * The backend expands and executes the matrix internally; clients poll the returned\n * `sweepId` for incremental results.\n *\n * Supplying `walkForward` runs the sweep in a different mode entirely. Instead of scoring\n * every parameter vector once over the whole range, the data is split into F sequential\n * folds; each fold optimizes the full grid on its own window and then scores only its winner\n * on the window immediately after — data that winner was not chosen on. It answers a harder\n * question than a leaderboard: not \"which parameters won\", but \"does re-optimizing this\n * periodically actually work\". Omit the block and nothing changes, including the response.\n *\n * The cost is the reason it is opt-in rather than always on: F folds × N vectors, so a\n * 4-fold run over a 500-point grid is 2004 backtests where the plain sweep is 500. The\n * request is rejected when `folds × totalRuns` exceeds the server's sweep budget.\n *\n */\nexport const executeSweep = <ThrowOnError extends boolean = false>(\n  options: Options<ExecuteSweepData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    ExecuteSweepResponse,\n    ExecuteSweepError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/executeSweep/{requestId}\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Cancel a running parameter sweep\n * Requests cancellation between parameter vectors. Completed rows remain readable.\n */\nexport const cancelSweep = <ThrowOnError extends boolean = false>(\n  options: Options<CancelSweepData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).delete<\n    CancelSweepResponse,\n    CancelSweepError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}\",\n    ...options,\n  });\n};\n\n/**\n * Get sweep progress and results\n * Returns incremental sweep progress. The default `ranked` view sorts and may truncate the\n * display leaderboard. `order=natural` returns every available row, untruncated, ordered by\n * deterministic `runIx`; use that view when materialising durable trial rows.\n *\n * The `ranked` view is ordered by **plateau score** by default, not by the raw objective. A\n * plateau score is the objective of the worst run in a parameter point's immediate\n * neighbourhood, so a point scores well only if the region around it also does — the highest\n * raw score is frequently a spike that does not survive the parameters moving slightly. Pass\n * `ranking=raw` for the unadjusted objective order.\n *\n * Rows in the `ranked` view carry `plateauScore` and `neighbourCount` when plateau ranking\n * applied. Read them together: `neighbourCount: 0` means the point had no neighbours to\n * compare against, so its plateau score is unevidenced rather than confirmed. Sweeps\n * submitted before plateau ranking existed have no stored parameter grid to rebuild a\n * neighbourhood from and are always ranked raw; the response's `ranking` field says which\n * ordering was actually used.\n *\n * A sweep submitted with `walkForward` answers in a different shape, and the `walkForward`\n * field on the response is what tells the two apart — it appears as soon as the sweep is\n * accepted, before any fold has finished, so it is safe to branch on while polling. There\n * the leaderboard is one row per completed fold: that fold's winner as it scored\n * **out-of-sample**, with `runIx` carrying the fold index rather than a grid position. The\n * in-sample runs behind those winners are not retained — they are an optimization's working\n * set, and only the winner survives its fold. `ranking` is always `raw` and no plateau, DSR\n * or PBO figure is reported: the out-of-sample scores are already the honest number, and\n * layering a certification computed over F observations on top of them would overstate what\n * was measured.\n *\n */\nexport const getSweepResult = <ThrowOnError extends boolean = false>(\n  options: Options<GetSweepResultData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetSweepResultResponse,\n    GetSweepResultError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}\",\n    ...options,\n  });\n};\n\n/**\n * Get sweep sensitivity surfaces\n * How the objective moves as each parameter moves — the question a leaderboard cannot answer.\n * A leaderboard says which point won; a sweep can spend its entire budget on an axis that\n * never moved the objective at all, and showing only the top rows hides that completely.\n *\n * A **marginal** takes one axis and collapses every other one: for each value of that axis,\n * it aggregates every run that used it, whatever the rest of the parameters were. A flat\n * marginal means the axis is irrelevant over the range swept. `best`, `mean` and `worst` are\n * all reported because them disagreeing is itself the signal — a value with a high `best` and\n * a poor `mean` works only in specific company, which is an interaction between parameters\n * and would be invisible behind a single number.\n *\n * A **heatmap** does the same over a pair of axes, where that interaction becomes visible\n * directly.\n *\n * Served from the sweep's stored rows: no re-run, no engine call, and it works on a sweep\n * still in flight — the aggregates then describe the runs finished so far. Aborted runs are\n * excluded throughout, since a run that threw measured nothing and counting it as a bad\n * outcome would invent evidence against a parameter value that was never really tested.\n *\n * This is a separate endpoint rather than extra fields on the result view because the\n * two-dimensional half is quadratic in the axis count (N axes give N(N-1)/2 surfaces, each\n * the product of two axes' value counts) and is not wanted on the poll that drives progress.\n *\n */\nexport const getSweepSensitivity = <ThrowOnError extends boolean = false>(\n  options: Options<GetSweepSensitivityData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetSweepSensitivityResponse,\n    GetSweepSensitivityError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}/sensitivity\",\n    ...options,\n  });\n};\n\n/**\n * Get one sweep trial's equity curve\n * The resource a leaderboard row's `equityCurve.url` points at — only reachable when that\n * trial's curve was actually selected (`equityCurve.mode: topN` or `topPct` on the sweep\n * submission, and this trial ranked among the winners). Returns the exact same\n * `{points|timestamps+equities, meta}` shape a plain backtest's inline `equityCurve` carries.\n *\n * Query params reshape the response the same way a plain backtest's `equityCurve` options do.\n * A param genuinely absent from the query string falls back to the `equityCurve` transform\n * preference the sweep was submitted with — a param\n * present but malformed does not fall back, it degrades the same way it always has. Above a\n * server-side size threshold, the shape is forced regardless of either — `meta.outMode` in\n * the response, not the query string or the submitted default, is the source of truth for\n * what shape actually came back.\n *\n */\nexport const getSweepRunEquityCurve = <ThrowOnError extends boolean = false>(\n  options: Options<GetSweepRunEquityCurveData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetSweepRunEquityCurveResponse,\n    GetSweepRunEquityCurveError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/executeSweep/{requestId}/{sweepId}/runs/{runIx}/equityCurve\",\n    ...options,\n  });\n};\n\n/**\n * Execute a compiled strategy against a prepared dataset\n * Enqueues an execute task that runs the strategy identified by `strategyId` over the data\n * prepared by the prepare job identified by `prepareJobId`. The instrument and date range are\n * recovered from the prepare job — they do not need to be sent again.\n *\n * Returns immediately with a `jobId`; poll `GET /backtest/{exchangeId}/{type}/execute/{jobId}`\n * for the result.\n *\n * Optionally takes `params`: strategy properties for this one run, applied without\n * recompiling. This is how a sweep leaderboard winner gets re-run for its `equityCurve` —\n * a sweep row carries the ten ranking metrics but never a curve, whatever its size. Compile\n * once, call this endpoint N times with different `params`, and each response is an ordinary\n * backtest result with the curve included.\n *\n * The same request (same `prepareJobId`, `strategyId`, `storeSignals`, `equityCurve`,\n * `baseConfig`, `params`) always returns the same `jobId` (idempotent) — a request that omits\n * `equityCurve`, `baseConfig` or `params` dedupes exactly as it did before those fields\n * existed. Two different `params` vectors over one prepare are two different jobs, and `9`\n * and `9.0` are the same one.\n *\n * The re-run is an independent execution rather than a replay of the sweep trial — the two\n * paths do not share a simulator — but they are pinned to agree: one vector run both ways\n * matches on every leaderboard metric, asserted as a regression test. Treat a difference as a\n * bug worth reporting, not as expected behaviour.\n *\n * Optionally takes `baseConfig`, the same `SweepBaseConfig` shape `executeSweep` accepts —\n * `initialFunding`, `feeRate`, `percentAmountToLock`, etc. — so the same object can be reused\n * against either endpoint. This endpoint has one effective fee rate rather than a sweep's\n * independent buy/sell legs: a `baseConfig` that resolves to different buy/sell rates, or sets\n * a non-default `feeLeg`, is rejected with `400` rather than silently collapsed to one side.\n *\n * Works unchanged for a dataset-backed prepare (`exchangeId: user`) — the request body is\n * identical either way, since the instrument and range are recovered from `prepareJobId`.\n *\n */\nexport const executeBacktest = <ThrowOnError extends boolean = false>(\n  options: Options<ExecuteBacktestData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    ExecuteBacktestResponse,\n    ExecuteBacktestError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/execute\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Cancel a running backtest execution\n * Requests cancellation of the specified execution. The execution\n * status will transition to `Aborted` once the cancellation is\n * processed. Cancellation is asynchronous — poll the GET endpoint\n * to confirm the final status.\n *\n */\nexport const cancelBacktest = <ThrowOnError extends boolean = false>(\n  options: Options<CancelBacktestData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).delete<\n    CancelBacktestResponse,\n    CancelBacktestError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/execute/{jobId}\",\n    ...options,\n  });\n};\n\n/**\n * Get the result of a backtest execution job\n * Retrieves the current state and results of the execute job identified by `jobId`.\n * Poll until `state.status` is `Completed`, `Failed`, or `Aborted`.\n *\n * A `202` means the result is not readable yet — keep polling. It is never a terminal\n * outcome, and it carries no `state`, so a poll loop that stops on a terminal status will\n * not stop on it.\n *\n */\nexport const getBacktestResult = <ThrowOnError extends boolean = false>(\n  options: Options<GetBacktestResultData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetBacktestResultResponse,\n    GetBacktestResultError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/backtest/{exchangeId}/{type}/execute/{jobId}\",\n    ...options,\n  });\n};\n\n/**\n * List your datasets\n * Every dataset you have created and not deleted, most recently created first. Never a `404`\n * — an empty array if you have none, same convention as `GET /strategies`.\n *\n */\nexport const listDatasets = <ThrowOnError extends boolean = false>(\n  options?: Options<ListDatasetsData, ThrowOnError>\n) => {\n  return (options?.client ?? _heyApiClient).get<\n    ListDatasetsResponse,\n    unknown,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets\",\n    ...options,\n  });\n};\n\n/**\n * Create a dataset and get a URL to upload it to\n * Creates a dataset AND its first upload session in one call — a presigned URL your client\n * PUTs the file to directly, no API credentials involved in that PUT. Call\n * `POST /datasets/{datasetId}/uploads/{uploadId}/finalize` once the upload completes to kick\n * off ingest.\n *\n * Losing this response loses nothing: calling this dataset's\n * `POST /datasets/{datasetId}/uploads` returns the very same upload session again rather than\n * opening a new one, as long as nothing has been finalized against it yet.\n *\n * v1 is ticker data only — `type` is not a request field, it is always `\"ticker\"` in the\n * response. `instrument` must be a plain spot pair (`BASE/QUOTE`, exactly one `/`); derivative\n * forms (e.g. `BTC/USDT:USDT`) are rejected.\n *\n * **Upload format.** A CSV with a header row, a parquet file with the same columns by\n * name, or a lastra file — our own native columnar format, the same one a dataset's\n * `dataUrl` hands back by default, so a downloaded dataset can be handed to another user to\n * upload with no conversion in between. For CSV/parquet, required: `timestamp` (ISO-8601, or\n * numeric epoch seconds/millis/micros — detected from the first row, then enforced for every\n * later row), `close`. Optional: `open`, `high`, `low`, `volume`, `quoteVolume`, `bid`,\n * `bidSize`, `ask`, `askSize`. A lastra upload carries its own fixed column set instead and\n * only needs a timestamp series and a close series present. Cadence and timestamp unit are\n * discovered from the data, not declared, for all three.\n *\n * A CSV upload is converted to our native columnar format (`lastra`) for storage. A parquet\n * or lastra upload is stored as-is today. Either way, always check `dataFormat` on\n * `GET /datasets/{datasetId}` and `GET /datasets/{datasetId}/uploads/{uploadId}` for which\n * one `dataUrl` actually is, rather than assuming from how you uploaded it (a converted CSV\n * and an uploaded lastra file both report `dataFormat: \"lastra\"`).\n *\n * The bytes PUT to `upload.url` may be that file directly, gzipped (`.gz`), or zipped\n * (`.zip`, exactly one file inside — a dataset is one file regardless of how it travels).\n * Format is detected from the decompressed content itself: there is no filename or\n * `Content-Type` anywhere in this flow for a client to declare it with, so nothing needs to\n * be sent besides the bytes.\n *\n */\nexport const createDataset = <ThrowOnError extends boolean = false>(\n  options: Options<CreateDatasetData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    CreateDatasetResponse,\n    CreateDatasetError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Delete a dataset\n * Soft-delete — the dataset stops appearing in `GET /datasets`/`GET /datasets/{datasetId}` and\n * can no longer be prepared from, but its object data is reclaimed later rather than purged\n * inline, so a backtest already running against one of its versions is not disrupted.\n *\n */\nexport const deleteDataset = <ThrowOnError extends boolean = false>(\n  options: Options<DeleteDatasetData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).delete<\n    DeleteDatasetResponse,\n    DeleteDatasetError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}\",\n    ...options,\n  });\n};\n\n/**\n * Get a dataset by id\n * Detail for one dataset, plus a self link.\n */\nexport const getDataset = <ThrowOnError extends boolean = false>(\n  options: Options<GetDatasetData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetDatasetResponse,\n    GetDatasetError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}\",\n    ...options,\n  });\n};\n\n/**\n * Open a new upload session for an existing dataset\n * Get a fresh presigned URL to upload a new version into a dataset you already have — a\n * corrected file, or the next chunk of history. Behaves the same way `POST /datasets` does\n * for a brand-new dataset's own upload: at most one upload session is open per dataset at a\n * time, so calling this again before finalizing just hands back that same session rather\n * than opening a second one — safe to call repeatedly if a response gets lost.\n *\n * Once a session has been finalized (successfully or not), the next call here opens a\n * genuinely new one for that dataset's next version.\n *\n */\nexport const openDatasetUpload = <ThrowOnError extends boolean = false>(\n  options: Options<OpenDatasetUploadData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    OpenDatasetUploadResponse,\n    OpenDatasetUploadError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}/uploads\",\n    ...options,\n  });\n};\n\n/**\n * Finalize an uploaded file and start ingest\n * Call once the file has been PUT to the `upload.url` from `POST /datasets` (or from\n * `POST /datasets/{datasetId}/uploads`). Enqueues ingest and returns immediately; poll\n * `GET /datasets/{datasetId}/uploads/{uploadId}` for the result.\n *\n * Idempotent while the upload is still open — a repeat finalize before it has produced a\n * version returns the same `jobId` rather than enqueueing a second ingest. Once it HAS\n * produced a version, `uploadId` is spent: finalizing it again is a `409`, even with\n * different bytes freshly PUT to the same URL — open a new upload session instead\n * (`POST /datasets/{datasetId}/uploads`) rather than reusing a spent one.\n *\n */\nexport const finalizeDatasetUpload = <ThrowOnError extends boolean = false>(\n  options: Options<FinalizeDatasetUploadData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    FinalizeDatasetUploadResponse,\n    FinalizeDatasetUploadError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}/uploads/{uploadId}/finalize\",\n    ...options,\n  });\n};\n\n/**\n * Get the state of an upload/ingest\n * Poll after `POST .../finalize` until `status` is `ready` or `failed`. Also reports\n * `uploading` (finalize not called yet, but the file was PUT) before you finalize at all.\n *\n */\nexport const getDatasetUpload = <ThrowOnError extends boolean = false>(\n  options: Options<GetDatasetUploadData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetDatasetUploadResponse,\n    GetDatasetUploadError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}/uploads/{uploadId}\",\n    ...options,\n  });\n};\n\n/**\n * Create a dataset by importing history instead of uploading it\n * A second way to get data into a dataset, alongside `POST /datasets`: instead of `PUT`ting a\n * file yourself, ask the API to go fetch history on your behalf. Creates the dataset and\n * starts the fetch in the same call — there is no separate upload step, and the result lands\n * as a dataset version indistinguishable from an uploaded one once it's ready. Poll\n * `GET /datasets/{datasetId}/imports/{importId}` for progress.\n *\n * `type` selects the source. `dex` — history over a pool/pair's own on-chain market — is the\n * only value today; other source types join this same endpoint later.\n *\n * A `dex` import has two data shapes, chosen by the top-level `cadence`:\n *\n * * Omitted/blank (default) — on-chain swap history, replayed directly from the pool/pair's\n * own chain. Cadence is native, not resampled: each swap keeps the timestamp it happened\n * at rather than being bucketed into candles, so the resulting version's `cadence` is `rt`\n * unless the swaps happen to sit on a fixed grid (see `DatasetVersion.cadence`).\n * * One of `1s` / `1m` / `5m` — pre-aggregated candles at that width instead of raw trades.\n * The resulting dataset's `type` is `klines`, not `ticker`. Not every network supports every\n * cadence yet — an unsupported combination fails asynchronously, same as an unresolvable\n * pool (see the `failed` status on the poll endpoint below).\n *\n */\nexport const importDataset = <ThrowOnError extends boolean = false>(\n  options: Options<ImportDatasetData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).post<\n    ImportDatasetResponse,\n    ImportDatasetError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/imports\",\n    ...options,\n    headers: {\n      \"Content-Type\": \"application/json\",\n      ...options?.headers,\n    },\n  });\n};\n\n/**\n * Get the state of an import/ingest\n * Poll after `POST /datasets/imports` until `status` is `ready` or `failed`. An import spends\n * real time fetching from its source before anything is even staged — `fetching` is the one\n * status only an import ever reports; `ingesting`/`ready`/`failed` mean exactly what they do\n * on `GET /datasets/{datasetId}/uploads/{uploadId}`, since an import re-enters that same\n * ingest chain once it has fetched and staged its data.\n *\n */\nexport const getDatasetImport = <ThrowOnError extends boolean = false>(\n  options: Options<GetDatasetImportData, ThrowOnError>\n) => {\n  return (options.client ?? _heyApiClient).get<\n    GetDatasetImportResponse,\n    GetDatasetImportError,\n    ThrowOnError\n  >({\n    security: [\n      {\n        scheme: \"bearer\",\n        type: \"http\",\n      },\n    ],\n    url: \"/datasets/{datasetId}/imports/{importId}\",\n    ...options,\n  });\n};\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qtsurfer/api-client",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Auto-generated TypeScript API client for the QTSurfer API (from OpenAPI 3.1 spec)",
   "type": "module",
   "main": "./dist/index.js",

package/src/generated/schemas.gen.ts

@@ -163,6 +163,174 @@ export const HalLinkSchema = {
   },
 } as const;
 
+export const AccountSchema = {
+  type: "object",
+  description: `Your identity and tier limits. No database call behind this one — safe to fetch on every
+page load. Live usage against these limits is a separate resource, \`GET /account/usage\`,
+deliberately: usage changes on every upload/execution and costs a query to compute, this
+one doesn't.
+`,
+  required: [
+    "userId",
+    "tier",
+    "maxDatasets",
+    "maxDatasetBytes",
+    "maxTotalStorageBytes",
+    "_links",
+  ],
+  properties: {
+    userId: {
+      type: "string",
+      description: "Your account id — the JWT `sub` claim.",
+      example: "00000000-0000-0000-0000-000000000000",
+    },
+    tier: {
+      type: "string",
+      description: "Your current subscription tier.",
+      example: "free",
+    },
+    maxDatasets: {
+      type: "integer",
+      description: "Maximum number of active datasets your tier allows.",
+      example: 3,
+    },
+    maxDatasetBytes: {
+      type: "integer",
+      format: "int64",
+      description: "Maximum size, in bytes, of a single dataset version.",
+      example: 52428800,
+    },
+    maxTotalStorageBytes: {
+      type: "integer",
+      format: "int64",
+      description: `Maximum combined storage, in bytes, across every dataset, strategy-execution signal,
+and registered strategy on your account — one shared pool, not a separate cap per
+resource type, since they all compete for the same underlying storage. See \`GET
+/account/usage\`'s \`storageBytesUsed\` for your current usage against this number.
+`,
+      example: 104857600,
+    },
+    _links: {
+      $ref: "#/components/schemas/AccountLinks",
+    },
+  },
+} as const;
+
+export const AccountLinksSchema = {
+  description: "HAL `_links` for `GET /account`",
+  type: "object",
+  required: ["self", "usage"],
+  properties: {
+    self: {
+      allOf: [
+        {
+          $ref: "#/components/schemas/HalLink",
+        },
+      ],
+      description: "Link to this resource.",
+    },
+    usage: {
+      allOf: [
+        {
+          $ref: "#/components/schemas/HalLink",
+        },
+      ],
+      description: "Link to your live usage, `GET /account/usage`.",
+    },
+  },
+} as const;
+
+export const AccountUsageSchema = {
+  type: "object",
+  description: `Your live usage of the shared storage pool \`GET /account\`'s \`maxTotalStorageBytes\` caps.
+Not guaranteed real-time — a just-completed upload or strategy execution may take a short
+moment to be reflected here.
+`,
+  required: [
+    "datasetsUsed",
+    "datasetBytesUsed",
+    "signalsUsed",
+    "signalBytesUsed",
+    "strategiesUsed",
+    "strategyBytesUsed",
+    "storageBytesUsed",
+    "_links",
+  ],
+  properties: {
+    datasetsUsed: {
+      type: "integer",
+      description:
+        "Active datasets counted — the same set `GET /account`'s `maxDatasets` limits.",
+      example: 2,
+    },
+    datasetBytesUsed: {
+      type: "integer",
+      format: "int64",
+      description: "Combined bytes of every active dataset's current version.",
+      example: 15728640,
+    },
+    signalsUsed: {
+      type: "integer",
+      description: "Recorded strategy-execution signal uploads.",
+      example: 1,
+    },
+    signalBytesUsed: {
+      type: "integer",
+      format: "int64",
+      description: "Combined bytes of every recorded signal upload.",
+      example: 524288,
+    },
+    strategiesUsed: {
+      type: "integer",
+      description: "Registered strategies (see `GET /strategies`).",
+      example: 4,
+    },
+    strategyBytesUsed: {
+      type: "integer",
+      format: "int64",
+      description: `Combined bytes of each registered strategy's source plus its latest compiled
+bytecode. Superseded (non-latest) compilations aren't counted.
+`,
+      example: 40960,
+    },
+    storageBytesUsed: {
+      type: "integer",
+      format: "int64",
+      description: `\`datasetBytesUsed + signalBytesUsed + strategyBytesUsed\` — the number checked
+against \`GET /account\`'s \`maxTotalStorageBytes\`.
+`,
+      example: 16293888,
+    },
+    _links: {
+      $ref: "#/components/schemas/AccountUsageLinks",
+    },
+  },
+} as const;
+
+export const AccountUsageLinksSchema = {
+  description: "HAL `_links` for `GET /account/usage`",
+  type: "object",
+  required: ["self", "account"],
+  properties: {
+    self: {
+      allOf: [
+        {
+          $ref: "#/components/schemas/HalLink",
+        },
+      ],
+      description: "Link to this resource.",
+    },
+    account: {
+      allOf: [
+        {
+          $ref: "#/components/schemas/HalLink",
+        },
+      ],
+      description: "Link to your tier limits, `GET /account`.",
+    },
+  },
+} as const;
+
 export const InstrumentDetailSchema = {
   description:
     "Exchange instrument with per-data-type coverage and market info",
@@ -369,7 +537,7 @@ export const JobStateSchema = {
       description:
         "Identifier for the job's execution context. Its current shape is a colon-delimited string encoding the data source type, an internal user id, the exchange, the job id, and the instrument — but that structure is not a committed contract and may change without notice. Treat it as an opaque token: store and pass it back, don't parse it.",
       example:
-        "jctx:ticker:76b90203-03c2-46f6-b366-9944f167e818:binance:5ikyamio8b3v9wcnfxztzg:btc/usdt:0vicnz3thzhrqvfczks1pu",
+        "jctx:ticker:00000000-0000-0000-0000-000000000000:binance:5ikyamio8b3v9wcnfxztzg:btc/usdt:0vicnz3thzhrqvfczks1pu",
     },
     status: {
       type: "string",
@@ -1964,11 +2132,12 @@ export const DatasetSchema = {
   description: `A dataset's own metadata — not its data. \`currentVersionId\` is what a prepare against
 \`exchangeId: user\` reads by default; see \`DatasetVersion\` for what a version carries.
 
-\`from\`/\`to\`/\`cadence\` mirror that current version's own discovered range and cadence, so
-you don't need a second call to \`GET /datasets/{datasetId}/uploads/{uploadId}\` just to see
-what a dataset covers. Absent until a version exists.
+\`from\`/\`to\`/\`cadence\`/\`timestampUnit\`/\`bytes\`/\`rows\`/\`gaps\`/\`largestGapSteps\` mirror that
+current version's own discovered range, cadence, timestamp unit and metrics, so you don't
+need a second call to \`GET /datasets/{datasetId}/uploads/{uploadId}\` just to see what a
+dataset covers.
 `,
-  required: ["datasetId", "name", "type", "instrument", "createdAt"],
+  required: ["datasetId", "name", "type", "instrument", "createdAt", "status"],
   properties: {
     datasetId: {
       type: "string",
@@ -2035,6 +2204,56 @@ a version exists.
 `,
       example: "1m",
     },
+    timestampUnit: {
+      type: "string",
+      enum: ["iso", "s", "ms", "us"],
+      description: `\`currentVersionId\`'s own timestamp unit (see \`DatasetVersion.timestampUnit\`) — decode
+the \`timestamp\` column of \`dataUrl\`'s file accordingly. Present only when \`status\` is
+\`ready\`.
+`,
+      example: "iso",
+    },
+    status: {
+      type: "string",
+      enum: ["ready", "failed", "pending"],
+      description: `* \`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).
+`,
+      example: "ready",
+    },
+    bytes: {
+      type: "integer",
+      description: `Size of \`currentVersionId\`'s own stored file. Present only when \`status\` is \`ready\` —
+see \`DatasetVersion.bytes\` for what it measures exactly.
+`,
+      example: 4831022,
+    },
+    rows: {
+      type: "integer",
+      description: `\`currentVersionId\`'s own row count. Present only when \`status\` is \`ready\`.`,
+      example: 86400,
+    },
+    gaps: {
+      type: "integer",
+      description: `\`currentVersionId\`'s own gap count at its discovered cadence. Present only when \`status\` is \`ready\`.`,
+      example: 0,
+    },
+    largestGapSteps: {
+      type: "integer",
+      description: `\`currentVersionId\`'s own largest gap, in units of its discovered cadence step. Present only when \`status\` is \`ready\`.`,
+      example: 0,
+    },
+    error: {
+      type: "string",
+      description: `A human-readable reason the most recent upload/import attempt failed. Present only
+when \`status\` is \`failed\`.
+`,
+      example: "line 3: column 'close' is not a number: not-a-number",
+    },
   },
 } as const;
 
@@ -2064,8 +2283,9 @@ session, not in one shot like a browser upload.
           enum: ["lastra", "parquet"],
           description: `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. \`parquet\` for a parquet
-upload, stored as-is today.
+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.
 `,
           example: "lastra",
         },
@@ -2244,8 +2464,9 @@ an extended viewing session, not in one shot like a browser upload.
       enum: ["lastra", "parquet"],
       description: `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. \`parquet\` for a parquet upload, stored
-as-is today.
+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.
 `,
       example: "lastra",
     },

package/src/generated/sdk.gen.ts

@@ -9,6 +9,10 @@ import type {
   AuthenticateData,
   AuthenticateResponse,
   AuthenticateError,
+  GetAccountData,
+  GetAccountResponse,
+  GetAccountUsageData,
+  GetAccountUsageResponse,
   ListExchangesData,
   ListExchangesResponse,
   ListInstrumentsData,
@@ -147,6 +151,60 @@ export const authenticate = <ThrowOnError extends boolean = false>(
   });
 };
 
+/**
+ * Get your account's identity and tier limits
+ * Your userId, current tier, and that tier's limits — no database call, safe to fetch on
+ * every page load. For live usage against these limits, see `_links.usage`
+ * (`GET /account/usage`).
+ *
+ */
+export const getAccount = <ThrowOnError extends boolean = false>(
+  options?: Options<GetAccountData, ThrowOnError>
+) => {
+  return (options?.client ?? _heyApiClient).get<
+    GetAccountResponse,
+    unknown,
+    ThrowOnError
+  >({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http",
+      },
+    ],
+    url: "/account",
+    ...options,
+  });
+};
+
+/**
+ * Get your live storage usage
+ * How much of your account's shared storage pool (`GET /account`'s `maxTotalStorageBytes`)
+ * you're currently using. Datasets, strategy-execution signals, and registered strategies
+ * all count against the same total — they compete for the same underlying storage, so
+ * there's one number to watch, not one per resource type. Not guaranteed real-time — a
+ * just-completed upload or strategy execution may take a short moment to be reflected here.
+ *
+ */
+export const getAccountUsage = <ThrowOnError extends boolean = false>(
+  options?: Options<GetAccountUsageData, ThrowOnError>
+) => {
+  return (options?.client ?? _heyApiClient).get<
+    GetAccountUsageResponse,
+    unknown,
+    ThrowOnError
+  >({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http",
+      },
+    ],
+    url: "/account/usage",
+    ...options,
+  });
+};
+
 /**
  * List the available exchanges
  */
@@ -895,16 +953,21 @@ export const listDatasets = <ThrowOnError extends boolean = false>(
  * response. `instrument` must be a plain spot pair (`BASE/QUOTE`, exactly one `/`); derivative
  * forms (e.g. `BTC/USDT:USDT`) are rejected.
  *
- * **Upload format.** A CSV with a header row, or a parquet file with the same columns by
- * name. Required: `timestamp` (ISO-8601, or numeric epoch seconds/millis/micros — detected
- * from the first row, then enforced for every later row), `close`. Optional: `open`, `high`,
- * `low`, `volume`, `quoteVolume`, `bid`, `bidSize`, `ask`, `askSize`. Cadence and timestamp
- * unit are discovered from the data, not declared.
+ * **Upload format.** A CSV with a header row, a parquet file with the same columns by
+ * name, or a lastra file — our own native columnar format, the same one a dataset's
+ * `dataUrl` hands back by default, so a downloaded dataset can be handed to another user to
+ * upload with no conversion in between. For CSV/parquet, required: `timestamp` (ISO-8601, or
+ * numeric epoch seconds/millis/micros — detected from the first row, then enforced for every
+ * later row), `close`. Optional: `open`, `high`, `low`, `volume`, `quoteVolume`, `bid`,
+ * `bidSize`, `ask`, `askSize`. A lastra upload carries its own fixed column set instead and
+ * only needs a timestamp series and a close series present. Cadence and timestamp unit are
+ * discovered from the data, not declared, for all three.
  *
  * A CSV upload is converted to our native columnar format (`lastra`) for storage. A parquet
- * upload is stored as-is today. Either way, always check `dataFormat` on
+ * or lastra upload is stored as-is today. Either way, always check `dataFormat` on
  * `GET /datasets/{datasetId}` and `GET /datasets/{datasetId}/uploads/{uploadId}` for which
- * one `dataUrl` actually is, rather than assuming from how you uploaded it.
+ * one `dataUrl` actually is, rather than assuming from how you uploaded it (a converted CSV
+ * and an uploaded lastra file both report `dataFormat: "lastra"`).
  *
  * The bytes PUT to `upload.url` may be that file directly, gzipped (`.gz`), or zipped
  * (`.zip`, exactly one file inside — a dataset is one file regardless of how it travels).

package/src/generated/types.gen.ts

@@ -103,6 +103,111 @@ export type HalLink = {
   templated?: boolean;
 };
 
+/**
+ * Your identity and tier limits. No database call behind this one — safe to fetch on every
+ * page load. Live usage against these limits is a separate resource, `GET /account/usage`,
+ * deliberately: usage changes on every upload/execution and costs a query to compute, this
+ * one doesn't.
+ *
+ */
+export type Account = {
+  /**
+   * Your account id — the JWT `sub` claim.
+   */
+  userId: string;
+  /**
+   * Your current subscription tier.
+   */
+  tier: string;
+  /**
+   * Maximum number of active datasets your tier allows.
+   */
+  maxDatasets: number;
+  /**
+   * Maximum size, in bytes, of a single dataset version.
+   */
+  maxDatasetBytes: number;
+  /**
+   * Maximum combined storage, in bytes, across every dataset, strategy-execution signal,
+   * and registered strategy on your account — one shared pool, not a separate cap per
+   * resource type, since they all compete for the same underlying storage. See `GET
+   * /account/usage`'s `storageBytesUsed` for your current usage against this number.
+   *
+   */
+  maxTotalStorageBytes: number;
+  _links: AccountLinks;
+};
+
+/**
+ * HAL `_links` for `GET /account`
+ */
+export type AccountLinks = {
+  /**
+   * Link to this resource.
+   */
+  self: HalLink;
+  /**
+   * Link to your live usage, `GET /account/usage`.
+   */
+  usage: HalLink;
+};
+
+/**
+ * Your live usage of the shared storage pool `GET /account`'s `maxTotalStorageBytes` caps.
+ * Not guaranteed real-time — a just-completed upload or strategy execution may take a short
+ * moment to be reflected here.
+ *
+ */
+export type AccountUsage = {
+  /**
+   * Active datasets counted — the same set `GET /account`'s `maxDatasets` limits.
+   */
+  datasetsUsed: number;
+  /**
+   * Combined bytes of every active dataset's current version.
+   */
+  datasetBytesUsed: number;
+  /**
+   * Recorded strategy-execution signal uploads.
+   */
+  signalsUsed: number;
+  /**
+   * Combined bytes of every recorded signal upload.
+   */
+  signalBytesUsed: number;
+  /**
+   * Registered strategies (see `GET /strategies`).
+   */
+  strategiesUsed: number;
+  /**
+   * Combined bytes of each registered strategy's source plus its latest compiled
+   * bytecode. Superseded (non-latest) compilations aren't counted.
+   *
+   */
+  strategyBytesUsed: number;
+  /**
+   * `datasetBytesUsed + signalBytesUsed + strategyBytesUsed` — the number checked
+   * against `GET /account`'s `maxTotalStorageBytes`.
+   *
+   */
+  storageBytesUsed: number;
+  _links: AccountUsageLinks;
+};
+
+/**
+ * HAL `_links` for `GET /account/usage`
+ */
+export type AccountUsageLinks = {
+  /**
+   * Link to this resource.
+   */
+  self: HalLink;
+  /**
+   * Link to your tier limits, `GET /account`.
+   */
+  account: HalLink;
+};
+
 /**
  * Exchange instrument with per-data-type coverage and market info
  */
@@ -1165,9 +1270,10 @@ export type StrategyState = {
  * A dataset's own metadata — not its data. `currentVersionId` is what a prepare against
  * `exchangeId: user` reads by default; see `DatasetVersion` for what a version carries.
  *
- * `from`/`to`/`cadence` mirror that current version's own discovered range and cadence, so
- * you don't need a second call to `GET /datasets/{datasetId}/uploads/{uploadId}` just to see
- * what a dataset covers. Absent until a version exists.
+ * `from`/`to`/`cadence`/`timestampUnit`/`bytes`/`rows`/`gaps`/`largestGapSteps` mirror that
+ * current version's own discovered range, cadence, timestamp unit and metrics, so you don't
+ * need a second call to `GET /datasets/{datasetId}/uploads/{uploadId}` just to see what a
+ * dataset covers.
  *
  */
 export type Dataset = {
@@ -1219,6 +1325,47 @@ export type Dataset = {
    *
    */
   cadence?: string;
+  /**
+   * `currentVersionId`'s own timestamp unit (see `DatasetVersion.timestampUnit`) — decode
+   * the `timestamp` column of `dataUrl`'s file accordingly. Present only when `status` is
+   * `ready`.
+   *
+   */
+  timestampUnit?: "iso" | "s" | "ms" | "us";
+  /**
+   * * `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).
+   *
+   */
+  status: "ready" | "failed" | "pending";
+  /**
+   * Size of `currentVersionId`'s own stored file. Present only when `status` is `ready` —
+   * see `DatasetVersion.bytes` for what it measures exactly.
+   *
+   */
+  bytes?: number;
+  /**
+   * `currentVersionId`'s own row count. Present only when `status` is `ready`.
+   */
+  rows?: number;
+  /**
+   * `currentVersionId`'s own gap count at its discovered cadence. Present only when `status` is `ready`.
+   */
+  gaps?: number;
+  /**
+   * `currentVersionId`'s own largest gap, in units of its discovered cadence step. Present only when `status` is `ready`.
+   */
+  largestGapSteps?: number;
+  /**
+   * A human-readable reason the most recent upload/import attempt failed. Present only
+   * when `status` is `failed`.
+   *
+   */
+  error?: string;
 };
 
 /**
@@ -1237,8 +1384,9 @@ export type DatasetWithLinks = Dataset & {
   /**
    * 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. `parquet` for a parquet
-   * upload, stored as-is today.
+   * 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.
    *
    */
   dataFormat?: "lastra" | "parquet";
@@ -1359,8 +1507,9 @@ export type DatasetVersion = {
   /**
    * 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. `parquet` for a parquet upload, stored
-   * as-is today.
+   * 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.
    *
    */
   dataFormat?: "lastra" | "parquet";
@@ -1609,6 +1758,39 @@ export type AuthenticateResponses = {
 export type AuthenticateResponse =
   AuthenticateResponses[keyof AuthenticateResponses];
 
+export type GetAccountData = {
+  body?: never;
+  path?: never;
+  query?: never;
+  url: "/account";
+};
+
+export type GetAccountResponses = {
+  /**
+   * Your account
+   */
+  200: Account;
+};
+
+export type GetAccountResponse = GetAccountResponses[keyof GetAccountResponses];
+
+export type GetAccountUsageData = {
+  body?: never;
+  path?: never;
+  query?: never;
+  url: "/account/usage";
+};
+
+export type GetAccountUsageResponses = {
+  /**
+   * Your current usage
+   */
+  200: AccountUsage;
+};
+
+export type GetAccountUsageResponse =
+  GetAccountUsageResponses[keyof GetAccountUsageResponses];
+
 export type ListExchangesData = {
   body?: never;
   path?: never;
@@ -2738,6 +2920,12 @@ export type FinalizeDatasetUploadErrors = {
    * The uploaded file exceeds your tier's size limit for a dataset.
    */
   413: ResponseError;
+  /**
+   * Your account's total storage limit (`GET /account`'s `maxTotalStorageBytes`) is
+   * reached or would be exceeded. Delete a dataset to free space, or upgrade.
+   *
+   */
+  429: ResponseError;
 };
 
 export type FinalizeDatasetUploadError =
@@ -2821,7 +3009,10 @@ export type ImportDatasetErrors = {
    */
   409: ResponseError;
   /**
-   * Your tier's dataset count limit is reached. Delete one, or upgrade.
+   * Your tier's dataset count limit is reached, or your account's total storage limit
+   * (`GET /account`'s `maxTotalStorageBytes`) is already reached. Delete a dataset to free
+   * a slot or space, or upgrade.
+   *
    */
   429: ResponseError;
 };