@qtsurfer/api-client 0.2.1 → 0.4.0

package/README.md

@@ -82,7 +82,7 @@ All operations are exported as standalone functions; every operation accepts an
 | `cancelExecution` | POST | `/backtesting/execute/{jobId}/cancel` | Cancel a running execution |
 | `getExecutionResult` | GET | `/backtesting/execute/{jobId}` | Poll or fetch execution results |
 
-All generated types (`Exchange`, `InstrumentDetail`, `BacktestJobResult`, `ResultMap`, etc.) are re-exported from the root.
+All generated types (`Exchange`, `InstrumentDetail`, `BacktestJobResult`, `PrepareJobState`, `ResultMap`, etc.) are re-exported from the root.
 
 ## Configuring the client
 

package/dist/index.d.ts

@@ -19,7 +19,65 @@ type ResponseError = {
  */
 type Instrument = string;
 /**
- * Exchange instrument with data availability and market info
+ * HAL-style response envelope for the instruments listing
+ */
+type InstrumentListResponse = {
+    /**
+     * The list of instruments for the segment
+     */
+    data: Array<InstrumentDetail>;
+    meta: InstrumentListMeta;
+    _links: InstrumentLinks;
+};
+/**
+ * Metadata describing the instruments listing
+ */
+type InstrumentListMeta = {
+    /**
+     * When this listing was last refreshed
+     */
+    updatedAt: string;
+    /**
+     * The exchange the instruments belong to
+     */
+    exchange: string;
+    /**
+     * The market segment served in `data`
+     */
+    segment: 'spot' | 'futures';
+};
+/**
+ * HAL `_links` — segment discovery for the instruments listing
+ */
+type InstrumentLinks = {
+    /**
+     * Link to this listing
+     */
+    self: HalLink;
+    /**
+     * Link to the spot instruments listing. Present when the exchange has a spot segment.
+     */
+    spot?: HalLink;
+    /**
+     * Link to the futures instruments listing. Present only when the exchange has a futures segment.
+     */
+    futures?: HalLink;
+};
+/**
+ * A HAL link object (Hypertext Application Language)
+ */
+type HalLink = {
+    /**
+     * The link target as an absolute-path URI reference (resolve against the API base). A URI Template (RFC 6570) when `templated` is true.
+     */
+    href: string;
+    /**
+     * True when `href` is an RFC 6570 URI Template.
+     */
+    templated?: boolean;
+};
+/**
+ * Exchange instrument with per-data-type coverage and market info
  */
 type InstrumentDetail = {
     /**
@@ -34,14 +92,7 @@ type InstrumentDetail = {
      * Quote currency
      */
     quote: string;
-    /**
-     * Earliest timestamp with quality-verified data available for backtesting
-     */
-    dataFrom?: string;
-    /**
-     * Latest timestamp with quality-verified data available for backtesting
-     */
-    dataTo?: string;
+    coverage?: InstrumentCoverage;
     /**
      * Last traded price
      */
@@ -51,6 +102,36 @@ type InstrumentDetail = {
      */
     volume24h?: number;
 };
+/**
+ * Time coverage of available data for this instrument, per data type
+ */
+type InstrumentCoverage = {
+    /**
+     * Coverage of ticker data
+     */
+    tickers?: CoverageWindow;
+    /**
+     * Coverage of kline (candlestick) data
+     */
+    klines?: CoverageWindow;
+};
+/**
+ * The time range of available data for a single data type
+ */
+type CoverageWindow = {
+    /**
+     * Earliest timestamp with data available
+     */
+    from?: string;
+    /**
+     * Latest timestamp with data available
+     */
+    to?: string;
+    /**
+     * If the instrument stopped producing this data type (delisted/inactive), the timestamp it went inactive. Optional — omitted while the instrument is active.
+     */
+    inactiveSince?: string;
+};
 /**
  * Exchange service provider
  */
@@ -81,13 +162,13 @@ type JobState = {
      */
     contextId: string;
     /**
-     * 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.
+     * Current status of the job. Treat `Completed | Aborted | Failed` as
+     * terminal; `New | Started` mean keep polling. A single-instrument prepare
+     * is always terminal (`Completed`) — decide from
+     * `PrepareJobState.coverageRatio`, not by polling.
      *
      */
-    status: 'New' | 'Started' | 'Partial' | 'Completed' | 'Aborted' | 'Failed';
+    status: 'New' | 'Started' | 'Completed' | 'Aborted' | 'Failed';
     /**
      * Detailed status information, if available
      */
@@ -109,6 +190,61 @@ type JobState = {
      */
     endTime?: string | null;
 };
+/**
+ * State of a single-instrument prepare job — the `JobState` shape plus a per-hour
+ * data-coverage summary. A single-instrument prepare is always terminal
+ * (`status: Completed`): the client decides what to do from `coverageRatio` (e.g.
+ * execute if it is at or above a chosen threshold) rather than polling for missing
+ * hours that may never arrive — a missing hour for one instrument usually means low
+ * activity, not missing data.
+ *
+ */
+type PrepareJobState = JobState & {
+    /**
+     * Start of the available data range for the prepared instrument.
+     */
+    dataFrom?: string | null;
+    /**
+     * End of the available data range for the prepared instrument.
+     */
+    dataTo?: string | null;
+    /**
+     * `hoursWithData / totalHours` in `[0,1]` (`1.0` when `totalHours` is 0) — the
+     * fraction of hours in the requested range that have served data.
+     *
+     */
+    coverageRatio?: number;
+    /**
+     * Number of whole hours in the requested prepare range.
+     */
+    totalHours?: number;
+    /**
+     * Number of hours in the range that have data.
+     */
+    hoursWithData?: number;
+    /**
+     * One entry per hour in the range that has no data, with a rationale.
+     */
+    hoursWithoutData?: Array<{
+        /**
+         * The hour (UTC, hour-aligned) that has no data.
+         */
+        hour?: string;
+        /**
+         * Expected row count for the hour (currently always 0; reserved for
+         * future use). The rationale never depends on it.
+         *
+         */
+        expected?: number;
+        /**
+         * Why the hour has no data. `pending_conversion`: data for this hour is
+         * still being produced — a re-poll may fill it. `low_activity`: the
+         * instrument did not trade that hour. `unknown`: no data to classify by.
+         *
+         */
+        rationale?: 'pending_conversion' | 'low_activity' | 'unknown';
+    }>;
+};
 /**
  * Response returned by async endpoints (`202 Accepted`). The `jobId` is deterministic for the
  * same input parameters — repeated calls with identical params return the same id.
@@ -321,11 +457,40 @@ type GetInstrumentsErrors = {
 type GetInstrumentsError = GetInstrumentsErrors[keyof GetInstrumentsErrors];
 type GetInstrumentsResponses = {
     /**
-     * A JSON array of Instrument details with data availability
+     * The default (spot) segment's instruments in `data`, `meta`, and HAL `_links` (self + spot/futures segment discovery)
      */
-    200: Array<InstrumentDetail>;
+    200: InstrumentListResponse;
 };
 type GetInstrumentsResponse = GetInstrumentsResponses[keyof GetInstrumentsResponses];
+type GetSegmentInstrumentsData = {
+    body?: never;
+    path: {
+        /**
+         * ID of the exchange to retrieve instruments for
+         */
+        exchangeId: string;
+        /**
+         * Market segment to list instruments for
+         */
+        segment: 'spot' | 'futures';
+    };
+    query?: never;
+    url: '/exchange/{exchangeId}/{segment}/instruments';
+};
+type GetSegmentInstrumentsErrors = {
+    /**
+     * Exchange, segment, or instrument catalog not found
+     */
+    404: ResponseError;
+};
+type GetSegmentInstrumentsError = GetSegmentInstrumentsErrors[keyof GetSegmentInstrumentsErrors];
+type GetSegmentInstrumentsResponses = {
+    /**
+     * An object with a `data` array of instrument details (each with per-data-type coverage) and a `meta` block
+     */
+    200: InstrumentListResponse;
+};
+type GetSegmentInstrumentsResponse = GetSegmentInstrumentsResponses[keyof GetSegmentInstrumentsResponses];
 type GetExchangeTickersHourData = {
     body?: never;
     path: {
@@ -618,7 +783,7 @@ type GetPreparationStatusResponses = {
     /**
      * Current prepare job state
      */
-    200: JobState;
+    200: PrepareJobState;
 };
 type GetPreparationStatusResponse = GetPreparationStatusResponses[keyof GetPreparationStatusResponses];
 type ExecuteBacktestingData = {
@@ -775,9 +940,23 @@ declare const auth: <ThrowOnError extends boolean = false>(options?: Options<Aut
  */
 declare const getExchanges: <ThrowOnError extends boolean = false>(options?: Options<GetExchangesData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<Exchange[], unknown, ThrowOnError>;
 /**
- * Get a list of Instruments from a specific exchange
+ * Get an exchange's instruments (default spot segment)
+ * "Give me binance instruments" — returns the exchange's DEFAULT segment (`spot`)
+ * in `data`, each instrument with per-data-type coverage and market info. `meta`
+ * confirms the served `segment` (`spot`); HAL `_links` carry `self` plus the
+ * `spot` / `futures` segment-discovery links.
+ *
+ */
+declare const getInstruments: <ThrowOnError extends boolean = false>(options: Options<GetInstrumentsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<InstrumentListResponse, ResponseError, ThrowOnError>;
+/**
+ * Get the instruments for a specific exchange segment
+ * Returns the instruments for one market segment of the exchange, each with
+ * per-data-type coverage and market info. HAL `_links` carry `self` plus the
+ * `spot` / `futures` segment-discovery links; the default-segment shortcut is
+ * `GET /exchange/{exchangeId}/instruments` (spot).
+ *
  */
-declare const getInstruments: <ThrowOnError extends boolean = false>(options: Options<GetInstrumentsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<InstrumentDetail[], ResponseError, ThrowOnError>;
+declare const getSegmentInstruments: <ThrowOnError extends boolean = false>(options: Options<GetSegmentInstrumentsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<InstrumentListResponse, 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
@@ -864,7 +1043,7 @@ declare const prepareBacktesting: <ThrowOnError extends boolean = false>(options
  * Poll until `status` is `Completed`, `Failed`, or `Aborted`.
  *
  */
-declare const getPreparationStatus: <ThrowOnError extends boolean = false>(options: Options<GetPreparationStatusData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<JobState, ResponseError, ThrowOnError>;
+declare const getPreparationStatus: <ThrowOnError extends boolean = false>(options: Options<GetPreparationStatusData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<PrepareJobState, ResponseError, ThrowOnError>;
 /**
  * Execute a compiled strategy against a prepared dataset
  * Enqueues an execute task that runs the strategy identified by `strategyId` over the data
@@ -901,4 +1080,4 @@ declare const getExecutionResult: <ThrowOnError extends boolean = false>(options
 
 declare const client: _hey_api_client_fetch.Client;
 
-export { type AcceptedJob, type AuthData, type AuthError, type AuthErrors, type AuthResponse, type AuthResponses, type AuthTokenError, type AuthTokenResponse, type BacktestJobResult, type CancelExecutionData, type CancelExecutionError, type CancelExecutionErrors, type CancelExecutionResponse, type CancelExecutionResponses, type ClientOptions, type DataSourceType, type EquityPoint, 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, auth, cancelExecution, client, executeBacktesting, getExchangeKlinesHour, getExchangeTickersHour, getExchanges, getExecutionResult, getInstruments, getPreparationStatus, getStrategyStatus, postStrategy, prepareBacktesting };
+export { type AcceptedJob, type AuthData, type AuthError, type AuthErrors, type AuthResponse, type AuthResponses, type AuthTokenError, type AuthTokenResponse, type BacktestJobResult, type CancelExecutionData, type CancelExecutionError, type CancelExecutionErrors, type CancelExecutionResponse, type CancelExecutionResponses, type ClientOptions, type CoverageWindow, type DataSourceType, type EquityPoint, 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 GetSegmentInstrumentsData, type GetSegmentInstrumentsError, type GetSegmentInstrumentsErrors, type GetSegmentInstrumentsResponse, type GetSegmentInstrumentsResponses, type GetStrategyStatusData, type GetStrategyStatusError, type GetStrategyStatusErrors, type GetStrategyStatusResponse, type GetStrategyStatusResponses, type HalLink, type Instrument, type InstrumentCoverage, type InstrumentDetail, type InstrumentLinks, type InstrumentListMeta, type InstrumentListResponse, 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 PrepareJobState, type ResponseError, type ResultMap, type StrategyId, auth, cancelExecution, client, executeBacktesting, getExchangeKlinesHour, getExchangeTickersHour, getExchanges, getExecutionResult, getInstruments, getPreparationStatus, getSegmentInstruments, getStrategyStatus, postStrategy, prepareBacktesting };

package/dist/index.js

@@ -29,6 +29,12 @@ var getInstruments = (options) => {
     ...options
   });
 };
+var getSegmentInstruments = (options) => {
+  return (options.client ?? client).get({
+    url: "/exchange/{exchangeId}/{segment}/instruments",
+    ...options
+  });
+};
 var getExchangeTickersHour = (options) => {
   return (options.client ?? client).get({
     url: "/exchange/{exchangeId}/tickers/{base}/{quote}",
@@ -149,6 +155,7 @@ export {
   getExecutionResult,
   getInstruments,
   getPreparationStatus,
+  getSegmentInstruments,
   getStrategyStatus,
   postStrategy,
   prepareBacktesting

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 { AuthData, AuthResponse, AuthError, 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 * Exchange API key for a short-lived JWT\n * Exchanges a long-lived API key for a short-lived JWT used by every other\n * endpoint. This is the only endpoint that accepts an API key directly —\n * callers should obtain a JWT here, then send it as `Authorization: Bearer\n * <token>` to all other operations.\n *\n * The returned JWT carries the caller's subscription `tier` as a claim and\n * expires after `expires_in` seconds. Callers should refresh the token\n * before expiry (or on a `401` response) by calling this endpoint again.\n *\n */\nexport const auth = <ThrowOnError extends boolean = false>(options?: Options<AuthData, ThrowOnError>) => {\n    return (options?.client ?? _heyApiClient).post<AuthResponse, AuthError, ThrowOnError>({\n        security: [\n            {\n                name: 'X-API-Key',\n                type: 'apiKey'\n            }\n        ],\n        url: '/auth/token',\n        ...options\n    });\n};\n\n/**\n * Get 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":[]}
+{"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 { AuthData, AuthResponse, AuthError, GetExchangesData, GetExchangesResponse, GetInstrumentsData, GetInstrumentsResponse, GetInstrumentsError, GetSegmentInstrumentsData, GetSegmentInstrumentsResponse, GetSegmentInstrumentsError, 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 * Exchange API key for a short-lived JWT\n * Exchanges a long-lived API key for a short-lived JWT used by every other\n * endpoint. This is the only endpoint that accepts an API key directly —\n * callers should obtain a JWT here, then send it as `Authorization: Bearer\n * <token>` to all other operations.\n *\n * The returned JWT carries the caller's subscription `tier` as a claim and\n * expires after `expires_in` seconds. Callers should refresh the token\n * before expiry (or on a `401` response) by calling this endpoint again.\n *\n */\nexport const auth = <ThrowOnError extends boolean = false>(options?: Options<AuthData, ThrowOnError>) => {\n    return (options?.client ?? _heyApiClient).post<AuthResponse, AuthError, ThrowOnError>({\n        security: [\n            {\n                name: 'X-API-Key',\n                type: 'apiKey'\n            }\n        ],\n        url: '/auth/token',\n        ...options\n    });\n};\n\n/**\n * Get 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 an exchange's instruments (default spot segment)\n * \"Give me binance instruments\" — returns the exchange's DEFAULT segment (`spot`)\n * in `data`, each instrument with per-data-type coverage and market info. `meta`\n * confirms the served `segment` (`spot`); HAL `_links` carry `self` plus the\n * `spot` / `futures` segment-discovery links.\n *\n */\nexport const 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 * Get the instruments for a specific exchange segment\n * Returns the instruments for one market segment of the exchange, each with\n * per-data-type coverage and market info. HAL `_links` carry `self` plus the\n * `spot` / `futures` segment-discovery links; the default-segment shortcut is\n * `GET /exchange/{exchangeId}/instruments` (spot).\n *\n */\nexport const getSegmentInstruments = <ThrowOnError extends boolean = false>(options: Options<GetSegmentInstrumentsData, ThrowOnError>) => {\n    return (options.client ?? _heyApiClient).get<GetSegmentInstrumentsResponse, GetSegmentInstrumentsError, ThrowOnError>({\n        url: '/exchange/{exchangeId}/{segment}/instruments',\n        ...options\n    });\n};\n\n/**\n * Download one hour of tickers for an instrument as a Lastra segment\n * Serves exactly one hour of raw ticker data for the given instrument on the\n * requested exchange. The payload is a native [Lastra](https://github.com/QTSurfer/lastra-java)\n * file — QTSurfer's columnar format for tick-precision timeseries — with\n * no JSON envelope.\n *\n * One segment = one hour, aligned to UTC. The `hour` query parameter selects\n * the segment and must match `YYYY-MM-DDTHH` (no minutes/seconds, no timezone\n * suffix). Example: `hour=2026-01-15T10` returns `h10.lastra` for\n * 2026-01-15, covering `[10:00:00Z, 11:00:00Z)`. Hours not yet available\n * return `404`.\n *\n * A `format=parquet` query parameter switches the response to on-the-fly\n * Parquet conversion via [lastra-convert](https://github.com/QTSurfer/lastra-convert)\n * for clients that don't yet read Lastra. Lastra is the primary format\n * and cheaper when the client can consume it.\n *\n * Clients:\n * - [lastra-java](https://github.com/QTSurfer/lastra-java) — reference\n * Java reader/writer with per-column codecs (ALP, Gorilla, delta-varint,\n * ZSTD) and CRC32 integrity.\n * - [lastra-ts](https://github.com/QTSurfer/lastra-ts) — TypeScript reader\n * (~4 kB bundle, browser + Node.js).\n * - [duckdb-lastra](https://github.com/QTSurfer/duckdb-lastra) — DuckDB\n * extension for ad-hoc SQL over Lastra files.\n * - [lastra-convert](https://github.com/QTSurfer/lastra-convert) — CLI + Java\n * API for converting to/from Parquet, Reef, and CSV.\n * - `curl -OJ` for offline dumps (the `Content-Disposition` header sets a\n * descriptive filename).\n *\n */\nexport const 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.2.1",
+  "version": "0.4.0",
   "description": "Auto-generated TypeScript API client for the QTSurfer API (from OpenAPI 3.1 spec)",
   "type": "module",
   "main": "./dist/index.js",

package/src/generated/schemas.gen.ts

@@ -24,8 +24,105 @@ export const InstrumentSchema = {
     example: 'BTC/USDT'
 } as const;
 
+export const InstrumentListResponseSchema = {
+    description: 'HAL-style response envelope for the instruments listing',
+    type: 'object',
+    required: ['data', 'meta', '_links'],
+    properties: {
+        data: {
+            type: 'array',
+            description: 'The list of instruments for the segment',
+            items: {
+                '$ref': '#/components/schemas/InstrumentDetail'
+            }
+        },
+        meta: {
+            '$ref': '#/components/schemas/InstrumentListMeta'
+        },
+        _links: {
+            '$ref': '#/components/schemas/InstrumentLinks'
+        }
+    }
+} as const;
+
+export const InstrumentListMetaSchema = {
+    description: 'Metadata describing the instruments listing',
+    type: 'object',
+    required: ['updatedAt', 'exchange', 'segment'],
+    properties: {
+        updatedAt: {
+            type: 'string',
+            format: 'date-time',
+            description: 'When this listing was last refreshed',
+            example: '2026-07-09T19:09:07Z'
+        },
+        exchange: {
+            type: 'string',
+            description: 'The exchange the instruments belong to',
+            example: 'binance'
+        },
+        segment: {
+            type: 'string',
+            enum: ['spot', 'futures'],
+            description: 'The market segment served in `data`',
+            example: 'spot'
+        }
+    }
+} as const;
+
+export const InstrumentLinksSchema = {
+    description: 'HAL `_links` — segment discovery for the instruments listing',
+    type: 'object',
+    required: ['self'],
+    properties: {
+        self: {
+            allOf: [
+                {
+                    '$ref': '#/components/schemas/HalLink'
+                }
+            ],
+            description: 'Link to this listing'
+        },
+        spot: {
+            allOf: [
+                {
+                    '$ref': '#/components/schemas/HalLink'
+                }
+            ],
+            description: 'Link to the spot instruments listing. Present when the exchange has a spot segment.'
+        },
+        futures: {
+            allOf: [
+                {
+                    '$ref': '#/components/schemas/HalLink'
+                }
+            ],
+            description: 'Link to the futures instruments listing. Present only when the exchange has a futures segment.'
+        }
+    }
+} as const;
+
+export const HalLinkSchema = {
+    description: 'A HAL link object (Hypertext Application Language)',
+    type: 'object',
+    required: ['href'],
+    properties: {
+        href: {
+            type: 'string',
+            format: 'uri-reference',
+            description: 'The link target as an absolute-path URI reference (resolve against the API base). A URI Template (RFC 6570) when `templated` is true.',
+            example: '/v1/exchange/binance/spot/instruments'
+        },
+        templated: {
+            type: 'boolean',
+            description: 'True when `href` is an RFC 6570 URI Template.',
+            example: false
+        }
+    }
+} as const;
+
 export const InstrumentDetailSchema = {
-    description: 'Exchange instrument with data availability and market info',
+    description: 'Exchange instrument with per-data-type coverage and market info',
     type: 'object',
     required: ['id', 'base', 'quote'],
     properties: {
@@ -44,17 +141,8 @@ export const InstrumentDetailSchema = {
             description: 'Quote currency',
             example: 'USDT'
         },
-        dataFrom: {
-            type: 'string',
-            format: 'date-time',
-            description: 'Earliest timestamp with quality-verified data available for backtesting',
-            example: '2026-03-17T00:00:00Z'
-        },
-        dataTo: {
-            type: 'string',
-            format: 'date-time',
-            description: 'Latest timestamp with quality-verified data available for backtesting',
-            example: '2026-03-31T18:00:00Z'
+        coverage: {
+            '$ref': '#/components/schemas/InstrumentCoverage'
         },
         lastPrice: {
             type: 'number',
@@ -71,6 +159,54 @@ export const InstrumentDetailSchema = {
     }
 } as const;
 
+export const InstrumentCoverageSchema = {
+    description: 'Time coverage of available data for this instrument, per data type',
+    type: 'object',
+    properties: {
+        tickers: {
+            allOf: [
+                {
+                    '$ref': '#/components/schemas/CoverageWindow'
+                }
+            ],
+            description: 'Coverage of ticker data'
+        },
+        klines: {
+            allOf: [
+                {
+                    '$ref': '#/components/schemas/CoverageWindow'
+                }
+            ],
+            description: 'Coverage of kline (candlestick) data'
+        }
+    }
+} as const;
+
+export const CoverageWindowSchema = {
+    description: 'The time range of available data for a single data type',
+    type: 'object',
+    properties: {
+        from: {
+            type: 'string',
+            format: 'date-time',
+            description: 'Earliest timestamp with data available',
+            example: '2026-04-10T21:00:00Z'
+        },
+        to: {
+            type: 'string',
+            format: 'date-time',
+            description: 'Latest timestamp with data available',
+            example: '2026-07-09T20:31:08Z'
+        },
+        inactiveSince: {
+            type: 'string',
+            format: 'date-time',
+            description: 'If the instrument stopped producing this data type (delisted/inactive), the timestamp it went inactive. Optional — omitted while the instrument is active.',
+            example: '2026-06-30T12:00:00Z'
+        }
+    }
+} as const;
+
 export const ExchangeSchema = {
     description: 'Exchange service provider',
     type: 'object',
@@ -113,12 +249,12 @@ export const JobStateSchema = {
         },
         status: {
             type: 'string',
-            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.
+            description: `Current status of the job. Treat \`Completed | Aborted | Failed\` as
+terminal; \`New | Started\` mean keep polling. A single-instrument prepare
+is always terminal (\`Completed\`) — decide from
+\`PrepareJobState.coverageRatio\`, not by polling.
 `,
-            enum: ['New', 'Started', 'Partial', 'Completed', 'Aborted', 'Failed'],
+            enum: ['New', 'Started', 'Completed', 'Aborted', 'Failed'],
             example: 'Completed'
         },
         statusDetail: {
@@ -151,6 +287,89 @@ means keep polling.
     }
 } as const;
 
+export const PrepareJobStateSchema = {
+    description: `State of a single-instrument prepare job — the \`JobState\` shape plus a per-hour
+data-coverage summary. A single-instrument prepare is always terminal
+(\`status: Completed\`): the client decides what to do from \`coverageRatio\` (e.g.
+execute if it is at or above a chosen threshold) rather than polling for missing
+hours that may never arrive — a missing hour for one instrument usually means low
+activity, not missing data.
+`,
+    allOf: [
+        {
+            '$ref': '#/components/schemas/JobState'
+        },
+        {
+            type: 'object',
+            properties: {
+                dataFrom: {
+                    type: ['string', 'null'],
+                    format: 'date-time',
+                    description: 'Start of the available data range for the prepared instrument.',
+                    example: '2026-04-14T13:00:00Z'
+                },
+                dataTo: {
+                    type: ['string', 'null'],
+                    format: 'date-time',
+                    description: 'End of the available data range for the prepared instrument.',
+                    example: '2026-04-14T15:30:05Z'
+                },
+                coverageRatio: {
+                    type: 'number',
+                    format: 'double',
+                    minimum: 0,
+                    maximum: 1,
+                    description: `\`hoursWithData / totalHours\` in \`[0,1]\` (\`1.0\` when \`totalHours\` is 0) — the
+fraction of hours in the requested range that have served data.
+`,
+                    example: 0.994
+                },
+                totalHours: {
+                    type: 'integer',
+                    description: 'Number of whole hours in the requested prepare range.',
+                    example: 168
+                },
+                hoursWithData: {
+                    type: 'integer',
+                    description: 'Number of hours in the range that have data.',
+                    example: 167
+                },
+                hoursWithoutData: {
+                    type: 'array',
+                    description: 'One entry per hour in the range that has no data, with a rationale.',
+                    items: {
+                        type: 'object',
+                        properties: {
+                            hour: {
+                                type: 'string',
+                                format: 'date-time',
+                                description: 'The hour (UTC, hour-aligned) that has no data.',
+                                example: '2026-04-14T02:00:00Z'
+                            },
+                            expected: {
+                                type: 'integer',
+                                description: `Expected row count for the hour (currently always 0; reserved for
+future use). The rationale never depends on it.
+`,
+                                example: 0
+                            },
+                            rationale: {
+                                type: 'string',
+                                description: `Why the hour has no data. \`pending_conversion\`: data for this hour is
+still being produced — a re-poll may fill it. \`low_activity\`: the
+instrument did not trade that hour. \`unknown\`: no data to classify by.
+`,
+                                enum: ['pending_conversion', 'low_activity', 'unknown'],
+                                example: 'low_activity'
+                            }
+                        }
+                    }
+                }
+            }
+        }
+    ]
+} as const;
+
 export const AcceptedJobSchema = {
     type: 'object',
     description: `Response returned by async endpoints (\`202 Accepted\`). The \`jobId\` is deterministic for the

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 { AuthData, AuthResponse, AuthError, 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 type { AuthData, AuthResponse, AuthError, GetExchangesData, GetExchangesResponse, GetInstrumentsData, GetInstrumentsResponse, GetInstrumentsError, GetSegmentInstrumentsData, GetSegmentInstrumentsResponse, GetSegmentInstrumentsError, 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> & {
@@ -54,7 +54,12 @@ export const getExchanges = <ThrowOnError extends boolean = false>(options?: Opt
 };
 
 /**
- * Get a list of Instruments from a specific exchange
+ * Get an exchange's instruments (default spot segment)
+ * "Give me binance instruments" — returns the exchange's DEFAULT segment (`spot`)
+ * in `data`, each instrument with per-data-type coverage and market info. `meta`
+ * confirms the served `segment` (`spot`); HAL `_links` carry `self` plus the
+ * `spot` / `futures` segment-discovery links.
+ *
  */
 export const getInstruments = <ThrowOnError extends boolean = false>(options: Options<GetInstrumentsData, ThrowOnError>) => {
     return (options.client ?? _heyApiClient).get<GetInstrumentsResponse, GetInstrumentsError, ThrowOnError>({
@@ -63,6 +68,21 @@ export const getInstruments = <ThrowOnError extends boolean = false>(options: Op
     });
 };
 
+/**
+ * Get the instruments for a specific exchange segment
+ * Returns the instruments for one market segment of the exchange, each with
+ * per-data-type coverage and market info. HAL `_links` carry `self` plus the
+ * `spot` / `futures` segment-discovery links; the default-segment shortcut is
+ * `GET /exchange/{exchangeId}/instruments` (spot).
+ *
+ */
+export const getSegmentInstruments = <ThrowOnError extends boolean = false>(options: Options<GetSegmentInstrumentsData, ThrowOnError>) => {
+    return (options.client ?? _heyApiClient).get<GetSegmentInstrumentsResponse, GetSegmentInstrumentsError, ThrowOnError>({
+        url: '/exchange/{exchangeId}/{segment}/instruments',
+        ...options
+    });
+};
+
 /**
  * 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

package/src/generated/types.gen.ts

@@ -20,7 +20,69 @@ export type ResponseError = {
 export type Instrument = string;
 
 /**
- * Exchange instrument with data availability and market info
+ * HAL-style response envelope for the instruments listing
+ */
+export type InstrumentListResponse = {
+    /**
+     * The list of instruments for the segment
+     */
+    data: Array<InstrumentDetail>;
+    meta: InstrumentListMeta;
+    _links: InstrumentLinks;
+};
+
+/**
+ * Metadata describing the instruments listing
+ */
+export type InstrumentListMeta = {
+    /**
+     * When this listing was last refreshed
+     */
+    updatedAt: string;
+    /**
+     * The exchange the instruments belong to
+     */
+    exchange: string;
+    /**
+     * The market segment served in `data`
+     */
+    segment: 'spot' | 'futures';
+};
+
+/**
+ * HAL `_links` — segment discovery for the instruments listing
+ */
+export type InstrumentLinks = {
+    /**
+     * Link to this listing
+     */
+    self: HalLink;
+    /**
+     * Link to the spot instruments listing. Present when the exchange has a spot segment.
+     */
+    spot?: HalLink;
+    /**
+     * Link to the futures instruments listing. Present only when the exchange has a futures segment.
+     */
+    futures?: HalLink;
+};
+
+/**
+ * A HAL link object (Hypertext Application Language)
+ */
+export type HalLink = {
+    /**
+     * The link target as an absolute-path URI reference (resolve against the API base). A URI Template (RFC 6570) when `templated` is true.
+     */
+    href: string;
+    /**
+     * True when `href` is an RFC 6570 URI Template.
+     */
+    templated?: boolean;
+};
+
+/**
+ * Exchange instrument with per-data-type coverage and market info
  */
 export type InstrumentDetail = {
     /**
@@ -35,14 +97,7 @@ export type InstrumentDetail = {
      * Quote currency
      */
     quote: string;
-    /**
-     * Earliest timestamp with quality-verified data available for backtesting
-     */
-    dataFrom?: string;
-    /**
-     * Latest timestamp with quality-verified data available for backtesting
-     */
-    dataTo?: string;
+    coverage?: InstrumentCoverage;
     /**
      * Last traded price
      */
@@ -53,6 +108,38 @@ export type InstrumentDetail = {
     volume24h?: number;
 };
 
+/**
+ * Time coverage of available data for this instrument, per data type
+ */
+export type InstrumentCoverage = {
+    /**
+     * Coverage of ticker data
+     */
+    tickers?: CoverageWindow;
+    /**
+     * Coverage of kline (candlestick) data
+     */
+    klines?: CoverageWindow;
+};
+
+/**
+ * The time range of available data for a single data type
+ */
+export type CoverageWindow = {
+    /**
+     * Earliest timestamp with data available
+     */
+    from?: string;
+    /**
+     * Latest timestamp with data available
+     */
+    to?: string;
+    /**
+     * If the instrument stopped producing this data type (delisted/inactive), the timestamp it went inactive. Optional — omitted while the instrument is active.
+     */
+    inactiveSince?: string;
+};
+
 /**
  * Exchange service provider
  */
@@ -85,13 +172,13 @@ export type JobState = {
      */
     contextId: string;
     /**
-     * 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.
+     * Current status of the job. Treat `Completed | Aborted | Failed` as
+     * terminal; `New | Started` mean keep polling. A single-instrument prepare
+     * is always terminal (`Completed`) — decide from
+     * `PrepareJobState.coverageRatio`, not by polling.
      *
      */
-    status: 'New' | 'Started' | 'Partial' | 'Completed' | 'Aborted' | 'Failed';
+    status: 'New' | 'Started' | 'Completed' | 'Aborted' | 'Failed';
     /**
      * Detailed status information, if available
      */
@@ -114,6 +201,62 @@ export type JobState = {
     endTime?: string | null;
 };
 
+/**
+ * State of a single-instrument prepare job — the `JobState` shape plus a per-hour
+ * data-coverage summary. A single-instrument prepare is always terminal
+ * (`status: Completed`): the client decides what to do from `coverageRatio` (e.g.
+ * execute if it is at or above a chosen threshold) rather than polling for missing
+ * hours that may never arrive — a missing hour for one instrument usually means low
+ * activity, not missing data.
+ *
+ */
+export type PrepareJobState = JobState & {
+    /**
+     * Start of the available data range for the prepared instrument.
+     */
+    dataFrom?: string | null;
+    /**
+     * End of the available data range for the prepared instrument.
+     */
+    dataTo?: string | null;
+    /**
+     * `hoursWithData / totalHours` in `[0,1]` (`1.0` when `totalHours` is 0) — the
+     * fraction of hours in the requested range that have served data.
+     *
+     */
+    coverageRatio?: number;
+    /**
+     * Number of whole hours in the requested prepare range.
+     */
+    totalHours?: number;
+    /**
+     * Number of hours in the range that have data.
+     */
+    hoursWithData?: number;
+    /**
+     * One entry per hour in the range that has no data, with a rationale.
+     */
+    hoursWithoutData?: Array<{
+        /**
+         * The hour (UTC, hour-aligned) that has no data.
+         */
+        hour?: string;
+        /**
+         * Expected row count for the hour (currently always 0; reserved for
+         * future use). The rationale never depends on it.
+         *
+         */
+        expected?: number;
+        /**
+         * Why the hour has no data. `pending_conversion`: data for this hour is
+         * still being produced — a re-poll may fill it. `low_activity`: the
+         * instrument did not trade that hour. `unknown`: no data to classify by.
+         *
+         */
+        rationale?: 'pending_conversion' | 'low_activity' | 'unknown';
+    }>;
+};
+
 /**
  * Response returned by async endpoints (`202 Accepted`). The `jobId` is deterministic for the
  * same input parameters — repeated calls with identical params return the same id.
@@ -344,13 +487,47 @@ export type GetInstrumentsError = GetInstrumentsErrors[keyof GetInstrumentsError
 
 export type GetInstrumentsResponses = {
     /**
-     * A JSON array of Instrument details with data availability
+     * The default (spot) segment's instruments in `data`, `meta`, and HAL `_links` (self + spot/futures segment discovery)
      */
-    200: Array<InstrumentDetail>;
+    200: InstrumentListResponse;
 };
 
 export type GetInstrumentsResponse = GetInstrumentsResponses[keyof GetInstrumentsResponses];
 
+export type GetSegmentInstrumentsData = {
+    body?: never;
+    path: {
+        /**
+         * ID of the exchange to retrieve instruments for
+         */
+        exchangeId: string;
+        /**
+         * Market segment to list instruments for
+         */
+        segment: 'spot' | 'futures';
+    };
+    query?: never;
+    url: '/exchange/{exchangeId}/{segment}/instruments';
+};
+
+export type GetSegmentInstrumentsErrors = {
+    /**
+     * Exchange, segment, or instrument catalog not found
+     */
+    404: ResponseError;
+};
+
+export type GetSegmentInstrumentsError = GetSegmentInstrumentsErrors[keyof GetSegmentInstrumentsErrors];
+
+export type GetSegmentInstrumentsResponses = {
+    /**
+     * An object with a `data` array of instrument details (each with per-data-type coverage) and a `meta` block
+     */
+    200: InstrumentListResponse;
+};
+
+export type GetSegmentInstrumentsResponse = GetSegmentInstrumentsResponses[keyof GetSegmentInstrumentsResponses];
+
 export type GetExchangeTickersHourData = {
     body?: never;
     path: {
@@ -671,7 +848,7 @@ export type GetPreparationStatusResponses = {
     /**
      * Current prepare job state
      */
-    200: JobState;
+    200: PrepareJobState;
 };
 
 export type GetPreparationStatusResponse = GetPreparationStatusResponses[keyof GetPreparationStatusResponses];