Prediction Markets API
Access real-time prediction market data via x402 micropayments. Powered by Predexon .
Unified access to Polymarket, Kalshi, dFlow, Binance, Limitless, Opinion, Predict.Fun, sports markets, plus UMA Oracle resolution data, canonical cross-venue market IDs, and on-chain wallet identity & clustering — all through a single API.
Mirrors the Predexon v2 Data API (docs.predexon.com/openapi-v2.json). Predexon's separate Trading API (order placement, fund management) is intentionally not exposed.
Networks
Network Base URL Asset Base (Ethereum L2) https://blockrun.aiUSDC Solana https://sol.blockrun.aiUSDC
Pricing
Tier Price Use Case Tier 1 $0.001 Market data, events, trades, orderbooks, positions, leaderboards, sports markets, canonical cross-venue markets Tier 2 $0.005 Wallet analytics (incl. identity + clustering), smart money, cross-platform matching, Binance data
Endpoints
Polymarket — Market Data (Tier 1: $0.001)
Endpoint Method Description /api/v1/pm/polymarket/marketsGET Query markets with filtering, sorting, and pagination /api/v1/pm/polymarket/markets/keysetGET Same filters as /polymarket/markets, with cursor-based keyset pagination /api/v1/pm/polymarket/eventsGET List events with filtering and sorting /api/v1/pm/polymarket/events/keysetGET List events with cursor-based keyset pagination /api/v1/pm/polymarket/crypto-updownGET List crypto up/down prediction markets /api/v1/pm/polymarket/market-price/{token_id}GET Get current or historical price for a token /api/v1/pm/polymarket/candlesticks/{condition_id}GET Get historical OHLCV candlestick data for a market /api/v1/pm/polymarket/candlesticks/token/{token_id}GET Get historical OHLCV candlestick data for a single outcome token /api/v1/pm/polymarket/volume-chart/{condition_id}GET Get volume chart with YES/NO breakdown /api/v1/pm/polymarket/orderbooksGET Get historical orderbook snapshots /api/v1/pm/polymarket/tradesGET Query historical trade data /api/v1/pm/polymarket/activityGET Fetch trading activity (merges, splits, redeems) /api/v1/pm/polymarket/markets/{token_id}/volumeGET Get historical cumulative volume /api/v1/pm/polymarket/markets/{condition_id}/open_interestGET Get historical open interest /api/v1/pm/polymarket/positionsGET Fetch all user positions
Polymarket — Analytics (Tier 1: $0.001)
Endpoint Method Description /api/v1/pm/polymarket/leaderboardGET Global leaderboard of smart wallets /api/v1/pm/polymarket/leaderboard/market/{condition_id}GET Leaderboard for a specific market /api/v1/pm/polymarket/cohorts/statsGET Compare performance across trading style cohorts /api/v1/pm/polymarket/market/{condition_id}/top-holdersGET Top holders ranked by position size
Polymarket — Wallet Analytics (Tier 2: $0.005)
Endpoint Method Description /api/v1/pm/polymarket/wallet/{wallet}GET Complete smart wallet profile /api/v1/pm/polymarket/wallet/{wallet}/marketsGET Per-market performance breakdown /api/v1/pm/polymarket/wallet/{wallet}/similarGET Find wallets with similar portfolios /api/v1/pm/polymarket/wallet/pnl/{wallet}GET P&L summary and time series /api/v1/pm/polymarket/wallet/positions/{wallet}GET Open and historical positions /api/v1/pm/polymarket/wallet/volume-chart/{wallet}GET Volume chart by BUY/SELL side /api/v1/pm/polymarket/wallets/profilesGET Batch wallet profiles (max 20) /api/v1/pm/polymarket/wallets/filterGET Filter wallets by market trades
Polymarket — Smart Money (Tier 2: $0.005)
Endpoint Method Description /api/v1/pm/polymarket/market/{condition_id}/smart-moneyGET Smart money positioning on a market /api/v1/pm/polymarket/markets/smart-activityGET Markets where top wallets are active
UMA Oracle — Polymarket Resolution (Tier 1: $0.001)
Endpoint Method Description /api/v1/pm/polymarket/uma/marketsGET List UMA oracle questions filtered by state (proposed, disputed, resolved, …) /api/v1/pm/polymarket/uma/market/{condition_id}GET Current UMA oracle status and event timeline for a single market
Wallet Identity & Clustering (Tier 2: $0.005)
Cross-context wallet labels and on-chain relationship graph data.
Endpoint Method Description /api/v1/pm/polymarket/wallet/identity/{wallet}GET Identity and profile metadata for a single wallet address /api/v1/pm/polymarket/wallet/identitiesPOST Bulk identity lookup — body {"addresses":[...]} (up to 200 addresses) /api/v1/pm/polymarket/wallet/{address}/clusterGET Wallets connected to a seed address via on-chain transfers and identity proofs
Kalshi (Tier 1: $0.001)
Endpoint Method Description /api/v1/pm/kalshi/marketsGET Query markets with filtering, sorting, and pagination /api/v1/pm/kalshi/tradesGET Fetch historical trade data /api/v1/pm/kalshi/orderbooksGET Fetch historical orderbook snapshots
dFlow
Endpoint Method Price Description /api/v1/pm/dflow/tradesGET $0.001 Fetch trade history for a wallet /api/v1/pm/dflow/wallet/positions/{wallet}GET $0.005 Current positions for a wallet /api/v1/pm/dflow/wallet/pnl/{wallet}GET $0.005 Realized P&L history for a wallet
Binance (Tier 2: $0.005)
Endpoint Method Description /api/v1/pm/binance/candles/{symbol}GET OHLCV candlestick data (BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT) /api/v1/pm/binance/ticks/{symbol}GET Raw book ticker data at microsecond granularity
Cross-Venue Canonical Markets (Tier 1: $0.001)
Predexon v2 unified data layer — canonical Predexon IDs across all venues.
Endpoint Method Description /api/v1/pm/marketsGET List canonical market/question containers with cross-venue Predexon IDs /api/v1/pm/markets/listingsGET List venue-native executable listings flattened across canonical markets /api/v1/pm/outcomes/{predexon_id}GET Resolve a canonical Predexon outcome ID to its market context and venue listings
Cross-Platform Matching & Search (Tier 2: $0.005)
Endpoint Method Description /api/v1/pm/matching-marketsGET Find equivalent markets across Polymarket and Kalshi /api/v1/pm/matching-markets/pairsGET Get all active exact-matched market pairs /api/v1/pm/markets/searchGET Search markets across Polymarket, Kalshi, Limitless, Opinion, and Predict.Fun in a single call
Sports Markets (Tier 1: $0.001)
Endpoint Method Description /api/v1/pm/sports/categoriesGET List available sports categories, sports, and leagues /api/v1/pm/sports/marketsGET List sports markets grouped by game (filter by sport, league, game_date, etc.) /api/v1/pm/sports/markets/{game_id}GET Get a single sports game with all venue outcomes /api/v1/pm/sports/outcomes/{predexon_id}GET Find all equivalent sports outcomes across venues for a Predexon ID
Other Platforms (Tier 1: $0.001)
Endpoint Method Description /api/v1/pm/limitless/marketsGET List Limitless markets with filtering and sorting /api/v1/pm/limitless/orderbooksGET Historical orderbook snapshots for Limitless /api/v1/pm/opinion/marketsGET List Opinion markets with filtering and sorting /api/v1/pm/opinion/orderbooksGET Historical orderbook snapshots for Opinion /api/v1/pm/predictfun/marketsGET List Predict.Fun markets with filtering and sorting /api/v1/pm/predictfun/orderbooksGET Historical orderbook snapshots for Predict.Fun
Example: Polymarket Markets
GET https://blockrun.ai/api/v1/pm/polymarket/markets
Query Parameters
Parameter Type Description searchstring Search query (3-100 chars) statusstring Filter by status (active, closed, archived) sortstring Sort by volume, liquidity, created limitinteger Results per page (1-100, default 20) pagination_keystring Cursor for pagination
Example
curl "https://blockrun.ai/api/v1/pm/polymarket/markets?search=bitcoin&limit=10"
Returns 402 with payment requirements. Attach an x402 payment header to get results.
Example: Kalshi Markets
GET https://blockrun.ai/api/v1/pm/kalshi/markets
Query Parameters
Parameter Type Description statusstring open or closedsearchstring Search in title (3-100 chars) tickerstring Filter by ticker(s) (max 50) event_tickerstring Filter by event ticker(s) sortstring volume, open_interest, price_desc, price_asc, close_timelimitinteger Results per page (1-100, default 20) pagination_keystring Cursor for pagination
Example
curl "https://blockrun.ai/api/v1/pm/kalshi/markets?search=bitcoin&sort=volume"
Example: Binance Candles
GET https://blockrun.ai/api/v1/pm/binance/candles/{symbol}
Path Parameters
Parameter Type Description symbolstring BTCUSDT, ETHUSDT, SOLUSDT, or XRPUSDT
Query Parameters
Parameter Type Description intervalstring 1s, 1m, 5m, 15m, 1h, 4h, 1d (default 1m)start_timeinteger Unix timestamp (seconds) end_timeinteger Unix timestamp (seconds) limitinteger Max candles (1-1500, default 500)
Example
curl "https://blockrun.ai/api/v1/pm/binance/candles/BTCUSDT?interval=1h&limit=24"
Example: Wallet Profile
GET https://blockrun.ai/api/v1/pm/polymarket/wallet/{wallet}
Example
curl "https://blockrun.ai/api/v1/pm/polymarket/wallet/0x1234...abcd"
Returns a complete smart wallet profile with trading stats, P&L, labels, and activity metrics.
Example: Bulk Wallet Identity (POST)
POST https://blockrun.ai/api/v1/pm/polymarket/wallet/identities
Body shape:
{ "addresses" : [ "0xabc..." , "0xdef..." , "..." ] }
Up to 200 addresses per call. For a single wallet, prefer GET /polymarket/wallet/identity/{wallet}.
curl -X POST "https://blockrun.ai/api/v1/pm/polymarket/wallet/identities" \
-H "content-type: application/json" \
-d '{"addresses":["0x1234...abcd","0x5678...ef01"]}'
Example: Sports Markets
GET https://blockrun.ai/api/v1/pm/sports/markets
curl "https://blockrun.ai/api/v1/pm/sports/markets?league=mlb&status=open&limit=10"
curl "https://blockrun.ai/api/v1/pm/sports/markets/mlb-laa-nym-2026-05-02"
Returns sports games grouped with all venue outcomes (Kalshi, Polymarket, etc.) attached.
SDK Usage
Works on all clients: LLMClient (Base), AsyncLLMClient, and SolanaLLMClient.
Partner
These endpoints are powered by Predexon — a unified prediction market data aggregator. Payments go directly to the Predexon treasury via x402.
Full Predexon API documentation: docs.predexon.com
What's next?