The Unified REST API for Polymarket Prediction Markets
PredictUnify abstracts away the complexities of the Polygon blockchain and CTF (Conditional Token Framework), enabling developers to build trading bots, dashboards, and analytics tools using standard HTTP requests.
We handle the Gnosis Safe proxies, EIP-712 signing, and CLOB interactions so you can focus on your trading strategy.
- GET /markets - List and filter active markets
- GET /markets/{id} - Get detailed market metadata
- GET /markets/{id}/orderbook - Get live bids and asks
- GET /markets/{id}/history - Get OHLCV price candles
- GET /orders - List your open and historical orders
- POST /orders - Place a new limit or market order
- GET /orders/{id} - Get order details
- DELETE /orders/{id} - Cancel an open order
- GET /portfolio/positions - Get current positions and P&L
- GET /portfolio/balance - Get available USDC balance
- GET /health - API health check
- 📈 Real-Time Market Data: Live odds, volume, and liquidity for thousands of markets.
- 🤖 Algorithmic Trading: Programmatic execution of limit and market orders.
- 📊 Historical Data: OHLCV candlestick charts (1m to 1d intervals) for backtesting.
- 💼 Portfolio Management: Real-time tracking of positions, P&L, and cash balance.
- 🔒 Non-Custodial: Your keys, your funds. We pass credentials through securely and never store them.
Find the top 5 most active markets by volume.
curl --request GET \
--url 'https://predictunify.p.rapidapi.com/markets?status=active&sortBy=volume&limit=5' \
--header 'X-RapidAPI-Key: <YOUR_RAPIDAPI_KEY>'Response:
{
"data": [
{
"id": "0x...",
"question": "Who will win the 2024 US Presidential Election?",
"volume": 450000000,
"outcomes": ["Trump", "Biden", "Other"]
}
]
}Get 1-hour OHLCV candles for backtesting.
curl --request GET \
--url 'https://predictunify.p.rapidapi.com/markets/{market_id}/history?interval=1h&limit=100' \
--header 'X-RapidAPI-Key: <YOUR_RAPIDAPI_KEY>'Execute a limit order to buy "Yes" shares.
curl --request POST \
--url 'https://predictunify.p.rapidapi.com/orders' \
--header 'X-RapidAPI-Key: <YOUR_RAPIDAPI_KEY>' \
--header 'X-Poly-Api-Key: <YOUR_POLY_KEY>' \
--header 'X-Poly-Api-Secret: <YOUR_POLY_SECRET>' \
--header 'X-Poly-Passphrase: <YOUR_POLY_PASSPHRASE>' \
--header 'Content-Type: application/json' \
--data '{
"marketId": "0x...",
"outcomeId": "0x...",
"side": "buy",
"type": "limit",
"price": 0.55,
"size": 20
}'| Tier | Monthly Price | Request Limit | Trading Enabled? | Best For |
|---|---|---|---|---|
| Basic | Free | 200 / month | ❌ No | Testing connectivity |
| Pro | $9.00 | 50,000 / month | ✅ Yes | Algo Traders & Bots |
| Ultra | $49.00 | 1,000,000 / month | ✅ Yes | High-Frequency Trading |
- Pass-Through Architecture: Your Polymarket credentials (
X-Poly-Api-Key, etc.) are never stored on our servers (DB or Logs). They are used transiently to sign requests to the exchange. - Geo-Blocking: This API enforces Polymarket's restricted jurisdiction rules. Trading is not available from the USA.
Built for traders, by traders.