REST API
REST API reference
JSON over HTTPS. Every endpoint shares one base URL, one auth header and one error format, so what you learn on this page holds for all 33.
Base URL
https://prediction.com/api/v2curl 'https://prediction.com/api/v2/events?limit=5' \ -H 'X-API-Key: YOUR_API_KEY'
Start building
Free plan available
29 of 33 endpoints are available on Free. Signals need Dev or higher.
Compare plans →Conventions
All endpoints
OpenAPI specDiscoverBrowse what is listed right now
Events/v2/eventsLive events with their matched groupsAll plansMarkets/v2/marketsActive markets with current pricesAll plansSearch/v2/searchFind events by keywordAll plansMatchingThe same market on every venue
Matching Markets/v2/matching-marketsFrom a query, Polymarket slug or Kalshi tickerAll plansMatch by URL/v2/matching-markets/urlPaste a venue link, get the matchesAll plansSports Matching/v2/matching-markets/sportsGames, spreads, totals and propsAll plansPrices and booksQuotes, depth, history and fills
Prices/v2/prices/bulkCurrent prices for many markets at onceAll plansPrice History/v2/prices/historyOHLC candles at chosen intervalsAll plansOrderbook/v2/orderbookDepth for one venue's marketAll plansUnified Orderbook/v2/unified-orderbookOne book across matched venuesAll plansTrades/v2/tradesRecent fills across venuesAll plansSignalsOpportunities we compute for you
Arbitrage/v2/arbCross-venue arbitrage opportunitiesDev and upExpected Value/v2/evPositive EV prices against consensusDev and upSmart Money Alerts/v2/alerts/smart-moneyLarge informed Polymarket flowDev and upFade Finder Alerts/v2/alerts/fade-finderFlow worth betting againstDev and upVenue data Venue-native fields when you need them
Polymarket13 endpointsCandles, volume, open interest, wallets and tradersShowHide
Market Price/v2/polymarket/market-price/{token_id}Polymarket market priceAll plansCandlesticks/v2/polymarket/candlesticks/{condition_id}Polymarket candlesticksAll plansCandlesticks by Token/v2/polymarket/candlesticks/token/{token_id}Polymarket candlesticks by tokenAll plansToken Volume/v2/polymarket/markets/{token_id}/volumePolymarket token volumeAll plansVolume Chart/v2/polymarket/volume-chart/{condition_id}Polymarket volume chartAll plansOpen Interest/v2/polymarket/markets/{condition_id}/open_interestPolymarket open interestAll plansWallet Activity/v2/polymarket/activityPolymarket wallet activityAll plansWallet Positions/v2/wallet/{addr}/positionsPolymarket wallet positionsAll plansWallet Identity/v2/wallet/{addr}/identityPolymarket wallet identityAll plansTrader Leaderboard/v2/polymarket/leaderboardPolymarket trader leaderboardAll plansMarket Top Holders/v2/polymarket/market/{condition_id}/top-holdersPolymarket market top holdersAll plansSmart Activity Markets/v2/polymarket/markets/smart-activityPolymarket smart activity marketsAll plansSmart Money (per market)/v2/polymarket/market/{condition_id}/smart-moneyPolymarket smart money (per market)All plansKalshi3 endpointsMarkets, a single market and seriesShowHide
Markets/v2/kalshi/marketsKalshi marketsAll plansMarket/v2/kalshi/markets/{ticker}Kalshi marketAll plansSeries/v2/kalshi/seriesKalshi seriesAll plansAccount
Status/v2/statusVenue availability and freshnessAll plansRate Limit/v2/rate-limitYour key's usage and limitsAll plans