2026-05-27 - More reliable sports discovery
Sports and esports discovery now stays useful when Polymarket’s primary event listing is incomplete or temporarily unavailable. What’s improved:GET /v2/sports/leagues/{code}/gamesresolves each public league code to its sports series, then appliesstatus,sort,direction,limit, andoffsetconsistently.- Responses include
series_id,source,fallback, andstale, so clients can tell which source produced the result and whether a recent last-known-good response was used. - Known event variants such as exact-score, halftime-result, and more-markets pages are deduplicated in favor of the canonical game.
GET /v2/sports/searchcan fall back to alternate Polymarket event discovery instead of returning an upstream502immediately.GET /v2/sports/games/{slug}/historynow defaults to the full available history when no interval or timestamp range is supplied.GET /v2/sports/livecan supplement a partial sports summary with league-level event data instead of returning mostly empty arrays.
stale: true for up to 12 hours.
Docs: Sports Markets
2026-05-27 - One-month USDC checkout
Logged-in customers can buy one month of polynode access with USDC directly from the pricing page. What’s new:- Starter, Growth, and Enterprise pricing cards offer a
Pay 1 month with USDCoption alongside normal card subscriptions. - USDC purchases are one-time 30-day access grants, not recurring subscriptions.
- A later USDC purchase extends access from the end of the customer’s current USDC period rather than shortening or replacing it.
- Customers with an active card subscription are protected from accidental double payment. Trialing or past-due card users can switch to one-month USDC access.
- Existing card checkout, account login, API keys, and plan entitlements continue to work as before.
2026-05-27 - V3 wallet P&L alignment, fees, rebates, rewards, and PolyUSD flows
Updated V3 wallet accounting surfaces. What’s new:- Default/all-time
GET /v3/wallets/{address}/pnl/eventsnow returns a single all-time bucket so it agrees withGET /v3/wallets/{address}/pnl. - Explicit time-windowed P&L events (
period,after, orbefore) return realized P&L buckets and ignore timestamp-0 artifacts. - Added
GET /v3/wallets/{address}/fees-paidfor fee-bearing wallet fills. - Added
GET /v3/wallets/{address}/polyusd-flowsfor wallet PolyUSD deposits and withdrawals. - Added
GET /v3/wallets/{address}/rebatesfor maker rebates. - Added public reward-market configuration at
GET /v3/rewards/marketsandGET /v3/rewards/markets/{condition_id}.
- Fees paid and maker rebates are intentionally separate surfaces. LP reward market configuration is public; per-wallet earned LP rewards require authenticated Polymarket data and are not exposed as an arbitrary-wallet lookup in the public docs.
GET /v3/wallets/{address}/activityremains the conditional-token activity feed; PolyUSD deposits and withdrawals now live in the separate wallet PolyUSD flows endpoint.
2026-05-26 - Webhooks beta: first observed position opens
Addedposition_status_change support for watched-wallet CTF position opens and exits.
What’s new:
position_status_changenow detects first observednonetoopentransitions for watched wallets.- Existing positions are established as the wallet’s baseline when it is first watched, so future transitions are emitted without replaying historical opens.
- Adding another watched wallet does not replay source activity from before that wallet’s own baseline.
- Payloads include
previous_amount,new_amount,delta_amount,transfer_amount,source,source_event_id, block and transaction fields, and market enrichment. - Filters include
wallet_addresses,token_ids,condition_ids,event_slugs,tags,status_from, andstatus_to.
wallet_addresses is required. Unfiltered global position-status webhooks are not enabled.
Docs: position_status_change
2026-05-26 - Polymarket Profiles API
Added a paid-plan API for apps that want users to create or change a Polymarket username from a user-owned EOA without sharing private keys or long-lived Polymarket credentials. New endpoints:GET /v3/polymarket/profiles/username-availablechecks a requested username. Local format is 3-32 letters, numbers, or underscores; Polymarket remains the final authority.POST /v3/polymarket/profiles/username/challengereturns the Polymarket sign-in message and polynode consent typed data for the user’s wallet. Challenges expire after 10 minutes.POST /v3/polymarket/profiles/username/completeverifies both signatures and completes the profile or username action.GET /v3/polymarket/profiles/{address}returns normalized public profile information.
2026-05-26 - TypeScript SDK v0.10.13: V3 parity, resolver, and profile helpers
Released a TypeScript SDK parity update for the current REST API surface. What’s new:pn.v3namespace for the V3 historical data API while preserving existing top-level SDK behavior.- Typed V3 methods for wallet summaries, wallet P&L, P&L events, wallet trades, wallet positions, global trades, global positions, market search, market price, market trades, market positions, leaderboard, tags, builders, builder trades, fees, resolutions, conditions, and token info.
- Builder trade filters in the SDK:
tokenId,conditionId,marketSlug,eventSlug,side,category,tagSlug,minAmount,after,before,limit, andoffset. pn.resolve(query)for wallet, EOA, or username resolution, returning{ safe, eoa, username, type }.- Fully typed
pn.walletOnchainPositions()responses, including market metadata, status, price, P&L, and lifecycle timestamps. - V3 Polymarket profile helpers:
polymarketUsernameAvailable,createPolymarketUsernameChallenge,completePolymarketUsername, andpolymarketProfile.
pn.market(), pn.wallet(), pn.leaderboard(), and other top-level methods keep their historical paths and response shapes.
Upgrade:
2026-05-25 - Rust SDK v0.13.5 deposit-wallet onboarding fix
Releasedpolynode v0.13.5 for Rust integrations using V2 deposit wallets and POLY_1271 signatures.
What’s fixed:
ensure_ready()recognizes an already-deployed deposit wallet from its onchain contract state instead of re-entering a failed deployment loop.- Deposit-wallet approval batches contain only the supported V2 pUSD and Conditional Tokens approvals.
- Nested approval batches use the correct EIP-712 encoding and normalized wallet signature format.
- After setup, the SDK refreshes the V2 CLOB balance and allowance state for both new and already-deployed deposit wallets.
- Orders continue to use the deposit wallet as maker, the owner EOA as signer, and signature type
3(POLY_1271).
2026-05-25 - Sports and esports API suite
Added a game-centered API for discovering Polymarket sports markets, current prices, price history, and WebSocket subscription targets. New and expanded routes include:GET /v2/sports/leagues,/v2/sports/live, and/v2/sports/market-typesfor discovery and overview data.GET /v2/sports/leagues/{league}/teamsand/v2/sports/leagues/{league}/gamesfor league-specific coverage.GET /v2/sports/games/{slug}for normalized game and market details.GET /v2/sports/games/{slug}/statefor one object containing metadata, score fields, markets, current prices, and an orderbook subscription payload.GET /v2/sports/games/{slug}/pricesand/historyfor current CLOB price data and batch token history.GET /v2/sports/games/{slug}/contextfor generated matchup, injury, lineup, news, social, or market queries with optional game state.GET /v2/sports/search?q={query}for sports event and team search.
2026-05-25 - Online Search API beta
AddedGET /v2/search/online for low-volume web context and market research.
The endpoint returns normalized organic results with title, URL, domain, snippet, source engines, score, category, and optional publication time. It supports:
max_results, default10and maximum20- comma-separated
engines language, defaulten-UStime_range=day|week|month|yearsafe_search=0|1|2cache_ttl_seconds, default600and maximum3600
2026-05-25 - Public plan-limit conventions clarified
Consolidated the public limits into one plan table and separated Event WebSocket limits from Orderbook WebSocket limits. At the time of this release:- REST limits were 60 requests/minute on Free, 600 on Starter, 3,000 on Growth, and custom on Enterprise.
- Event WebSocket and Orderbook WebSocket connection limits were each 1 on Free, 10 on Starter, 50 on Growth, and unlimited on Enterprise.
- A subscription could contain up to 10,000 filter items; paid plans had unlimited session time and unlimited orderbook market subscriptions.
- API-key allowances were 1 on Free, 3 on Starter, 10 on Growth, and 25 on Enterprise.
- Expensive endpoints could still carry endpoint-specific caps or plan requirements in addition to the plan’s main REST allowance.
2026-05-25 - Polygon RPC endpoint restored
https://rpc.polynode.dev returned to service for authenticated Polygon JSON-RPC requests.
The endpoint again served live chain reads such as eth_chainId and eth_blockNumber using the existing request shape and API-key authentication. No client change was required.
Docs: Polygon RPC
