@predictorsdk/client 0.2.0 → 0.3.1

package/dist/Client.d.ts

@@ -11,13 +11,14 @@ export declare class PredictorSDKClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<PredictorSDKClient.Options>;
     constructor(options: PredictorSDKClient.Options);
     /**
-     * Find cross-platform market matches for sports events. Provide a Kalshi event ticker or Polymarket market slug to look up the equivalent market on other platforms. When called without parameters, returns all currently matched sports markets.
+     * Find cross-platform market matches for sports events. When called without parameters, returns all currently matched sports markets with cursor-based pagination (default `limit=25`, max `100`). Provide a Kalshi event ticker, Polymarket slug, Predict market ID, or SX Bet market ID to look up a specific event — lookups return the full match immediately and skip pagination.
      *
      * @param {PredictorSDK.GetSportsMatchingMarketsRequest} request
      * @param {PredictorSDKClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link PredictorSDK.BadRequestError}
      * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
      * @throws {@link PredictorSDK.ForbiddenError}
      * @throws {@link PredictorSDK.TooManyRequestsError}
      * @throws {@link PredictorSDK.ServiceUnavailableError}
@@ -27,6 +28,24 @@ export declare class PredictorSDKClient {
      */
     getSportsMatchingMarkets(request?: PredictorSDK.GetSportsMatchingMarketsRequest, requestOptions?: PredictorSDKClient.RequestOptions): core.HttpResponsePromise<PredictorSDK.SportsMatchingResponse>;
     private __getSportsMatchingMarkets;
