PARTNER

Predexon

Prediction Market Data for AI Agents

Real-time prediction market data from Predexon. This catalog is generated from the live BlockRun registry, so the endpoints below match the routes you can actually call via x402.

58 endpoints live on Base

Website

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

GET requests: $0.001. POST queries: $0.005. 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.001

per request

Market data and historical snapshots

POST

$0.005

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.001	Query Polymarket markets with filtering, sorting, and pagination
`/api/v1/pm/polymarket/markets/keyset`	GET	$0.001	List Polymarket markets with cursor-based keyset pagination (same filters as /polymarket/markets)
`/api/v1/pm/polymarket/events`	GET	$0.001	List Polymarket events with filtering and sorting
`/api/v1/pm/polymarket/events/keyset`	GET	$0.001	List Polymarket events with cursor-based keyset pagination
`/api/v1/pm/polymarket/crypto-updown`	GET	$0.001	List crypto up/down prediction markets
`/api/v1/pm/polymarket/market-price/:token_id`	GET	$0.001	Get current or historical price for a specific token
`/api/v1/pm/polymarket/candlesticks/:condition_id`	GET	$0.001	Get historical OHLCV candlestick data for a market
`/api/v1/pm/polymarket/candlesticks/token/:token_id`	GET	$0.001	Get historical OHLCV candlestick data for a single outcome token
`/api/v1/pm/polymarket/volume-chart/:condition_id`	GET	$0.001	Get volume chart with YES/NO breakdown for a market
`/api/v1/pm/polymarket/orderbooks`	GET	$0.001	Get historical orderbook snapshots for a token
`/api/v1/pm/polymarket/trades`	GET	$0.001	Query historical Polymarket trade data with flexible filtering
`/api/v1/pm/polymarket/activity`	GET	$0.001	Fetch trading activity (merges, splits, redeems) for a user
`/api/v1/pm/polymarket/markets/:token_id/volume`	GET	$0.001	Get historical cumulative volume data for a market
`/api/v1/pm/polymarket/markets/:condition_id/open_interest`	GET	$0.001	Get historical open interest data for a market
`/api/v1/pm/polymarket/positions`	GET	$0.001	Fetch all user positions with filtering and pagination
`/api/v1/pm/polymarket/leaderboard`	GET	$0.001	Get the global leaderboard of smart wallets
`/api/v1/pm/polymarket/leaderboard/market/:condition_id`	GET	$0.001	Get leaderboard for a specific market
`/api/v1/pm/polymarket/cohorts/stats`	GET	$0.001	Compare performance across trading style cohorts
`/api/v1/pm/polymarket/market/:condition_id/top-holders`	GET	$0.001	Get top holders for a specific market ranked by position size
`/api/v1/pm/polymarket/wallet/:wallet`	GET	$0.005	Get a complete smart wallet profile with all metrics
`/api/v1/pm/polymarket/wallet/:wallet/markets`	GET	$0.005	Get per-market performance breakdown for a wallet
`/api/v1/pm/polymarket/wallet/:wallet/similar`	GET	$0.005	Find wallets with similar market portfolios
`/api/v1/pm/polymarket/wallet/pnl/:wallet`	GET	$0.005	Get P&L summary and realized P&L time series for a wallet
`/api/v1/pm/polymarket/wallet/positions/:wallet`	GET	$0.005	Get open and historical positions for a wallet address
`/api/v1/pm/polymarket/wallet/volume-chart/:wallet`	GET	$0.005	Get volume chart broken down by BUY/SELL side for a wallet
`/api/v1/pm/polymarket/wallets/profiles`	GET	$0.005	Batch retrieve wallet profiles for multiple addresses
`/api/v1/pm/polymarket/wallets/filter`	GET	$0.005	Filter wallets by market trades with AND/OR logic
`/api/v1/pm/polymarket/market/:condition_id/smart-money`	GET	$0.005	View smart money positioning on a specific market
`/api/v1/pm/polymarket/markets/smart-activity`	GET	$0.005	Discover markets where high-performing wallets are active

