Prediction Market Data for AI Agents
Real-time prediction market data from Predexon. This catalog is generated from the live BlockRun registry, so every endpoint below is a route you can call via x402.
58 endpoints live on Base
Capabilities
58 Endpoints
Prediction markets, wallet analytics, smart money, and cross-market matching through one x402 gateway.
11 Categories
Polymarket, Kalshi, dFlow, Binance, matching markets, and more, all mapped directly from the live registry.
Pay Per Request
Flat $0.0095 per call — GET or POST, every endpoint the same. No API keys, no subscriptions — just USDC on Base.
Pricing
Pass-through pricing with 0% BlockRun margin. Payments go directly to Predexon's treasury wallet via x402.
GET
$0.0095
per request
Market data and historical snapshots
POST
$0.0095
per query
Wallet analytics, smart money, and matching endpoints
API Reference
Base URL: https://blockrun.ai/api/v1/pm/
Send any request without a payment header to get a 402 response with the exact price. Attach an x402 payment header to receive data.
Polymarket
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/polymarket/markets | GET | $0.0095 | Query Polymarket markets with filtering, sorting, and pagination |
/api/v1/pm/polymarket/markets/keyset | GET | $0.0095 | List Polymarket markets with cursor-based keyset pagination (same filters as /polymarket/markets) |
/api/v1/pm/polymarket/events | GET | $0.0095 | List Polymarket events with filtering and sorting |
/api/v1/pm/polymarket/events/keyset | GET | $0.0095 | List Polymarket events with cursor-based keyset pagination |
/api/v1/pm/polymarket/crypto-updown | GET | $0.0095 | List crypto up/down prediction markets |
/api/v1/pm/polymarket/market-price/:token_id | GET | $0.0095 | Get current or historical price for a specific token |
/api/v1/pm/polymarket/candlesticks/:condition_id | GET | $0.0095 | Get historical OHLCV candlestick data for a market |
/api/v1/pm/polymarket/candlesticks/token/:token_id | GET | $0.0095 | Get historical OHLCV candlestick data for a single outcome token |
/api/v1/pm/polymarket/volume-chart/:condition_id | GET | $0.0095 | Get volume chart with YES/NO breakdown for a market |
/api/v1/pm/polymarket/orderbooks | GET | $0.0095 | Get historical orderbook snapshots for a token |
/api/v1/pm/polymarket/trades | GET | $0.0095 | Query historical Polymarket trade data with flexible filtering |
/api/v1/pm/polymarket/activity | GET | $0.0095 | Fetch trading activity (merges, splits, redeems) for a user |
/api/v1/pm/polymarket/markets/:token_id/volume | GET | $0.0095 | Get historical cumulative volume data for a market |
/api/v1/pm/polymarket/markets/:condition_id/open_interest | GET | $0.0095 | Get historical open interest data for a market |
/api/v1/pm/polymarket/positions | GET | $0.0095 | Fetch all user positions with filtering and pagination |
/api/v1/pm/polymarket/leaderboard | GET | $0.0095 | Get the global leaderboard of smart wallets |
/api/v1/pm/polymarket/leaderboard/market/:condition_id | GET | $0.0095 | Get leaderboard for a specific market |
/api/v1/pm/polymarket/cohorts/stats | GET | $0.0095 | Compare performance across trading style cohorts |
/api/v1/pm/polymarket/market/:condition_id/top-holders | GET | $0.0095 | Get top holders for a specific market ranked by position size |
/api/v1/pm/polymarket/wallet/:wallet | GET | $0.0095 | Get a complete smart wallet profile with all metrics |
/api/v1/pm/polymarket/wallet/:wallet/markets | GET | $0.0095 | Get per-market performance breakdown for a wallet |
/api/v1/pm/polymarket/wallet/:wallet/similar | GET | $0.0095 | Find wallets with similar market portfolios |
/api/v1/pm/polymarket/wallet/pnl/:wallet | GET | $0.0095 | Get P&L summary and realized P&L time series for a wallet |
/api/v1/pm/polymarket/wallet/positions/:wallet | GET | $0.0095 | Get open and historical positions for a wallet address |
/api/v1/pm/polymarket/wallet/volume-chart/:wallet | GET | $0.0095 | Get volume chart broken down by BUY/SELL side for a wallet |
/api/v1/pm/polymarket/wallets/profiles | GET | $0.0095 | Batch retrieve wallet profiles for multiple addresses |
/api/v1/pm/polymarket/wallets/filter | GET | $0.0095 | Filter wallets by market trades with AND/OR logic |
/api/v1/pm/polymarket/market/:condition_id/smart-money | GET | $0.0095 | View smart money positioning on a specific market |
/api/v1/pm/polymarket/markets/smart-activity | GET | $0.0095 | Discover markets where high-performing wallets are active |
Kalshi
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/kalshi/markets | GET | $0.0095 | Query Kalshi markets with filtering, sorting, and pagination |
/api/v1/pm/kalshi/trades | GET | $0.0095 | Fetch historical Kalshi trade data |
/api/v1/pm/kalshi/orderbooks | GET | $0.0095 | Fetch historical orderbook snapshots for a Kalshi market |
dFlow
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/dflow/trades | GET | $0.0095 | Fetch trade history for a wallet on dFlow |
/api/v1/pm/dflow/wallet/positions/:wallet | GET | $0.0095 | Fetch current positions for a dFlow wallet |
/api/v1/pm/dflow/wallet/pnl/:wallet | GET | $0.0095 | Fetch realized profit and loss history for a dFlow wallet |
Binance
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/binance/candles/:symbol | GET | $0.0095 | Get OHLCV candlestick data for a Binance trading pair |
/api/v1/pm/binance/ticks/:symbol | GET | $0.0095 | Get raw book ticker data at microsecond granularity |
Cross-Venue Canonical Markets & Search
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/matching-markets | GET | $0.0095 | Find equivalent markets across Polymarket and Kalshi |
/api/v1/pm/matching-markets/pairs | GET | $0.0095 | Get all active exact-matched market pairs |
/api/v1/pm/markets/search | GET | $0.0095 | Search markets across Polymarket, Kalshi, Limitless, Opinion, and Predict.Fun in a single call |
/api/v1/pm/markets | GET | $0.0095 | List canonical market/question containers with cross-venue Predexon IDs |
/api/v1/pm/markets/listings | GET | $0.0095 | List venue-native executable listings flattened across canonical markets |
/api/v1/pm/outcomes/:predexon_id | GET | $0.0095 | Resolve a canonical Predexon outcome ID to its market context and venue listings |
Sports
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/sports/categories | GET | $0.0095 | List available sports categories |
/api/v1/pm/sports/markets | GET | $0.0095 | List sports markets grouped by game |
/api/v1/pm/sports/markets/:game_id | GET | $0.0095 | Get a single sports game with all venue outcomes |
/api/v1/pm/sports/outcomes/:predexon_id | GET | $0.0095 | Find all equivalent sports outcomes across venues for a Predexon ID |
Limitless
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/limitless/markets | GET | $0.0095 | List Limitless markets with filtering and sorting |
/api/v1/pm/limitless/orderbooks | GET | $0.0095 | Fetch historical orderbook snapshots for a Limitless market |
Opinion
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/opinion/markets | GET | $0.0095 | List Opinion markets with filtering and sorting |
/api/v1/pm/opinion/orderbooks | GET | $0.0095 | Fetch historical orderbook snapshots for an Opinion market |
Predict.Fun
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/predictfun/markets | GET | $0.0095 | List Predict.Fun markets with filtering and sorting |
/api/v1/pm/predictfun/orderbooks | GET | $0.0095 | Fetch historical orderbook snapshots for a Predict.Fun market |
UMA Oracle
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/polymarket/uma/markets | GET | $0.0095 | List UMA oracle questions filtered by state (proposed, disputed, resolved, …) |
/api/v1/pm/polymarket/uma/market/:condition_id | GET | $0.0095 | Get current UMA oracle status and event timeline for a single market |
Wallet Identity & Clustering
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/polymarket/wallet/identity/:wallet | GET | $0.0095 | Fetch identity and profile metadata for a wallet address |
/api/v1/pm/polymarket/wallet/identities | POST | $0.0095 | Bulk identity lookup for up to 200 wallet addresses (POST body: {addresses: [..]}) |
/api/v1/pm/polymarket/wallet/:address/cluster | GET | $0.0095 | Discover wallets connected to a seed address via on-chain transfers and identity proofs |
Quick Start
Fetch Polymarket events with a single curl command:
# 1. Discover the price (no payment needed) curl https://blockrun.ai/api/v1/pm/polymarket/events # Returns: 402 with price ($0.0095) and payment instructions # 2. Make a paid request (with x402 payment header) curl https://blockrun.ai/api/v1/pm/polymarket/events \ -H "x-payment: <x402_payment_token>" # Returns: 200 with Polymarket event data
Use the BlockRun Python SDK or TypeScript SDK to handle x402 payment automatically.
Start using Predexon data
Fund your wallet with USDC on Base and start querying prediction market data immediately. No registration required.