# PolyNode

- [WebSocket Overview](https://docs.polynode.dev/websocket/overview.md): Real-time Polymarket trades, 3-5 seconds before on-chain confirmation.
- [Subscriptions & Filters](https://docs.polynode.dev/websocket/subscribing.md): Subscription types, filter options, and how event matching works.
- [Combo Stream](https://docs.polynode.dev/websocket/combos.md): Real-time Polymarket combo trades from pending calldata through receipt confirmation.
- [Compression](https://docs.polynode.dev/websocket/compression.md): Reduce WebSocket bandwidth by ~60% with built-in zlib compression.
- [Settlement Event](https://docs.polynode.dev/websocket/events/settlement.md): Polymarket settlement — pending (pre-chain) or confirmed (on-chain).
- [Status Update Event](https://docs.polynode.dev/websocket/events/status-update.md): Notification when a pending settlement confirms on-chain, with exact fill data from receipt logs.
- [Combo Execution Event](https://docs.polynode.dev/websocket/events/combo-execution.md): Pending Polymarket combo trades decoded from ExchangeV3 calldata.
- [Combo Status Update Event](https://docs.polynode.dev/websocket/events/combo-status-update.md): Receipt-backed confirmation for a pending combo execution or combo lifecycle transaction.
- [Combo Lifecycle Event](https://docs.polynode.dev/websocket/events/combo-lifecycle.md): Split, merge, redeem, convert, wrap, unwrap, and related combo lifecycle actions.
- [Combo Approval Event](https://docs.polynode.dev/websocket/events/combo-approval.md): PositionManager approval events relevant to combo settlement and auto-redemption.
- [Trade Event](https://docs.polynode.dev/websocket/events/trade.md): Confirmed on-chain trade execution from Polymarket exchange contracts.
- [Price Feed Event](https://docs.polynode.dev/websocket/events/price-feed.md): Real-time crypto price updates -- BTC, ETH, SOL, BNB, XRP, DOGE, HYPE.
- [Block Event](https://docs.polynode.dev/websocket/events/block.md): New Polygon block with Polymarket-specific statistics.
- [Position Change Event](https://docs.polynode.dev/websocket/events/position-change.md): Polymarket position transfers between wallets.
- [Deposit Event](https://docs.polynode.dev/websocket/events/deposit.md): USDC and PolyUSD deposits and withdrawals on Polymarket.
- [Position Split Event](https://docs.polynode.dev/websocket/events/position-split.md): Collateral split into outcome tokens on Polymarket.
- [Position Merge Event](https://docs.polynode.dev/websocket/events/position-merge.md): Outcome tokens merged back into collateral on Polymarket.
- [Positions Converted Event](https://docs.polynode.dev/websocket/events/positions-converted.md): Position conversion on neg-risk multi-outcome markets.
- [Oracle Event](https://docs.polynode.dev/websocket/events/oracle.md): UMA Optimistic Oracle events — market initializations, proposals, disputes, resolutions, settlements, and admin actions on Polymarket.
- [Redemption Event](https://docs.polynode.dev/websocket/events/redemption.md): Position payout redemptions on Polymarket.
- [Perps WebSocket](https://docs.polynode.dev/perps/websocket/overview.md): One connection streams every perps channel: tickers, books, best bid/offer, trades, statistics, and candles.
- [Channels](https://docs.polynode.dev/perps/websocket/channels.md): Every perps WebSocket channel and its payload.
- [Examples](https://docs.polynode.dev/websocket/examples.md): Complete WebSocket examples in JavaScript, Python, and wscat.
- [Webhooks](https://docs.polynode.dev/webhooks/overview.md): Push notifications for Polymarket events — trades, price changes, market resolutions, and more.
- [trade](https://docs.polynode.dev/webhooks/events/trade.md): Fires when a fill occurs involving wallets or markets you're watching.
- [large_trade](https://docs.polynode.dev/webhooks/events/large-trade.md): Fires when any trade exceeds your USD threshold. No wallet filter required — catches whale trades across all markets.
- [builder_trade](https://docs.polynode.dev/webhooks/events/builder-trade.md): Fires when a trade is routed through a specific builder. Monitor builder volume, attribution, and fee flow.
- [first_trade](https://docs.polynode.dev/webhooks/events/first-trade.md): Fires when a wallet makes its first-ever Polymarket trade. Detect new market participants.
- [price_change](https://docs.polynode.dev/webhooks/events/price-change.md): Fires when a token's price changes. Track price movements across any market.
- [market_resolved](https://docs.polynode.dev/webhooks/events/market-resolved.md): Fires when a Polymarket market is resolved. Get the winning outcome, payouts, and market details instantly.
- [market_created](https://docs.polynode.dev/webhooks/events/market-created.md): Fires when a new prediction market appears on Polymarket.
- [pnl_change](https://docs.polynode.dev/webhooks/events/pnl-change.md): Fires when a wallet's realized PnL changes. Track profit milestones, loss alerts, and performance shifts.
- [position_status_change](https://docs.polynode.dev/webhooks/events/position-status-change.md): Fires when a watched wallet's CTF position changes state, including first observed opens.
- [redemption](https://docs.polynode.dev/webhooks/events/redemption.md): Fires when a wallet redeems shares from a resolved market. Know instantly when a leader cashes out.
- [split](https://docs.polynode.dev/webhooks/events/split.md): Fires when a wallet splits conditional tokens. Track collateral movements and position restructuring.
- [merge](https://docs.polynode.dev/webhooks/events/merge.md): Fires when a wallet merges conditional tokens. Inverse of split — tokens combined back into collateral.
- [neg_risk_conversion](https://docs.polynode.dev/webhooks/events/neg-risk-conversion.md): Fires on neg-risk conversion events. Track hedging activity in multi-outcome markets.
- [fee_earned](https://docs.polynode.dev/webhooks/events/fee-earned.md): Fires when a fee receiver gets paid. Track builder revenue, market maker fees, or protocol fee flows.
- [wallet_activity](https://docs.polynode.dev/webhooks/events/wallet-activity.md): Fires on any action by a watched wallet — trades, redemptions, splits, merges, and neg-risk conversions. One webhook replaces five.
- [order_complete](https://docs.polynode.dev/webhooks/events/order-complete.md): Fires when a multi-fill order finishes. One aggregated event per order instead of N individual fills.
- [Create Webhook](https://docs.polynode.dev/webhooks/management/create.md): Register a new webhook to receive event notifications.
- [List Webhooks](https://docs.polynode.dev/webhooks/management/list.md): List all webhooks registered to your API key.
- [Get Webhook](https://docs.polynode.dev/webhooks/management/get.md): Retrieve one webhook subscription by id.
- [Update Webhook](https://docs.polynode.dev/webhooks/management/update.md): Update a webhook's URL, filters, event types, or active status.
- [Delete Webhook](https://docs.polynode.dev/webhooks/management/delete.md): Permanently delete a webhook and its delivery history.
- [Test Webhook](https://docs.polynode.dev/webhooks/management/test.md): Send a test delivery to verify your endpoint is reachable and configured correctly.
- [Rotate Secret](https://docs.polynode.dev/webhooks/management/rotate-secret.md): Generate a new HMAC signing secret for a webhook.
- [Delivery History](https://docs.polynode.dev/webhooks/management/deliveries.md): View the delivery history for a webhook — status codes, latency, errors, and retry attempts.
- [List Event Types](https://docs.polynode.dev/webhooks/management/event-types.md): Retrieve all available webhook event types with descriptions and supported filters.
- [API Reference](https://docs.polynode.dev/api-reference/overview.md): Start here for PolyNode REST APIs: V3 Polymarket data, wallet analytics, market data, orderbook snapshots, profiles, search, and legacy endpoints.
- [API Overview](https://docs.polynode.dev/data/overview.md): polynode API reference. Real-time streaming, historical data, P&L analytics, market data, and more.
- [Query Catalog](https://docs.polynode.dev/data/query-catalog/overview.md): Intent-based catalog of the most useful PolyNode V3 query shapes.
- [Trades Query Catalog](https://docs.polynode.dev/data/query-catalog/trades.md): Trade feed recipes for global, wallet, order-hash, market, builder, grouped-order, and combo trade queries.
- [All Trades](https://docs.polynode.dev/data/query-catalog/trades/all-trades.md): Browse the global Polymarket trade feed.
- [Trades by Wallet](https://docs.polynode.dev/data/query-catalog/trades/by-wallet.md): Get trades where a wallet participated as maker or taker.
- [Trades by Order Hash](https://docs.polynode.dev/data/query-catalog/trades/by-order-hash.md): Return every fill for an exact Polymarket order, globally or inside a wallet or market scope.
- [Trades by Market Token](https://docs.polynode.dev/data/query-catalog/trades/by-market-token.md): Get trades for one outcome token.
- [Trades by Market Slug](https://docs.polynode.dev/data/query-catalog/trades/by-market-slug.md): Get trades for all outcome tokens in one market slug.
- [Wallet Trades by Condition](https://docs.polynode.dev/data/query-catalog/trades/wallet-by-condition.md): Filter one wallet's trades to a specific market condition.
- [Wallet Trades Grouped by Order](https://docs.polynode.dev/data/query-catalog/trades/wallet-grouped-by-order.md): Group wallet fills by order hash.
- [Builder Trades](https://docs.polynode.dev/data/query-catalog/trades/by-builder.md): Get trades attributed to a builder code.
- [Combo Wallet Trades](https://docs.polynode.dev/data/query-catalog/trades/combo-wallet-trades.md): Get combo-only wallet trades or include combo trades in the standard wallet trade view.
- [Positions Query Catalog](https://docs.polynode.dev/data/query-catalog/positions.md): Position recipes for wallet positions, open positions, holders, market positions, and combo positions.
- [Positions by Wallet](https://docs.polynode.dev/data/query-catalog/positions/by-wallet.md): Get all standard positions for one wallet.
- [Open Wallet Positions](https://docs.polynode.dev/data/query-catalog/positions/open-wallet-positions.md): Get current open positions for one wallet.
- [Global Positions](https://docs.polynode.dev/data/query-catalog/positions/global-positions.md): Browse platform-wide open positions.
- [Positions by Market Token](https://docs.polynode.dev/data/query-catalog/positions/by-market-token.md): Get holders for one outcome token.
- [Positions by Condition](https://docs.polynode.dev/data/query-catalog/positions/by-condition.md): Get holders across all outcomes in one market condition.
- [Positions by Market Slug](https://docs.polynode.dev/data/query-catalog/positions/by-market-slug.md): Get holders for a market URL slug.
- [Combo Positions](https://docs.polynode.dev/data/query-catalog/positions/combo-positions.md): Get combo-only wallet positions or include combos in the standard wallet position view.
- [P&L Query Catalog](https://docs.polynode.dev/data/query-catalog/pnl.md): P&L recipes for wallet totals, time windows, tag and market filters, events, batches, and leaderboards.
- [Wallet All-Time P&L](https://docs.polynode.dev/data/query-catalog/pnl/wallet-all-time.md): Get recovered all-time wallet P&L.
- [Wallet Time-Windowed P&L](https://docs.polynode.dev/data/query-catalog/pnl/wallet-time-window.md): Get wallet P&L for a period such as 30 days.
- [Wallet P&L by Tag](https://docs.polynode.dev/data/query-catalog/pnl/wallet-by-tag.md): Filter wallet P&L to a tag or category.
- [Wallet P&L by Market](https://docs.polynode.dev/data/query-catalog/pnl/wallet-by-market.md): Filter wallet P&L to one condition ID or market slug.
- [Wallet P&L Events](https://docs.polynode.dev/data/query-catalog/pnl/wallet-events.md): Get bucketed wallet P&L events for charts.
- [Batch Wallet P&L](https://docs.polynode.dev/data/query-catalog/pnl/batch-wallet-pnl.md): Query P&L for multiple wallets in one request.
- [Global P&L Leaderboard](https://docs.polynode.dev/data/query-catalog/pnl/global-leaderboard.md): Rank wallets all-time or by 1-day, 7-day, and 30-day realized P&L.
- [Tag P&L Leaderboard](https://docs.polynode.dev/data/query-catalog/pnl/tag-leaderboard.md): Rank wallets inside one tag using all-time metrics or rolling realized P&L.
- [Markets Query Catalog](https://docs.polynode.dev/data/query-catalog/markets.md): Market recipes for complete catalog walks, search, condition lookup, slug lookup, token info, prices, tags, and resolutions.
- [Search Markets](https://docs.polynode.dev/data/query-catalog/markets/search-markets.md): Search Polymarket markets by text.
- [Market by Condition](https://docs.polynode.dev/data/query-catalog/markets/by-condition.md): Get market metadata and outcome tokens from a condition ID.
- [Condition Detail](https://docs.polynode.dev/data/query-catalog/markets/condition-detail.md): Get resolution and payout data for a condition.
- [Trades and Positions by Slug](https://docs.polynode.dev/data/query-catalog/markets/by-slug.md): Use a market slug to fetch trades or positions.
- [Token Info](https://docs.polynode.dev/data/query-catalog/markets/token-info.md): Get metadata, price, category, tags, and resolution status for one outcome token.
- [Token Price](https://docs.polynode.dev/data/query-catalog/markets/token-price.md): Get the current price and resolution status for one outcome token.
- [Market Candles](https://docs.polynode.dev/data/query-catalog/markets/candles.md): Build OHLCV candles for a V3 market token, condition ID, or slug.
- [Tags and Markets by Tag](https://docs.polynode.dev/data/query-catalog/markets/tags.md): List tags and discover markets under a tag.
- [Market Resolutions](https://docs.polynode.dev/data/query-catalog/markets/resolutions.md): Browse recent resolved markets with payout data.
- [Wallet Activity Query Catalog](https://docs.polynode.dev/data/query-catalog/wallet-activity.md): Wallet activity recipes for lifecycle events, PolyUSD flows, fees, rebates, and rewards.
- [Unified Wallet Activity](https://docs.polynode.dev/data/query-catalog/wallets/unified-activity.md): Get non-trade wallet activity in one feed.
- [Wallet Splits](https://docs.polynode.dev/data/query-catalog/wallets/splits.md): Get split events where USDC was converted into outcome tokens.
- [Wallet Merges](https://docs.polynode.dev/data/query-catalog/wallets/merges.md): Get merge events where outcome tokens were converted back into USDC.
- [Wallet Redemptions](https://docs.polynode.dev/data/query-catalog/wallets/redemptions.md): Get direct and AutoRedeemer-attributed wallet payout redemptions with exact transaction hashes.
- [Neg-Risk Conversions](https://docs.polynode.dev/data/query-catalog/wallets/neg-risk-conversions.md): Get neg-risk conversion activity for one wallet.
- [PolyUSD Flows](https://docs.polynode.dev/data/query-catalog/wallets/polyusd-flows.md): Get PolyUSD deposits and withdrawals for one wallet.
- [Wallet Fees Paid](https://docs.polynode.dev/data/query-catalog/wallets/fees-paid.md): Get fee-bearing fills for one wallet.
- [Wallet Rebates and Rewards](https://docs.polynode.dev/data/query-catalog/wallets/rebates-rewards.md): Query maker rebates and wallet reward surfaces.
- [Builders Query Catalog](https://docs.polynode.dev/data/query-catalog/builders.md): Builder recipes for rankings, profiles, fee sorting, attributed trades, and filtered builder feeds.
- [Builder Leaderboard](https://docs.polynode.dev/data/query-catalog/builders/leaderboard.md): Rank builders by V2-attributed share-notional volume, fills, or fees.
- [Builder Detail](https://docs.polynode.dev/data/query-catalog/builders/detail.md): Get stats and public profile metadata for one builder.
- [Builder Trader Leaderboard](https://docs.polynode.dev/data/query-catalog/builders/trader-leaderboard.md): Rank one Builder's active trader cohort across rolling and All Time P&L or attributed activity.
- [Builder Daily Activity](https://docs.polynode.dev/data/query-catalog/builders/daily-activity.md): Chart one Builder's daily volume, fills, traders, fees, and buy/sell mix.
- [Compare Builder Daily Activity](https://docs.polynode.dev/data/query-catalog/builders/activity-comparison.md): Fetch aligned daily series for up to 20 selected Builder codes in one request.
- [Builder Trades](https://docs.polynode.dev/data/query-catalog/builders/trades.md): Get trades attributed to one builder code.
- [Builder Trades by Market](https://docs.polynode.dev/data/query-catalog/builders/trades-by-market.md): Filter builder-attributed trades to one market slug.
- [Builder Trades by Tag or Category](https://docs.polynode.dev/data/query-catalog/builders/trades-by-tag-category.md): Filter builder trades by tag or category on a narrow market, condition, or token scope.
- [Builder Trades by Side and Size](https://docs.polynode.dev/data/query-catalog/builders/trades-by-side-size.md): Filter builder-attributed trades by side and minimum amount.
- [Tags and Categories Query Catalog](https://docs.polynode.dev/data/query-catalog/tags-categories.md): Tag and category recipes for discovery, market lists, P&L filters, leaderboards, and builder filters.
- [Combos Query Catalog](https://docs.polynode.dev/data/query-catalog/combos.md): Combo recipes for markets, activity, wallet summaries, combo positions, combo trades, and combined wallet views.
- [Combo Markets](https://docs.polynode.dev/data/query-catalog/combos/markets.md): List observed combo markets with leg metadata.
- [Combo Activity](https://docs.polynode.dev/data/query-catalog/combos/activity.md): Query combo lifecycle activity by market, condition, position, or wallet.
- [Combo Redemptions](https://docs.polynode.dev/data/query-catalog/combos/redemptions.md): Query terminal redemptions, post-resolution compression, and combo lineage across wallets.
- [Wallet Combo Summary](https://docs.polynode.dev/data/query-catalog/combos/wallet-summary.md): Get combo-only P&L and position counts for one wallet.
- [Wallet Combo Positions](https://docs.polynode.dev/data/query-catalog/combos/wallet-positions.md): List combo positions for one wallet.
- [Wallet Combo Trades](https://docs.polynode.dev/data/query-catalog/combos/wallet-trades.md): List combo trades for one wallet.
- [Wallet Combo Activity](https://docs.polynode.dev/data/query-catalog/combos/wallet-activity.md): List combo lifecycle activity for one wallet.
- [Wallet Combo Redemptions](https://docs.polynode.dev/data/query-catalog/combos/wallet-redemptions.md): List terminal combo redemptions, partial compression, and structural lineage for one wallet.
- [Include Combos in Wallet Views](https://docs.polynode.dev/data/query-catalog/combos/include-combos.md): Add combo branches to standard wallet P&L, positions, and trades.
- [Resolve Wallet](https://docs.polynode.dev/api-reference/wallets/resolve.md): Instantly resolve any Polymarket wallet address, EOA, or username.
- [Wallet Summary](https://docs.polynode.dev/data/wallets/summary.md): Get a complete P&L summary for any Polymarket wallet in USD. Realized and unrealized profit/loss, win rate, position count, and total volume.
- [Wallet P&L](https://docs.polynode.dev/data/wallets/pnl.md): Get profit and loss for a wallet in USD. Supports time-windowed P&L with ?period=1d|7d|30d|1y plus tag, category, market, event, and condition filters.
- [Wallet P&L Time Series](https://docs.polynode.dev/data/wallets/pnl-events.md): Realized P&L bucketed by hour, day, week, or month — chart-ready time series for a wallet.
- [Batch Wallet P&L](https://docs.polynode.dev/data/wallets/batch.md): Query P&L for up to 100 wallets in a single request. All amounts in USD.
- [Wallet Positions](https://docs.polynode.dev/data/wallets/positions.md): Get all positions for a wallet with market context, current prices, unrealized P&L, and settlement status.
- [Wallet Trades](https://docs.polynode.dev/data/wallets/trades.md): Get all trades for a wallet with market context, computed price, direction, and order hash.
- [Copy PnL](https://docs.polynode.dev/data/wallets/copy-pnl.md): Estimate copying slippage with date filters, optional full history, and lifetime realized-PnL context.
- [Copy PnL Batch](https://docs.polynode.dev/data/wallets/copy-pnl-batch.md): Calculate copying-slippage cash flow for up to 100 wallets in one request.
- [Wallet Fees Paid](https://docs.polynode.dev/data/wallets/fees-paid.md): Get fee-bearing order fills for a wallet.
- [Wallet PolyUSD Flows](https://docs.polynode.dev/data/wallets/polyusd-flows.md): Get PolyUSD deposits and withdrawals for a wallet.
- [Wallet Maker Rebates](https://docs.polynode.dev/data/wallets/rebates.md): Get Polymarket-reported maker rebates for a wallet and date.
- [Wallet Redemptions](https://docs.polynode.dev/data/wallets/redemptions.md): Get all direct and AutoRedeemer-attributed payout redemptions for a wallet.
- [Wallet Splits](https://docs.polynode.dev/data/wallets/splits.md): Get all split events for a wallet. Splits occur when USDC is converted into outcome tokens.
- [Wallet Merges](https://docs.polynode.dev/data/wallets/merges.md): Get all merge events for a wallet. Merges occur when outcome tokens are converted back into USDC.
- [Wallet NRC](https://docs.polynode.dev/data/wallets/nrc.md): Get neg-risk conversion events for a wallet. NRC events convert between multi-outcome market positions.
- [Wallet Activity](https://docs.polynode.dev/data/wallets/activity.md): Get all non-trade activity for a wallet: splits, merges, neg-risk conversions, and redemptions.
- [Credits Overview](https://docs.polynode.dev/credits/overview.md): Every Polymarket payout to users — liquidity rewards, yield, maker/taker rebates and referral rewards — indexed on-chain from the first payment ever made, with totals, leaderboards and filters Polymarket's API does not offer.
- [Liquidity Rewards](https://docs.polynode.dev/credits/rewards.md): Polymarket's liquidity rewards program — daily payouts to accounts that quote rewarded markets inside the spread.
- [Yield](https://docs.polynode.dev/credits/yield.md): Interest paid on Polymarket balances — daily on-chain distributions since July 2025.
- [Maker Rebates](https://docs.polynode.dev/credits/maker-rebates.md): Maker fee rebates — the largest Polymarket credit program, $135M+ paid since January 2026.
- [Taker Rebates](https://docs.polynode.dev/credits/taker-rebates.md): Taker fee rebates — volume-based rebates to active takers, launched June 2026.
- [Referral Rewards](https://docs.polynode.dev/credits/referral-rewards.md): Referral program earnings — fee-share payouts to referrers since March 2026.
- [Wallet Credit Totals](https://docs.polynode.dev/credits/wallet-totals.md): Lifetime or time-windowed totals per credit type for one wallet, in one call. Polymarket's own API only exposes these as a raw activity feed you would have to page and sum yourself.
- [Wallet Credit Events](https://docs.polynode.dev/credits/wallet-events.md): Individual credit events for one wallet with filters Polymarket does not offer: amount bounds, amount sorting, token filter.
- [Wallet Credit Series](https://docs.polynode.dev/credits/wallet-series.md): Time-bucketed earnings series per credit type for one wallet.
- [Credits Leaderboard](https://docs.polynode.dev/credits/leaderboard.md): Top earners for any credit type over any window, across every wallet. Not possible with Polymarket's per-wallet activity feed.
- [Global Credit Stats](https://docs.polynode.dev/credits/stats.md): Program-wide aggregates per credit type: totals, unique recipients, batch transaction counts, average credit size, plus a bucketed series.
- [Global Credit Feed](https://docs.polynode.dev/credits/feed.md): Most recent credit events across ALL wallets — watch large rebates or rewards land in near real time. Cursor-paginated.
- [Credit Distributors](https://docs.polynode.dev/credits/distributors.md): The on-chain payout addresses behind each credit type, with lifetime totals — full transparency into where the money comes from.
- [Decode Payout Transaction](https://docs.polynode.dev/credits/tx.md): Decode one payout transaction into typed credit rows: every recipient, every amount.
- [Recipient Growth](https://docs.polynode.dev/credits/recipients.md): How many wallets earned their first credit per bucket — program growth over time.
- [Batch Resolve](https://docs.polynode.dev/identities/batch-resolve.md): Resolve up to 1,000 Polymarket trading wallets to usernames, controlling EOAs, wallet types, deployment status, and current status in one call.
- [Username Search](https://docs.polynode.dev/identities/search.md): Search 5M+ Polymarket usernames by substring, returning wallet type, deployment status, and current status with exact matches ranked first.
- [Identity Lookup](https://docs.polynode.dev/identities/lookup.md): Resolve one address: by trading wallet (returns username, EOA, wallet type, deployment/current status, and related wallets) or, if not a known trading wallet, by controlling EOA (returns every wallet that account controls with status).
- [Fees Overview](https://docs.polynode.dev/data/fees/overview.md): Where to query trader-paid fees, fee receiver events, builder-attributed fees, maker rebates, and reward market configuration.
- [Wallet Fees Paid](https://docs.polynode.dev/data/fees/wallet-fees-paid.md): Query fee-bearing executed fills for one wallet.
- [Global Fee Events](https://docs.polynode.dev/data/fees/global-fees.md): Browse fee charged events across Polymarket.
- [Fees by Receiver](https://docs.polynode.dev/data/fees/fees-by-receiver.md): Fetch fee charged events received by one address.
- [Builder Fees](https://docs.polynode.dev/data/fees/builder-fees.md): Rank builders by attributed fee generation and inspect their fee-bearing fills.
- [Maker Rebates](https://docs.polynode.dev/data/fees/maker-rebates.md): Query Polymarket-reported maker rebate records for one maker/date.
- [Reward Market Configs](https://docs.polynode.dev/data/fees/reward-market-configs.md): Query public Polymarket reward-market configuration.
- [Combos Overview](https://docs.polynode.dev/data/combos/overview.md): Query Polymarket combo markets, combo wallet positions, combo trades, and combo lifecycle activity.
- [Combo Markets](https://docs.polynode.dev/data/combos/markets.md): List observed Polymarket combo markets with legs and activity counters.
- [Combo Activity](https://docs.polynode.dev/data/combos/activity.md): Query combo lifecycle activity by market, condition, position, or wallet.
- [Combo Daily Activity](https://docs.polynode.dev/data/combos/daily-activity.md): Chart complete UTC-day Combo fills, share volume, lifecycle activity, mapped transfers, and exact redemptions.
- [Combo P&L Leaderboard](https://docs.polynode.dev/data/combos/leaderboard.md): Rank eligible Combo wallets by realized P&L over fixed or custom windows, or by marked All Time P&L.
- [Combo Redemptions](https://docs.polynode.dev/data/combos/redemptions.md): Query terminal combo redemptions, partial post-resolution compression, and exact on-chain lineage.
- [Wallet Combo Summary](https://docs.polynode.dev/data/combos/wallet-summary.md): Get combo-only P&L and position counts for one wallet.
- [Wallet Combo Positions](https://docs.polynode.dev/data/combos/wallet-positions.md): List combo positions for one wallet with legs, entry basis, balances, and P&L.
- [Wallet Combo Trades](https://docs.polynode.dev/data/combos/wallet-trades.md): List confirmed combo fills for one wallet with side, size, price, role, counterparty, and transaction data.
- [Wallet Combo Activity](https://docs.polynode.dev/data/combos/wallet-activity.md): List combo lifecycle activity for one wallet, including split and merge activity.
- [Wallet Combo Redemptions](https://docs.polynode.dev/data/combos/wallet-redemptions.md): List full combo redemptions and partial combo reductions for one wallet with exact leg changes.
- [Reward Markets](https://docs.polynode.dev/data/rewards/markets.md): List public Polymarket reward market configurations.
- [Reward Market Detail](https://docs.polynode.dev/data/rewards/market.md): Get public Polymarket reward configuration for one condition ID.
- [Market Catalog](https://docs.polynode.dev/data/markets/catalog.md): Walk the complete Polymarket market catalog with stable cursor pagination and optional status or event filters.
- [Market Catalog Stats](https://docs.polynode.dev/data/markets/catalog-stats.md): Get complete market counts and open, closed, and inactive status totals.
- [Event Catalog](https://docs.polynode.dev/data/events/catalog.md): Walk the complete Polymarket event catalog with member-market counts and stable cursor pagination.
- [Event Catalog Stats](https://docs.polynode.dev/data/events/catalog-stats.md): Get complete event, member-market, and event-status counts.
- [Search Markets](https://docs.polynode.dev/data/markets/search.md): Full-text search across all Polymarket markets. Returns matching markets with metadata.
- [Market by Condition](https://docs.polynode.dev/data/markets/by-condition.md): Get market metadata, token IDs, and outcomes by condition ID.
- [Market Positions (Condition)](https://docs.polynode.dev/data/markets/condition-positions.md): Get wallet positions across every outcome token in a market condition.
- [Market Trades](https://docs.polynode.dev/data/markets/trades.md): Get all trades for a specific outcome token or market slug, with full enrichment.
- [Market Positions (Token)](https://docs.polynode.dev/data/markets/positions.md): Get all wallets holding positions in a specific outcome token, sorted by P&L or size.
- [Token Price](https://docs.polynode.dev/data/markets/price.md): Get the current price, resolution status, and price source for any outcome token.
- [Market Candles](https://docs.polynode.dev/data/markets/candles.md): Trade-built OHLCV candles for V3 Polymarket outcome tokens, condition IDs, and market slugs.
- [Market by Slug](https://docs.polynode.dev/data/markets/by-slug.md): Get trades and positions for a market by its URL slug.
- [Order Book](https://docs.polynode.dev/api-reference/orderbook/order-book.md): Returns the full order book for a token, including all bid and ask price levels, market properties, and PolyNode metadata enrichment.
- [Midpoint Price](https://docs.polynode.dev/api-reference/orderbook/midpoint.md): Returns the midpoint price for a token, calculated as the average of the best bid and best ask.
- [Bid-Ask Spread](https://docs.polynode.dev/api-reference/orderbook/spread.md): Returns the bid-ask spread for a token, calculated as the difference between the best ask and best bid price.
- [Leaderboard](https://docs.polynode.dev/data/leaderboard/global.md): Rank Polymarket wallets globally, by category, or by one tag. Supports all-time rankings and 1-day, 7-day, and 30-day realized-P&L rankings.
- [Leaderboard Scopes](https://docs.polynode.dev/data/leaderboard/scopes.md): Discover and search the categories or tags available to 1-day, 7-day, and 30-day realized-P&L leaderboards.
- [Tags](https://docs.polynode.dev/data/leaderboard/tags.md): List all market tags with the number of markets in each category.
- [Tag Markets](https://docs.polynode.dev/data/leaderboard/tag-markets.md): List markets that belong to a specific tag (category), ordered by all-time volume or other metrics.
- [Tag Leaderboard](https://docs.polynode.dev/data/leaderboard/tag-leaderboard.md): Rank wallets within one market tag using all-time metrics or 1-day, 7-day, and 30-day realized P&L.
- [Builder Leaderboard](https://docs.polynode.dev/data/builders/list.md): Rank Polymarket builders by V2-attributed share notional, fill count, fees, and enriched builder profile metadata.
- [Builder Detail](https://docs.polynode.dev/data/builders/detail.md): Get stats and public profile metadata for a single Builder by code or exact public name.
- [Builder Trader P&L Leaderboard](https://docs.polynode.dev/data/builders/trader-leaderboard.md): Rank every trader active through one builder by global wallet P&L, attributed volume, fills, trader-paid fees, active days, or recency.
- [Builder Daily Activity](https://docs.polynode.dev/data/builders/daily-activity.md): Return an inclusive daily time series plus recent market and category composition for one Builder.
- [Compare Builder Daily Activity](https://docs.polynode.dev/data/builders/activity-comparison.md): Return aligned daily activity for up to 20 Builder codes, with an optional residual series.
- [Builder Trades](https://docs.polynode.dev/data/builders/trades.md): Get trades attributed to a specific builder, with builder profile and market enrichment.
- [Polymarket Profiles](https://docs.polynode.dev/api-reference/polymarket-profiles/overview.md): Create or change a Polymarket username from a user-owned EOA wallet.
- [Check Username Availability](https://docs.polynode.dev/api-reference/polymarket-profiles/username-available.md): Check whether Polymarket will accept a username.
- [Create Username Challenge](https://docs.polynode.dev/api-reference/polymarket-profiles/create-challenge.md): Create the wallet-signing challenge for a Polymarket username create or update.
- [Complete Username Action](https://docs.polynode.dev/api-reference/polymarket-profiles/complete-username.md): Submit wallet signatures and create or change the user's Polymarket username.
- [Get Public Profile](https://docs.polynode.dev/api-reference/polymarket-profiles/get-profile.md): Read public Polymarket profile state for an EOA address.
- [Platform Stats](https://docs.polynode.dev/data/global/stats.md): Global aggregates for the entire Polymarket database. Total fills, wallets, volume, and P&L.
- [Global Trades](https://docs.polynode.dev/data/global/trades.md): Browse the full Polymarket trade history with market enrichment, computed prices, and order hashes.
- [Global Positions](https://docs.polynode.dev/data/global/positions.md): Browse the latest positions across all Polymarket wallets. Filter by market, status, or size.
- [Fee Events](https://docs.polynode.dev/data/global/fees.md): Browse fee charged events across all Polymarket trades.
- [Market Resolutions](https://docs.polynode.dev/data/global/resolutions.md): Browse recent market resolutions with payout data and market metadata.
- [Condition Detail](https://docs.polynode.dev/data/global/conditions.md): Get full market condition data including payouts, outcomes, metadata, and resolution status.
- [Token Info](https://docs.polynode.dev/data/tokens/info.md): Get full details for an outcome token: price, resolution status, market metadata, and tags.
- [Perps Overview](https://docs.polynode.dev/perps/overview.md): Polymarket perpetual futures data through the polynode API: live market data, orderbooks, trades, funding, klines, wallet portfolios, and WebSocket streaming.
- [Quickstart](https://docs.polynode.dev/perps/quickstart.md): From zero to live perps data in three requests.
- [Wallet Mapping](https://docs.polynode.dev/perps/wallet-mapping.md): Why Polymarket perps accounts use a different address than the profile you see, and how polynode resolves it for you automatically.
- [Rate Limits](https://docs.polynode.dev/perps/rate-limits.md): Request and WebSocket limits for the perps endpoints, by plan.
- [Instruments](https://docs.polynode.dev/perps/market-data/instruments.md): Every listed perps instrument with full contract config (leverage, risk tiers, precision, funding interval), plus `first_seen`. Filter with `?category=` (crypto, index, commodity, equity).
- [Tickers](https://docs.polynode.dev/perps/market-data/tickers.md): Live prices, open interest and funding for one instrument. `index_price` is the real underlying asset price.
- [Screener](https://docs.polynode.dev/perps/market-data/screener.md): Live cross-instrument screen: per-instrument funding rate, open interest, and the **basis** (mark minus index, in bps). Sort by `funding`, `oi`, or `basis`, and filter by `min_funding`. Computed on demand — Polymarket has no cross-instrument screen.
- [Best Bid/Offer](https://docs.polynode.dev/perps/market-data/bbo.md): Top-of-book best bid/offer for one instrument.
- [Orderbook](https://docs.polynode.dev/perps/market-data/book.md): Full order book (price/quantity levels, best-first). Use `?depth=` to limit levels per side.
- [Trades](https://docs.polynode.dev/perps/market-data/trades.md): Recent executions (price, quantity, side, time). Add `after`/`before` for archived history. Archived pages are newest first and return `has_more`, `next_cursor`, and the existing `more` field. Reuse the same filters with each cursor.
- [24h Statistics](https://docs.polynode.dev/perps/market-data/statistics.md): Rolling 24h volume, open price and hourly candles for one instrument.
- [Klines (OHLCV)](https://docs.polynode.dev/perps/market-data/klines.md): Candlestick data. `interval` = 1m,5m,15m,30m,1h,4h,6h,12h,1d,1w. `start` is optional (defaults to a sane window).
- [Funding Rates](https://docs.polynode.dev/perps/market-data/funding.md): Hourly funding-rate history, newest first. Window with `start_timestamp`/`end_timestamp` (Unix ms).
- [Open Interest History](https://docs.polynode.dev/perps/market-data/open-interest.md): Open-interest time series (with mark price and funding at each sample) — history the exchange does not offer.
- [Volume History](https://docs.polynode.dev/perps/market-data/volume.md): Bucketed notional volume and trade counts. `bucket` = 1m,5m,15m,1h,4h,1d.
- [Perps Daily Activity](https://docs.polynode.dev/perps/market-data/daily-activity.md): Chart complete UTC-day perps notional and taker flow for the platform and selected instruments.
- [Fees & Exchange Meta](https://docs.polynode.dev/perps/market-data/meta.md): Fee schedule, exchange rate-limit tiers, contract info, collateral assets, and index composition.
- [Basis History](https://docs.polynode.dev/perps/market-data/basis.md): The perp's premium/discount to spot over time: mark - index (absolute and in bps), from the ticker snapshots.
- [Trade Flow / CVD](https://docs.polynode.dev/perps/market-data/flow.md): Per time bucket: taker buy versus sell notional, net quantity, and running cumulative volume delta (CVD). This is a bounded single-page series and does not accept a cursor.
- [Cumulative Funding](https://docs.polynode.dev/perps/market-data/funding-pnl.md): The funding-rate series plus a running sum - what a 1-unit long has paid (positive) or earned (negative) over the window.
- [Wallet Overview](https://docs.polynode.dev/perps/wallets/overview.md): One call: resolve any Polymarket address, report the wallet type + signer, perps registration, and (if registered) the live enriched portfolio.
- [Portfolio](https://docs.polynode.dev/perps/wallets/portfolio.md): Live perps positions and equity for a wallet, enriched per position with symbol, side, mark price and notional.
- [Registered](https://docs.polynode.dev/perps/wallets/registered.md): Whether a wallet has activated a perps account. Cheapest way to filter a wallet list before requesting portfolios.
- [Registered (batch)](https://docs.polynode.dev/perps/wallets/batch-registered.md): Check perps registration for many wallets in one call (max 50). Each address is resolved and reported inline; a failure on one address does not fail the batch.
- [Portfolios (batch)](https://docs.polynode.dev/perps/wallets/batch-portfolios.md): Fetch the enriched live portfolio for many wallets in one call (max 20). Each address is resolved and reported inline; a failure on one address does not fail the batch.
- [Perps Analytics](https://docs.polynode.dev/perps/analytics/overview.md): Historical and cross-account perps data that Polymarket does not offer — whale leaderboards, positioning over time, position history, and a live large-position feed.
- [Whale Leaderboard](https://docs.polynode.dev/perps/analytics/leaderboard.md): Top perps accounts, ranked. `metric=equity` ranks by account equity; `metric=size` by total open notional; `metric=pnl` by total unrealized PnL. Optional `instrument` filter. **Polymarket has no perps leaderboard** — perps trades carry no account attribution, so this only exists because we snapshot…
- [Positioning](https://docs.polynode.dev/perps/analytics/positioning.md): Aggregate positioning for one instrument across all tracked accounts, over time: total long size, total short size, and the net. Answers 'is the crowd long or short, and how is that shifting' — impossible from Polymarket's per-account API.
- [Large Positions](https://docs.polynode.dev/perps/analytics/large-positions.md): Current large open positions across all tracked accounts, notional-sorted — a live whale-position feed. Filter by `min_notional` and `instrument`.
- [Position History](https://docs.polynode.dev/perps/analytics/position-history.md): A wallet's perps positions over time — how each position changed, opened, or closed, with equity and PnL trajectory. Polymarket only returns a wallet's *current* portfolio; this is the accumulated history. Filter by `instrument` and time window (`after`/`before`). A read also captures a fresh snapsh…
- [Smart Money](https://docs.polynode.dev/perps/analytics/traders.md): Rank wallets by real TRADING P&L over a window: equity change minus net deposits. Possible only because we hold both equity snapshots and on-chain collateral flows.
- [Position Events](https://docs.polynode.dev/perps/analytics/events.md): Position activity feed: opened / closed / increased / reduced / flipped. Filter by type, instrument, min_notional, address, liquidation, and after. Continue newest first through a fixed traversal with `next_cursor`.
- [Liquidations](https://docs.polynode.dev/perps/analytics/liquidations.md): Likely liquidations detected from position closes at a large loss. Returns the same stable cursor response shape as position events, with route-specific cursors.
- [Coverage](https://docs.polynode.dev/perps/analytics/coverage.md): Transparency metric: for each instrument, our tracked long/short open interest (from the latest position snapshots) vs the exchange's live reported OI.
- [TVL & Collateral](https://docs.polynode.dev/perps/onchain/tvl.md): Protocol collateral: current net (deposited - withdrawn) plus a daily net-flow series.
- [Top Depositors](https://docs.polynode.dev/perps/onchain/depositors.md): Biggest depositors ranked by total pUSD deposited, keyed by the real beneficiary account (not the router).
- [Top Withdrawers](https://docs.polynode.dev/perps/onchain/withdrawers.md): Biggest withdrawers ranked by total pUSD withdrawn.
- [Deposits Feed](https://docs.polynode.dev/perps/onchain/deposits.md): Recent deposits, filterable by size and time. Each row carries the depositor (often a router) and the beneficiary (real account).
- [Withdrawals Feed](https://docs.polynode.dev/perps/onchain/withdrawals.md): Recent withdrawals, filterable by size and time.
- [Wallet Flows](https://docs.polynode.dev/perps/onchain/flows.md): One wallet's collateral flow: total deposited, withdrawn, net, and stable pages of deposit or withdrawal events. Resolved to the signer. Totals and counts remain fixed across pages in one traversal.
- [Perps WebSocket](https://docs.polynode.dev/perps/websocket/overview.md): One connection streams every perps channel: tickers, books, best bid/offer, trades, statistics, and candles.
- [Channels](https://docs.polynode.dev/perps/websocket/channels.md): Every perps WebSocket channel and its payload.
- [Crypto Markets](https://docs.polynode.dev/api-reference/crypto/markets.md): All crypto prediction markets with liquidity, volume, and open interest.
- [Oracle Candles](https://docs.polynode.dev/api-reference/crypto/candles.md): 5-minute OHLC candles from PolyNode's live Chainlink tick archive.
- [Historical Price Ticks](https://docs.polynode.dev/api-reference/crypto/ticks.md): Historical 1-second crypto price ticks for short-form chart backfill.
- [Price to Beat](https://docs.polynode.dev/api-reference/crypto/price.md): Open and close price for a specific crypto market window.
- [Active 5-Minute Markets](https://docs.polynode.dev/api-reference/crypto/active.md): Currently active 5-minute up-or-down markets for all 7 coins.
- [Crypto Series](https://docs.polynode.dev/api-reference/crypto/series.md): Recurring crypto market series.
- [Sports Markets](https://docs.polynode.dev/api-reference/sports/sports-markets.md)
- [BYOL Overview](https://docs.polynode.dev/api-reference/byol/overview.md): Bring Your Own Leaderboard. Track any set of Polymarket wallets and get a private, ranked leaderboard with P&L across all time periods and categories.
- [Get Leaderboard](https://docs.polynode.dev/api-reference/byol/get-leaderboard.md): Query your custom leaderboard ranked by P&L or volume, filtered by time period and category.
- [Add Wallets](https://docs.polynode.dev/api-reference/byol/add-wallets.md): Add wallets to your tracked leaderboard set.
- [Remove Wallets](https://docs.polynode.dev/api-reference/byol/remove-wallets.md): Remove wallets from your tracked leaderboard set.
- [List Wallets](https://docs.polynode.dev/api-reference/byol/list-wallets.md): List all wallets currently in your tracked leaderboard set.
- [Backtesting Overview](https://docs.polynode.dev/api-reference/backtesting/overview.md): Estimate copying slippage from recent wallet fills with V3 Copy PnL.
- [Deprecated: Backtest Copy PnL](https://docs.polynode.dev/api-reference/backtesting/copy-pnl.md): Score a wallet for copy-trading quality. Returns realized PnL, cashflow PnL, simulated copier PnL with 2% slippage friction, and a toxic-for-copying flag.
- [Deprecated: Backtest Copy PnL — Batch](https://docs.polynode.dev/api-reference/backtesting/batch.md): Score multiple wallets in one call. Same math as the single-wallet endpoint.
- [BYOB — Add Wallets](https://docs.polynode.dev/api-reference/backtesting/byob-add-wallets.md): Add wallets to your BYOB tracked-pool. Newly-added wallets get scored within seconds (on-add freshening).
- [BYOB — Remove Wallets](https://docs.polynode.dev/api-reference/backtesting/byob-remove-wallets.md): Remove wallets from your BYOB tracked-pool. Removal is idempotent — re-removing a wallet that's not in the pool returns 0 with no error.
- [BYOB — List Wallets](https://docs.polynode.dev/api-reference/backtesting/byob-list-wallets.md): Return every wallet in your BYOB tracked-pool, sorted lexicographically.
- [BYOB — Leaderboard](https://docs.polynode.dev/api-reference/backtesting/byob-leaderboard.md): Sub-second sorted, filtered, paginated leaderboard over your tracked-wallet pool. Reads precomputed scores from cache.
- [BYOB — Snapshot](https://docs.polynode.dev/api-reference/backtesting/byob-snapshot.md): Every wallet in your tracked pool with backtest scores across every period in a single response. The headline read for stats-card UIs.
- [Market Card](https://docs.polynode.dev/api-reference/pricing/market-statistics.md): One-shot consolidated summary for a token — condition, outcomes, neg-risk flag, end date, last trade time, current orderbook liquidity, 24h OHLCV, and last price. Saves you from making 3–4 separate calls when you just need a market overview tile.
- [System Status](https://docs.polynode.dev/api-reference/system/system-status.md): Returns system status including node connectivity, uptime, stream lengths, and state engine summary.
- [Generate API Key](https://docs.polynode.dev/api-reference/system/generate-api-key.md): Generates a new API key. Rate limited to 1 per IP per day. The key is returned only once and cannot be retrieved again.
- [Health Check](https://docs.polynode.dev/api-reference/system/health-check.md): Liveness probe. Returns 200 OK if the server is running.
- [Readiness Check](https://docs.polynode.dev/api-reference/system/readiness-check.md): Returns 200 if node is connected and Redis is reachable, 503 otherwise.
- [Online Search API](https://docs.polynode.dev/api-reference/search-online.md): Search the public web and return normalized organic results for agent context, market research, and enrichment workflows.
- [X Search API](https://docs.polynode.dev/api-reference/x-search.md): Beta endpoint for live X (Twitter) search and account-timeline data. Drop social context next to your prediction market data without building your own X integration.
- [Trade History (All)](https://docs.polynode.dev/api-reference/onchain/trades.md): Query every trade ever executed on Polymarket. Filter by wallet, market, time range, or minimum size. Full history with cursor pagination.
- [Positions (All)](https://docs.polynode.dev/api-reference/onchain/positions.md): Query every position on Polymarket. Filter by wallet, market, status, or minimum size. Full history with cursor pagination.
- [Positions & P&L (Wallet)](https://docs.polynode.dev/api-reference/wallets/onchain-positions.md): Every position a wallet has held — open and closed — with realized + unrealized P&L, per-position activity timestamps, market resolution timestamps, and parent event slugs. Optional time-window filtering.
- [Trade History (Wallet)](https://docs.polynode.dev/api-reference/onchain/wallet-trades.md): Complete onchain trade fill history for any wallet. Every fill, every counterparty, every fee.
- [Trade History (Wallet) — Bulk](https://docs.polynode.dev/api-reference/onchain/wallet-trades-all.md): Return every trade for a wallet in a single response. Growth plan or above.
- [Wallet Redemptions](https://docs.polynode.dev/api-reference/onchain/wallet-redemptions.md): All onchain redemptions for a wallet. See who cashed out, when, and how much.
- [Wallet Activity](https://docs.polynode.dev/api-reference/onchain/wallet-activity.md): Onchain activity for a wallet: splits, merges, and multi-outcome conversions.
- [Trade History (Market)](https://docs.polynode.dev/api-reference/onchain/market-trades.md): Complete onchain trade history for any market token.
- [Trade History (Market) — Bulk](https://docs.polynode.dev/api-reference/onchain/market-trades-all.md): Return every trade for a market token in a single response. Growth plan or above.
- [Top Traders (Market)](https://docs.polynode.dev/api-reference/wallets/market-positions.md): Every wallet that holds (or has held) a position in a single market, grouped by outcome and sorted by P&L. The 'who's making money on this market' feed.
- [Candles (Trade-Indexed OHLCV)](https://docs.polynode.dev/api-reference/onchain/candles.md): Server-built OHLCV candles from real onchain trades. Anchor-based pagination with buy/sell volume split, VWAP, and trade counts. Resolutions from 1m to 1d.
- [Market Volume](https://docs.polynode.dev/api-reference/onchain/market-volume.md): Lifetime onchain volume statistics for any market token.
- [Market Open Interest](https://docs.polynode.dev/api-reference/onchain/market-oi.md): Onchain open interest for a specific market.
- [Global Open Interest](https://docs.polynode.dev/api-reference/onchain/global-oi.md): Total platform-wide open interest from onchain data.
- [Crypto Prices](https://docs.polynode.dev/crypto/overview.md): Stream Chainlink spot prices and 30-second or 60-second TWAP prices over WebSocket.
- [Chainlink Spot and TWAP Prices](https://docs.polynode.dev/crypto/twap.md): Choose Chainlink spot, 30-second TWAP, 60-second TWAP, or both TWAP streams.
- [Available Feeds](https://docs.polynode.dev/crypto/feeds.md): All crypto price feeds with live examples.
- [Event Format](https://docs.polynode.dev/crypto/event-format.md): Price feed event schema and field reference.
- [REST API](https://docs.polynode.dev/crypto/rest-api.md): REST endpoints for crypto market discovery, oracle candles, historical ticks, price-to-beat, and active short-form markets.
- [Orderbook Stream](https://docs.polynode.dev/orderbook/overview.md): Real-time orderbook data for every Polymarket market, delivered through a single WebSocket connection.
- [Orderbook Integrity (PN1)](https://docs.polynode.dev/orderbook/integrity.md): Opt-in sequence numbers and deterministic checksums for detecting gaps or divergence in a local Orderbook Stream mirror.
- [Message Reference](https://docs.polynode.dev/orderbook/messages.md): Complete reference for all message types sent and received on the Orderbook Stream.
- [Examples](https://docs.polynode.dev/orderbook/examples.md): Code examples for connecting to the Orderbook Stream in JavaScript, Python, and from the command line.
- [Polygon RPC](https://docs.polynode.dev/rpc/overview.md): Authenticated Polygon RPC with priority transaction routing
- [Integration Guide](https://docs.polynode.dev/rpc/integration.md): Connect to polynode RPC from any Ethereum library or wallet
- [Gas Oracle](https://docs.polynode.dev/rpc/gas-oracle.md): Real-time gas price intelligence for optimal transaction positioning
- [Transaction Tracking](https://docs.polynode.dev/rpc/tx-tracking.md): Track your transaction's block position and confirmation status
- [CLI](https://docs.polynode.dev/cli/overview.md): Bloomberg terminal for prediction markets. Real-time TUI dashboards and JSON output for agents.
- [Trading and Fees](https://docs.polynode.dev/sdks/trading.md): Set up a wallet, place and manage Polymarket V2 orders, and understand protocol fees, builder attribution, and optional application fees.
- [User-owned execution](https://docs.polynode.dev/sdks/user-owned-execution.md): Use wallet-scoped authorization with zero builder attribution and no shared builder relayer allowance.
- [Web app: connect wallet to an order](https://docs.polynode.dev/sdks/user-owned-web-app.md): Build a secure connect-wallet flow that ends with a zero-attribution user-owned order.
- [Polynode SDKs](https://docs.polynode.dev/sdks/overview.md): Install an official Polynode SDK and use V3 data, settlement streams, Chainlink TWAP markets, PN1 orderbooks, and perps.
- [Complete V3 API](https://docs.polynode.dev/sdks/v3-api.md): Call the shared 120-operation V3 SDK registry and use authenticated REST for newer routes awaiting a registry release.
- [Settlement and Event Streams](https://docs.polynode.dev/sdks/websocket-streaming.md): Subscribe to settlements and other PolyNode events with typed filtering, acknowledgements, reconnect replay, deduplication, and explicit cleanup.
- [Short-Form Markets and Chainlink TWAP](https://docs.polynode.dev/sdks/short-form.md): Follow rotating 5-minute, 15-minute, 1-hour, and 4-hour crypto markets with the matching Chainlink price window.
- [Orderbook Streaming and PN1](https://docs.polynode.dev/sdks/orderbook.md): Stream prediction-market depth, maintain local books, and optionally fail closed on PN1 sequence or checksum errors.
- [Perps WebSocket](https://docs.polynode.dev/sdks/perps.md): Stream Polymarket perps tickers, BBO, complete books, trades, statistics, and klines with managed resubscription.
- [Trading and Fees](https://docs.polynode.dev/sdks/trading.md): Set up a wallet, place and manage Polymarket V2 orders, and understand protocol fees, builder attribution, and optional application fees.
- [User-owned execution](https://docs.polynode.dev/sdks/user-owned-execution.md): Use wallet-scoped authorization with zero builder attribution and no shared builder relayer allowance.
- [Web app: connect wallet to an order](https://docs.polynode.dev/sdks/user-owned-web-app.md): Build a secure connect-wallet flow that ends with a zero-attribution user-owned order.
- [REST Clients](https://docs.polynode.dev/sdks/rest-api.md): Use the complete V3 API or the SDKs' compatibility methods for older V1 and V2 endpoints.
- [Local Cache](https://docs.polynode.dev/sdks/local-cache.md): Persist selected wallet, trade, position, and settlement data in local SQLite from TypeScript or Rust.
- [Redemption Watcher](https://docs.polynode.dev/sdks/redemption-watcher.md): Track wallet positions and receive an alert when an oracle resolution makes them redeemable.
- [RPC Helper](https://docs.polynode.dev/sdks/rpc.md): Make authenticated Polygon JSON-RPC requests from TypeScript, Python, or Rust.
- [TypeScript SDK](https://docs.polynode.dev/sdks/ts/overview.md): Install polynode-sdk 0.14 and make a first V3 request from Node.js.
- [TypeScript V3 API](https://docs.polynode.dev/sdks/ts/v3-data.md): Use typed TypeScript helpers or execute any of the 120 registered V3 operations.
- [TypeScript Settlement Stream](https://docs.polynode.dev/sdks/ts/websocket.md): Consume acknowledged settlement subscriptions with reconnect replay, deduplication, and overflow visibility.
- [TypeScript Short-Form and TWAP](https://docs.polynode.dev/sdks/ts/short-form.md): Rotate TypeScript subscriptions across short-form crypto markets with the correct Chainlink TWAP window.
- [TypeScript PN1 Orderbook](https://docs.polynode.dev/sdks/ts/orderbook.md): Maintain exact local orderbooks with optional PN1 sequence and checksum verification.
- [TypeScript Perps Stream](https://docs.polynode.dev/sdks/ts/perps.md): Subscribe to managed perps tickers, BBO, full books, trades, statistics, and klines.
- [TypeScript Trading and Fees](https://docs.polynode.dev/sdks/ts/trading.md): Use the TypeScript V2 trading defaults and keep protocol fees, builder attribution, and application fees distinct.
- [TypeScript Configuration](https://docs.polynode.dev/sdks/ts/config.md): Configure PolyNode TypeScript endpoints, timeouts, reconnects, replay buffers, and integrity behavior.
- [TypeScript Errors](https://docs.polynode.dev/sdks/ts/errors.md): Handle HTTP, WebSocket, reconnect, overflow, and orderbook-integrity failures in TypeScript.
- [TypeScript Types](https://docs.polynode.dev/sdks/ts/types.md): Narrow event unions, preserve unknown additive messages, and keep exact numeric wire values.
- [TypeScript REST Compatibility](https://docs.polynode.dev/sdks/ts/rest-api.md): Use the current V3 client and understand the retained top-level V1/V2 methods.
- [Python SDK](https://docs.polynode.dev/sdks/python/overview.md): Install polynode 0.14 and make a first V3 request from Python.
- [Python V3 API](https://docs.polynode.dev/sdks/python/v3-api.md): Use synchronous or asynchronous Python clients for all 120 registered V3 operations.
- [Python Settlement Stream](https://docs.polynode.dev/sdks/python/websocket.md): Consume acknowledged Python settlement subscriptions with reconnect replay, deduplication, and overflow visibility.
- [Python Short-Form and TWAP](https://docs.polynode.dev/sdks/python/short-form.md): Rotate Python subscriptions across short-form crypto markets with the correct Chainlink TWAP window.
- [Python PN1 Orderbook](https://docs.polynode.dev/sdks/python/orderbook.md): Maintain exact Python orderbooks with PN1 sequence and checksum verification.
- [Python Perps Stream](https://docs.polynode.dev/sdks/python/perps.md): Subscribe to managed Python perps tickers, BBO, full books, trades, statistics, and klines.
- [Python Trading and Fees](https://docs.polynode.dev/sdks/python/trading.md): Use Python's V2 trading defaults and keep protocol fees, builder attribution, and application fees distinct.
- [Python Configuration](https://docs.polynode.dev/sdks/python/config.md): Configure Python endpoints, HTTP timeouts, reconnects, replay buffers, and orderbook integrity.
- [Python Errors](https://docs.polynode.dev/sdks/python/errors.md): Handle HTTP, WebSocket, reconnect, overflow, and orderbook-integrity failures in Python.
- [Python Models](https://docs.polynode.dev/sdks/python/models.md): Work with Python event models, unknown additive messages, Decimal V3 values, and exact orderbook strings.
- [Python REST Compatibility](https://docs.polynode.dev/sdks/python/rest-api.md): Use the current Python V3 client and understand retained top-level V1/V2 helpers.
- [Rust SDK](https://docs.polynode.dev/sdks/rust/overview.md): Install polynode 0.17 and make a first V3 request with Tokio.
- [Rust V3 API](https://docs.polynode.dev/sdks/rust/v3-api.md): Execute all 120 registered V3 operations with precision-preserving serde_json values.
- [Rust Settlement Stream](https://docs.polynode.dev/sdks/rust/websocket.md): Consume acknowledged Rust settlement subscriptions with reconnect replay, deduplication, and bounded backpressure.
- [Rust Short-Form and TWAP](https://docs.polynode.dev/sdks/rust/short-form.md): Rotate Rust subscriptions across short-form crypto markets with the correct Chainlink TWAP window.
- [Rust PN1 Orderbook](https://docs.polynode.dev/sdks/rust/orderbook.md): Maintain exact Rust orderbooks with PN1 sequence and checksum verification.
- [Rust Perps Stream](https://docs.polynode.dev/sdks/rust/perps.md): Subscribe to managed Rust perps tickers, BBO, full books, trades, statistics, and klines.
- [Rust Trading and Fees](https://docs.polynode.dev/sdks/rust/trading.md): Enable Rust trading, use the V2 default, and distinguish protocol fees, builder attribution, and application fees.
- [Rust Configuration](https://docs.polynode.dev/sdks/rust/config.md): Configure Rust endpoints, timeouts, reconnects, bounded buffers, and PN1 integrity.
- [Rust Errors](https://docs.polynode.dev/sdks/rust/errors.md): Handle structured V3, WebSocket, trading, reconnect, and PN1 integrity failures in Rust.
- [Rust REST Compatibility](https://docs.polynode.dev/sdks/rust/rest-api.md): Use the current Rust V3 client and understand retained V1/V2 helper methods.
- [Charts SDK](https://docs.polynode.dev/charts/overview.md): High-performance Canvas 2D charting library built for prediction markets and live crypto prices
- [Getting Started](https://docs.polynode.dev/charts/getting-started.md): Create your first chart in under 5 minutes
- [API Reference](https://docs.polynode.dev/charts/api-reference.md): Complete API documentation for Chart, Series, TimeScale, PriceScale, and Orderbook
- [Data Providers](https://docs.polynode.dev/charts/data-providers.md): Built-in providers for polynode REST API, orderbook streaming, and short-form market discovery
- [Live Streaming](https://docs.polynode.dev/charts/live-streaming.md): Real-time crypto price charts with price-to-beat overlays and live odds
- [Examples](https://docs.polynode.dev/charts/examples.md): Copy-paste examples for common chart setups
- [Changelog](https://docs.polynode.dev/changelog.md): Recent polynode API, SDK, account, and product changes, with older releases preserved in linked weekly archives.
- [Changelog - August 10-16, 2026](https://docs.polynode.dev/changelog-august-10-16-2026.md): Archived polynode SDK, billing, V3, WebSocket, Chainlink, and user-owned execution changes from August 10 through August 16, 2026.
- [Changelog - August 3-9, 2026](https://docs.polynode.dev/changelog-august-3-9-2026.md): Archived polynode usage, billing, V3, WebSocket, perps, Chainlink, and dashboard changes from August 3 through August 9, 2026.
- [Changelog - July 27-August 2, 2026](https://docs.polynode.dev/changelog-july-27-august-2-2026.md): Archived polynode SDK, combo, Chainlink, V3, order-book, and account changes from July 27 through August 2, 2026.
- [Changelog - July 20-26, 2026](https://docs.polynode.dev/changelog-july-20-26-2026.md): Archived polynode combo, trade, WebSocket, account, and billing changes from July 20 through July 26, 2026.
- [Changelog - July 13-19, 2026](https://docs.polynode.dev/changelog-july-13-19-2026.md): Archived PolyNode API, identity, WebSocket, orderbook, website, pagination, performance, and reliability changes from July 13 through July 19, 2026.
- [Changelog - July 6-12, 2026](https://docs.polynode.dev/changelog-july-6-12-2026.md): Archived PolyNode API, identity, credits, perps, orderbook, and data-quality changes from July 6 through July 12, 2026.
- [Changelog - June 29-July 5, 2026](https://docs.polynode.dev/changelog-june-29-july-5-2026.md): Archived polynode API and data-quality changes from June 29 through July 5, 2026.
- [Changelog - June 22-28, 2026](https://docs.polynode.dev/changelog-june-22-28-2026.md): Archived PolyNode API, WebSocket, Explorer, and documentation changes from June 22 through June 28, 2026.
- [Changelog - June 15-21, 2026](https://docs.polynode.dev/changelog-june-15-21-2026.md): Archived PolyNode API, WebSocket, and documentation changes from June 15 through June 21, 2026.
- [Changelog - June 8-14, 2026](https://docs.polynode.dev/changelog-june-8-14-2026.md): Archived PolyNode API, WebSocket, orderbook, and SDK changes from June 8 through June 14, 2026.
- [Changelog - June 1-7, 2026](https://docs.polynode.dev/changelog-june-1-7-2026.md): Archived polynode API and WebSocket changes from June 1 through June 7, 2026.
- [Changelog - May 25-31, 2026](https://docs.polynode.dev/changelog-may-25-31-2026.md): Archived polynode API, SDK, WebSocket, webhook, and billing changes from May 25 through May 31, 2026.
- [Changelog - May 2-24, 2026](https://docs.polynode.dev/changelog-may-2-24-2026.md): Archived polynode API and SDK changes from May 2 through May 24, 2026.
- [Changelog — May 1, 2026](https://docs.polynode.dev/changelog-may-1-2026.md): Archived PolyNode API and SDK changes from May 1, 2026.
- [Changelog — April 30, 2026](https://docs.polynode.dev/changelog-april-30-2026.md): Archived PolyNode API and SDK changes from April 30, 2026.
- [Changelog — April 27, 2026 — Positions](https://docs.polynode.dev/changelog-april-27-2026-positions.md): Archived PolyNode position API changes from April 27, 2026.
- [Changelog — April 27, 2026 — Trades](https://docs.polynode.dev/changelog-april-27-2026-trades.md): Archived PolyNode trade API changes from April 27, 2026.
- [Changelog — April 26, 2026](https://docs.polynode.dev/changelog-april-26-2026.md): Archived PolyNode API and SDK changes from April 26, 2026.
- [Changelog — April 17–25, 2026](https://docs.polynode.dev/changelog-april-17-25-2026.md): Archived PolyNode API and SDK changes from April 17–25, 2026.
- [Changelog — April 1–15, 2026](https://docs.polynode.dev/changelog-april-1-15-2026.md): Archived PolyNode API and SDK changes from April 1–15, 2026.
- [Changelog — March 28–31, 2026](https://docs.polynode.dev/changelog-march-28-31-2026.md): Archived PolyNode API and SDK changes from March 28–31, 2026.
- [Changelog — March 15–26, 2026](https://docs.polynode.dev/changelog-march-15-26-2026.md): Archived PolyNode API and SDK changes from March 15–26, 2026.
- [Introduction](https://docs.polynode.dev/introduction.md): Real-time Polymarket data API — settlements detected up to 5 seconds before on-chain confirmation.
- [Quickstart](https://docs.polynode.dev/quickstart.md): Generate an API key and make your first request in 30 seconds.
- [Authentication](https://docs.polynode.dev/authentication.md): API key generation, authentication methods, and security.
- [Polymarket Profile Setup](https://docs.polynode.dev/guides/polymarket-profile-setup.md): Let your users create or change their Polymarket username from an EOA wallet without handling private keys.
- [Deposit Wallets](https://docs.polynode.dev/guides/deposit-wallets.md): Everything you need to know about Polymarket's new deposit wallet system and how it affects your integration.
- [Polymarket V2 Migration](https://docs.polynode.dev/guides/v2-migration.md): polynode is ready for the Polymarket V2 exchange upgrade. Here's what you need to know.
- [Polymarket Protocol V2 Markets](https://docs.polynode.dev/guides/polymarket-protocol-v2.md): What Polymarket Protocol V2 is, when new markets move to it, and what it means for your polynode integration. For most integrations, nothing changes.
- [V2 Technical Details](https://docs.polynode.dev/guides/v2-details.md): Detailed V2 contract information for polynode subscribers.
- [PolyUSD Guide](https://docs.polynode.dev/guides/polyusd.md): How to wrap and unwrap PolyUSD — the collateral token for Polymarket V2.
- [Trade Tracking Guide](https://docs.polynode.dev/guides/trade-tracking.md): How to track Polymarket trades for copy trading, analytics, and bookkeeping.
- [Nonce Exploit Research](https://docs.polynode.dev/guides/nonce-exploit.md): Live research on the Polymarket settlement exploit — methodology, on-chain evidence, attacker identification, and detection.
- [Best Practices](https://docs.polynode.dev/guides/best-practices.md): Patterns for correctly handling the pending-to-confirmed lifecycle, snapshots, and reconnection.
- [Position Management](https://docs.polynode.dev/guides/position-management.md): Split, merge, and convert positions on Polymarket, with gasless Safe and deposit-wallet execution.
- [Errors](https://docs.polynode.dev/guides/errors.md): Error format, status codes, and troubleshooting.
- [Rate Limits](https://docs.polynode.dev/guides/rate-limits.md): Rate limiting details and best practices.
- [Fee Escrow](https://docs.polynode.dev/guides/fee-escrow.md): Optional per-order fee collection with on-chain escrow, refund on cancel, and affiliate revenue sharing.
- [Copy Trading API](https://docs.polynode.dev/guides/copy-trading-api.md): Build a copy-trading product on top of polynode. Register followers + leaders, we detect fills and webhook your backend an unsigned order ready to sign.
- [Serving ~1 Billion On-Chain Events at Sub-10ms](https://docs.polynode.dev/guides/trade-index.md): How polynode replaced third-party subgraph infrastructure with a purpose-built trade index covering every Polymarket trade, position, and settlement since November 2022.
- [Copy Trading Pipeline](https://docs.polynode.dev/guides/copy-trading.md): Private documentation for copy trading integration partners
- [Case studies](https://docs.polynode.dev/case-studies/overview.md): Dated, reproducible studies of Polynode performance, coverage, and production behavior.
- [Pending and confirmed WebSocket delivery: Polynode vs RTDS and Struct](https://docs.polynode.dev/case-studies/pending-confirmed-websocket-latency-2026-08-14.md): An August 14, 2026 production benchmark of Polynode pending detection, confirmation delivery, confirmed fills, and exact on-chain completeness.
- [Pending signal and observed copy execution: Polynode vs Bravado](https://docs.polynode.dev/case-studies/bravado-pending-copy-execution-2026-08-07.md): An August 7, 2026 study of pending latency, public-stream coverage, observed same-block copy execution, and product breadth.
- [WebSocket latency and completeness: PolyNode, Struct, and RTDS](https://docs.polynode.dev/case-studies/struct-rtds-websocket-benchmark-2026-08-01.md): Reproducible August 1 and August 4, 2026 benchmarks of pending detection, confirmed fills, and on-chain completeness.
- [Polygon cut block time by 25%: what changed for Polymarket](https://docs.polynode.dev/case-studies/polygon-block-time-polymarket-2026-08-04.md): A measured study of Polygon's move from 2.0-second to 1.5-second blocks and the resulting change in Polymarket pre-confirmation timing.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.