@qtsurfer/api-client 0.1.0 → 0.1.2

package/dist/index.js

@@ -1,3 +1,143 @@
-export * from './generated';
-export { client } from './generated/client.gen';
+// src/generated/client.gen.ts
+import { createClient, createConfig } from "@hey-api/client-fetch";
+var client = createClient(createConfig({
+  baseUrl: "https://api.staging.qtsurfer.com/v1"
+}));
+
+// src/generated/sdk.gen.ts
+var getExchanges = (options) => {
+  return (options?.client ?? client).get({
+    url: "/exchanges",
+    ...options
+  });
+};
+var getInstruments = (options) => {
+  return (options.client ?? client).get({
+    url: "/exchange/{exchangeId}/instruments",
+    ...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,
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/strategy",
+    ...options,
+    headers: {
+      "Content-Type": "text/plain",
+      ...options?.headers
+    }
+  });
+};
+var getStrategyStatus = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/strategy/{strategyId}",
+    ...options
+  });
+};
+var prepareBacktesting = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/backtest/{exchangeId}/{type}/prepare",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var getPreparationStatus = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/backtest/{exchangeId}/{type}/prepare/{jobId}",
+    ...options
+  });
+};
+var executeBacktesting = (options) => {
+  return (options.client ?? client).post({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/backtest/{exchangeId}/{type}/execute",
+    ...options,
+    headers: {
+      "Content-Type": "application/json",
+      ...options?.headers
+    }
+  });
+};
+var cancelExecution = (options) => {
+  return (options.client ?? client).delete({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/backtest/{exchangeId}/{type}/execute/{jobId}",
+    ...options
+  });
+};
+var getExecutionResult = (options) => {
+  return (options.client ?? client).get({
+    security: [
+      {
+        scheme: "bearer",
+        type: "http"
+      }
+    ],
+    url: "/backtest/{exchangeId}/{type}/execute/{jobId}",
+    ...options
+  });
+};
+export {
+  cancelExecution,
+  client,
+  executeBacktesting,
+  getExchangeKlinesHour,
+  getExchangeTickersHour,
+  getExchanges,
+  getExecutionResult,
+  getInstruments,
+  getPreparationStatus,
+  getStrategyStatus,
+  postStrategy,
+  prepareBacktesting
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC"}
+{"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":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qtsurfer/api-client",
-  "version": "0.1.0",
+  "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",
@@ -20,7 +20,7 @@
   ],
   "scripts": {
     "generate": "openapi-ts",
-    "build": "tsc",
+    "build": "tsup",
     "lint": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },
@@ -48,6 +48,7 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "^0.66",
+    "tsup": "^8.5.1",
     "typescript": "^5.8.0"
   },
   "dependencies": {

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: {
         /**

package/dist/generated/client.gen.d.ts

@@ -1,13 +0,0 @@
-import type { ClientOptions } from './types.gen';
-import { type Config, type ClientOptions as DefaultClientOptions } from '@hey-api/client-fetch';
-/**
- * The `createClientConfig()` function will be called on client initialization
- * and the returned object will become the client's initial configuration.
- *
- * You may want to initialize your client this way instead of calling
- * `setConfig()`. This is useful for example if you're using Next.js
- * to ensure your client always has the correct values.
- */
-export type CreateClientConfig<T extends DefaultClientOptions = ClientOptions> = (override?: Config<DefaultClientOptions & T>) => Config<Required<DefaultClientOptions> & T>;
-export declare const client: import("@hey-api/client-fetch").Client;
-//# sourceMappingURL=client.gen.d.ts.map

package/dist/generated/client.gen.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.gen.d.ts","sourceRoot":"","sources":["../../src/generated/client.gen.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,IAAI,oBAAoB,EAA8B,MAAM,uBAAuB,CAAC;AAE5H;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,oBAAoB,GAAG,aAAa,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,oBAAoB,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;AAE7K,eAAO,MAAM,MAAM,wCAEhB,CAAC"}

package/dist/generated/client.gen.js

@@ -1,6 +0,0 @@
-// This file is auto-generated by @hey-api/openapi-ts
-import { createClient, createConfig } from '@hey-api/client-fetch';
-export const client = createClient(createConfig({
-    baseUrl: 'https://api.staging.qtsurfer.com/v1'
-}));
-//# sourceMappingURL=client.gen.js.map

package/dist/generated/client.gen.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.gen.js","sourceRoot":"","sources":["../../src/generated/client.gen.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAGrD,OAAO,EAA2D,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAY5H,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAgB;IAC3D,OAAO,EAAE,qCAAqC;CACjD,CAAC,CAAC,CAAC"}

package/dist/generated/index.d.ts

@@ -1,3 +0,0 @@
-export * from './types.gen';
-export * from './sdk.gen';
-//# sourceMappingURL=index.d.ts.map

package/dist/generated/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}

package/dist/generated/index.js

@@ -1,4 +0,0 @@
-// This file is auto-generated by @hey-api/openapi-ts
-export * from './types.gen';
-export * from './sdk.gen';
-//# sourceMappingURL=index.js.map

package/dist/generated/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generated/index.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC"}