+    /**
+     * Returns a paginated list of unified markets from all supported prediction market providers. Uses cursor-based pagination with default `limit=25`, max `100`.
+     *
+     * @param {PredictorSDK.GetMarketsRequest} request
+     * @param {PredictorSDKClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link PredictorSDK.BadRequestError}
+     * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
+     * @throws {@link PredictorSDK.ForbiddenError}
+     * @throws {@link PredictorSDK.TooManyRequestsError}
+     * @throws {@link PredictorSDK.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.getMarkets()
+     */
+    getMarkets(request?: PredictorSDK.GetMarketsRequest, requestOptions?: PredictorSDKClient.RequestOptions): core.HttpResponsePromise<PredictorSDK.MarketsListResponse>;
+    private __getMarkets;
     /**
      * 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`.
      *
@@ -35,6 +54,7 @@ export declare class PredictorSDKClient {
      *
      * @throws {@link PredictorSDK.BadRequestError}
      * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
      * @throws {@link PredictorSDK.ForbiddenError}
      * @throws {@link PredictorSDK.TooManyRequestsError}
      * @throws {@link PredictorSDK.BadGatewayError}

package/dist/Client.js

@@ -13,13 +13,14 @@ export class PredictorSDKClient {
         this._options = normalizeClientOptionsWithAuth(options);
     }
     /**
-     * Find cross-platform market matches for sports events. Provide a Kalshi event ticker or Polymarket market slug to look up the equivalent market on other platforms. When called without parameters, returns all currently matched sports markets.
+     * Find cross-platform market matches for sports events. When called without parameters, returns all currently matched sports markets with cursor-based pagination (default `limit=25`, max `100`). Provide a Kalshi event ticker, Polymarket slug, Predict market ID, or SX Bet market ID to look up a specific event — lookups return the full match immediately and skip pagination.
      *
      * @param {PredictorSDK.GetSportsMatchingMarketsRequest} request
      * @param {PredictorSDKClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link PredictorSDK.BadRequestError}
      * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
      * @throws {@link PredictorSDK.ForbiddenError}
      * @throws {@link PredictorSDK.TooManyRequestsError}
      * @throws {@link PredictorSDK.ServiceUnavailableError}
@@ -31,8 +32,11 @@ export class PredictorSDKClient {
         return core.HttpResponsePromise.fromPromise(this.__getSportsMatchingMarkets(request, requestOptions));
     }
     async __getSportsMatchingMarkets(request = {}, requestOptions) {
-        const { kalshiEventTicker, polymarketMarketSlug, predictMarketId, sxbetMarketId } = request;
+        const { limit, cursor, includeSettled, kalshiEventTicker, polymarketMarketSlug, predictMarketId, sxbetMarketId, } = request;
         const _queryParams = {
+            limit,
+            cursor,
+            include_settled: includeSettled,
             kalshi_event_ticker: kalshiEventTicker,
             polymarket_market_slug: polymarketMarketSlug,
             predict_market_id: predictMarketId,
@@ -83,6 +87,14 @@ export class PredictorSDKClient {
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
+                case 402:
+                    throw new PredictorSDK.PaymentRequiredError(serializers.PaymentRequiredErrorBody.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",
@@ -117,6 +129,118 @@ export class PredictorSDKClient {
         }
         return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/matching-markets/sports");
     }
+    /**
+     * Returns a paginated list of unified markets from all supported prediction market providers. Uses cursor-based pagination with default `limit=25`, max `100`.
+     *
+     * @param {PredictorSDK.GetMarketsRequest} request
+     * @param {PredictorSDKClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link PredictorSDK.BadRequestError}
+     * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
+     * @throws {@link PredictorSDK.ForbiddenError}
+     * @throws {@link PredictorSDK.TooManyRequestsError}
+     * @throws {@link PredictorSDK.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.getMarkets()
+     */
+    getMarkets(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getMarkets(request, requestOptions));
+    }
+    async __getMarkets(request = {}, requestOptions) {
+        const { limit, cursor } = request;
+        const _queryParams = {
+            limit,
+            cursor,
+        };
+        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/markets"),
+            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.MarketsListResponse.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 402:
+                    throw new PredictorSDK.PaymentRequiredError(serializers.PaymentRequiredErrorBody.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 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/markets");
+    }
     /**
      * 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`.
      *
@@ -125,6 +249,7 @@ export class PredictorSDKClient {
      *
      * @throws {@link PredictorSDK.BadRequestError}
      * @throws {@link PredictorSDK.UnauthorizedError}
+     * @throws {@link PredictorSDK.PaymentRequiredError}
      * @throws {@link PredictorSDK.ForbiddenError}
      * @throws {@link PredictorSDK.TooManyRequestsError}
      * @throws {@link PredictorSDK.BadGatewayError}
@@ -192,6 +317,14 @@ export class PredictorSDKClient {
                         skipValidation: true,
                         breadcrumbsPrefix: ["response"],
                     }), _response.rawResponse);
+                case 402:
+                    throw new PredictorSDK.PaymentRequiredError(serializers.PaymentRequiredErrorBody.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",

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

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {}
+ */
+export interface GetMarketsRequest {
+    /** Maximum number of markets to return per page. Range 1–100, default 25. */
+    limit?: number;
+    /** Opaque cursor from a previous response's `pagination.nextCursor` in the SDKs (raw JSON: `pagination.next_cursor`). */
+    cursor?: string;
+}

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

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

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

@@ -3,12 +3,18 @@
  *     {}
  */
 export interface GetSportsMatchingMarketsRequest {
-    /** Kalshi event ticker(s) to find matching markets for (e.g. `KXNFLGAME-25AUG16ARIDEN`). Provide the parameter multiple times for multiple tickers. Only one filter type may be used per request. */
+    /** Maximum number of matched events to return per page. Range 1–100, default 25. Ignored when a platform-ID filter is supplied. */
+    limit?: number;
+    /** Opaque cursor from a previous response's `pagination.nextCursor` in the SDKs (raw JSON: `pagination.next_cursor`). Must be used with the same filter set — a cursor from `include_settled=true` cannot be replayed against `include_settled=false` and will return `400`. */
+    cursor?: string;
+    /** When `true`, include settled/archived events alongside currently live matches. Defaults to `false`. */
+    includeSettled?: boolean;
+    /** Kalshi event ticker(s) to find matching markets for (e.g. `KXNFLGAME-25AUG16ARIDEN`). Provide the parameter multiple times for multiple tickers. Only one filter type may be used per request. Lookup mode — pagination parameters are ignored. */
     kalshiEventTicker?: string | string[];
-    /** Polymarket market slug(s) to find matching markets for (e.g. `nfl-ari-den-2025-08-16`). Provide the parameter multiple times for multiple slugs. Only one filter type may be used per request. */
+    /** Polymarket market slug(s) to find matching markets for (e.g. `nfl-ari-den-2025-08-16`). Provide the parameter multiple times for multiple slugs. Only one filter type may be used per request. Lookup mode — pagination parameters are ignored. */
     polymarketMarketSlug?: string | string[];
-    /** Predict market ID(s) to find matching markets for (e.g. `110629`). Provide the parameter multiple times for multiple IDs. Only one filter type may be used per request. */
+    /** Predict market ID(s) to find matching markets for (e.g. `110629`). Provide the parameter multiple times for multiple IDs. Only one filter type may be used per request. Lookup mode — pagination parameters are ignored. */
     predictMarketId?: string | string[];
-    /** SX Bet market ID(s) to find matching markets for (e.g. `0x4c000abdbf197ef32ecdf15561b1d636f1e5b02629f466678757fd83e2ec3599`). Provide the parameter multiple times for multiple IDs. Only one filter type may be used per request. */
+    /** SX Bet market ID(s) to find matching markets for (e.g. `0x4c000abdbf197ef32ecdf15561b1d636f1e5b02629f466678757fd83e2ec3599`). Provide the parameter multiple times for multiple IDs. Only one filter type may be used per request. Lookup mode — pagination parameters are ignored. */
     sxbetMarketId?: string | string[];
 }

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

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

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

@@ -2,5 +2,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 {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

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

@@ -2,5 +2,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 BadRequestError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

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

@@ -2,5 +2,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 ForbiddenError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

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

@@ -0,0 +1,7 @@
+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 PaymentRequiredError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.PaymentRequiredErrorBody;
+    constructor(body: PredictorSDK.PaymentRequiredErrorBody, rawResponse?: core.RawResponse);
+}

package/dist/api/errors/PaymentRequiredError.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 PaymentRequiredError extends errors.PredictorSDKError {
+    constructor(body, rawResponse) {
+        super({
+            message: "PaymentRequiredError",
+            statusCode: 402,
+            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/ServiceUnavailableError.d.ts

@@ -2,5 +2,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 ServiceUnavailableError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

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

@@ -2,5 +2,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 TooManyRequestsError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

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

@@ -2,5 +2,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 UnauthorizedError extends errors.PredictorSDKError {
+    readonly body: PredictorSDK.ErrorResponse;
     constructor(body: PredictorSDK.ErrorResponse, rawResponse?: core.RawResponse);
 }

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

@@ -1,6 +1,7 @@
 export * from "./BadGatewayError.js";
 export * from "./BadRequestError.js";
 export * from "./ForbiddenError.js";
+export * from "./PaymentRequiredError.js";
 export * from "./ServiceUnavailableError.js";
 export * from "./TooManyRequestsError.js";
 export * from "./UnauthorizedError.js";

package/dist/api/errors/index.js

@@ -1,6 +1,7 @@
 export * from "./BadGatewayError.js";
 export * from "./BadRequestError.js";
 export * from "./ForbiddenError.js";
+export * from "./PaymentRequiredError.js";
 export * from "./ServiceUnavailableError.js";
 export * from "./TooManyRequestsError.js";
 export * from "./UnauthorizedError.js";

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

@@ -0,0 +1,7 @@
+import type * as PredictorSDK from "../index.js";
+export interface MarketsListResponse {
+    /** Array of markets for the current page. */
+    data: PredictorSDK.UnifiedMarket[];
+    /** Pagination metadata for the current page. */
+    pagination: PredictorSDK.PaginationBlock;
+}

package/dist/api/types/MarketsListResponse.js

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

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

@@ -0,0 +1,10 @@
+export interface PaginationBlock {
+    /** Number of items requested per page (echoes the `limit` query param). */
+    limit: number;
+    /** Total matching items across all pages. */
+    total: number;
+    /** Whether additional pages exist beyond this one. */
+    hasMore: boolean;
+    /** Opaque cursor for fetching the next page. Pass back via the `cursor` query parameter. Omitted when `has_more` is `false`. Clients must preserve the same filter set when re-using a cursor — mismatches return `400`. */
+    nextCursor?: string;
+}

package/dist/api/types/PaginationBlock.js

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

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

@@ -0,0 +1,6 @@
+/** Recommended client action for this 402. */
+export declare const PaymentRequiredErrorAction: {
+    readonly UpgradePlan: "upgrade_plan";
+    readonly ResolvePayment: "resolve_payment";
+};
+export type PaymentRequiredErrorAction = (typeof PaymentRequiredErrorAction)[keyof typeof PaymentRequiredErrorAction];

package/dist/api/types/PaymentRequiredErrorAction.js

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Recommended client action for this 402. */
+export const PaymentRequiredErrorAction = {
+    UpgradePlan: "upgrade_plan",
+    ResolvePayment: "resolve_payment",
+};

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

@@ -0,0 +1,20 @@
+import type * as PredictorSDK from "../index.js";
+/**
+ * Error body returned with HTTP 402. The `action` discriminator lets clients route to the correct recovery flow: `upgrade_plan` means the caller is on a lower tier than the endpoint requires, or the Free monthly allowance is exhausted; `resolve_payment` means the caller had a paid subscription that entered a payment-recovery state (past_due/unpaid/paused/incomplete) and the backend has already downgraded them to Free — the fix is in the billing portal, not a new purchase. `required_tier` / `current_tier` are always populated; `included_requests_per_month` and `current_period_requests` are only set when a Free caller hits the monthly allowance.
+ */
+export interface PaymentRequiredErrorBody {
+    error: string;
+    /** Additional detail about the error. */
+    message?: string;
+    statusCode: number;
+    /** Recommended client action for this 402. */
+    action: PredictorSDK.PaymentRequiredErrorAction;
+    /** Billing tier that would satisfy the gate (e.g. `starter`, `pro`, `business`, `enterprise`). */
+    requiredTier: string;
+    /** Billing tier currently associated with the caller. */
+    currentTier: string;
+    /** Monthly Free-tier allowance. Present only when the 402 is caused by the Free cap. */
+    includedRequestsPerMonth?: number;
+    /** Requests the Free caller has made in the current calendar month. Present only when the 402 is caused by the Free cap. */
+    currentPeriodRequests?: number;
+}

package/dist/api/types/PaymentRequiredErrorBody.js

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

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

@@ -2,4 +2,6 @@ import type * as PredictorSDK from "../index.js";
 export interface SportsMatchingResponse {
     /** Key-value pairs where each key is the queried identifier (Kalshi event ticker, Polymarket slug, or canonical event ID when no filter is provided) and each value is an array of platform market objects. */
     markets: Record<string, PredictorSDK.PlatformMarket[]>;
+    /** Pagination metadata for the current page. Present in list mode (no platform-ID filter). Absent in lookup mode since the response is bounded by the filter. */
+    pagination?: PredictorSDK.PaginationBlock;
 }

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

@@ -0,0 +1,9 @@
+import type * as PredictorSDK from "../index.js";
+export interface UnifiedMarket {
+    /** Composite market identifier in the format `{provider}:{provider_id}` (e.g. `kalshi:KXNBAGAME-26MAR06INDLAL-LAL`). */
+    id: string;
+    /** Prediction market provider. */
+    provider: PredictorSDK.UnifiedMarketProvider;
+    /** Human-readable market title/question. */
+    title: string;
+}

package/dist/api/types/UnifiedMarket.js

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

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

@@ -0,0 +1,8 @@
+/** Prediction market provider. */
+export declare const UnifiedMarketProvider: {
+    readonly Kalshi: "kalshi";
+    readonly Polymarket: "polymarket";
+    readonly Predict: "predict";
+    readonly Sxbet: "sxbet";
+};
+export type UnifiedMarketProvider = (typeof UnifiedMarketProvider)[keyof typeof UnifiedMarketProvider];

package/dist/api/types/UnifiedMarketProvider.js

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+/** Prediction market provider. */
+export const UnifiedMarketProvider = {
+    Kalshi: "kalshi",
+    Polymarket: "polymarket",
+    Predict: "predict",
+    Sxbet: "sxbet",
+};

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

@@ -1,6 +1,12 @@
 export * from "./CryptoPriceItem.js";
 export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
+export * from "./MarketsListResponse.js";
+export * from "./PaginationBlock.js";
+export * from "./PaymentRequiredErrorAction.js";
+export * from "./PaymentRequiredErrorBody.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./SportsMatchingResponse.js";
+export * from "./UnifiedMarket.js";
+export * from "./UnifiedMarketProvider.js";

package/dist/api/types/index.js

@@ -1,6 +1,12 @@
 export * from "./CryptoPriceItem.js";
 export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
+export * from "./MarketsListResponse.js";
+export * from "./PaginationBlock.js";
+export * from "./PaymentRequiredErrorAction.js";
+export * from "./PaymentRequiredErrorBody.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./SportsMatchingResponse.js";
+export * from "./UnifiedMarket.js";
+export * from "./UnifiedMarketProvider.js";

package/dist/serialization/types/MarketsListResponse.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 { PaginationBlock } from "./PaginationBlock.js";
+import { UnifiedMarket } from "./UnifiedMarket.js";
+export declare const MarketsListResponse: core.serialization.ObjectSchema<serializers.MarketsListResponse.Raw, PredictorSDK.MarketsListResponse>;
+export declare namespace MarketsListResponse {
+    interface Raw {
+        data: UnifiedMarket.Raw[];
+        pagination: PaginationBlock.Raw;
+    }
+}

package/dist/serialization/types/MarketsListResponse.js

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+import { PaginationBlock } from "./PaginationBlock.js";
+import { UnifiedMarket } from "./UnifiedMarket.js";
+export const MarketsListResponse = core.serialization.object({
+    data: core.serialization.list(UnifiedMarket),
+    pagination: PaginationBlock,
+});

package/dist/serialization/types/PaginationBlock.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";
+export declare const PaginationBlock: core.serialization.ObjectSchema<serializers.PaginationBlock.Raw, PredictorSDK.PaginationBlock>;
+export declare namespace PaginationBlock {
+    interface Raw {
+        limit: number;
+        total: number;
+        has_more: boolean;
+        next_cursor?: string | null;
+    }
+}

package/dist/serialization/types/PaginationBlock.js

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+export const PaginationBlock = core.serialization.object({
+    limit: core.serialization.number(),
+    total: core.serialization.number(),
+    hasMore: core.serialization.property("has_more", core.serialization.boolean()),
+    nextCursor: core.serialization.property("next_cursor", core.serialization.string().optional()),
+});

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

@@ -0,0 +1,7 @@
+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 PaymentRequiredErrorAction: core.serialization.Schema<serializers.PaymentRequiredErrorAction.Raw, PredictorSDK.PaymentRequiredErrorAction>;
+export declare namespace PaymentRequiredErrorAction {
+    type Raw = "upgrade_plan" | "resolve_payment";
+}

package/dist/serialization/types/PaymentRequiredErrorAction.js

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+export const PaymentRequiredErrorAction = core.serialization.enum_(["upgrade_plan", "resolve_payment"]);

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

@@ -0,0 +1,17 @@
+import type * as PredictorSDK from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { PaymentRequiredErrorAction } from "./PaymentRequiredErrorAction.js";
+export declare const PaymentRequiredErrorBody: core.serialization.ObjectSchema<serializers.PaymentRequiredErrorBody.Raw, PredictorSDK.PaymentRequiredErrorBody>;
+export declare namespace PaymentRequiredErrorBody {
+    interface Raw {
+        error: string;
+        message?: string | null;
+        status_code: number;
+        action: PaymentRequiredErrorAction.Raw;
+        required_tier: string;
+        current_tier: string;
+        included_requests_per_month?: number | null;
+        current_period_requests?: number | null;
+    }
+}

package/dist/serialization/types/PaymentRequiredErrorBody.js

@@ -0,0 +1,13 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+import { PaymentRequiredErrorAction } from "./PaymentRequiredErrorAction.js";
+export const PaymentRequiredErrorBody = core.serialization.object({
+    error: core.serialization.string(),
+    message: core.serialization.string().optional(),
+    statusCode: core.serialization.property("status_code", core.serialization.number()),
+    action: PaymentRequiredErrorAction,
+    requiredTier: core.serialization.property("required_tier", core.serialization.string()),
+    currentTier: core.serialization.property("current_tier", core.serialization.string()),
+    includedRequestsPerMonth: core.serialization.property("included_requests_per_month", core.serialization.number().optional()),
+    currentPeriodRequests: core.serialization.property("current_period_requests", core.serialization.number().optional()),
+});

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

@@ -1,10 +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 { PaginationBlock } from "./PaginationBlock.js";
 import { PlatformMarket } from "./PlatformMarket.js";
 export declare const SportsMatchingResponse: core.serialization.ObjectSchema<serializers.SportsMatchingResponse.Raw, PredictorSDK.SportsMatchingResponse>;
 export declare namespace SportsMatchingResponse {
     interface Raw {
         markets: Record<string, PlatformMarket.Raw[]>;
+        pagination?: PaginationBlock.Raw | null;
     }
 }

package/dist/serialization/types/SportsMatchingResponse.js

@@ -1,6 +1,8 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as core from "../../core/index.js";
+import { PaginationBlock } from "./PaginationBlock.js";
 import { PlatformMarket } from "./PlatformMarket.js";
 export const SportsMatchingResponse = core.serialization.object({
     markets: core.serialization.record(core.serialization.string(), core.serialization.list(PlatformMarket)),
+    pagination: PaginationBlock.optional(),
 });

package/dist/serialization/types/UnifiedMarket.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 { UnifiedMarketProvider } from "./UnifiedMarketProvider.js";
+export declare const UnifiedMarket: core.serialization.ObjectSchema<serializers.UnifiedMarket.Raw, PredictorSDK.UnifiedMarket>;
+export declare namespace UnifiedMarket {
+    interface Raw {
+        id: string;
+        provider: UnifiedMarketProvider.Raw;
+        title: string;
+    }
+}

package/dist/serialization/types/UnifiedMarket.js

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+import { UnifiedMarketProvider } from "./UnifiedMarketProvider.js";
+export const UnifiedMarket = core.serialization.object({
+    id: core.serialization.string(),
+    provider: UnifiedMarketProvider,
+    title: core.serialization.string(),
+});

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

@@ -0,0 +1,7 @@
+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 UnifiedMarketProvider: core.serialization.Schema<serializers.UnifiedMarketProvider.Raw, PredictorSDK.UnifiedMarketProvider>;
+export declare namespace UnifiedMarketProvider {
+    type Raw = "kalshi" | "polymarket" | "predict" | "sxbet";
+}

package/dist/serialization/types/UnifiedMarketProvider.js

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+export const UnifiedMarketProvider = core.serialization.enum_(["kalshi", "polymarket", "predict", "sxbet"]);

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

@@ -1,6 +1,12 @@
 export * from "./CryptoPriceItem.js";
 export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
+export * from "./MarketsListResponse.js";
+export * from "./PaginationBlock.js";
+export * from "./PaymentRequiredErrorAction.js";
+export * from "./PaymentRequiredErrorBody.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./SportsMatchingResponse.js";
+export * from "./UnifiedMarket.js";
+export * from "./UnifiedMarketProvider.js";

package/dist/serialization/types/index.js

@@ -1,6 +1,12 @@
 export * from "./CryptoPriceItem.js";
 export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
+export * from "./MarketsListResponse.js";
+export * from "./PaginationBlock.js";
+export * from "./PaymentRequiredErrorAction.js";
+export * from "./PaymentRequiredErrorBody.js";
 export * from "./PlatformMarket.js";
 export * from "./PlatformMarketPlatform.js";
 export * from "./SportsMatchingResponse.js";
+export * from "./UnifiedMarket.js";
+export * from "./UnifiedMarketProvider.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@predictorsdk/client",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "The official TypeScript/JavaScript client for the PredictorSDK matching markets API",
   "license": "MIT",
   "keywords": [