@predictorsdk/client 0.4.0 → 0.5.0

package/dist/Client.d.ts

@@ -93,6 +93,62 @@ export declare class PredictorSDKClient {
      */
     getPolymarketWallet(request?: PredictorSDK.GetPolymarketWalletRequest, requestOptions?: PredictorSDKClient.RequestOptions): core.HttpResponsePromise<PredictorSDK.PolymarketWalletResponse>;
     private __getPolymarketWallet;
+    /**
+     * Returns the current Polymarket positions for a wallet. Accepts either a wallet `address` (proxy address only — see note below) or a Polymarket `username`. Exactly one of the two must be supplied — passing both returns `400`.
+     *
+     * v1 surfaces a minimal field set so the endpoint scaffolding can be verified end-to-end: `condition_id` (which market), `outcome` (which side), and `shares` (how much). Title/slug, avg/current price, PnL (`cash_pnl`, `realized_pnl`), `redeemable`/`mergeable` flags, and event metadata will be added in follow-ups.
+     *
+     * `total` in the pagination block is always `0` because the upstream Data API does not return a total count; rely on `has_more` + `next_cursor` to paginate.
+     *
+     * **EOA inputs are not auto-resolved on this endpoint.** Unlike `/v1/polymarket/wallet`, this endpoint does not perform the EOA→proxy CREATE2 resolution. Callers with a signer EOA should call `/v1/polymarket/wallet` first to resolve the proxy, then pass the returned `address`. Passing an EOA directly will return an empty `data` array.
+     *
+     * @param {PredictorSDK.ListPolymarketWalletPositionsRequest} 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.NotFoundError}
+     * @throws {@link PredictorSDK.TooManyRequestsError}
+     * @throws {@link PredictorSDK.BadGatewayError}
+     * @throws {@link PredictorSDK.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.listPolymarketWalletPositions({
+     *         address: "0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b"
+     *     })
+     */
+    listPolymarketWalletPositions(request?: PredictorSDK.ListPolymarketWalletPositionsRequest, requestOptions?: PredictorSDKClient.RequestOptions): core.HttpResponsePromise<PredictorSDK.PolymarketPositionsResponse>;
+    private __listPolymarketWalletPositions;
+    /**
+     * Returns a single event and the markets nested under it on the identified platform. The `event_id` is the platform's native identifier — a Kalshi `event_ticker`, a Polymarket event slug, an SX Bet `eventId`, or a Predict market identifier. The `platform` is inferred from the ID format when unambiguous; callers must pass `?platform=` for numeric IDs or kebab-case slugs that could belong to either Polymarket or Predict.
+     *
+     * Response is minimal in v0: each market is returned with its platform-native `market_id` and a human-readable `title`. Pricing, volume, status, and timestamps are intentionally deferred — they'll be added as additive fields to `EventMarket` in a later release. The endpoint mirrors the `/v1/markets` rollout pattern (titles first, fields later).
+     *
+     * **Kalshi sibling fanout.** A single Kalshi sports game lives across multiple event tickers that share a game suffix — e.g. `KXMLBGAME-26MAY221840CLEPHI` holds the moneyline, `KXMLBF5TOTAL-26MAY221840CLEPHI` holds the totals, and so on. When the supplied event_ticker belongs to a sport in the sibling registry (MLB, NBA, NFL, NHL, WNBA today), this endpoint fans out across known sibling series in parallel and merges their markets into one response. Siblings that don't exist for a particular game silently drop. Siblings that error are reported under `fanout.siblings_missing`; the primary event still returns 200 in that case. Only the primary fetch failing produces a 4xx/5xx — partial fanouts never fail the request.
+     *
+     * **Polymarket** events already nest the moneyline plus all spread/totals/game-level prop markets under a single event slug, so no fanout is performed. **SX Bet** fixtures similarly bundle game lines per `eventId`. **Predict** currently treats `event_id` as a market identifier and wraps the single market as a 1-element event response, since the upstream `event` concept on Predict is closer to a category than to a multi-market container.
+     *
+     * @param {PredictorSDK.GetEventRequest} 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.NotFoundError}
+     * @throws {@link PredictorSDK.TooManyRequestsError}
+     * @throws {@link PredictorSDK.BadGatewayError}
+     * @throws {@link PredictorSDK.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.getEvent({
+     *         eventId: "KXMLBGAME-26MAY221840CLEPHI"
+     *     })
+     */
+    getEvent(request: PredictorSDK.GetEventRequest, requestOptions?: PredictorSDKClient.RequestOptions): core.HttpResponsePromise<PredictorSDK.EventResponse>;
+    private __getEvent;
     /**
      * 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

@@ -519,6 +519,296 @@ export class PredictorSDKClient {
         }
         return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/v1/polymarket/wallet");
     }
+    /**
+     * Returns the current Polymarket positions for a wallet. Accepts either a wallet `address` (proxy address only — see note below) or a Polymarket `username`. Exactly one of the two must be supplied — passing both returns `400`.
+     *
+     * v1 surfaces a minimal field set so the endpoint scaffolding can be verified end-to-end: `condition_id` (which market), `outcome` (which side), and `shares` (how much). Title/slug, avg/current price, PnL (`cash_pnl`, `realized_pnl`), `redeemable`/`mergeable` flags, and event metadata will be added in follow-ups.
+     *
+     * `total` in the pagination block is always `0` because the upstream Data API does not return a total count; rely on `has_more` + `next_cursor` to paginate.
+     *
+     * **EOA inputs are not auto-resolved on this endpoint.** Unlike `/v1/polymarket/wallet`, this endpoint does not perform the EOA→proxy CREATE2 resolution. Callers with a signer EOA should call `/v1/polymarket/wallet` first to resolve the proxy, then pass the returned `address`. Passing an EOA directly will return an empty `data` array.
+     *
+     * @param {PredictorSDK.ListPolymarketWalletPositionsRequest} 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.NotFoundError}
+     * @throws {@link PredictorSDK.TooManyRequestsError}
+     * @throws {@link PredictorSDK.BadGatewayError}
+     * @throws {@link PredictorSDK.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.listPolymarketWalletPositions({
+     *         address: "0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b"
+     *     })
+     */
+    listPolymarketWalletPositions(request = {}, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__listPolymarketWalletPositions(request, requestOptions));
+    }
+    async __listPolymarketWalletPositions(request = {}, requestOptions) {
+        const { address, username, limit, cursor } = request;
+        const _queryParams = {
+            address,
+            username,
+            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/polymarket/wallet/positions"),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            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.PolymarketPositionsResponse.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 404:
+                    throw new PredictorSDK.NotFoundError(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/polymarket/wallet/positions");
+    }
+    /**
+     * Returns a single event and the markets nested under it on the identified platform. The `event_id` is the platform's native identifier — a Kalshi `event_ticker`, a Polymarket event slug, an SX Bet `eventId`, or a Predict market identifier. The `platform` is inferred from the ID format when unambiguous; callers must pass `?platform=` for numeric IDs or kebab-case slugs that could belong to either Polymarket or Predict.
+     *
+     * Response is minimal in v0: each market is returned with its platform-native `market_id` and a human-readable `title`. Pricing, volume, status, and timestamps are intentionally deferred — they'll be added as additive fields to `EventMarket` in a later release. The endpoint mirrors the `/v1/markets` rollout pattern (titles first, fields later).
+     *
+     * **Kalshi sibling fanout.** A single Kalshi sports game lives across multiple event tickers that share a game suffix — e.g. `KXMLBGAME-26MAY221840CLEPHI` holds the moneyline, `KXMLBF5TOTAL-26MAY221840CLEPHI` holds the totals, and so on. When the supplied event_ticker belongs to a sport in the sibling registry (MLB, NBA, NFL, NHL, WNBA today), this endpoint fans out across known sibling series in parallel and merges their markets into one response. Siblings that don't exist for a particular game silently drop. Siblings that error are reported under `fanout.siblings_missing`; the primary event still returns 200 in that case. Only the primary fetch failing produces a 4xx/5xx — partial fanouts never fail the request.
+     *
+     * **Polymarket** events already nest the moneyline plus all spread/totals/game-level prop markets under a single event slug, so no fanout is performed. **SX Bet** fixtures similarly bundle game lines per `eventId`. **Predict** currently treats `event_id` as a market identifier and wraps the single market as a 1-element event response, since the upstream `event` concept on Predict is closer to a category than to a multi-market container.
+     *
+     * @param {PredictorSDK.GetEventRequest} 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.NotFoundError}
+     * @throws {@link PredictorSDK.TooManyRequestsError}
+     * @throws {@link PredictorSDK.BadGatewayError}
+     * @throws {@link PredictorSDK.ServiceUnavailableError}
+     *
+     * @example
+     *     await client.getEvent({
+     *         eventId: "KXMLBGAME-26MAY221840CLEPHI"
+     *     })
+     */
+    getEvent(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getEvent(request, requestOptions));
+    }
+    async __getEvent(request, requestOptions) {
+        const { eventId, platform } = request;
+        const _queryParams = {
+            platform: platform != null
+                ? serializers.GetEventRequestPlatform.jsonOrThrow(platform, {
+                    unrecognizedObjectKeys: "strip",
+                    omitUndefined: true,
+                })
+                : undefined,
+        };
+        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/events/${core.url.encodePathParam(eventId)}`),
+            method: "GET",
+            headers: _headers,
+            queryString: core.url
+                .queryBuilder()
+                .addMany(_queryParams)
+                .mergeAdditional(requestOptions?.queryParams)
+                .build(),
+            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.EventResponse.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 404:
+                    throw new PredictorSDK.NotFoundError(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/events/{event_id}");
+    }
     /**
      * 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/GetEventRequest.d.ts

@@ -0,0 +1,13 @@
+import type * as PredictorSDK from "../../index.js";
+/**
+ * @example
+ *     {
+ *         eventId: "KXMLBGAME-26MAY221840CLEPHI"
+ *     }
+ */
+export interface GetEventRequest {
+    /** Platform-native event identifier. Examples per platform: Kalshi event ticker (`KXMLBGAME-26MAY221840CLEPHI`), Polymarket event slug (`mlb-cle-phi-2026-05-22`), SX Bet event id (`L10073358`), Predict market id (`110629`). */
+    eventId: string;
+    /** Optional platform override. When omitted, inferred from the `event_id` format: `KX…` → Kalshi, `L\d+` → SX Bet. Numeric IDs and kebab-case slugs are ambiguous between Polymarket and Predict; supplying `platform` is required in that case or the response is `400`. */
+    platform?: PredictorSDK.GetEventRequestPlatform;
+}

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * @example
+ *     {
+ *         address: "0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b"
+ *     }
+ */
+export interface ListPolymarketWalletPositionsRequest {
+    /** Polymarket proxy wallet address. Must match `^0x[a-fA-F0-9]{40}$`. Mixed-case input is accepted and lowercased in the response. Mutually exclusive with `username`; exactly one of the two is required. */
+    address?: string;
+    /** Polymarket display name to resolve to a proxy wallet. Match is case-insensitive and exact against the user's stored `name`. A leading `@` is accepted and stripped. Mutually exclusive with `address`. */
+    username?: string;
+    /** Number of items per page. Defaults to 50. */
+    limit?: number;
+    /** Opaque cursor from a previous response's `pagination.next_cursor`. Bound to the resolved wallet address — replaying a cursor against a different identifier returns `400`. */
+    cursor?: string;
+}

package/dist/api/client/requests/ListPolymarketWalletPositionsRequest.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,4 +1,6 @@
 export type { GetBinanceCryptoPricesRequest } from "./GetBinanceCryptoPricesRequest.js";
+export type { GetEventRequest } from "./GetEventRequest.js";
 export type { GetMarketsRequest } from "./GetMarketsRequest.js";
 export type { GetPolymarketWalletRequest } from "./GetPolymarketWalletRequest.js";
 export type { GetSportsMatchingMarketsRequest } from "./GetSportsMatchingMarketsRequest.js";
+export type { ListPolymarketWalletPositionsRequest } from "./ListPolymarketWalletPositionsRequest.js";

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

@@ -0,0 +1,8 @@
+export interface EventFanout {
+    /** Sibling event tickers the server attempted to fetch alongside the primary event. Determined by the Kalshi sibling registry for the primary event's series. */
+    siblingsAttempted: string[];
+    /** Sibling event tickers that returned successfully and contributed markets to the merged response. */
+    siblingsReturned: string[];
+    /** Sibling event tickers that did not exist upstream (404) or errored. The primary event still returned 200 — these are reported for observability, not as request failures. */
+    siblingsMissing: string[];
+}

package/dist/api/types/EventFanout.js

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

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

@@ -0,0 +1,6 @@
+export interface EventMarket {
+    /** Platform-native market identifier. Kalshi ticker (`KXMLBGAME-26MAY221840CLEPHI-CLE`), Polymarket numeric market id, SX Bet `marketHash`, or Predict market id. */
+    marketId: string;
+    /** Human-readable market title/question. */
+    title: string;
+}

package/dist/api/types/EventMarket.js

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

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

@@ -0,0 +1,13 @@
+import type * as PredictorSDK from "../index.js";
+export interface EventResponse {
+    /** Echo of the platform-native event identifier supplied in the request path. */
+    eventId: string;
+    /** The platform the event_id was resolved against, either inferred from the ID format or supplied via `?platform=`. */
+    platform: PredictorSDK.EventResponsePlatform;
+    /** Human-readable event title from the platform. */
+    title: string;
+    /** Markets nested under this event. Order is platform-native for the primary event, followed by markets from fanout siblings (Kalshi sports) in registry order. */
+    markets: PredictorSDK.EventMarket[];
+    /** Present when the response was assembled from multiple upstream events (Kalshi sports sibling fanout). Lists which sibling event tickers were attempted, which contributed markets, and which failed or didn't exist. Absent for non-Kalshi platforms and for Kalshi events whose series is not in the sibling registry. */
+    fanout?: PredictorSDK.EventFanout;
+}

package/dist/api/types/EventResponse.js

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

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

@@ -0,0 +1,8 @@
+/** The platform the event_id was resolved against, either inferred from the ID format or supplied via `?platform=`. */
+export declare const EventResponsePlatform: {
+    readonly Kalshi: "kalshi";
+    readonly Polymarket: "polymarket";
+    readonly Predict: "predict";
+    readonly Sxbet: "sxbet";
+};
+export type EventResponsePlatform = (typeof EventResponsePlatform)[keyof typeof EventResponsePlatform];

package/dist/api/types/EventResponsePlatform.js

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+/** The platform the event_id was resolved against, either inferred from the ID format or supplied via `?platform=`. */
+export const EventResponsePlatform = {
+    Kalshi: "kalshi",
+    Polymarket: "polymarket",
+    Predict: "predict",
+    Sxbet: "sxbet",
+};

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

@@ -0,0 +1,7 @@
+export declare const GetEventRequestPlatform: {
+    readonly Kalshi: "kalshi";
+    readonly Polymarket: "polymarket";
+    readonly Predict: "predict";
+    readonly Sxbet: "sxbet";
+};
+export type GetEventRequestPlatform = (typeof GetEventRequestPlatform)[keyof typeof GetEventRequestPlatform];

package/dist/api/types/GetEventRequestPlatform.js

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

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

@@ -1,7 +1,7 @@
 export interface PaginationBlock {
     /** Number of items requested per page (echoes the `limit` query param). */
     limit: number;
-    /** Total matching items across all pages. */
+    /** Total matching items across all pages, when known. Set to `0` for endpoints whose upstream does not expose a total count — clients should rely on `has_more` and `next_cursor` to paginate in that case. */
     total: number;
     /** Whether additional pages exist beyond this one. */
     hasMore: boolean;

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

@@ -0,0 +1,8 @@
+export interface PolymarketPosition {
+    /** Polymarket condition ID (`0x`-prefixed hex). */
+    conditionId: string;
+    /** Outcome label held in this position (`Yes`/`No` for binary markets). */
+    outcome: string;
+    /** Number of outcome shares held. */
+    shares: number;
+}

package/dist/api/types/PolymarketPosition.js

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

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

@@ -0,0 +1,7 @@
+import type * as PredictorSDK from "../index.js";
+export interface PolymarketPositionsResponse {
+    /** Resolved Polymarket proxy wallet (lowercased). */
+    address: string;
+    data: PredictorSDK.PolymarketPosition[];
+    pagination: PredictorSDK.PaginationBlock;
+}

package/dist/api/types/PolymarketPositionsResponse.js

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

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

@@ -1,12 +1,19 @@
 export * from "./CryptoPriceItem.js";
 export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
+export * from "./EventFanout.js";
+export * from "./EventMarket.js";
+export * from "./EventResponse.js";
+export * from "./EventResponsePlatform.js";
+export * from "./GetEventRequestPlatform.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 "./PolymarketPosition.js";
+export * from "./PolymarketPositionsResponse.js";
 export * from "./PolymarketWalletResponse.js";
 export * from "./SportsMatchingResponse.js";
 export * from "./UnifiedMarket.js";

package/dist/api/types/index.js

@@ -1,12 +1,19 @@
 export * from "./CryptoPriceItem.js";
 export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
+export * from "./EventFanout.js";
+export * from "./EventMarket.js";
+export * from "./EventResponse.js";
+export * from "./EventResponsePlatform.js";
+export * from "./GetEventRequestPlatform.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 "./PolymarketPosition.js";
+export * from "./PolymarketPositionsResponse.js";
 export * from "./PolymarketWalletResponse.js";
 export * from "./SportsMatchingResponse.js";
 export * from "./UnifiedMarket.js";

package/dist/serialization/types/EventFanout.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 EventFanout: core.serialization.ObjectSchema<serializers.EventFanout.Raw, PredictorSDK.EventFanout>;
+export declare namespace EventFanout {
+    interface Raw {
+        siblings_attempted: string[];
+        siblings_returned: string[];
+        siblings_missing: string[];
+    }
+}

package/dist/serialization/types/EventFanout.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 EventFanout = core.serialization.object({
+    siblingsAttempted: core.serialization.property("siblings_attempted", core.serialization.list(core.serialization.string())),
+    siblingsReturned: core.serialization.property("siblings_returned", core.serialization.list(core.serialization.string())),
+    siblingsMissing: core.serialization.property("siblings_missing", core.serialization.list(core.serialization.string())),
+});

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

@@ -0,0 +1,10 @@
+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 EventMarket: core.serialization.ObjectSchema<serializers.EventMarket.Raw, PredictorSDK.EventMarket>;
+export declare namespace EventMarket {
+    interface Raw {
+        market_id: string;
+        title: string;
+    }
+}

package/dist/serialization/types/EventMarket.js

@@ -0,0 +1,6 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+export const EventMarket = core.serialization.object({
+    marketId: core.serialization.property("market_id", core.serialization.string()),
+    title: core.serialization.string(),
+});

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

@@ -0,0 +1,16 @@
+import type * as PredictorSDK from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { EventFanout } from "./EventFanout.js";
+import { EventMarket } from "./EventMarket.js";
+import { EventResponsePlatform } from "./EventResponsePlatform.js";
+export declare const EventResponse: core.serialization.ObjectSchema<serializers.EventResponse.Raw, PredictorSDK.EventResponse>;
+export declare namespace EventResponse {
+    interface Raw {
+        event_id: string;
+        platform: EventResponsePlatform.Raw;
+        title: string;
+        markets: EventMarket.Raw[];
+        fanout?: EventFanout.Raw | null;
+    }
+}

package/dist/serialization/types/EventResponse.js

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.js";
+import { EventFanout } from "./EventFanout.js";
+import { EventMarket } from "./EventMarket.js";
+import { EventResponsePlatform } from "./EventResponsePlatform.js";
+export const EventResponse = core.serialization.object({
+    eventId: core.serialization.property("event_id", core.serialization.string()),
+    platform: EventResponsePlatform,
+    title: core.serialization.string(),
+    markets: core.serialization.list(EventMarket),
+    fanout: EventFanout.optional(),
+});

package/dist/serialization/types/EventResponsePlatform.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 EventResponsePlatform: core.serialization.Schema<serializers.EventResponsePlatform.Raw, PredictorSDK.EventResponsePlatform>;
+export declare namespace EventResponsePlatform {
+    type Raw = "kalshi" | "polymarket" | "predict" | "sxbet";
+}

package/dist/serialization/types/EventResponsePlatform.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 EventResponsePlatform = core.serialization.enum_(["kalshi", "polymarket", "predict", "sxbet"]);

package/dist/serialization/types/GetEventRequestPlatform.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 GetEventRequestPlatform: core.serialization.Schema<serializers.GetEventRequestPlatform.Raw, PredictorSDK.GetEventRequestPlatform>;
+export declare namespace GetEventRequestPlatform {
+    type Raw = "kalshi" | "polymarket" | "predict" | "sxbet";
+}

package/dist/serialization/types/GetEventRequestPlatform.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 GetEventRequestPlatform = core.serialization.enum_(["kalshi", "polymarket", "predict", "sxbet"]);

package/dist/serialization/types/PolymarketPosition.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 PolymarketPosition: core.serialization.ObjectSchema<serializers.PolymarketPosition.Raw, PredictorSDK.PolymarketPosition>;
+export declare namespace PolymarketPosition {
+    interface Raw {
+        condition_id: string;
+        outcome: string;
+        shares: number;
+    }
+}

package/dist/serialization/types/PolymarketPosition.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 PolymarketPosition = core.serialization.object({
+    conditionId: core.serialization.property("condition_id", core.serialization.string()),
+    outcome: core.serialization.string(),
+    shares: core.serialization.number(),
+});

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

@@ -0,0 +1,13 @@
+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 { PolymarketPosition } from "./PolymarketPosition.js";
+export declare const PolymarketPositionsResponse: core.serialization.ObjectSchema<serializers.PolymarketPositionsResponse.Raw, PredictorSDK.PolymarketPositionsResponse>;
+export declare namespace PolymarketPositionsResponse {
+    interface Raw {
+        address: string;
+        data: PolymarketPosition.Raw[];
+        pagination: PaginationBlock.Raw;
+    }
+}

package/dist/serialization/types/PolymarketPositionsResponse.js

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

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

@@ -1,12 +1,19 @@
 export * from "./CryptoPriceItem.js";
 export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
+export * from "./EventFanout.js";
+export * from "./EventMarket.js";
+export * from "./EventResponse.js";
+export * from "./EventResponsePlatform.js";
+export * from "./GetEventRequestPlatform.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 "./PolymarketPosition.js";
+export * from "./PolymarketPositionsResponse.js";
 export * from "./PolymarketWalletResponse.js";
 export * from "./SportsMatchingResponse.js";
 export * from "./UnifiedMarket.js";

package/dist/serialization/types/index.js

@@ -1,12 +1,19 @@
 export * from "./CryptoPriceItem.js";
 export * from "./CryptoPricesResponse.js";
 export * from "./ErrorResponse.js";
+export * from "./EventFanout.js";
+export * from "./EventMarket.js";
+export * from "./EventResponse.js";
+export * from "./EventResponsePlatform.js";
+export * from "./GetEventRequestPlatform.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 "./PolymarketPosition.js";
+export * from "./PolymarketPositionsResponse.js";
 export * from "./PolymarketWalletResponse.js";
 export * from "./SportsMatchingResponse.js";
 export * from "./UnifiedMarket.js";

package/package.json

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