@qtsurfer/api-client 0.14.1 → 0.15.0

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} 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 * `params`) always returns the same `jobId` (idempotent) — a request that omits `equityCurve`\n * or `params` dedupes exactly as it did before those fields existed. Two different `params`\n * vectors over one prepare are two different jobs, and `9` 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 * 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"],"mappings":"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","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  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":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qtsurfer/api-client",
-  "version": "0.14.1",
+  "version": "0.15.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

@@ -335,30 +335,20 @@ the dataset instead of its current one. Defaults to the dataset's current versio
     },
     cadence: {
       type: "string",
-      description: `Output bar cadence for the prepared range. Defaults to the publisher's
-native cadence (\`1s\`); coarser cadences are produced on demand via
-resampling and stored alongside the native blob in cache. Coarser-than-
-source values must be exact multiples of the source cadence — invalid
-labels return \`400\`.
-`,
-      enum: [
-        "1s",
-        "5s",
-        "1m",
-        "3m",
-        "5m",
-        "15m",
-        "30m",
-        "1h",
-        "2h",
-        "4h",
-        "8h",
-        "12h",
-        "1d",
-        "1w",
-        "1q",
-      ],
-      default: "1s",
+      description: `Output bar cadence for the prepared range. Coarser cadences are produced on demand by
+resampling the source and stored alongside the native blob in cache. A target finer
+than the source, or not an exact multiple of it, returns \`400\`. What's accepted, and
+what omitting it means, depends on the source:
+
+* Managed exchange — one of \`1s\`, \`5s\`, \`1m\`, \`3m\`, \`5m\`, \`15m\`, \`30m\`, \`1h\`, \`2h\`,
+  \`4h\`, \`8h\`, \`12h\`, \`1d\`, \`1w\`, \`1q\`; any other label returns \`400\`. Omitted = \`1s\`,
+  the publisher's native cadence.
+* Dataset (\`exchangeId: user\`) — omitted = the dataset version's own discovered
+  \`cadence\` (see \`DatasetVersion.cadence\`), served as-is. Any cadence equal to or
+  coarser than it and an exact multiple of it is accepted, including ones outside the
+  managed-exchange list (e.g. \`15s\`); an \`rt\` dataset can be resampled to any fixed
+  cadence.
+`,
     },
   },
   example: {
@@ -386,7 +376,8 @@ export const JobStateSchema = {
       description: `Current status of the job. Treat \`Completed | Aborted | Failed\` as
 terminal; \`New | Started\` mean keep polling. A single-instrument prepare
 is always terminal (\`Completed\`) — decide from
-\`PrepareJobState.coverageRatio\`, not by polling.
+\`PrepareJobState.coverageRatio\` (or \`dataFrom\`/\`dataTo\` against an \`rt\` dataset,
+which has no ratio), not by polling.
 `,
       enum: ["New", "Started", "Completed", "Aborted", "Failed"],
       example: "Completed",
@@ -433,8 +424,10 @@ walked hour by hour: \`totalHours\`/\`hoursWithData\`/\`hoursWithoutData\`. Agai
 dataset-backed prepare (\`exchangeId: user\`), coverage is reported on the dataset's own
 cadence grid instead — hour-walking a daily dataset would report \`1/24\` and read as
 broken — via \`cadence\`/\`gaps\`/\`largestGapSteps\`; \`totalHours\`/\`hoursWithData\`/
-\`hoursWithoutData\` are absent in that case. \`dataFrom\`/\`dataTo\`/\`coverageRatio\` are present
-either way, computed accordingly.
+\`hoursWithoutData\` are absent in that case. \`dataFrom\`/\`dataTo\` are present either way, and
+\`coverageRatio\` too, computed accordingly — except against a dataset whose \`cadence\` is \`rt\`:
+with no fixed step there is no expected row count to measure against, so \`coverageRatio\`
+is absent and \`gaps\`/\`largestGapSteps\` are \`0\`.
 `,
   allOf: [
     {
@@ -466,7 +459,8 @@ either way, computed accordingly.
 \`totalHours\` is 0), the fraction of hours in the requested range that have served
 data. Against a dataset (\`exchangeId: user\`): \`rows / expectedStepsAtCadence\`
 over the dataset version's own range — echoing what ingest computed once, not
-recomputed against a narrower prepare request.
+recomputed against a narrower prepare request. Absent for an \`rt\` dataset (no
+fixed step, so no expected row count).
 `,
           example: 0.994,
         },
@@ -486,22 +480,23 @@ a dataset-backed prepare.
         },
         cadence: {
           type: "string",
-          description: `The dataset version's own discovered cadence (e.g. \`1m\`, \`1h\`). Only present for a
-dataset-backed prepare (\`exchangeId: user\`).
+          description: `The dataset version's own discovered cadence — a fixed grid (e.g. \`1m\`, \`1h\`) or
+\`rt\` (see \`DatasetVersion.cadence\`). Only present for a dataset-backed prepare
+(\`exchangeId: user\`).
 `,
           example: "1m",
         },
         gaps: {
           type: "integer",
           description: `Number of gaps in the dataset version at its own cadence, as discovered at ingest
-time. Only present for a dataset-backed prepare.
+time. \`0\` for \`rt\`. Only present for a dataset-backed prepare.
 `,
           example: 0,
         },
         largestGapSteps: {
           type: "integer",
-          description: `The largest gap in the dataset version, in units of its own cadence step. Only
-present for a dataset-backed prepare.
+          description: `The largest gap in the dataset version, in units of its own cadence step. \`0\` for
+\`rt\`. Only present for a dataset-backed prepare.
 `,
           example: 0,
         },
@@ -654,7 +649,7 @@ export const SweepBaseConfigSchema = {
       type: "number",
       format: "double",
       exclusiveMinimum: 0,
-      default: 10000,
+      default: 100,
     },
     feeRate: {
       type: "number",
@@ -1987,8 +1982,11 @@ what a dataset covers. Absent until a version exists.
     },
     type: {
       type: "string",
-      enum: ["ticker"],
-      description: "Always `ticker` in v1.",
+      enum: ["ticker", "klines"],
+      description: `\`ticker\` for an upload or a \`dex\` import with no \`cadence\` requested (native per-trade
+data). \`klines\` for a \`dex\` import that requested a candle \`cadence\` — pre-aggregated
+bars rather than raw ticks. Purely informational; both shapes are read the same way.
+`,
       example: "ticker",
     },
     instrument: {
@@ -2032,8 +2030,8 @@ a version exists.
     },
     cadence: {
       type: "string",
-      description: `\`currentVersionId\`'s own discovered bar cadence (e.g. \`1s\`, \`1m\`, \`1h\`). Absent until a
-version exists.
+      description: `\`currentVersionId\`'s own discovered cadence — a fixed grid (e.g. \`1s\`, \`1m\`, \`1h\`) or
+\`rt\` (see \`DatasetVersion.cadence\`). Absent until a version exists.
 `,
       example: "1m",
     },
@@ -2202,7 +2200,13 @@ not declared by the caller.
     },
     cadence: {
       type: "string",
-      description: "The discovered bar cadence (e.g. `1s`, `1m`, `1h`).",
+      description: `The cadence discovered from the data's own timestamps. Either a fixed grid — \`1s\`,
+\`5s\`, \`15s\`, \`1m\`, \`5m\`, \`15m\`, \`30m\`, \`1h\`, \`4h\`, \`1d\` — when at least half the
+intervals between consecutive rows fall on that step (small clock jitter tolerated), or
+\`rt\`: native data at the rate it was captured, each row at its own timestamp with no
+fixed step — per-trade on-chain swaps, block-spaced or sub-second ticks, irregular
+intervals. An \`rt\` dataset can be resampled to any fixed cadence at prepare time.
+`,
       example: "1s",
     },
     timestampUnit: {
@@ -2215,12 +2219,14 @@ numeric values fell in (seconds, millis, or micros).
     },
     gaps: {
       type: "integer",
-      description: "Number of gaps at the discovered cadence.",
+      description:
+        "Number of gaps at the discovered cadence. Always `0` for `rt`.",
       example: 0,
     },
     largestGapSteps: {
       type: "integer",
-      description: "The largest gap, in units of the discovered cadence step.",
+      description:
+        "The largest gap, in units of the discovered cadence step. Always `0` for `rt`.",
       example: 0,
     },
     dataUrl: {
@@ -2274,6 +2280,209 @@ that can itself age out — see the \`404\` case on \`GET .../uploads/{uploadId}
       type: "string",
       description: "The ingest job id, while `status` is `ingesting`.",
     },
+    error: {
+      type: "string",
+      description: `A human-readable reason, present when \`status\` is \`failed\` (e.g. bad CSV contract,
+mixed timestamp units, a \`.zip\` with no file inside or more than one). Durably
+recorded alongside the failure itself, so it stays available however long after the
+fact you poll — not tied to how recently the failure happened.
+`,
+      example: "line 3: column 'close' is not a number: not-a-number",
+    },
+    version: {
+      allOf: [
+        {
+          $ref: "#/components/schemas/DatasetVersion",
+        },
+      ],
+      description: "Present when `status` is `ready` or `failed`.",
+    },
+  },
+} as const;
+
+export const DatasetImportRequestSchema = {
+  type: "object",
+  description: `\`POST /datasets/imports\`'s request body. A common block plus one type-specific block,
+selected by \`type\` — \`dex\` is the only value today.
+`,
+  required: ["name", "instrument", "from", "to", "type"],
+  properties: {
+    name: {
+      type: "string",
+      description: "A name unique among your datasets. `409` if already taken.",
+      example: "weth-usdc-week",
+    },
+    instrument: {
+      $ref: "#/components/schemas/Instrument",
+    },
+    from: {
+      type: "string",
+      format: "date-time",
+      description:
+        "Start of the range to fetch, inclusive. Must be before `to`.",
+      example: "2026-08-01T00:00:00Z",
+    },
+    to: {
+      type: "string",
+      format: "date-time",
+      description: `End of the range to fetch, exclusive. The total span is capped by your tier — a
+request wider than that ceiling is \`400\`, regardless of source type.
+`,
+      example: "2026-08-08T00:00:00Z",
+    },
+    cadence: {
+      type: "string",
+      enum: ["1s", "1m", "5m"],
+      description: `Optional. Omitted/blank keeps native per-trade event cadence — each swap at its own
+timestamp, so the resulting version's \`cadence\` is \`rt\` unless the swaps happen to sit
+on a fixed grid (see \`DatasetVersion.cadence\`). Set to \`1s\`, \`1m\` or
+\`5m\` instead to get pre-aggregated candles at that width rather than raw trades (the
+resulting dataset's \`type\` becomes \`klines\`); any other value is \`400\`. Not every
+network supports every cadence — an unsupported combination fails asynchronously, not
+at request time (see \`DatasetImportState.error\`).
+`,
+    },
+    type: {
+      type: "string",
+      enum: ["dex"],
+      description: "The source to fetch from. `dex` is the only value today.",
+      example: "dex",
+    },
+    dex: {
+      $ref: "#/components/schemas/DatasetImportDexRequest",
+    },
+  },
+} as const;
+
+export const DatasetImportDexRequestSchema = {
+  type: "object",
+  description: `The \`dex\` source's own fields — required when \`type\` is \`dex\`. \`id\`/\`version\` are required
+for a plain (native-cadence) import; both are ignored if the top-level \`cadence\` requested
+pre-aggregated candles instead, since that path needs neither a protocol nor a version
+distinction.
+`,
+  required: ["network", "contract"],
+  properties: {
+    network: {
+      type: "string",
+      enum: ["ethereum", "robinhood"],
+      description: "Which chain the pool/pair lives on.",
+      example: "ethereum",
+    },
+    id: {
+      type: "string",
+      enum: ["uniswap"],
+      description: `Which on-chain DEX protocol \`contract\` implements. Required unless the top-level
+\`cadence\` requested pre-aggregated candles, in which case it's ignored.
+`,
+      example: "uniswap",
+    },
+    version: {
+      type: "string",
+      enum: ["v2", "v3"],
+      description: `Uniswap version the pool/pair contract implements. Required unless the top-level
+\`cadence\` requested pre-aggregated candles, in which case it's ignored.
+`,
+      example: "v3",
+    },
+    contract: {
+      type: "string",
+      description: "The pool (v3) or pair (v2) contract address.",
+      example: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
+    },
+    factory: {
+      type: "string",
+      description: `The factory that deployed \`contract\`. Optional — when omitted, it is discovered
+on-chain from \`contract\` itself at fetch time. Supply it explicitly only if you
+already know it, or the pool/pair belongs to a factory other than the canonical one
+for \`network\`/\`version\`. Either way, the pool/pair is validated against whichever
+factory is used before anything is fetched — a wrong or unrelated factory fails the
+import rather than silently fetching from the wrong pool. Ignored if the top-level
+\`cadence\` requested pre-aggregated candles.
+`,
+    },
+  },
+  example: {
+    network: "ethereum",
+    id: "uniswap",
+    version: "v3",
+    contract: "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
+  },
+} as const;
+
+export const DatasetImportCreatedSchema = {
+  type: "object",
+  description:
+    "The response to `POST /datasets/imports` — the dataset now exists, and its fetch has started.",
+  required: ["datasetId", "importId", "jobId", "status"],
+  properties: {
+    datasetId: {
+      type: "string",
+      description:
+        "Opaque id of the newly created dataset — same id space as `POST /datasets`.",
+      example: "ds_3f9a1c2e7b0d4a5f",
+    },
+    importId: {
+      type: "string",
+      description: `Identifies this import. Pass to \`GET /datasets/{datasetId}/imports/{importId}\` to poll
+it — there is no separate "finalize" step the way an upload has.
+`,
+      example: "imp_01j9z1x2y3z4a5b6c7d8e9f0g1",
+    },
+    jobId: {
+      type: "string",
+      description: "The fetch/ingest job id.",
+      example:
+        "dataset-import:00000000-.../ds_3f9a1c2e7b0d4a5f:imp_01j9z1x2y3z4a5b6c7d8e9f0g1",
+    },
+    status: {
+      type: "string",
+      enum: ["fetching"],
+      description:
+        "Always `fetching` in this response — the fetch has only just started.",
+      example: "fetching",
+    },
+  },
+} as const;
+
+export const DatasetImportStateSchema = {
+  type: "object",
+  description: `Progress of one import, from fetching through ingest. \`fetching\` is the one status only an
+import ever reports — an upload's file already exists by the time you can poll it; an
+import's doesn't, until this source finishes fetching it.
+`,
+  required: ["importId", "status"],
+  properties: {
+    importId: {
+      type: "string",
+      example: "imp_01j9z1x2y3z4a5b6c7d8e9f0g1",
+    },
+    status: {
+      type: "string",
+      enum: ["fetching", "ingesting", "ready", "failed"],
+      description: `* \`fetching\` — reading from the source; nothing staged yet.
+* \`ingesting\` — fetch complete, staged, and re-entered the same ingest chain an
+  upload uses; the worker is parsing and validating it.
+* \`ready\` — ingested successfully. \`version\` carries the result.
+* \`failed\` — the fetch or the ingest that followed it was rejected. \`error\` names why.
+`,
+      example: "ready",
+    },
+    jobId: {
+      type: "string",
+      description:
+        "The fetch/ingest job id, while `status` is `fetching` or `ingesting`.",
+    },
+    error: {
+      type: "string",
+      description: `A human-readable reason, present when \`status\` is \`failed\` — an unresolvable
+pool/pair, no data in the requested range, a range older than the configured source
+retains, the fetch exceeding your tier's time ceiling, or any of
+\`DatasetUploadState.error\`'s own ingest-side reasons once fetching hands off to it.
+Durably recorded, same as on the upload path.
+`,
+      example: "Import exceeded the tier's 12 minute ceiling",
+    },
     version: {
       allOf: [
         {