@predictorsdk/client 0.1.2 → 0.2.0

package/dist/Client.d.ts

@@ -27,6 +27,26 @@ export declare class PredictorSDKClient {
      */
     getSportsMatchingMarkets(request?: PredictorSDK.GetSportsMatchingMarketsRequest, requestOptions?: PredictorSDKClient.RequestOptions): core.HttpResponsePromise<PredictorSDK.SportsMatchingResponse>;
     private __getSportsMatchingMarkets;
+    /**
+     * Returns per-second price data for a Binance trading pair. When called without a time range, returns the latest price. With `start_time` and `end_time`, returns historical per-second prices in newest-first order. Supports cursor-based pagination for large result sets. Unknown or invalid symbols return `200` with `{"prices":[]}` and omit `total`.
+     *
+     * @param {PredictorSDK.GetBinanceCryptoPricesRequest} request
+     * @param {PredictorSDKClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link PredictorSDK.BadRequestError}
+     * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.ForbiddenError}
+     * @throws {@link PredictorSDK.TooManyRequestsError}
+     * @throws {@link PredictorSDK.BadGatewayError}
+     * @throws {@link PredictorSDK.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.getBinanceCryptoPrices({
+     *         currency: "btcusdt"
+     *     })
+     */
+    getBinanceCryptoPrices(request: PredictorSDK.GetBinanceCryptoPricesRequest, requestOptions?: PredictorSDKClient.RequestOptions): core.HttpResponsePromise<PredictorSDK.CryptoPricesResponse>;
+    private __getBinanceCryptoPrices;
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
      * This is useful for making requests to endpoints not yet supported in the SDK.

package/dist/Client.js

@@ -117,6 +117,123 @@ export class PredictorSDKClient {
         }
         return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/matching-markets/sports");
     }
