[github-actions]

This PR was opened by the Changesets release GitHub action. Merging publishes these versions to npm.

Releases

@polymarket/bindings@0.14.0

Minor Changes

• c05ca40, f059b22: Add optional equity market status (open, closed, unknown) to spot/TWAP updates and snapshots; omission means not stated, never open. Status describes the provider's instrument. Spot status-only updates may repeat the price timestamp with isCarriedForward: true; do not deduplicate by timestamp alone. Older unstated spot frames retain the last stated snapshot status. Snapshots carry status at batch level and may retain an older closing price; TWAP status changes with a new price.
• 3bc5493: Breaking 0.x: SplitActivity, MergeActivity and RedeemActivity include Combo variants (isCombo: true, ComboConditionId, optional titles, no slug/eventSlug). Add !activity.isCombo to SPLIT/MERGE/REDEEM guards before accessing market URLs. Parsed ordinary rows use isCombo: false; ordinary object construction may omit it. Combo presentation metadata is optional; trade/redemption outcome and outcomeIndex preserve zero and normalize blank labels/index 999 to undefined. Automatic redemption remains REDEEM; listComboActivity is unchanged.
• 3d93028: Add one-shot authenticated order heartbeats with mismatch-ID recovery (OrderHeartbeatMismatchError retains RequestRejectedError inheritance and its own runtime name). The first accepted send enables API-key-wide timeout cancellation with no disarm operation. Callers own scheduling and ID serialization; cancellation after expiry is best effort.
• 8ae8885: Add Router v2 neg-risk workflows by market condition ID; low-level helpers retain explicit protocol event IDs.
• ef3d314: Add optional oracle event/request IDs, market resolution status, and discovery filters for these fields and protocol version, with pagination and backend ID-count limits.
• 8d0ecfb, bffb030, 66b441d: Add filtered/sorted reward-market cursor pagination (preserving selections, supported 24-hour volume keys, no removed tag-exclusion filter, ISO 8601 dates), current maker rebates by date/address (decimal-string amounts; empty results become []), and direct outcome-asset reference lookup by decimal asset/condition selectors with nullable metadata.
• a2ebe7c, 84e07ef, bdcfad0, d79941a: Extend experimental Perps with fill instrument filters and ADL/liquidation details, portfolio available order margin/fee tier/position ADL index, and instrument UI live time/logos (advisory, not trading eligibility). Preserve server event horizons as eventTimestamp: EpochMilliseconds | null independently of send time; zero becomes null, and synthetic recovery invents no horizon.
• 3fd2412: Normalize native/upstream rejection envelopes and expose extensible known rejection codes, preserving transport fallbacks.

Patch Changes

• d54c900, 24ec298: Normalize gameStartTime on new-market events/notifications to ISO 8601, empty values to null, and impossible dates/times to validation failures. Deliver user order websocket INVALID and CANCELED_* statuses instead of dropping them.
• 911574f, edf336f: Add optional native/sponsored earnings breakdowns and sponsored queries without changing defaults; retain taker-tier upgrade notifications (previous/current tier, rebate basis points and snapshot date).
• 7705d09: UMA lifecycle rows retain the initial RequestPrice log index, while their transaction hash may identify a later event; do not combine them as a log locator. Condition-resolution fallback rows retain their own event transaction/log metadata.
• Update @polymarket/types to 0.3.0 (removed neverthrow exports and unwrap; await SDK requests directly and import remaining neverthrow APIs from your own dependency).

@polymarket/client@0.14.0

Minor Changes

