​
Overview

The Predictions vertical gives you access to Polymarket’s binary and multi-outcome event markets. Trade on the outcomes of elections, sports, crypto events, and more.
Polymarket is currently the only predictions provider. More providers may be added in the future.

​
Step 1: Browse Events

Events are the top-level containers. Each event has one or more markets (outcomes). 
curl -s -H "X-API-Key: $API_KEY" \
  "https://api.perps.studio/v1/predictions/polymarket/events?status=active&limit=10" | jq
Example response: 
[
  {
    "eventId": "12345",
    "title": "Will BTC exceed $100k by end of 2026?",
    "category": "Crypto",
    "status": "active",
    "endDate": "2026-12-31T23:59:59Z",
    "markets": [
      {
        "marketId": "0xabc123",
        "question": "BTC > $100k by Dec 31, 2026",
        "outcomes": ["Yes", "No"],
        "tokens": [
          { "tokenId": "71234", "outcome": "Yes", "price": "0.72" },
          { "tokenId": "71235", "outcome": "No", "price": "0.28" }
        ]
      }
    ]
  }
]

​
Step 2: View Market Details

Get detailed information about a specific market: 
curl -s -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/predictions/polymarket/markets/0xabc123 | jq

​
Step 3: Check the Orderbook

Each outcome token has its own orderbook: 
# Get the orderbook for the "Yes" token
curl -s -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/predictions/polymarket/orderbook/71234 | jq
Prices are between 0 and 1, representing the implied probability of the outcome.

​
Step 4: Place a Prediction

To buy “Yes” shares (betting the outcome will happen): 
curl -X POST -H "X-API-Key: $API_KEY" \
  -H "Content-Type: application/json" \
  https://api.perps.studio/v1/predictions/polymarket/orders \
  -d '{
    "tokenId": "71234",
    "side": "buy",
    "type": "limit",
    "size": "100",
    "price": "0.70",
    "apiKey": "your-poly-api-key",
    "apiSecret": "your-poly-secret",
    "passphrase": "your-passphrase"
  }'
A price of 0.70 means you are buying shares at 0.70each.Iftheoutcomeresolves"Yes",eachsharepays0.70 each. If the outcome resolves "Yes", each share pays 1.00 — a profit of 0.30pershare.If"No",thesharesareworth0.30 per share. If "No", the shares are worth 0.00.

​
Step 5: Track Your Positions

curl -s -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/predictions/polymarket/positions/0xYourWallet | jq

​
Step 6: View Activity History

curl -s -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/predictions/polymarket/activity/0xYourWallet | jq

​
Browsing by Category

Get all available categories: 
curl -s -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/predictions/polymarket/categories | jq
Then filter events by category: 
curl -s -H "X-API-Key: $API_KEY" \
  "https://api.perps.studio/v1/predictions/polymarket/events?category=Crypto" | jq

​
Price History

Track how market sentiment has changed over time: 
curl -s -H "X-API-Key: $API_KEY" \
  "https://api.perps.studio/v1/predictions/polymarket/prices/history/0xabc123?interval=1h" | jq

​
Leaderboard

See the top traders: 
curl -s -H "X-API-Key: $API_KEY" \
  https://api.perps.studio/v1/predictions/polymarket/leaderboard | jq
Polymarket does not support testnet. All prediction market trades are on mainnet with real funds.