+    /**
+     * Returns per-second price data for a Binance trading pair. When called without a time range, returns the latest price. With `start_time` and `end_time`, returns historical per-second prices in newest-first order. Supports cursor-based pagination for large result sets. Unknown or invalid symbols return `200` with `{"prices":[]}` and omit `total`.
+     *
+     * @param {PredictorSDK.GetBinanceCryptoPricesRequest} request
+     * @param {PredictorSDKClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link PredictorSDK.BadRequestError}
+     * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.ForbiddenError}
+     * @throws {@link PredictorSDK.TooManyRequestsError}
+     * @throws {@link PredictorSDK.BadGatewayError}
+     * @throws {@link PredictorSDK.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.getBinanceCryptoPrices({
+     *         currency: "btcusdt"
+     *     })
+     */
+    getBinanceCryptoPrices(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getBinanceCryptoPrices(request, requestOptions));
+    }
+    async __getBinanceCryptoPrices(request, requestOptions) {
+        const { currency, startTime, endTime, limit, paginationKey } = request;
+        const _queryParams = {
+            currency,
+            start_time: startTime,
+            end_time: endTime,
+            limit,
+            pagination_key: paginationKey,
+        };
+        const _authRequest = await this._options.authProvider.getAuthRequest();
+        const _headers = mergeHeaders(_authRequest.headers, this._options?.headers, requestOptions?.headers);
+        const _response = await core.fetcher({
+            url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.PredictorSDKEnvironment.Production, "v1/crypto-prices/binance"),
+            method: "GET",
+            headers: _headers,
+            queryParameters: { ..._queryParams, ...requestOptions?.queryParams },
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return {
+                data: serializers.CryptoPricesResponse.parseOrThrow(_response.body, {
+                    unrecognizedObjectKeys: "passthrough",
+                    allowUnrecognizedUnionMembers: true,
+                    allowUnrecognizedEnumValues: true,
+                    skipValidation: true,
+                    breadcrumbsPrefix: ["response"],
+                }),
+                rawResponse: _response.rawResponse,
+            };
+        }
+        if (_response.error.reason === "status-code") {
+            switch (_response.error.statusCode) {
+                case 400:
+                    throw new PredictorSDK.BadRequestError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
+                case 401:
+                    throw new PredictorSDK.UnauthorizedError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
+                case 403:
+                    throw new PredictorSDK.ForbiddenError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
+                case 429:
+                    throw new PredictorSDK.TooManyRequestsError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
+                case 502:
+                    throw new PredictorSDK.BadGatewayError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
+                case 503:
+                    throw new PredictorSDK.ServiceUnavailableError(serializers.ErrorResponse.parseOrThrow(_response.error.body, {
+                        unrecognizedObjectKeys: "passthrough",
+                        allowUnrecognizedUnionMembers: true,
+                        allowUnrecognizedEnumValues: true,
+                        skipValidation: true,
+                        breadcrumbsPrefix: ["response"],
+                    }), _response.rawResponse);
+                default:
+                    throw new errors.PredictorSDKError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.body,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        }
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/crypto-prices/binance");
+    }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
      * This is useful for making requests to endpoints not yet supported in the SDK.

package/dist/api/client/requests/GetBinanceCryptoPricesRequest.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @example
+ *     {
+ *         currency: "btcusdt"
+ *     }
+ */
+export interface GetBinanceCryptoPricesRequest {
+    /** Binance trading pair (e.g. `btcusdt`, `ethusdt`, `solusdt`). Must contain only alphanumeric characters (no hyphens, underscores, or other separators). Uppercase is accepted and automatically lowercased (e.g. `BTCUSDT` → `btcusdt`). Must be a valid Binance symbol; unknown symbols return `200` with an empty `prices` array. */
+    currency: string;
+    /** Start of the time range as a Unix timestamp in milliseconds (inclusive). Negative values are clamped to 0. */
+    startTime?: number;
+    /** End of the time range as a Unix timestamp in milliseconds (inclusive). Negative values are clamped to 0. */
+    endTime?: number;
+    /** Maximum number of prices to return. Defaults to 100 when a time range is present. Values above 100 are silently clamped to 100. Without a time range, this parameter is ignored — the endpoint always returns the single latest price. */
+    limit?: number;
+    /** Base64-encoded cursor from a previous response to fetch the next page of results. */
+    paginationKey?: string;
+}

package/dist/api/client/requests/GetBinanceCryptoPricesRequest.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/client/requests/index.d.ts

@@ -1 +1,2 @@
+export type { GetBinanceCryptoPricesRequest } from "./GetBinanceCryptoPricesRequest.js";
 export type { GetSportsMatchingMarketsRequest } from "./GetSportsMatchingMarketsRequest.js";

package/dist/api/errors/BadGatewayError.d.ts

@@ -0,0 +1,6 @@
+import type * as core from "../../core/index.js";
+import * as errors from "../../errors/index.js";
+import type * as PredictorSDK from "../index.js";
+export declare class BadGatewayError extends errors.PredictorSDKError {
+    constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/api/errors/BadGatewayError.js

@@ -0,0 +1,17 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../errors/index.js";
+export class BadGatewayError extends errors.PredictorSDKError {
+    constructor(body, rawResponse) {
+        super({
+            message: "BadGatewayError",
+            statusCode: 502,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+    }
+}

package/dist/api/errors/index.d.ts

@@ -1,3 +1,4 @@
+export * from "./BadGatewayError.js";
 export * from "./BadRequestError.js";
 export * from "./ForbiddenError.js";
 export * from "./ServiceUnavailableError.js";

package/dist/api/errors/index.js

@@ -1,3 +1,4 @@
+export * from "./BadGatewayError.js";
 export * from "./BadRequestError.js";
 export * from "./ForbiddenError.js";
 export * from "./ServiceUnavailableError.js";

package/dist/api/types/CryptoPriceItem.d.ts

@@ -0,0 +1,8 @@
+export interface CryptoPriceItem {
+    /** Trading pair in lowercase (e.g. `btcusdt`). */
+    symbol: string;
+    /** Close price for the 1-second interval. */
+    value: number;
+    /** Unix timestamp in milliseconds for the start of the 1-second interval. */
+    timestamp: number;
+}

package/dist/api/types/CryptoPriceItem.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/types/CryptoPricesResponse.d.ts

@@ -0,0 +1,8 @@
+import type * as PredictorSDK from "../index.js";
+export interface CryptoPricesResponse {
+    prices: PredictorSDK.CryptoPriceItem[];
+    /** Base64-encoded cursor for fetching the next page. Absent when there are no more results. */
+    paginationKey?: string;
+    /** Number of prices in this response page. Omitted on empty responses for unknown symbols. */
+    total?: number;
+}

package/dist/api/types/CryptoPricesResponse.js

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/api/types/ErrorResponse.d.ts

@@ -1,4 +1,6 @@
 export interface ErrorResponse {
     error: string;
+    /** Additional detail about the error. May be present, including on some validation errors. */
+    message?: string;
     statusCode: number;
 }

package/dist/api/types/index.d.ts

@@ -1,3 +1,5 @@
+export * from "./CryptoPriceItem.js";
+export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";

package/dist/api/types/index.js

@@ -1,3 +1,5 @@
+export * from "./CryptoPriceItem.js";
+export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";

package/dist/serialization/types/CryptoPriceItem.d.ts

@@ -0,0 +1,11 @@
+import type * as PredictorSDK from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+export declare const CryptoPriceItem: core.serialization.ObjectSchema<serializers.CryptoPriceItem.Raw, PredictorSDK.CryptoPriceItem>;
+export declare namespace CryptoPriceItem {
+    interface Raw {
+        symbol: string;
+        value: number;
+        timestamp: number;
+    }
+}

package/dist/serialization/types/CryptoPriceItem.js

@@ -0,0 +1,7 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+export const CryptoPriceItem = core.serialization.object({
+    symbol: core.serialization.string(),
+    value: core.serialization.number(),
+    timestamp: core.serialization.number(),
+});

package/dist/serialization/types/CryptoPricesResponse.d.ts

@@ -0,0 +1,12 @@
+import type * as PredictorSDK from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { CryptoPriceItem } from "./CryptoPriceItem.js";
+export declare const CryptoPricesResponse: core.serialization.ObjectSchema<serializers.CryptoPricesResponse.Raw, PredictorSDK.CryptoPricesResponse>;
+export declare namespace CryptoPricesResponse {
+    interface Raw {
+        prices: CryptoPriceItem.Raw[];
+        pagination_key?: string | null;
+        total?: number | null;
+    }
+}

package/dist/serialization/types/CryptoPricesResponse.js

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+import { CryptoPriceItem } from "./CryptoPriceItem.js";
+export const CryptoPricesResponse = core.serialization.object({
+    prices: core.serialization.list(CryptoPriceItem),
+    paginationKey: core.serialization.property("pagination_key", core.serialization.string().optional()),
+    total: core.serialization.number().optional(),
+});

package/dist/serialization/types/ErrorResponse.d.ts

@@ -5,6 +5,7 @@ export declare const ErrorResponse: core.serialization.ObjectSchema<serializers.
 export declare namespace ErrorResponse {
     interface Raw {
         error: string;
+        message?: string | null;
         status_code: number;
     }
 }

package/dist/serialization/types/ErrorResponse.js

@@ -2,5 +2,6 @@
 import * as core from "../../core/index.js";
 export const ErrorResponse = core.serialization.object({
     error: core.serialization.string(),
+    message: core.serialization.string().optional(),
     statusCode: core.serialization.property("status_code", core.serialization.number()),
 });

package/dist/serialization/types/index.d.ts

@@ -1,3 +1,5 @@
+export * from "./CryptoPriceItem.js";
+export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";

package/dist/serialization/types/index.js

@@ -1,3 +1,5 @@
+export * from "./CryptoPriceItem.js";
+export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@predictorsdk/client",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "The official TypeScript/JavaScript client for the PredictorSDK matching markets API",
   "license": "MIT",
   "keywords": [
@@ -47,7 +47,7 @@
     "node": ">=18"
   },
   "devDependencies": {
-    "@types/node": "^22.0.0",
+    "@types/node": "^25.5.2",
     "typescript": "^5.7.0"
   }
 }