@qtsurfer/api-client 0.1.1 → 0.1.2

package/LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2026 QTSurfer
+   Copyright 2026 Wualabs LTD
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/README.md

@@ -49,6 +49,8 @@ All operations are exported as standalone functions; every operation accepts an
 | -------- | ------ | ---- | ------- |
 | `getExchanges` | GET | `/exchanges` | List available exchanges |
 | `getInstruments` | GET | `/exchange/{exchangeId}/instruments` | List instruments for an exchange |
+| `getExchangeTickersHour` | GET | `/exchange/{exchangeId}/tickers/{base}/{quote}` | Download one hour of tickers as Lastra/Parquet |
+| `getExchangeKlinesHour` | GET | `/exchange/{exchangeId}/klines/{base}/{quote}` | Download one hour of klines as Lastra/Parquet |
 | `postStrategy` | POST | `/strategy` | Compile a strategy |
 | `getStrategyStatus` | GET | `/strategy/{strategyId}` | Poll strategy compilation status |
 | `prepareBacktesting` | POST | `/backtesting/prepare` | Start a data preparation job |

package/dist/index.d.ts

@@ -69,7 +69,7 @@ type Exchange = {
     description?: string;
 };
 /**
- * Managed exchange data sources available for backtesting. Currently only ticker is supported; kline and funding rate support is planned.
+ * Managed exchange data sources available for backtesting.
  */
 type DataSourceType = 'ticker';
 /**
@@ -77,13 +77,17 @@ type DataSourceType = 'ticker';
  */
 type JobState = {
     /**
-     * Unique context ID for the job
+     * Opaque context identifier for the job
      */
     contextId: string;
     /**
-     * Current status of the job
+     * Current status of the job. `Partial` (prepare only) means some
+     * hours are still being produced asynchronously — keep polling.
+     * Treat `Completed | Aborted | Failed` as terminal; anything else
+     * means keep polling.
+     *
      */
-    status: 'New' | 'Started' | 'Completed' | 'Aborted' | 'Failed';
+    status: 'New' | 'Started' | 'Partial' | 'Completed' | 'Aborted' | 'Failed';
     /**
      * Detailed status information, if available
      */
@@ -128,7 +132,7 @@ type BacktestJobResult = {
  */
 type ResultMap = {
     /**
-     * Hostname of the worker node that executed the strategy
+     * Identifier of the worker that executed the strategy. Useful when reporting issues so support can correlate with logs.
      */
     hostName?: string;
     /**
@@ -136,7 +140,7 @@ type ResultMap = {
      */
     iops?: number;
     /**
-     * Redis key of the compiled strategy used for execution. Format: strategy:{userId}:ticker:{compilationId}
+     * Identifier of the compiled strategy that produced this result
      */
     strategyId: string;
     /**
@@ -180,15 +184,15 @@ type ResultMap = {
      */
     signalCount?: number;
     /**
-     * Storage key for the signal Parquet file. Format: {userId}/exec/{exchange}/{jobId}
+     * Storage key for the signals file. Treat as opaque; use signalsUrl to download.
      */
     signalsId?: string;
     /**
-     * Public HTTPS URL to the Parquet file. Computed at setup time from publicBaseUrl + signalsId + .parquet. Available even before upload completes.
+     * HTTPS URL to download the signals Parquet file. Use signalsUpload to know when it's ready.
      */
     signalsUrl?: string;
     /**
-     * Upload status. Done = file uploaded to R2. Failed = upload error (see signalsUploadReason). Skipped = no signals emitted or storage not configured.
+     * Upload status. Done = signal file is available at signalsUrl. Failed = upload error (see signalsUploadReason). Skipped = no signals emitted.
      */
     signalsUpload?: 'Done' | 'Failed' | 'Skipped';
     /**
@@ -242,6 +246,122 @@ type GetInstrumentsResponses = {
     200: Array<InstrumentDetail>;
 };
 type GetInstrumentsResponse = GetInstrumentsResponses[keyof GetInstrumentsResponses];
+type GetExchangeTickersHourData = {
+    body?: never;
+    path: {
+        /**
+         * ID of the exchange (e.g. `binance`).
+         */
+        exchangeId: string;
+        /**
+         * Base asset symbol (first leg of the pair).
+         */
+        base: string;
+        /**
+         * Quote asset symbol (second leg of the pair).
+         */
+        quote: string;
+    };
+    query: {
+        /**
+         * Hour selector in `YYYY-MM-DDTHH` (UTC). The returned segment covers
+         * `[HH:00:00Z, HH+1:00:00Z)`.
+         *
+         */
+        hour: string;
+        /**
+         * Response wire format. `lastra` (default) returns raw Lastra bytes.
+         * `parquet` returns Parquet via on-the-fly conversion using
+         * [lastra-convert](https://github.com/QTSurfer/lastra-convert).
+         *
+         */
+        format?: 'lastra' | 'parquet';
+    };
+    url: '/exchange/{exchangeId}/tickers/{base}/{quote}';
+};
+type GetExchangeTickersHourErrors = {
+    /**
+     * Missing or malformed parameters (e.g. `hour` not `YYYY-MM-DDTHH`).
+     */
+    400: ResponseError;
+    /**
+     * No Lastra segment exists for the requested instrument/hour.
+     */
+    404: ResponseError;
+    /**
+     * Unexpected I/O error serving the file.
+     */
+    500: ResponseError;
+};
+type GetExchangeTickersHourError = GetExchangeTickersHourErrors[keyof GetExchangeTickersHourErrors];
+type GetExchangeTickersHourResponses = {
+    /**
+     * One hour of tickers for the instrument. `Content-Type` is
+     * `application/vnd.lastra` by default or
+     * `application/vnd.apache.parquet` when `format=parquet` was
+     * requested.
+     *
+     */
+    200: Blob | File;
+};
+type GetExchangeTickersHourResponse = GetExchangeTickersHourResponses[keyof GetExchangeTickersHourResponses];
+type GetExchangeKlinesHourData = {
+    body?: never;
+    path: {
+        /**
+         * ID of the exchange (e.g. `binance`).
+         */
+        exchangeId: string;
+        /**
+         * Base asset symbol.
+         */
+        base: string;
+        /**
+         * Quote asset symbol.
+         */
+        quote: string;
+    };
+    query: {
+        /**
+         * Hour selector in `YYYY-MM-DDTHH` (UTC). The returned segment covers
+         * `[HH:00:00Z, HH+1:00:00Z)`.
+         *
+         */
+        hour: string;
+        /**
+         * Response wire format. `lastra` (default) returns raw Lastra bytes.
+         * `parquet` returns Parquet via on-the-fly conversion.
+         *
+         */
+        format?: 'lastra' | 'parquet';
+    };
+    url: '/exchange/{exchangeId}/klines/{base}/{quote}';
+};
+type GetExchangeKlinesHourErrors = {
+    /**
+     * Missing or malformed parameters (e.g. `hour` not `YYYY-MM-DDTHH`).
+     */
+    400: ResponseError;
+    /**
+     * No Lastra segment exists for the requested instrument/hour.
+     */
+    404: ResponseError;
+    /**
+     * Unexpected I/O error serving the file.
+     */
+    500: ResponseError;
+};
+type GetExchangeKlinesHourError = GetExchangeKlinesHourErrors[keyof GetExchangeKlinesHourErrors];
+type GetExchangeKlinesHourResponses = {
+    /**
+     * One hour of klines for the instrument. `Content-Type` is
+     * `application/vnd.lastra` by default or
+     * `application/vnd.apache.parquet` when `format=parquet`.
+     *
+     */
+    200: Blob | File;
+};
+type GetExchangeKlinesHourResponse = GetExchangeKlinesHourResponses[keyof GetExchangeKlinesHourResponses];
 type PostStrategyData = {
     /**
      * Raw strategy Java source code
@@ -335,6 +455,15 @@ type PrepareBacktestingData = {
          *
          */
         to: string;
+        /**
+         * 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`.
+         *
+         */
+        cadence?: '1s' | '5s' | '1m' | '5m' | '15m' | '1h' | '4h' | '1d';
     };
     path: {
         /**
@@ -556,6 +685,52 @@ declare const getExchanges: <ThrowOnError extends boolean = false>(options?: Opt
  * Get a list of Instruments from a specific exchange
  */
 declare const getInstruments: <ThrowOnError extends boolean = false>(options: Options<GetInstrumentsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<InstrumentDetail[], ResponseError, ThrowOnError>;
+/**
+ * Download one hour of tickers for an instrument as a Lastra segment
+ * Serves exactly one hour of raw ticker data for the given instrument on the
+ * requested exchange. The payload is a native [Lastra](https://github.com/QTSurfer/lastra-java)
+ * file — QTSurfer's columnar format for tick-precision timeseries — with
+ * no JSON envelope.
+ *
+ * One segment = one hour, aligned to UTC. The `hour` query parameter selects
+ * the segment and must match `YYYY-MM-DDTHH` (no minutes/seconds, no timezone
+ * suffix). Example: `hour=2026-01-15T10` returns `h10.lastra` for
+ * 2026-01-15, covering `[10:00:00Z, 11:00:00Z)`. Hours not yet available
+ * return `404`.
+ *
+ * A `format=parquet` query parameter switches the response to on-the-fly
+ * Parquet conversion via [lastra-convert](https://github.com/QTSurfer/lastra-convert)
+ * for clients that don't yet read Lastra. Lastra is the primary format
+ * and cheaper when the client can consume it.
+ *
+ * Clients:
+ * - [lastra-java](https://github.com/QTSurfer/lastra-java) — reference
+ * Java reader/writer with per-column codecs (ALP, Gorilla, delta-varint,
+ * ZSTD) and CRC32 integrity.
+ * - [lastra-ts](https://github.com/QTSurfer/lastra-ts) — TypeScript reader
+ * (~4 kB bundle, browser + Node.js).
+ * - [duckdb-lastra](https://github.com/QTSurfer/duckdb-lastra) — DuckDB
+ * extension for ad-hoc SQL over Lastra files.
+ * - [lastra-convert](https://github.com/QTSurfer/lastra-convert) — CLI + Java
+ * API for converting to/from Parquet, Reef, and CSV.
+ * - `curl -OJ` for offline dumps (the `Content-Disposition` header sets a
+ * descriptive filename).
+ *
+ */
+declare const getExchangeTickersHour: <ThrowOnError extends boolean = false>(options: Options<GetExchangeTickersHourData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<Blob | File, ResponseError, ThrowOnError>;
+/**
+ * Download one hour of klines for an instrument as a Lastra segment
+ * Same shape and semantics as `/exchange/{exchangeId}/tickers/{base}/{quote}`,
+ * but serves klines (aggregated bars) instead of raw ticks. One
+ * [Lastra](https://github.com/QTSurfer/lastra-java) segment = one hour of
+ * klines at the exchange's native kline cadence, aligned to UTC.
+ *
+ * Klines use the same columnar layout as tickers — readers that handle one
+ * format read the other with the same code. Use this endpoint when a
+ * per-tick payload would be too large for the window of interest.
+ *
+ */
+declare const getExchangeKlinesHour: <ThrowOnError extends boolean = false>(options: Options<GetExchangeKlinesHourData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<Blob | File, ResponseError, ThrowOnError>;
 /**
  * Compile a strategy from source code
  * Submits raw strategy source for compilation. By default the call is synchronous and returns
@@ -633,4 +808,4 @@ declare const getExecutionResult: <ThrowOnError extends boolean = false>(options
 
 declare const client: _hey_api_client_fetch.Client;
 
-export { type AcceptedJob, type BacktestJobResult, type CancelExecutionData, type CancelExecutionError, type CancelExecutionErrors, type CancelExecutionResponse, type CancelExecutionResponses, type ClientOptions, type DataSourceType, type Exchange, type ExecuteBacktestingData, type ExecuteBacktestingError, type ExecuteBacktestingErrors, type ExecuteBacktestingResponse, type ExecuteBacktestingResponses, type GetExchangesData, type GetExchangesResponse, type GetExchangesResponses, type GetExecutionResultData, type GetExecutionResultError, type GetExecutionResultErrors, type GetExecutionResultResponse, type GetExecutionResultResponses, type GetInstrumentsData, type GetInstrumentsError, type GetInstrumentsErrors, type GetInstrumentsResponse, type GetInstrumentsResponses, type GetPreparationStatusData, type GetPreparationStatusError, type GetPreparationStatusErrors, type GetPreparationStatusResponse, type GetPreparationStatusResponses, type GetStrategyStatusData, type GetStrategyStatusError, type GetStrategyStatusErrors, type GetStrategyStatusResponse, type GetStrategyStatusResponses, type Instrument, type InstrumentDetail, type JobState, type Options, type PostStrategyData, type PostStrategyError, type PostStrategyErrors, type PostStrategyResponse, type PostStrategyResponses, type PrepareBacktestingData, type PrepareBacktestingError, type PrepareBacktestingErrors, type PrepareBacktestingResponse, type PrepareBacktestingResponses, type ResponseError, type ResultMap, type StrategyId, cancelExecution, client, executeBacktesting, getExchanges, getExecutionResult, getInstruments, getPreparationStatus, getStrategyStatus, postStrategy, prepareBacktesting };
+export { type AcceptedJob, type BacktestJobResult, type CancelExecutionData, type CancelExecutionError, type CancelExecutionErrors, type CancelExecutionResponse, type CancelExecutionResponses, type ClientOptions, type DataSourceType, type Exchange, type ExecuteBacktestingData, type ExecuteBacktestingError, type ExecuteBacktestingErrors, type ExecuteBacktestingResponse, type ExecuteBacktestingResponses, type GetExchangeKlinesHourData, type GetExchangeKlinesHourError, type GetExchangeKlinesHourErrors, type GetExchangeKlinesHourResponse, type GetExchangeKlinesHourResponses, type GetExchangeTickersHourData, type GetExchangeTickersHourError, type GetExchangeTickersHourErrors, type GetExchangeTickersHourResponse, type GetExchangeTickersHourResponses, type GetExchangesData, type GetExchangesResponse, type GetExchangesResponses, type GetExecutionResultData, type GetExecutionResultError, type GetExecutionResultErrors, type GetExecutionResultResponse, type GetExecutionResultResponses, type GetInstrumentsData, type GetInstrumentsError, type GetInstrumentsErrors, type GetInstrumentsResponse, type GetInstrumentsResponses, type GetPreparationStatusData, type GetPreparationStatusError, type GetPreparationStatusErrors, type GetPreparationStatusResponse, type GetPreparationStatusResponses, type GetStrategyStatusData, type GetStrategyStatusError, type GetStrategyStatusErrors, type GetStrategyStatusResponse, type GetStrategyStatusResponses, type Instrument, type InstrumentDetail, type JobState, type Options, type PostStrategyData, type PostStrategyError, type PostStrategyErrors, type PostStrategyResponse, type PostStrategyResponses, type PrepareBacktestingData, type PrepareBacktestingError, type PrepareBacktestingErrors, type PrepareBacktestingResponse, type PrepareBacktestingResponses, type ResponseError, type ResultMap, type StrategyId, cancelExecution, client, executeBacktesting, getExchangeKlinesHour, getExchangeTickersHour, getExchanges, getExecutionResult, getInstruments, getPreparationStatus, getStrategyStatus, postStrategy, prepareBacktesting };

package/dist/index.js

@@ -17,6 +17,18 @@ var getInstruments = (options) => {
     ...options
   });
 };
+var getExchangeTickersHour = (options) => {
+  return (options.client ?? client).get({
+    url: "/exchange/{exchangeId}/tickers/{base}/{quote}",
+    ...options
+  });
+};
+var getExchangeKlinesHour = (options) => {
+  return (options.client ?? client).get({
+    url: "/exchange/{exchangeId}/klines/{base}/{quote}",
+    ...options
+  });
+};
 var postStrategy = (options) => {
   return (options.client ?? client).post({
     bodySerializer: null,
@@ -118,6 +130,8 @@ export {
   cancelExecution,
   client,
   executeBacktesting,
+  getExchangeKlinesHour,
+  getExchangeTickersHour,
   getExchanges,
   getExecutionResult,
   getInstruments,

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 { type Config, type ClientOptions as DefaultClientOptions, createClient, createConfig } 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> = (override?: Config<DefaultClientOptions & T>) => Config<Required<DefaultClientOptions> & T>;\n\nexport const client = createClient(createConfig<ClientOptions>({\n    baseUrl: 'https://api.staging.qtsurfer.com/v1'\n}));","// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';\nimport type { GetExchangesData, GetExchangesResponse, GetInstrumentsData, GetInstrumentsResponse, GetInstrumentsError, PostStrategyData, PostStrategyResponse, PostStrategyError, GetStrategyStatusData, GetStrategyStatusResponse, GetStrategyStatusError, PrepareBacktestingData, PrepareBacktestingResponse, PrepareBacktestingError, GetPreparationStatusData, GetPreparationStatusResponse, GetPreparationStatusError, ExecuteBacktestingData, ExecuteBacktestingResponse, ExecuteBacktestingError, CancelExecutionData, CancelExecutionResponse, CancelExecutionError, GetExecutionResultData, GetExecutionResultResponse, GetExecutionResultError } from './types.gen';\nimport { client as _heyApiClient } from './client.gen';\n\nexport type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = 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 * Get a list of available exchanges\n */\nexport const getExchanges = <ThrowOnError extends boolean = false>(options?: Options<GetExchangesData, ThrowOnError>) => {\n    return (options?.client ?? _heyApiClient).get<GetExchangesResponse, unknown, ThrowOnError>({\n        url: '/exchanges',\n        ...options\n    });\n};\n\n/**\n * Get a list of Instruments from a specific exchange\n */\nexport const getInstruments = <ThrowOnError extends boolean = false>(options: Options<GetInstrumentsData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetInstrumentsResponse, GetInstrumentsError, ThrowOnError>({\n        url: '/exchange/{exchangeId}/instruments',\n        ...options\n    });\n};\n\n/**\n * Compile a strategy from source code\n * Submits raw strategy source for compilation. By default the call is synchronous and returns\n * the `strategyId` once compilation succeeds. Set the header `X-Compile-Async: true` to enqueue\n * the compile task and return immediately with a `jobId` — poll\n * `GET /strategy/{strategyId}` to check status.\n *\n * The `strategyId` is deterministic: the same source for the same user always produces the\n * same id.\n *\n */\nexport const postStrategy = <ThrowOnError extends boolean = false>(options: Options<PostStrategyData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).post<PostStrategyResponse, PostStrategyError, ThrowOnError>({\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 * Get the status of an async compile task\n * Polls the status of a strategy compilation. Useful when the strategy was submitted with\n * `X-Compile-Async: true`. Returns the resolved `strategyId` once compilation completes.\n *\n */\nexport const getStrategyStatus = <ThrowOnError extends boolean = false>(options: Options<GetStrategyStatusData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetStrategyStatusResponse, GetStrategyStatusError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/strategy/{strategyId}',\n        ...options\n    });\n};\n\n/**\n * Prepare backtesting 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 */\nexport const prepareBacktesting = <ThrowOnError extends boolean = false>(options: Options<PrepareBacktestingData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).post<PrepareBacktestingResponse, PrepareBacktestingError, ThrowOnError>({\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 */\nexport const getPreparationStatus = <ThrowOnError extends boolean = false>(options: Options<GetPreparationStatusData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetPreparationStatusResponse, GetPreparationStatusError, ThrowOnError>({\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 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 * The same params (same `prepareJobId`, `strategyId`, `storeSignals`) always return the same\n * `jobId` (idempotent).\n *\n */\nexport const executeBacktesting = <ThrowOnError extends boolean = false>(options: Options<ExecuteBacktestingData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).post<ExecuteBacktestingResponse, ExecuteBacktestingError, ThrowOnError>({\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 cancelExecution = <ThrowOnError extends boolean = false>(options: Options<CancelExecutionData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).delete<CancelExecutionResponse, CancelExecutionError, ThrowOnError>({\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 */\nexport const getExecutionResult = <ThrowOnError extends boolean = false>(options: Options<GetExecutionResultData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetExecutionResultResponse, GetExecutionResultError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/backtest/{exchangeId}/{type}/execute/{jobId}',\n        ...options\n    });\n};"],"mappings":";AAGA,SAAkE,cAAc,oBAAoB;AAY7F,IAAM,SAAS,aAAa,aAA4B;AAAA,EAC3D,SAAS;AACb,CAAC,CAAC;;;ACMK,IAAM,eAAe,CAAuC,YAAsD;AACrH,UAAQ,SAAS,UAAU,QAAe,IAAiD;AAAA,IACvF,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAKO,IAAM,iBAAiB,CAAuC,YAAuD;AACxH,UAAQ,QAAQ,UAAU,QAAe,IAA+D;AAAA,IACpG,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAaO,IAAM,eAAe,CAAuC,YAAqD;AACpH,UAAQ,QAAQ,UAAU,QAAe,KAA4D;AAAA,IACjG,gBAAgB;AAAA,IAChB,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACL,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IAChB;AAAA,EACJ,CAAC;AACL;AAQO,IAAM,oBAAoB,CAAuC,YAA0D;AAC9H,UAAQ,QAAQ,UAAU,QAAe,IAAqE;AAAA,IAC1G,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAWO,IAAM,qBAAqB,CAAuC,YAA2D;AAChI,UAAQ,QAAQ,UAAU,QAAe,KAAwE;AAAA,IAC7G,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACL,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IAChB;AAAA,EACJ,CAAC;AACL;AAQO,IAAM,uBAAuB,CAAuC,YAA6D;AACpI,UAAQ,QAAQ,UAAU,QAAe,IAA2E;AAAA,IAChH,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAeO,IAAM,qBAAqB,CAAuC,YAA2D;AAChI,UAAQ,QAAQ,UAAU,QAAe,KAAwE;AAAA,IAC7G,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACL,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IAChB;AAAA,EACJ,CAAC;AACL;AAUO,IAAM,kBAAkB,CAAuC,YAAwD;AAC1H,UAAQ,QAAQ,UAAU,QAAe,OAAoE;AAAA,IACzG,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAQO,IAAM,qBAAqB,CAAuC,YAA2D;AAChI,UAAQ,QAAQ,UAAU,QAAe,IAAuE;AAAA,IAC5G,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;","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 { type Config, type ClientOptions as DefaultClientOptions, createClient, createConfig } 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> = (override?: Config<DefaultClientOptions & T>) => Config<Required<DefaultClientOptions> & T>;\n\nexport const client = createClient(createConfig<ClientOptions>({\n    baseUrl: 'https://api.staging.qtsurfer.com/v1'\n}));","// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';\nimport type { GetExchangesData, GetExchangesResponse, GetInstrumentsData, GetInstrumentsResponse, GetInstrumentsError, GetExchangeTickersHourData, GetExchangeTickersHourResponse, GetExchangeTickersHourError, GetExchangeKlinesHourData, GetExchangeKlinesHourResponse, GetExchangeKlinesHourError, PostStrategyData, PostStrategyResponse, PostStrategyError, GetStrategyStatusData, GetStrategyStatusResponse, GetStrategyStatusError, PrepareBacktestingData, PrepareBacktestingResponse, PrepareBacktestingError, GetPreparationStatusData, GetPreparationStatusResponse, GetPreparationStatusError, ExecuteBacktestingData, ExecuteBacktestingResponse, ExecuteBacktestingError, CancelExecutionData, CancelExecutionResponse, CancelExecutionError, GetExecutionResultData, GetExecutionResultResponse, GetExecutionResultError } from './types.gen';\nimport { client as _heyApiClient } from './client.gen';\n\nexport type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = 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 * Get a list of available exchanges\n */\nexport const getExchanges = <ThrowOnError extends boolean = false>(options?: Options<GetExchangesData, ThrowOnError>) => {\n    return (options?.client ?? _heyApiClient).get<GetExchangesResponse, unknown, ThrowOnError>({\n        url: '/exchanges',\n        ...options\n    });\n};\n\n/**\n * Get a list of Instruments from a specific exchange\n */\nexport const getInstruments = <ThrowOnError extends boolean = false>(options: Options<GetInstrumentsData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetInstrumentsResponse, GetInstrumentsError, ThrowOnError>({\n        url: '/exchange/{exchangeId}/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 getExchangeTickersHour = <ThrowOnError extends boolean = false>(options: Options<GetExchangeTickersHourData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetExchangeTickersHourResponse, GetExchangeTickersHourError, ThrowOnError>({\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 getExchangeKlinesHour = <ThrowOnError extends boolean = false>(options: Options<GetExchangeKlinesHourData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetExchangeKlinesHourResponse, GetExchangeKlinesHourError, ThrowOnError>({\n        url: '/exchange/{exchangeId}/klines/{base}/{quote}',\n        ...options\n    });\n};\n\n/**\n * Compile a strategy from source code\n * Submits raw strategy source for compilation. By default the call is synchronous and returns\n * the `strategyId` once compilation succeeds. Set the header `X-Compile-Async: true` to enqueue\n * the compile task and return immediately with a `jobId` — poll\n * `GET /strategy/{strategyId}` to check status.\n *\n * The `strategyId` is deterministic: the same source for the same user always produces the\n * same id.\n *\n */\nexport const postStrategy = <ThrowOnError extends boolean = false>(options: Options<PostStrategyData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).post<PostStrategyResponse, PostStrategyError, ThrowOnError>({\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 * Get the status of an async compile task\n * Polls the status of a strategy compilation. Useful when the strategy was submitted with\n * `X-Compile-Async: true`. Returns the resolved `strategyId` once compilation completes.\n *\n */\nexport const getStrategyStatus = <ThrowOnError extends boolean = false>(options: Options<GetStrategyStatusData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetStrategyStatusResponse, GetStrategyStatusError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/strategy/{strategyId}',\n        ...options\n    });\n};\n\n/**\n * Prepare backtesting 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 */\nexport const prepareBacktesting = <ThrowOnError extends boolean = false>(options: Options<PrepareBacktestingData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).post<PrepareBacktestingResponse, PrepareBacktestingError, ThrowOnError>({\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 */\nexport const getPreparationStatus = <ThrowOnError extends boolean = false>(options: Options<GetPreparationStatusData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetPreparationStatusResponse, GetPreparationStatusError, ThrowOnError>({\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 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 * The same params (same `prepareJobId`, `strategyId`, `storeSignals`) always return the same\n * `jobId` (idempotent).\n *\n */\nexport const executeBacktesting = <ThrowOnError extends boolean = false>(options: Options<ExecuteBacktestingData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).post<ExecuteBacktestingResponse, ExecuteBacktestingError, ThrowOnError>({\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 cancelExecution = <ThrowOnError extends boolean = false>(options: Options<CancelExecutionData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).delete<CancelExecutionResponse, CancelExecutionError, ThrowOnError>({\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 */\nexport const getExecutionResult = <ThrowOnError extends boolean = false>(options: Options<GetExecutionResultData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetExecutionResultResponse, GetExecutionResultError, ThrowOnError>({\n        security: [\n            {\n                scheme: 'bearer',\n                type: 'http'\n            }\n        ],\n        url: '/backtest/{exchangeId}/{type}/execute/{jobId}',\n        ...options\n    });\n};"],"mappings":";AAGA,SAAkE,cAAc,oBAAoB;AAY7F,IAAM,SAAS,aAAa,aAA4B;AAAA,EAC3D,SAAS;AACb,CAAC,CAAC;;;ACMK,IAAM,eAAe,CAAuC,YAAsD;AACrH,UAAQ,SAAS,UAAU,QAAe,IAAiD;AAAA,IACvF,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAKO,IAAM,iBAAiB,CAAuC,YAAuD;AACxH,UAAQ,QAAQ,UAAU,QAAe,IAA+D;AAAA,IACpG,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAkCO,IAAM,yBAAyB,CAAuC,YAA+D;AACxI,UAAQ,QAAQ,UAAU,QAAe,IAA+E;AAAA,IACpH,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAcO,IAAM,wBAAwB,CAAuC,YAA8D;AACtI,UAAQ,QAAQ,UAAU,QAAe,IAA6E;AAAA,IAClH,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAaO,IAAM,eAAe,CAAuC,YAAqD;AACpH,UAAQ,QAAQ,UAAU,QAAe,KAA4D;AAAA,IACjG,gBAAgB;AAAA,IAChB,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACL,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IAChB;AAAA,EACJ,CAAC;AACL;AAQO,IAAM,oBAAoB,CAAuC,YAA0D;AAC9H,UAAQ,QAAQ,UAAU,QAAe,IAAqE;AAAA,IAC1G,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAWO,IAAM,qBAAqB,CAAuC,YAA2D;AAChI,UAAQ,QAAQ,UAAU,QAAe,KAAwE;AAAA,IAC7G,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACL,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IAChB;AAAA,EACJ,CAAC;AACL;AAQO,IAAM,uBAAuB,CAAuC,YAA6D;AACpI,UAAQ,QAAQ,UAAU,QAAe,IAA2E;AAAA,IAChH,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAeO,IAAM,qBAAqB,CAAuC,YAA2D;AAChI,UAAQ,QAAQ,UAAU,QAAe,KAAwE;AAAA,IAC7G,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,IACH,SAAS;AAAA,MACL,gBAAgB;AAAA,MAChB,GAAG,SAAS;AAAA,IAChB;AAAA,EACJ,CAAC;AACL;AAUO,IAAM,kBAAkB,CAAuC,YAAwD;AAC1H,UAAQ,QAAQ,UAAU,QAAe,OAAoE;AAAA,IACzG,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;AAQO,IAAM,qBAAqB,CAAuC,YAA2D;AAChI,UAAQ,QAAQ,UAAU,QAAe,IAAuE;AAAA,IAC5G,UAAU;AAAA,MACN;AAAA,QACI,QAAQ;AAAA,QACR,MAAM;AAAA,MACV;AAAA,IACJ;AAAA,IACA,KAAK;AAAA,IACL,GAAG;AAAA,EACP,CAAC;AACL;","names":[]}

package/package.json

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

@@ -96,7 +96,7 @@ export const ExchangeSchema = {
 
 export const DataSourceTypeSchema = {
     type: 'string',
-    description: 'Managed exchange data sources available for backtesting. Currently only ticker is supported; kline and funding rate support is planned.',
+    description: 'Managed exchange data sources available for backtesting.',
     enum: ['ticker'],
     example: 'ticker'
 } as const;
@@ -108,13 +108,17 @@ export const JobStateSchema = {
     properties: {
         contextId: {
             type: 'string',
-            description: 'Unique context ID for the job',
-            example: 'jctx:ticker:4a627755-7f5a-4297-b647-8dddd8aee416:binance:1rabbrpk5r4kkegs83w6qr:btc/usdt:2o8heaioicr0edvx5ybcap'
+            description: 'Opaque context identifier for the job',
+            example: 'ctx_2o8heaioicr0edvx5ybcap'
         },
         status: {
             type: 'string',
-            description: 'Current status of the job',
-            enum: ['New', 'Started', 'Completed', 'Aborted', 'Failed'],
+            description: `Current status of the job. \`Partial\` (prepare only) means some
+hours are still being produced asynchronously — keep polling.
+Treat \`Completed | Aborted | Failed\` as terminal; anything else
+means keep polling.
+`,
+            enum: ['New', 'Started', 'Partial', 'Completed', 'Aborted', 'Failed'],
             example: 'Completed'
         },
         statusDetail: {
@@ -186,8 +190,8 @@ export const ResultMapSchema = {
     properties: {
         hostName: {
             type: 'string',
-            description: 'Hostname of the worker node that executed the strategy',
-            example: 'backtesting-job-worker-84b569dff9-dr4lb'
+            description: 'Identifier of the worker that executed the strategy. Useful when reporting issues so support can correlate with logs.',
+            example: 'executor10'
         },
         iops: {
             type: 'number',
@@ -197,8 +201,8 @@ export const ResultMapSchema = {
         },
         strategyId: {
             type: 'string',
-            description: 'Redis key of the compiled strategy used for execution. Format: strategy:{userId}:ticker:{compilationId}',
-            example: 'strategy:4a627755-7f5a-4297-b647-8dddd8aee416:ticker:2iyvtenlzh9dabqtxn7nbv'
+            description: 'Identifier of the compiled strategy that produced this result',
+            example: 'strategy:00000000-0000-0000-0000-000000000000:ticker:2iyvtenlzh9dabqtxn7nbv'
         },
         instrument: {
             type: 'string',
@@ -260,19 +264,19 @@ export const ResultMapSchema = {
         },
         signalsId: {
             type: 'string',
-            description: 'Storage key for the signal Parquet file. Format: {userId}/exec/{exchange}/{jobId}',
-            example: '4a627755-7f5a-4297-b647-8dddd8aee416/exec/binance/3vsndwikcuaatjmb83fjtl'
+            description: 'Storage key for the signals file. Treat as opaque; use signalsUrl to download.',
+            example: '00000000-0000-0000-0000-000000000000/exec/binance/3vsndwikcuaatjmb83fjtl'
         },
         signalsUrl: {
             type: 'string',
             format: 'uri',
-            description: 'Public HTTPS URL to the Parquet file. Computed at setup time from publicBaseUrl + signalsId + .parquet. Available even before upload completes.',
-            example: 'https://storage.qtsurfer.com/4a627755-7f5a-4297-b647-8dddd8aee416/exec/binance/3vsndwikcuaatjmb83fjtl.parquet'
+            description: "HTTPS URL to download the signals Parquet file. Use signalsUpload to know when it's ready.",
+            example: 'https://storage.qtsurfer.com/00000000-0000-0000-0000-000000000000/exec/binance/3vsndwikcuaatjmb83fjtl.parquet'
         },
         signalsUpload: {
             type: 'string',
             enum: ['Done', 'Failed', 'Skipped'],
-            description: 'Upload status. Done = file uploaded to R2. Failed = upload error (see signalsUploadReason). Skipped = no signals emitted or storage not configured.',
+            description: 'Upload status. Done = signal file is available at signalsUrl. Failed = upload error (see signalsUploadReason). Skipped = no signals emitted.',
             example: 'Done'
         },
         signalsUploadedAt: {
@@ -284,7 +288,7 @@ export const ResultMapSchema = {
         signalsUploadReason: {
             type: 'string',
             description: 'Human-readable reason when signalsUpload is Failed or Skipped.',
-            example: 'parquet file empty or missing after close'
+            example: 'signal file generation failed'
         }
     }
 } as const;

package/src/generated/sdk.gen.ts

@@ -1,7 +1,7 @@
 // This file is auto-generated by @hey-api/openapi-ts
 
 import type { Options as ClientOptions, TDataShape, Client } from '@hey-api/client-fetch';
-import type { GetExchangesData, GetExchangesResponse, GetInstrumentsData, GetInstrumentsResponse, GetInstrumentsError, PostStrategyData, PostStrategyResponse, PostStrategyError, GetStrategyStatusData, GetStrategyStatusResponse, GetStrategyStatusError, PrepareBacktestingData, PrepareBacktestingResponse, PrepareBacktestingError, GetPreparationStatusData, GetPreparationStatusResponse, GetPreparationStatusError, ExecuteBacktestingData, ExecuteBacktestingResponse, ExecuteBacktestingError, CancelExecutionData, CancelExecutionResponse, CancelExecutionError, GetExecutionResultData, GetExecutionResultResponse, GetExecutionResultError } from './types.gen';
+import type { GetExchangesData, GetExchangesResponse, GetInstrumentsData, GetInstrumentsResponse, GetInstrumentsError, GetExchangeTickersHourData, GetExchangeTickersHourResponse, GetExchangeTickersHourError, GetExchangeKlinesHourData, GetExchangeKlinesHourResponse, GetExchangeKlinesHourError, PostStrategyData, PostStrategyResponse, PostStrategyError, GetStrategyStatusData, GetStrategyStatusResponse, GetStrategyStatusError, PrepareBacktestingData, PrepareBacktestingResponse, PrepareBacktestingError, GetPreparationStatusData, GetPreparationStatusResponse, GetPreparationStatusError, ExecuteBacktestingData, ExecuteBacktestingResponse, ExecuteBacktestingError, CancelExecutionData, CancelExecutionResponse, CancelExecutionError, GetExecutionResultData, GetExecutionResultResponse, GetExecutionResultError } from './types.gen';
 import { client as _heyApiClient } from './client.gen';
 
 export type Options<TData extends TDataShape = TDataShape, ThrowOnError extends boolean = boolean> = ClientOptions<TData, ThrowOnError> & {
@@ -38,6 +38,64 @@ export const getInstruments = <ThrowOnError extends boolean = false>(options: Op
     });
 };
 
+/**
+ * Download one hour of tickers for an instrument as a Lastra segment
+ * Serves exactly one hour of raw ticker data for the given instrument on the
+ * requested exchange. The payload is a native [Lastra](https://github.com/QTSurfer/lastra-java)
+ * file — QTSurfer's columnar format for tick-precision timeseries — with
+ * no JSON envelope.
+ *
+ * One segment = one hour, aligned to UTC. The `hour` query parameter selects
+ * the segment and must match `YYYY-MM-DDTHH` (no minutes/seconds, no timezone
+ * suffix). Example: `hour=2026-01-15T10` returns `h10.lastra` for
+ * 2026-01-15, covering `[10:00:00Z, 11:00:00Z)`. Hours not yet available
+ * return `404`.
+ *
+ * A `format=parquet` query parameter switches the response to on-the-fly
+ * Parquet conversion via [lastra-convert](https://github.com/QTSurfer/lastra-convert)
+ * for clients that don't yet read Lastra. Lastra is the primary format
+ * and cheaper when the client can consume it.
+ *
+ * Clients:
+ * - [lastra-java](https://github.com/QTSurfer/lastra-java) — reference
+ * Java reader/writer with per-column codecs (ALP, Gorilla, delta-varint,
+ * ZSTD) and CRC32 integrity.
+ * - [lastra-ts](https://github.com/QTSurfer/lastra-ts) — TypeScript reader
+ * (~4 kB bundle, browser + Node.js).
+ * - [duckdb-lastra](https://github.com/QTSurfer/duckdb-lastra) — DuckDB
+ * extension for ad-hoc SQL over Lastra files.
+ * - [lastra-convert](https://github.com/QTSurfer/lastra-convert) — CLI + Java
+ * API for converting to/from Parquet, Reef, and CSV.
+ * - `curl -OJ` for offline dumps (the `Content-Disposition` header sets a
+ * descriptive filename).
+ *
+ */
+export const getExchangeTickersHour = <ThrowOnError extends boolean = false>(options: Options<GetExchangeTickersHourData, ThrowOnError>) => {
+    return (options.client ?? _heyApiClient).get<GetExchangeTickersHourResponse, GetExchangeTickersHourError, ThrowOnError>({
+        url: '/exchange/{exchangeId}/tickers/{base}/{quote}',
+        ...options
+    });
+};
+
+/**
+ * Download one hour of klines for an instrument as a Lastra segment
+ * Same shape and semantics as `/exchange/{exchangeId}/tickers/{base}/{quote}`,
+ * but serves klines (aggregated bars) instead of raw ticks. One
+ * [Lastra](https://github.com/QTSurfer/lastra-java) segment = one hour of
+ * klines at the exchange's native kline cadence, aligned to UTC.
+ *
+ * Klines use the same columnar layout as tickers — readers that handle one
+ * format read the other with the same code. Use this endpoint when a
+ * per-tick payload would be too large for the window of interest.
+ *
+ */
+export const getExchangeKlinesHour = <ThrowOnError extends boolean = false>(options: Options<GetExchangeKlinesHourData, ThrowOnError>) => {
+    return (options.client ?? _heyApiClient).get<GetExchangeKlinesHourResponse, GetExchangeKlinesHourError, ThrowOnError>({
+        url: '/exchange/{exchangeId}/klines/{base}/{quote}',
+        ...options
+    });
+};
+
 /**
  * Compile a strategy from source code
  * Submits raw strategy source for compilation. By default the call is synchronous and returns

package/src/generated/types.gen.ts

@@ -72,7 +72,7 @@ export type Exchange = {
 };
 
 /**
- * Managed exchange data sources available for backtesting. Currently only ticker is supported; kline and funding rate support is planned.
+ * Managed exchange data sources available for backtesting.
  */
 export type DataSourceType = 'ticker';
 
@@ -81,13 +81,17 @@ export type DataSourceType = 'ticker';
  */
 export type JobState = {
     /**
-     * Unique context ID for the job
+     * Opaque context identifier for the job
      */
     contextId: string;
     /**
-     * Current status of the job
+     * Current status of the job. `Partial` (prepare only) means some
+     * hours are still being produced asynchronously — keep polling.
+     * Treat `Completed | Aborted | Failed` as terminal; anything else
+     * means keep polling.
+     *
      */
-    status: 'New' | 'Started' | 'Completed' | 'Aborted' | 'Failed';
+    status: 'New' | 'Started' | 'Partial' | 'Completed' | 'Aborted' | 'Failed';
     /**
      * Detailed status information, if available
      */
@@ -135,7 +139,7 @@ export type BacktestJobResult = {
  */
 export type ResultMap = {
     /**
-     * Hostname of the worker node that executed the strategy
+     * Identifier of the worker that executed the strategy. Useful when reporting issues so support can correlate with logs.
      */
     hostName?: string;
     /**
@@ -143,7 +147,7 @@ export type ResultMap = {
      */
     iops?: number;
     /**
-     * Redis key of the compiled strategy used for execution. Format: strategy:{userId}:ticker:{compilationId}
+     * Identifier of the compiled strategy that produced this result
      */
     strategyId: string;
     /**
@@ -187,15 +191,15 @@ export type ResultMap = {
      */
     signalCount?: number;
     /**
-     * Storage key for the signal Parquet file. Format: {userId}/exec/{exchange}/{jobId}
+     * Storage key for the signals file. Treat as opaque; use signalsUrl to download.
      */
     signalsId?: string;
     /**
-     * Public HTTPS URL to the Parquet file. Computed at setup time from publicBaseUrl + signalsId + .parquet. Available even before upload completes.
+     * HTTPS URL to download the signals Parquet file. Use signalsUpload to know when it's ready.
      */
     signalsUrl?: string;
     /**
-     * Upload status. Done = file uploaded to R2. Failed = upload error (see signalsUploadReason). Skipped = no signals emitted or storage not configured.
+     * Upload status. Done = signal file is available at signalsUrl. Failed = upload error (see signalsUploadReason). Skipped = no signals emitted.
      */
     signalsUpload?: 'Done' | 'Failed' | 'Skipped';
     /**
@@ -259,6 +263,132 @@ export type GetInstrumentsResponses = {
 
 export type GetInstrumentsResponse = GetInstrumentsResponses[keyof GetInstrumentsResponses];
 
+export type GetExchangeTickersHourData = {
+    body?: never;
+    path: {
+        /**
+         * ID of the exchange (e.g. `binance`).
+         */
+        exchangeId: string;
+        /**
+         * Base asset symbol (first leg of the pair).
+         */
+        base: string;
+        /**
+         * Quote asset symbol (second leg of the pair).
+         */
+        quote: string;
+    };
+    query: {
+        /**
+         * Hour selector in `YYYY-MM-DDTHH` (UTC). The returned segment covers
+         * `[HH:00:00Z, HH+1:00:00Z)`.
+         *
+         */
+        hour: string;
+        /**
+         * Response wire format. `lastra` (default) returns raw Lastra bytes.
+         * `parquet` returns Parquet via on-the-fly conversion using
+         * [lastra-convert](https://github.com/QTSurfer/lastra-convert).
+         *
+         */
+        format?: 'lastra' | 'parquet';
+    };
+    url: '/exchange/{exchangeId}/tickers/{base}/{quote}';
+};
+
+export type GetExchangeTickersHourErrors = {
+    /**
+     * Missing or malformed parameters (e.g. `hour` not `YYYY-MM-DDTHH`).
+     */
+    400: ResponseError;
+    /**
+     * No Lastra segment exists for the requested instrument/hour.
+     */
+    404: ResponseError;
+    /**
+     * Unexpected I/O error serving the file.
+     */
+    500: ResponseError;
+};
+
+export type GetExchangeTickersHourError = GetExchangeTickersHourErrors[keyof GetExchangeTickersHourErrors];
+
+export type GetExchangeTickersHourResponses = {
+    /**
+     * One hour of tickers for the instrument. `Content-Type` is
+     * `application/vnd.lastra` by default or
+     * `application/vnd.apache.parquet` when `format=parquet` was
+     * requested.
+     *
+     */
+    200: Blob | File;
+};
+
+export type GetExchangeTickersHourResponse = GetExchangeTickersHourResponses[keyof GetExchangeTickersHourResponses];
+
+export type GetExchangeKlinesHourData = {
+    body?: never;
+    path: {
+        /**
+         * ID of the exchange (e.g. `binance`).
+         */
+        exchangeId: string;
+        /**
+         * Base asset symbol.
+         */
+        base: string;
+        /**
+         * Quote asset symbol.
+         */
+        quote: string;
+    };
+    query: {
+        /**
+         * Hour selector in `YYYY-MM-DDTHH` (UTC). The returned segment covers
+         * `[HH:00:00Z, HH+1:00:00Z)`.
+         *
+         */
+        hour: string;
+        /**
+         * Response wire format. `lastra` (default) returns raw Lastra bytes.
+         * `parquet` returns Parquet via on-the-fly conversion.
+         *
+         */
+        format?: 'lastra' | 'parquet';
+    };
+    url: '/exchange/{exchangeId}/klines/{base}/{quote}';
+};
+
+export type GetExchangeKlinesHourErrors = {
+    /**
+     * Missing or malformed parameters (e.g. `hour` not `YYYY-MM-DDTHH`).
+     */
+    400: ResponseError;
+    /**
+     * No Lastra segment exists for the requested instrument/hour.
+     */
+    404: ResponseError;
+    /**
+     * Unexpected I/O error serving the file.
+     */
+    500: ResponseError;
+};
+
+export type GetExchangeKlinesHourError = GetExchangeKlinesHourErrors[keyof GetExchangeKlinesHourErrors];
+
+export type GetExchangeKlinesHourResponses = {
+    /**
+     * One hour of klines for the instrument. `Content-Type` is
+     * `application/vnd.lastra` by default or
+     * `application/vnd.apache.parquet` when `format=parquet`.
+     *
+     */
+    200: Blob | File;
+};
+
+export type GetExchangeKlinesHourResponse = GetExchangeKlinesHourResponses[keyof GetExchangeKlinesHourResponses];
+
 export type PostStrategyData = {
     /**
      * Raw strategy Java source code
@@ -362,6 +492,15 @@ export type PrepareBacktestingData = {
          *
          */
         to: string;
+        /**
+         * 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`.
+         *
+         */
+        cadence?: '1s' | '5s' | '1m' | '5m' | '15m' | '1h' | '4h' | '1d';
     };
     path: {
         /**