blockrun_markets

Prediction market + derivatives data via Predexon aggregator. Flat $0.0075 base per call (every endpoint) plus the gateway's network fee — $0.001 on Base today, none quoted on Solana; the 402 header carries the exact charge (we reserve $0.0095).

POLYMARKET (Tier 1):

• polymarket/events, polymarket/markets — list events/markets (filter, sort, paginate)

• polymarket/markets/keyset, polymarket/events/keyset — same data, cursor-based keyset pagination (params: { pagination_key })

• polymarket/crypto-updown — crypto up/down markets

• polymarket/market-price/:token_id — current/historical price

• polymarket/candlesticks/:condition_id — OHLCV by market

• polymarket/candlesticks/token/:token_id — OHLCV by single outcome token

• polymarket/volume-chart/:condition_id — volume w/ YES/NO split

• polymarket/orderbooks, polymarket/trades, polymarket/activity

• polymarket/markets/:token_id/volume, polymarket/markets/:condition_id/open_interest

• polymarket/positions — user positions

• polymarket/leaderboard, polymarket/leaderboard/market/:condition_id

• polymarket/cohorts/stats, polymarket/market/:condition_id/top-holders

• polymarket/uma/markets, polymarket/uma/market/:condition_id — UMA oracle questions/timeline

POLYMARKET (Tier 2 — wallet/smart-money analytics):

• polymarket/wallet/:wallet — full smart-wallet profile

• polymarket/wallet/:wallet/markets, .../similar

• polymarket/wallet/pnl/:wallet, .../positions/:wallet, .../volume-chart/:wallet

• polymarket/wallets/profiles — batch profiles, GET with params: { addresses } (POST 404s); polymarket/wallets/filter — AND/OR filter

• polymarket/market/:condition_id/smart-money, polymarket/markets/smart-activity

WALLET IDENTITY & CLUSTERING (Tier 2) — cross-context labels + on-chain relationship graph:

• polymarket/wallet/identity/:wallet — fetch identity + profile metadata for one wallet

• polymarket/wallet/identities — POST { addresses: [...] } for bulk lookup (up to 200 wallets)

• polymarket/wallet/:address/cluster — discover wallets connected via on-chain transfers + identity proofs

SPORTS — sports/* (categories, markets, markets/:game_id, outcomes/:predexon_id) DEGRADED, do not call: Predexon 500 on every call since 2026-08-04; the gateway releases the payment on that upstream 500. Use markets/search { q: "NBA" } or polymarket/events { search: "NBA" } instead — no live route takes a "league" param.

KALSHI: kalshi/markets, kalshi/trades, kalshi/orderbooks LIMITLESS / OPINION / PREDICT.FUN: {platform}/markets, {platform}/orderbooks BINANCE FUTURES: binance/candles/:symbol, binance/ticks/:symbol

CROSS-PLATFORM:

• markets/search — search every venue in one call (search term is "q"). The only canonical-layer route left: markets, markets/listings, outcomes/:id and matching-markets(/pairs) were removed upstream 2026-08-04 and 404 before payment.

REQUEST CONTRACTS:

• Discover current markets with markets/search (its search term is "q"), then resolve the chosen Polymarket market with polymarket/markets/keyset and condition_id.

• On polymarket/markets{,/keyset} the free-text filter is "search" (NOT "q"), and status:"open"/"closed" replaces Gamma's active/closed. "sort", "end_after", and "end_before" are supported; "order"/"ascending" are not.

• Candlesticks interval is integer minutes ("1440", not "1h"); it is OPTIONAL (the server defaults). Which intervals a market serves varies — 1440 may work where 60 does not. start_time/end_time are Unix seconds.

• polymarket/orderbooks requires token_id plus start_time/end_time in Unix milliseconds.

• Smart-money needs a smart-wallet CRITERION (min_trades, min_volume, min_roi, min_*_pnl, min_win_rate, min_profit_factor). "window" only scopes time and is NOT sufficient on its own. Default: { window: "30d", min_trades: "100" }.

Pass query params via 'params' (GET) — a '?' in 'path' is refused before payment, because path-carried values bypass the pre-payment checks above. Use 'body' only for POST endpoints (e.g. polymarket/wallet/identities).