Base URLs
- Data API:
https://api.predexon.com
- Trading API:
https://trade.predexon.com
All endpoints authenticate via the x-api-key header. Get your API key →
Data API - 58 Endpoints
Polymarket
Kalshi
Binance
Other Platforms
Cross-Platform
Markets & Pricing
| Method | Endpoint | Description |
|---|
GET | /v2/polymarket/markets/keyset | List markets - search, filter, sort with cursor pagination |
GET | /v2/polymarket/events/keyset | List events - top-level event groupings with cursor pagination |
GET | /v2/polymarket/crypto-updown | Crypto up/down - BTC, ETH, SOL, XRP, HYPE, DOGE, BNB across 5m–daily |
GET | /v2/polymarket/market-price/{token_id} | Market price - current or historical |
GET | /v2/polymarket/candlesticks/{condition_id} | Candlesticks - OHLCV at 1m/1h/1d intervals, normalized to YES side |
GET | /v2/polymarket/candlesticks/token/{token_id} | Candlesticks by token - per-token OHLCV with un-normalized NO prices |
GET | /v2/polymarket/markets/{token_id}/volume | Volume time series - cumulative by buy/sell |
GET | /v2/polymarket/volume-chart/{condition_id} | Volume chart - per-period with YES/NO breakdown |
GET | /v2/polymarket/markets/{condition_id}/open_interest | Open interest - historical OI tracking |
GET | /v2/polymarket/orderbooks | Orderbooks - historical snapshots at ms resolution |
Discovery & Taxonomy
| Method | Endpoint | Description |
|---|
GET | /v2/polymarket/search | Unified search - markets, events, and tags in one query |
GET | /v2/polymarket/categories | Categories - top-level categories with counts + active volume/OI |
GET | /v2/polymarket/tags | Tags - curated tags with rolled-up volume/OI metrics |
GET | /v2/polymarket/tag/{slug} | Tag detail - metadata + metrics for one tag |
GET | /v2/polymarket/tag/{slug}/subtags | Tag subtags - ranked child subtags with event counts |
GET | /v2/polymarket/series | Series - recurring market groupings (daily/weekly/monthly) |
GET | /v2/polymarket/series/{slug} | Series detail - one series plus its events (keyset) |
Trades & Activity
| Method | Endpoint | Description |
|---|
GET | /v2/polymarket/trades | Trades - by market, token, or wallet |
GET | /v2/polymarket/activity | Activity - splits, merges, redeems |
GET | /v2/polymarket/positions | Positions - cross-wallet position scanner |
Wallet Analytics
| Method | Endpoint | Description |
|---|
GET | /v2/polymarket/wallet/{wallet} | Profile - full metrics across all time windows |
GET | /v2/polymarket/wallets/profiles | Batch profiles - up to 20 wallets at once |
GET | /v2/polymarket/wallet/positions/{wallet} | Positions - open + historical with P&L |
GET | /v2/polymarket/wallet/pnl/{wallet} | P&L - realized, unrealized, total |
GET | /v2/polymarket/wallet/{wallet}/markets | Market breakdown - per-market performance |
GET | /v2/polymarket/wallet/{wallet}/similar | Similar wallets - portfolio overlap detection |
GET | /v2/polymarket/wallet/volume-chart/{wallet} | Volume chart - BUY/SELL breakdown |
GET | /v2/polymarket/wallet/identity/{wallet} | Identity - display name, X handle, badges, wallet type, USDC balance |
POST | /v2/polymarket/wallet/identities | Identities (batch) - up to 200 addresses, proxy or signer EOA |
GET | /v2/polymarket/wallet/{address}/cluster | Connected wallets - on-chain transfer graph + identity-proof clusters |
Smart Money & Analytics
Requires Dev plan or higher.
| Method | Endpoint | Description |
|---|
GET | /v2/polymarket/markets/smart-activity | Smart activity - markets where top wallets trade |
GET | /v2/polymarket/market/{condition_id}/smart-money | Smart money - net positioning for a market |
GET | /v2/polymarket/leaderboard | Leaderboard - global wallet rankings |
GET | /v2/polymarket/leaderboard/market/{condition_id} | Market leaderboard - per-market rankings |
GET | /v2/polymarket/market/{condition_id}/top-holders | Top holders - largest positions |
GET | /v2/polymarket/position/{token_id}/top-holders | Position top holders - largest holders of one token |
GET | /v2/polymarket/wallets/filter | Filter wallets - by market + performance |
GET | /v2/polymarket/cohorts/stats | Cohort stats - aggregate by trading style |
UMA
| Method | Endpoint | Description |
|---|
GET | /v2/polymarket/uma/markets | List UMA markets - non-sports UMA questions, sorted by last_event_at |
GET | /v2/polymarket/uma/market/{condition_id} | Get UMA market - current oracle status + event timeline |
Builders
V2-only. Builder attribution excludes V1 fills and the zero-sentinel builder.
| Method | Endpoint | Description |
|---|
GET | /v2/polymarket/builders/leaderboard | Builder leaderboard - V2 builders ranked by volume or fee revenue |
GET | /v2/polymarket/builders/{builder_code} | Builder stats - single-builder summary + full (taker_bps, maker_bps) history |
GET | /v2/polymarket/builders/{builder_code}/markets | Builder markets - top markets attributed to a builder over a rolling window |
GET | /v2/polymarket/builders/{builder_code}/timeseries | Builder timeseries - bucketed volume + fee revenue over a rolling window |
GET | /v2/polymarket/builders/wallet/{wallet} | Wallet builder fees - total builder fees a wallet paid, per-builder breakdown |
| Method | Endpoint | Description |
|---|
GET | /v2/kalshi/markets | List markets - filter by ticker, event, status, price range |
GET | /v2/kalshi/trades | Trades - historical with taker side |
GET | /v2/kalshi/orderbooks | Orderbooks - historical snapshots, prices in cents |
Requires Dev plan or higher.
| Method | Endpoint | Description |
|---|
GET | /v2/binance/ticks/{symbol} | Ticks - raw book ticker at microsecond granularity |
GET | /v2/binance/candles/{symbol} | Candles - OHLCV from 1s to 1d intervals |
Requires Dev plan or higher.
Canonical Markets
| Method | Endpoint | Description |
|---|
GET | /v2/markets | Canonical markets - cross-venue market containers with outcome-level predexon_ids |
GET | /v2/markets/listings | Canonical listings - flattened venue-native executable metadata |
GET | /v2/outcomes/{predexon_id} | Canonical outcome - all venue listings mapped to one predexon_id |
Matching
| Method | Endpoint | Description |
|---|
GET | /v2/markets/search | Search markets - cross-venue text search across all 5 venues, round-robin interleaved |
GET | /v2/matching-markets | Find matches - get equivalent markets across platforms |
GET | /v2/matching-markets/pairs | Matched pairs - all active exact matches |
Trading API
Base URL: https://trade.predexon.comEndpoints below use the accounts path (/api/accounts) — the canonical surface for all trading.
Accounts
Orders
Positions
Transfers
Fees
| Method | Endpoint | Description |
|---|
POST | /api/accounts/create | Create account - empty, no venues enabled |
GET | /api/accounts | List accounts - owned by this API key |
GET | /api/accounts/{accountId} | Get account - profile + per-venue entitlements |
DELETE | /api/accounts/{accountId} | Delete account - cascades cleanup across venues |
POST | /api/accounts/{accountId}/enable | Enable venue - provision wallet, gas, approvals |
| Method | Endpoint | Description |
|---|
POST | /api/accounts/{accountId}/orders | Place order - Polymarket, Predict, Opinion, Limitless, or Hyperliquid |
GET | /api/accounts/{accountId}/orders | List orders - optional ?venue= filter, ?aggregated=true to strip venue |
GET | /api/accounts/{accountId}/orders/{orderId} | Get order - by ID |
DELETE | /api/accounts/{accountId}/orders/{orderId} | Cancel order |
DELETE | /api/accounts/{accountId}/orders | Cancel all - optional ?venue= scope |
| Method | Endpoint | Description |
|---|
GET | /api/accounts/{accountId}/balance | Balance - optional ?aggregated=true for single USD-equivalent row |
GET | /api/accounts/{accountId}/positions | Positions - optional ?aggregated=true to collapse across venues |
POST | /api/accounts/{accountId}/redeem | Redeem - single-venue, by market bag |
| Method | Endpoint | Description |
|---|
GET | /api/accounts/{accountId}/deposit-info | Deposit wallet - Base USDC address + live balance |
POST | /api/accounts/{accountId}/transfers | Create transfer - one verb for fund / drain / withdraw |
GET | /api/accounts/{accountId}/transfers | List transfers - all directions, paginated |
GET | /api/accounts/{accountId}/transfers/{transferId} | Get transfer - poll cross-token transfers until terminal |
POST | /api/accounts/{accountId}/transfers/quote | Quote transfer - preview cost; signed tx for inbound deposits |
POST | /api/accounts/{accountId}/withdraw | Per-venue withdraw - used for Hyperliquid |
| Method | Endpoint | Description |
|---|
GET | /api/fees/policy | Get fee policy - Polymarket only |
PUT | /api/fees/policy | Set fee policy - configure partner markup |
DELETE | /api/fees/policy | Remove partner fee |
Access Tiers
Free - 16 endpoints
All Polymarket market data plus Kalshi markets, trades, and orderbooks. No credit card required.
Dev & Pro - 21 additional
Cross-platform matching, wallet analytics, smart money, leaderboards, Binance data, and WebSocket streaming.
