Prediction Markets API

Access real-time prediction market data via x402 micropayments. Powered by Predexon.

Unified access to Polymarket, Kalshi, Binance, Limitless, Opinion and Predict.Fun, plus UMA Oracle resolution data and on-chain wallet identity & clustering — all through a single API.

Networks

Pricing

Both tiers are a flat $0.0075 base plus the $0.001 per-transaction fee, so every call costs $0.0085 regardless of tier. The 402 body reports the charged price (price.amount: "0.0085") together with endpoint, method, description, category and tier; the signable x402 v2 requirements are in the X-Payment-Required / PAYMENT-REQUIRED headers (base64 JSON, also mirrored in WWW-Authenticate).

Endpoints

Polymarket — Market Data (Tier 1: $0.0085)

Polymarket — Analytics (Tier 1: $0.0085)

Polymarket — Wallet Analytics (Tier 2: $0.0085)

Polymarket — Smart Money (Tier 2: $0.0085)

UMA Oracle — Polymarket Resolution (Tier 1: $0.0085)

Wallet Identity & Clustering (Tier 2: $0.0085)

Cross-context wallet labels and on-chain relationship graph data.

Kalshi (Tier 1: $0.0085)

Binance (Tier 2: $0.0085)

Cross-Platform Search (Tier 2: $0.0085)

Retired. Predexon discontinued market matching on 2026-07-20, and the whole canonical layer went with it: matching-markets, matching-markets/pairs, markets, markets/listings and outcomes/{predexon_id} were removed from the gateway (upstream answers 410; the gateway now returns 404 Not Found for them). The dflow/* endpoints (dflow/trades, dflow/wallet/positions/{wallet}, dflow/wallet/pnl/{wallet}) were removed on 2026-08-04 for the same reason — they no longer exist upstream. markets/search above is the surviving cross-venue endpoint.

Sports Markets — temporarily unavailable

/api/v1/pm/sports/* (sports/categories, sports/markets, sports/markets/{game_id}, sports/outcomes/{predexon_id}, all Tier 1) is returning an upstream 500 as of 2026-08-04 and is withheld from discovery until Predexon restores it. The routes still resolve (they answer 402 unpaid), so existing integrations keep working the moment upstream recovers; new ones should not build on it yet. While upstream is down a paid call returns 502 and is not charged.

Other Platforms (Tier 1: $0.0085)

Example: Polymarket Markets

GET https://blockrun.ai/api/v1/pm/polymarket/markets

Query Parameters

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

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

Query Parameters

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: Cross-Venue Search

GET https://blockrun.ai/api/v1/pm/markets/search

curl "https://blockrun.ai/api/v1/pm/markets/search?q=bitcoin%202026"
curl "https://blockrun.ai/api/v1/pm/markets/search?q=election&venue=kalshi"

Searches Polymarket, Kalshi, Limitless, Opinion and Predict.Fun in one call. q is required — omitting it returns 422.

SDK Usage

Works on all clients: LLMClient (Base), AsyncLLMClient, and SolanaLLMClient.

Errors

Payment is verified before the request is forwarded and settled only after Predexon answers, so a rejected or failed request is never charged. Upstream calls time out after 30 seconds.

Successful responses carry X-Payment-Response (x402 v2 settlement receipt) and X-Payment-Receipt (the settlement transaction hash).

Payment verification codes

A verification 402 spreads a machine-readable code:

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?