• c05ca40, f059b22: Add optional equity market status (open, closed, unknown) to spot/TWAP updates and snapshots; omission means not stated, never open. Status describes the provider's instrument. Spot status-only updates may repeat the price timestamp with isCarriedForward: true; do not deduplicate by timestamp alone. Older unstated spot frames retain the last stated snapshot status. Snapshots carry status at batch level and may retain an older closing price; TWAP status changes with a new price.
• 8e79e95: Breaking dependency migration: @polymarket/types@0.3.0 removes neverthrow re-exports and unwrap. Await SDK requests directly (await service.get(path) replaces await unwrap(service.get(path))); service promises return parsed data, with { responseType: "raw" } for a response object. Add neverthrow as your own dependency for any remaining imports.
• 0b23abe, b268185: Add closed: 'any' for market/event discovery while preserving open-only defaults, and scalar/array listEvents protocol-version filters (one or two supported values; repeated query parameters; retained in continuation/query-bound cursors). Omission keeps the server default of CTF v1 events.
• aeed79a, 3025be9: Add experimental custom fetch and per-read signal, retries, and timeout controls. Default to two retries per request and a 30-second HTTP timeout including RPC; pagination requests have independent budgets. Set timeout in milliseconds or false to disable it.
• caceac5, f6ab0ec, 23cf0b3: Add experimental predictions through https://api.defi.polymarket.com with POLYMARKET_CLIENT metadata; preserve gateway errors and never automatically retry prediction mutations.
• 3bc5493: Breaking 0.x: SplitActivity, MergeActivity and RedeemActivity include Combo variants (isCombo: true, ComboConditionId, optional titles, no slug/eventSlug). Add !activity.isCombo to SPLIT/MERGE/REDEEM guards before accessing market URLs. Parsed ordinary rows use isCombo: false; ordinary object construction may omit it. Combo presentation metadata is optional; trade/redemption outcome and outcomeIndex preserve zero and normalize blank labels/index 999 to undefined. Automatic redemption remains REDEEM; listComboActivity is unchanged.
• 3d93028: Add one-shot authenticated order heartbeats with mismatch-ID recovery (OrderHeartbeatMismatchError retains RequestRejectedError inheritance and its own runtime name). The first accepted send enables API-key-wide timeout cancellation with no disarm operation. Callers own scheduling and ID serialization; cancellation after expiry is best effort.
• 8ae8885: Add Router v2 neg-risk workflows by market condition ID; low-level helpers retain explicit protocol event IDs.
• ef3d314: Add optional oracle event/request IDs, market resolution status, and discovery filters for these fields and protocol version, with pagination and backend ID-count limits.
• 8d0ecfb, bffb030, 66b441d: Add filtered/sorted reward-market cursor pagination (preserving selections, supported 24-hour volume keys, no removed tag-exclusion filter, ISO 8601 dates), current maker rebates by date/address (decimal-string amounts; empty results become []), and direct outcome-asset reference lookup by decimal asset/condition selectors with nullable metadata.
• a2ebe7c, 84e07ef, bdcfad0, d79941a: Extend experimental Perps with fill instrument filters and ADL/liquidation details, portfolio available order margin/fee tier/position ADL index, and instrument UI live time/logos (advisory, not trading eligibility). Preserve server event horizons as eventTimestamp: EpochMilliseconds | null independently of send time; zero becomes null, and synthetic recovery invents no horizon.
• 3fd2412: Normalize native/upstream rejection envelopes and expose extensible known rejection codes, preserving transport fallbacks.

Patch Changes

• d62a171: Automatic pagination throws UnexpectedResponseError on missing or repeated continuation cursors after yielding fetched pages, preventing restart/loops.
• d64b285: Wallet-anchored closed-position queries for tokens, value, price or unrealized PnL use realized-PnL ordering. Preserve filters/sort on replay; discard rejected obsolete cursors and start a new first page manually.
• 70fb500: Continue internal-transfer history past full millisecond pages only after verifying the overlap is complete, without duplicates or skipped rows.
• d54c900, 24ec298: Normalize gameStartTime on new-market events/notifications to ISO 8601, empty values to null, and impossible dates/times to validation failures. Deliver user order websocket INVALID and CANCELED_* statuses instead of dropping them.
• 911574f, edf336f: Add optional native/sponsored earnings breakdowns and sponsored queries without changing defaults; retain taker-tier upgrade notifications (previous/current tier, rebate basis points and snapshot date).
• Update @polymarket/bindings to 0.14.0 and @polymarket/types to 0.3.0.

@polymarket/types@0.3.0

Minor Changes

• 8e79e95: Breaking: remove neverthrow exports and unwrap. Await SDK requests directly;
  import any remaining neverthrow APIs from your own dependency.

---

Note

High Risk
This release bundles breaking API/type changes (neverthrow removal, activity union changes) with trading, heartbeat, gateway, and pagination behavior changes that can break existing integrations on upgrade.

Overview
Release packaging only: merges accumulated changesets into package changelogs, bumps @polymarket/bindings and @polymarket/client to 0.14.0 and @polymarket/types to 0.3.0, and deletes the consumed .changeset/*.md files so merging publishes these versions to npm.

The published 0.14.0 SDK line (documented in the new changelog sections) adds discovery and transport controls (closed: 'any', listEvents protocol-version filters, default 30s timeouts, per-read fetch/signal/retries/timeout), experimental predictions via the DeFi gateway, order heartbeats, Router v2 neg-risk by condition ID, reward markets / maker rebates / outcome-asset lookups, equity market status on price streams, and further experimental Perps and Gamma parity. Breaking 0.x updates include Combo variants on split/merge/redeem activity (isCombo guards) and @polymarket/types@0.3.0 dropping neverthrow re-exports and unwrap—callers should await SDK methods directly. Patch notes cover stricter automatic pagination cursors, closed-position ordering/cursor behavior, and websocket order statuses that were previously dropped.

^{Reviewed by Cursor Bugbot for commit b60fff9. Bugbot is set up for automated code reviews on this repo. Configure here.}

[kartojal]

Reviewed the release metadata, compact changelog, package exports, and non-live verification for this candidate.