PredictUnify API Documentation

The Unified REST API for Polymarket Prediction Markets

---

⚡️ Overview

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.

➡️ Click here to view the full Interactive Documentation

---

📚 API Quick Reference

Markets

• 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

Orders (Pro Tier)

• 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

Portfolio (Pro Tier)

• GET /portfolio/positions - Get current positions and P&L
• GET /portfolio/balance - Get available USDC balance

System

• GET /health - API health check

🚀 Key Features

• 📈 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.

🛠️ Usage Examples

1. Search for Active Markets

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"]
    }
  ]
}

2. Get Price History (Candlesticks)

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>'

3. Place a Trade (Pro Only)

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
	}'

💰 Pricing Tiers

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

Subscribe on RapidAPI

🛡 Security & Privacy

• 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.