# Predexon API

## Docs

- [Welcome to Predexon](https://docs.predexon.com/index.md): The data layer for prediction markets — the fastest WebSocket, tick-level orderbook history, and blockchain-indexed analytics behind a single API key.
- [Get started in 5 minutes](https://docs.predexon.com/start-here/get-started.md): Sign up, get a key, make your first call. Then pick the path that fits your use case.
- [Quant & data trader](https://docs.predexon.com/start-here/quant-guide.md): From zero to a working backtest in 10 minutes. The data, signals, and tools quants reach for first.
- [App builder & platform](https://docs.predexon.com/start-here/builder-guide.md): Architecture patterns for products built on prediction-market data — dashboards, trackers, discovery, and analytics UX on one API.
- [Active trader & fund guide](https://docs.predexon.com/start-here/active-trader-guide.md): The data-driven trading loop — find edges with the fastest feeds, smart-money signals, and tick-level history, then act on them wherever you execute.
- [AI agent developer](https://docs.predexon.com/start-here/agent-cookbook.md): Drop the Predexon MCP server into Claude, Cursor, or Codex. Five recipes for agents that read prediction-market data.
- [Copy-trade a wallet](https://docs.predexon.com/start-here/cookbook/copy-trade-wallet.md): Subscribe to a target wallet's trades over WebSocket, then mirror each fill through your own venue-native execution.
- [Detect smart-money entry into a market](https://docs.predexon.com/start-here/cookbook/smart-money-entry.md): Watch which markets profitable wallets are piling into, alert when net smart-money flow crosses a threshold, optionally auto-size in via your own execution.
- [Portfolio monitor](https://docs.predexon.com/start-here/cookbook/portfolio-monitor.md): Live dashboard of any wallet's positions, P&L, and fills — the pattern behind most prediction-market portfolio UIs.
- [Front-run from pending trades](https://docs.predexon.com/start-here/cookbook/pending-trade-frontrun.md): Detect Polymarket fills 3–5 seconds before they confirm by listening to the Polygon mempool, then act on the leading indicator.
- [Prediction Markets 101](https://docs.predexon.com/concepts/prediction-markets.md): Understand how prediction markets work and the key concepts behind the Predexon API
- [Smart Money & Analytics](https://docs.predexon.com/concepts/smart-money.md): Understand how Predexon identifies and tracks high-performing traders
- [How It Works](https://docs.predexon.com/concepts/how-it-works.md): How Predexon turns raw blockchain and venue data into the fastest, most accurate prediction-market datasets.
- [Authentication](https://docs.predexon.com/authentication.md): How to authenticate with the Predexon API
- [Rate Limits & Plans](https://docs.predexon.com/rate-limits.md): Understand Predexon's pricing tiers, rate limits, and feature access
- [Best practices](https://docs.predexon.com/start-here/best-practices.md): Patterns we've seen work in production: pagination, retries, rate-limit handling, WebSocket reconnect, idempotency, testing strategy.
- [Migrating from another provider](https://docs.predexon.com/start-here/migrating.md): Side-by-side translations from Polymarket's native API, Goldsky, Dune, and self-built indexers to Predexon endpoints.
- [MCP Server](https://docs.predexon.com/mcp-server.md): Use Predexon API with AI assistants via Model Context Protocol
- [Data & Signals](https://docs.predexon.com/data-signals/overview.md): Normalized prediction-market data, wallet analytics, smart-money signals, and real-time WebSocket feeds across every major venue.
- [Quickstart](https://docs.predexon.com/quickstart.md): Get started with the Predexon Data API in under 5 minutes
- [Data Credits & Pricing](https://docs.predexon.com/data-signals/ticks/data-credits.md): How bulk tick downloads are priced: prepaid credits, quotes, and download charges
- [Tick Data](https://docs.predexon.com/data-signals/ticks/kalshi.md): Download raw, tick-level Kalshi orderbook deltas as bulk columnar Parquet
- [Tick Data](https://docs.predexon.com/data-signals/ticks/polymarket.md): Download raw, tick-level Polymarket CLOB price changes as bulk columnar Parquet
- [Tick Data](https://docs.predexon.com/data-signals/ticks/opinion.md): Download raw, tick-level Opinion orderbook deltas as bulk columnar Parquet
- [List Markets](https://docs.predexon.com/api-reference/markets/list-markets.md): Query markets with filtering, sorting, and cursor-based pagination
- [List Events](https://docs.predexon.com/api-reference/markets/events.md): List events with filtering, sorting, and cursor-based pagination
- [Crypto Up/Down Markets](https://docs.predexon.com/api-reference/markets/crypto-updown.md): List crypto up/down prediction markets
- [List Markets](https://docs.predexon.com/api-reference/kalshi/list-markets.md): Query Kalshi markets with filtering, sorting, and pagination
- [List Markets](https://docs.predexon.com/api-reference/limitless/markets.md): List Limitless markets with filtering and sorting
- [List Markets](https://docs.predexon.com/api-reference/opinion/markets.md): List Opinion markets with filtering and sorting
- [List Markets](https://docs.predexon.com/api-reference/predictfun/markets.md): List Predict.Fun markets with filtering and sorting
- [Unified Search](https://docs.predexon.com/api-reference/discovery/search.md): Cross-surface search over Polymarket markets, events, and tags
- [List Categories](https://docs.predexon.com/api-reference/discovery/categories.md): Top-level categories with market counts, volume, and liquidity
- [List Tags](https://docs.predexon.com/api-reference/discovery/tags.md): Curated tags with rolled-up volume and liquidity metrics
- [Get Tag Detail](https://docs.predexon.com/api-reference/discovery/tag.md): Metadata and rolled-up metrics for a single curated tag
- [Get Tag Subtags](https://docs.predexon.com/api-reference/discovery/tag-subtags.md): Ranked child subtags for a major tag, each with an event count
- [List Series](https://docs.predexon.com/api-reference/discovery/series.md): Recurring market groupings, ordered by open-event count
- [Get Series Detail](https://docs.predexon.com/api-reference/discovery/series-detail.md): A single series plus its events (keyset-paginated)
- [Market Price](https://docs.predexon.com/api-reference/markets/market-price.md): Get the current or historical price for a specific token
- [Candlesticks](https://docs.predexon.com/api-reference/markets/candlesticks.md): Get historical OHLCV candlestick data for a market
- [Candlesticks by Token](https://docs.predexon.com/api-reference/markets/candlesticks-by-token.md): Get historical OHLCV candlestick data for a single outcome token
- [Volume Time Series](https://docs.predexon.com/api-reference/markets/volume.md): Get historical cumulative volume data for a market
- [Volume Chart](https://docs.predexon.com/api-reference/markets/volume-chart.md): Fetch volume chart data for a market
- [Open Interest Time Series](https://docs.predexon.com/api-reference/markets/open-interest.md): Get historical open interest data for a market
- [Ticks](https://docs.predexon.com/api-reference/binance/ticks.md): Get raw book ticker data at microsecond granularity
- [Candles](https://docs.predexon.com/api-reference/binance/candles.md): Get OHLCV candlestick data for a Binance trading pair
- [Orderbook History](https://docs.predexon.com/api-reference/markets/orderbooks.md): Get historical orderbook snapshots for a token
- [Orderbook History](https://docs.predexon.com/api-reference/kalshi/orderbooks.md): Fetch historical orderbook snapshots for a Kalshi market
- [Orderbook History (Sub-Cent)](https://docs.predexon.com/api-reference/kalshi/orderbooks-subcent.md): Fetch historical sub-cent orderbook snapshots for a Kalshi market
- [Orderbook History](https://docs.predexon.com/api-reference/limitless/orderbooks.md): Fetch historical orderbook snapshots for a Limitless market
- [Orderbook History](https://docs.predexon.com/api-reference/opinion/orderbooks.md): Fetch historical orderbook snapshots for an Opinion market
- [Orderbook History](https://docs.predexon.com/api-reference/predictfun/orderbooks.md): Fetch historical orderbook snapshots for a Predict.Fun market
- [Trades History](https://docs.predexon.com/api-reference/trading/trades.md): Fetch historical trade data
- [Trades History](https://docs.predexon.com/api-reference/kalshi/trades.md): Fetch historical Kalshi trade data
- [Activity](https://docs.predexon.com/api-reference/trading/activity.md): Fetch trading activity (merges, splits, redeems) for a user
- [All Positions](https://docs.predexon.com/api-reference/trading/positions.md): Fetch all user positions with filtering and pagination
- [Wallet Profile](https://docs.predexon.com/api-reference/wallet/wallet-profile.md): Get a complete smart wallet profile
- [Wallet Profiles (Batch)](https://docs.predexon.com/api-reference/wallet/wallet-profiles-batch.md): Get wallet profiles for multiple addresses in a single request
- [Wallet Identity](https://docs.predexon.com/api-reference/wallet/identity.md): Fetch identity and profile metadata for a wallet
- [Wallet Identities (Batch)](https://docs.predexon.com/api-reference/wallet/identities-batch.md): Bulk lookup of wallet identity profiles
- [Connected Wallets](https://docs.predexon.com/api-reference/wallet/cluster.md): Discover wallets connected to a seed address via on-chain transfers and identity proofs
- [Wallet Positions](https://docs.predexon.com/api-reference/wallet/positions.md): Get open and historical positions for a wallet address
- [Wallet P&L](https://docs.predexon.com/api-reference/wallet/pnl.md): Get P&L summary and realized P&L time series for a wallet
- [Wallet Markets](https://docs.predexon.com/api-reference/wallet/wallet-markets.md): Get per-market performance breakdown for a wallet
- [Similar Wallets](https://docs.predexon.com/api-reference/wallet/similar-wallets.md): Find wallets with similar market portfolios
- [Wallet Volume Chart](https://docs.predexon.com/api-reference/wallet/volume-chart.md): Fetch volume chart data for a wallet
- [Smart Activity Markets](https://docs.predexon.com/api-reference/smart-money/smart-activity.md): Discover markets where high-performing wallets are active
- [Smart Money Positioning](https://docs.predexon.com/api-reference/smart-money/smart-money-market.md): Smart money positioning for a specific market
- [Global Leaderboard](https://docs.predexon.com/api-reference/analytics/leaderboard.md): Get the global leaderboard of smart wallets
- [Market Leaderboard](https://docs.predexon.com/api-reference/analytics/market-leaderboard.md): Leaderboard for a specific market
- [Cohort Stats](https://docs.predexon.com/api-reference/analytics/cohort-stats.md): Compare performance across trading style cohorts
- [Filter Wallets by Markets](https://docs.predexon.com/api-reference/analytics/filter-wallets.md): Filter wallets by market trades with AND/OR logic
- [Market Top Holders](https://docs.predexon.com/api-reference/analytics/top-holders.md): Top holders for a specific market ranked by position size
- [Position Top Holders](https://docs.predexon.com/api-reference/analytics/position-top-holders.md): Top holders of a specific Polymarket token, ranked by position size
- [List UMA Markets](https://docs.predexon.com/api-reference/uma/list-markets.md): List UMA questions filtered by oracle state
- [Get UMA Market](https://docs.predexon.com/api-reference/uma/get-market.md): Get current UMA oracle status and event timeline for a market
- [Builder Leaderboard](https://docs.predexon.com/api-reference/builders/leaderboard.md): Ranked list of V2 builders by attributed volume or fee revenue
- [Builder Stats](https://docs.predexon.com/api-reference/builders/builder-stats.md): Single-builder summary plus full fee-rate history
- [Builder Markets](https://docs.predexon.com/api-reference/builders/builder-markets.md): Top markets attributed to a builder over a rolling window
- [Builder Timeseries](https://docs.predexon.com/api-reference/builders/builder-timeseries.md): Bucketed volume and fee revenue for a builder over a rolling window
- [Wallet Builder Fees](https://docs.predexon.com/api-reference/builders/wallet-builder-fees.md): Total builder fees a wallet has paid, with a per-builder breakdown
- [Overview](https://docs.predexon.com/websocket/overview.md): Real-time Polymarket trade, activity, and lifecycle events via WebSocket
- [Subscriptions](https://docs.predexon.com/websocket/subscriptions.md): Create and manage WebSocket subscriptions
- [V2 Migration Guide](https://docs.predexon.com/websocket/v2-migration.md): What changed in the WebSocket API for Polymarket V2 - deployed 2026-04-19
- [Trade Events](https://docs.predexon.com/websocket/trades.md): Real-time confirmed order fills and fee refunds
- [Pending Trades](https://docs.predexon.com/websocket/pending-trades.md): Get trade events 3–5 seconds early from the Polygon mempool
- [Trades Playground](https://docs.predexon.com/websocket/playground-trades.md): Real-time order fills and fee refunds. Set status filter to `all` or `pending` for mempool events (3-5s early).
- [Activity Events](https://docs.predexon.com/websocket/activity.md): Real-time split, merge, and redemption events
- [Activity Playground](https://docs.predexon.com/websocket/playground-activity.md): Position splits, merges, and redemptions on Polymarket.
- [Lifecycle Events](https://docs.predexon.com/websocket/lifecycle.md): Real-time token registrations and market resolutions
- [Lifecycle Playground](https://docs.predexon.com/websocket/playground-lifecycle.md): Market creation (token_registered) and resolution (condition_resolution) events.
- [Orderbook Stream](https://docs.predexon.com/websocket/orderbook.md): Real-time L2 orderbook data: price changes, trades, and book snapshots for Polymarket markets
- [Orderbook Playground](https://docs.predexon.com/websocket/playground-orderbook.md): Real-time L2 orderbook from Polymarket CLOB. Exactly one filter type per subscription.
- [Oracle Events](https://docs.predexon.com/websocket/oracle.md): Real-time UMA oracle events: proposals, disputes, settlements, and resets for Polymarket markets
- [Oracle Playground](https://docs.predexon.com/websocket/playground-oracle.md): UMA oracle resolution events — proposals, disputes, settlements, and resets.
- [Collateral Events](https://docs.predexon.com/websocket/collateral.md): Real-time pUSD deposit and withdrawal events (V2)
- [Collateral Playground](https://docs.predexon.com/websocket/playground-collateral.md): pUSD wrap/unwrap events (V2). Tracks deposits and withdrawals of the V2 trading collateral.
- [Crypto Prices](https://docs.predexon.com/websocket/crypto-prices.md): Real-time crypto price ticks relayed from Chainlink Data Streams
- [Crypto Prices Playground](https://docs.predexon.com/websocket/playground-crypto-prices.md): Real-time crypto price ticks relayed from Chainlink Data Streams (Mercury). One tick per upstream observation.
- [Orderbook replay](https://docs.predexon.com/data-signals/backtesting/orderbook-replay.md): Replay historical Polymarket orderbook state to backtest strategies against the real depth that existed at the time.
- [Candle and trade reconciliation](https://docs.predexon.com/data-signals/backtesting/candle-trade-reconciliation.md): Backtest faster with candles for top-level pattern detection, then reconcile against the trade tape to confirm fills were really available.
- [Backtesting Predexon signals](https://docs.predexon.com/data-signals/backtesting/signal-backtest.md): Validate smart-money, top-holders, and pending-trade signals against historical trades and orderbook state before going live.
- [All Endpoints](https://docs.predexon.com/api-reference/endpoints.md): Complete directory of every Predexon API endpoint - markets, prices, orderbooks, trades, wallets, and smart money across every venue
- [Trading Labels](https://docs.predexon.com/api-reference/trading-labels.md): How Predexon classifies wallet trading behavior and entry styles
- [Changelog](https://docs.predexon.com/changelog.md): Updates and new features for the Predexon API and WebSocket service

## OpenAPI Specs

- [openapi-v2](https://docs.predexon.com/openapi-v2.json)
- [openapi-v1](https://docs.predexon.com/api-reference/openapi-v1.json)

## AsyncAPI Specs

- [asyncapi](https://docs.predexon.com/websocket/asyncapi.json)