Kalshi

Endpoint	Method	Price	Description
`/api/v1/pm/kalshi/markets`	GET	$0.001	Query Kalshi markets with filtering, sorting, and pagination
`/api/v1/pm/kalshi/trades`	GET	$0.001	Fetch historical Kalshi trade data
`/api/v1/pm/kalshi/orderbooks`	GET	$0.001	Fetch historical orderbook snapshots for a Kalshi market

dFlow

Endpoint	Method	Price	Description
`/api/v1/pm/dflow/trades`	GET	$0.001	Fetch trade history for a wallet on dFlow
`/api/v1/pm/dflow/wallet/positions/:wallet`	GET	$0.005	Fetch current positions for a dFlow wallet
`/api/v1/pm/dflow/wallet/pnl/:wallet`	GET	$0.005	Fetch realized profit and loss history for a dFlow wallet

Binance

Endpoint	Method	Price	Description
`/api/v1/pm/binance/candles/:symbol`	GET	$0.005	Get OHLCV candlestick data for a Binance trading pair
`/api/v1/pm/binance/ticks/:symbol`	GET	$0.005	Get raw book ticker data at microsecond granularity

Cross-Venue Canonical Markets & Search

Endpoint	Method	Price	Description
`/api/v1/pm/matching-markets`	GET	$0.005	Find equivalent markets across Polymarket and Kalshi
`/api/v1/pm/matching-markets/pairs`	GET	$0.005	Get all active exact-matched market pairs
`/api/v1/pm/markets/search`	GET	$0.005	Search markets across Polymarket, Kalshi, Limitless, Opinion, and Predict.Fun in a single call
`/api/v1/pm/markets`	GET	$0.001	List canonical market/question containers with cross-venue Predexon IDs
`/api/v1/pm/markets/listings`	GET	$0.001	List venue-native executable listings flattened across canonical markets
`/api/v1/pm/outcomes/:predexon_id`	GET	$0.001	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.001	List available sports categories
`/api/v1/pm/sports/markets`	GET	$0.001	List sports markets grouped by game
`/api/v1/pm/sports/markets/:game_id`	GET	$0.001	Get a single sports game with all venue outcomes
`/api/v1/pm/sports/outcomes/:predexon_id`	GET	$0.001	Find all equivalent sports outcomes across venues for a Predexon ID

Limitless

Endpoint	Method	Price	Description
`/api/v1/pm/limitless/markets`	GET	$0.001	List Limitless markets with filtering and sorting
`/api/v1/pm/limitless/orderbooks`	GET	$0.001	Fetch historical orderbook snapshots for a Limitless market

Opinion

Endpoint	Method	Price	Description
`/api/v1/pm/opinion/markets`	GET	$0.001	List Opinion markets with filtering and sorting
`/api/v1/pm/opinion/orderbooks`	GET	$0.001	Fetch historical orderbook snapshots for an Opinion market

Predict.Fun

Endpoint	Method	Price	Description
`/api/v1/pm/predictfun/markets`	GET	$0.001	List Predict.Fun markets with filtering and sorting
`/api/v1/pm/predictfun/orderbooks`	GET	$0.001	Fetch historical orderbook snapshots for a Predict.Fun market

UMA Oracle

Endpoint	Method	Price	Description
`/api/v1/pm/polymarket/uma/markets`	GET	$0.001	List UMA oracle questions filtered by state (proposed, disputed, resolved, …)
`/api/v1/pm/polymarket/uma/market/:condition_id`	GET	$0.001	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.005	Fetch identity and profile metadata for a wallet address
`/api/v1/pm/polymarket/wallet/identities`	POST	$0.005	Bulk identity lookup for up to 200 wallet addresses (POST body: {addresses: [..]})
`/api/v1/pm/polymarket/wallet/:address/cluster`	GET	$0.005	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.001) 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.

View Docs View All Data Sources