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 today, priced per request.
46 endpoints live on Base
Capabilities
46 Endpoints
Prediction markets, wallet analytics, smart money, and cross-market matching through one x402 gateway.
9 Categories
Polymarket, Kalshi, Binance, UMA oracle, wallet identity and more, all mapped directly from the live registry.
Pay Per Request
Flat $0.0085 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.0085
per request
Market data and historical snapshots
POST
$0.0085
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.0085 | Query Polymarket markets with filtering, sorting, and pagination |
/api/v1/pm/polymarket/markets/keyset | GET | $0.0085 | List Polymarket markets with cursor-based keyset pagination (same filters as /polymarket/markets) |
/api/v1/pm/polymarket/events | GET | $0.0085 | List Polymarket events with filtering and sorting |
/api/v1/pm/polymarket/events/keyset | GET | $0.0085 | List Polymarket events with cursor-based keyset pagination |
/api/v1/pm/polymarket/crypto-updown | GET | $0.0085 | List crypto up/down prediction markets |
/api/v1/pm/polymarket/market-price/:token_id | GET | $0.0085 | Get current or historical price for a specific token |
/api/v1/pm/polymarket/candlesticks/:condition_id | GET | $0.0085 | Get historical OHLCV candlestick data for a market |
/api/v1/pm/polymarket/candlesticks/token/:token_id | GET | $0.0085 | Get historical OHLCV candlestick data for a single outcome token |
/api/v1/pm/polymarket/volume-chart/:condition_id | GET | $0.0085 | Get volume chart with YES/NO breakdown for a market |
/api/v1/pm/polymarket/orderbooks | GET | $0.0085 | Get historical orderbook snapshots for a token |
/api/v1/pm/polymarket/trades | GET | $0.0085 | Query historical Polymarket trade data with flexible filtering |
/api/v1/pm/polymarket/activity | GET | $0.0085 | Fetch trading activity (merges, splits, redeems) for a user |
/api/v1/pm/polymarket/markets/:token_id/volume | GET | $0.0085 | Get historical cumulative volume data for a market |
/api/v1/pm/polymarket/markets/:condition_id/open_interest | GET | $0.0085 | Get historical open interest data for a market |
/api/v1/pm/polymarket/positions | GET | $0.0085 | Fetch all user positions with filtering and pagination |
/api/v1/pm/polymarket/leaderboard | GET | $0.0085 | Get the global leaderboard of smart wallets |
/api/v1/pm/polymarket/leaderboard/market/:condition_id | GET | $0.0085 | Get leaderboard for a specific market |
/api/v1/pm/polymarket/cohorts/stats | GET | $0.0085 | Compare performance across trading style cohorts |
/api/v1/pm/polymarket/market/:condition_id/top-holders | GET | $0.0085 | Get top holders for a specific market ranked by position size |
/api/v1/pm/polymarket/wallet/:wallet | GET | $0.0085 | Get a complete smart wallet profile with all metrics |
/api/v1/pm/polymarket/wallet/:wallet/markets | GET | $0.0085 | Get per-market performance breakdown for a wallet |
/api/v1/pm/polymarket/wallet/:wallet/similar | GET | $0.0085 | Find wallets with similar market portfolios |
/api/v1/pm/polymarket/wallet/pnl/:wallet | GET | $0.0085 | Get P&L summary and realized P&L time series for a wallet |
/api/v1/pm/polymarket/wallet/positions/:wallet | GET | $0.0085 | Get open and historical positions for a wallet address |
/api/v1/pm/polymarket/wallet/volume-chart/:wallet | GET | $0.0085 | Get volume chart broken down by BUY/SELL side for a wallet |
/api/v1/pm/polymarket/wallets/profiles | GET | $0.0085 | Batch retrieve wallet profiles for multiple addresses |
/api/v1/pm/polymarket/wallets/filter | GET | $0.0085 | Filter wallets by market trades with AND/OR logic |
/api/v1/pm/polymarket/market/:condition_id/smart-money | GET | $0.0085 | View smart money positioning on a specific market |
/api/v1/pm/polymarket/markets/smart-activity | GET | $0.0085 | Discover markets where high-performing wallets are active |
Kalshi
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/kalshi/markets | GET | $0.0085 | Query Kalshi markets with filtering, sorting, and pagination |
/api/v1/pm/kalshi/trades | GET | $0.0085 | Fetch historical Kalshi trade data |
/api/v1/pm/kalshi/orderbooks | GET | $0.0085 | Fetch historical orderbook snapshots for a Kalshi market |
Binance
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/binance/candles/:symbol | GET | $0.0085 | Get OHLCV candlestick data for a Binance trading pair |
/api/v1/pm/binance/ticks/:symbol | GET | $0.0085 | Get raw book ticker data at microsecond granularity |
Cross-Venue Search
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/markets/search | GET | $0.0085 | Search markets across Polymarket, Kalshi, Limitless, Opinion, and Predict.Fun in a single call |
Limitless
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/limitless/markets | GET | $0.0085 | List Limitless markets with filtering and sorting |
/api/v1/pm/limitless/orderbooks | GET | $0.0085 | Fetch historical orderbook snapshots for a Limitless market |
Opinion
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/opinion/markets | GET | $0.0085 | List Opinion markets with filtering and sorting |
/api/v1/pm/opinion/orderbooks | GET | $0.0085 | Fetch historical orderbook snapshots for an Opinion market |
Predict.Fun
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/predictfun/markets | GET | $0.0085 | List Predict.Fun markets with filtering and sorting |
/api/v1/pm/predictfun/orderbooks | GET | $0.0085 | Fetch historical orderbook snapshots for a Predict.Fun market |
UMA Oracle
| Endpoint | Method | Price | Description |
|---|---|---|---|
/api/v1/pm/polymarket/uma/markets | GET | $0.0085 | List UMA oracle questions filtered by state (proposed, disputed, resolved, …) |
/api/v1/pm/polymarket/uma/market/:condition_id | GET | $0.0085 | 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.0085 | Fetch identity and profile metadata for a wallet address |
/api/v1/pm/polymarket/wallet/identities | POST | $0.0085 | Bulk identity lookup for up to 200 wallet addresses (POST body: {addresses: [..]}) |
/api/v1/pm/polymarket/wallet/:address/cluster | GET | $0.0085 | 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.0085) 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.
Predexon API questions: Polymarket, Kalshi, wallets, pricing
- What is the Predexon prediction market API?
- Live prediction-market data across Polymarket, Kalshi and the smaller venues through one endpoint: markets, events, trades, orderbooks, history, cross-venue matching, wallet analytics and oracle state, priced per request.
- Which prediction market venues does Predexon cover?
- Polymarket and Kalshi in depth, plus Limitless, Opinion and Predict.Fun, with a cross-venue search that lines up the same event across all of them.
- How is the Predexon API priced through BlockRun?
- A flat per-call price, the same on every endpoint, passed through to Predexon with no BlockRun margin — quoted in the 402 before the request runs. No Predexon key, no venue accounts.
- Can I get live Polymarket odds and orderbooks?
- Yes. Prices, orderbook snapshots and recent trades are read from the venue at request time, not served from a daily snapshot.
- Is the Predexon API for trading or for data?
- Data only. It reads odds, markets, trades and resolutions and does not place positions; an agent that trades reads here and orders at the venue.
- Predexon via BlockRun vs the Polymarket API, Kalshi API or Dune?
- Each venue's own API covers that venue alone; Dune dashboards are hours old and not callable. Predexon reads every venue through one shape, matches events across them, and is priced per call for an agent to hit at request time.
- Does Predexon track Polymarket whale and smart-money wallets?
- Yes. Wallet analytics on the same prefix cover leaderboards, per-wallet positions and P&L, smart-money positioning, and identity and cluster lookups for an address.
- Can an AI trading agent call the Predexon API without an account?
- Yes. Each request pays for itself, so an agent reads odds across every venue from its own balance with no venue or Predexon account.