Skip to main content
Get your free API key at dashboard.predexon.com to unlock higher rate limits and try all the examples below.

​
Overview

The Predexon API provides RESTful endpoints for accessing prediction market data. This guide will walk you through making your first API calls.
1

Base URL

All API requests should be made to:
https://api.predexon.com
2

Make Your First Request

Let’s fetch the top markets by trading volume:
curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.predexon.com/v1/polymarket/markets?status=open&sort=volume&limit=5"
3

Explore the Response

The API returns structured JSON with market data:
{
  "markets": [
    {
      "condition_id": "0x1234...",
      "market_slug": "will-donald-trump-win-the-2024-us-presidential-election",
      "title": "Will Trump win the 2024 election?",
      "status": "open",
      "outcomes": [
        {"label": "Yes", "token_id": "123...", "price": 0.62},
        {"label": "No", "token_id": "456...", "price": 0.38}
      ],
      "total_volume_usd": 1500000000,
      "liquidity_usd": 25000000
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 1234,
    "has_more": true
  }
}

​
Common Use Cases

​
Get Market Price History

Fetch candlestick data for charting: 
response = requests.get(
    f"{BASE_URL}/v1/polymarket/candlesticks/{condition_id}",
    headers={"x-api-key": API_KEY},
    params={
        "interval": 60,  # 1-hour candles
        "start_time": 1704067200,
        "end_time": 1704153600
    }
)

​
Track a Wallet’s Positions

Get all open positions for a wallet address: 
response = requests.get(
    f"{BASE_URL}/v1/polymarket/wallet/positions/{wallet_address}",
    headers={"x-api-key": API_KEY},
    params={"sort_by": "value", "limit": 50}
)

​
Find Cross-Platform Matches

Discover equivalent markets on Kalshi: 
response = requests.get(
    f"{BASE_URL}/v1/matching-markets",
    headers={"x-api-key": API_KEY},
    params={"polymarket_market_slug": "will-donald-trump-win-the-2024-us-presidential-election"}
)

​
Rate Limits

TierRateQuota
Free1 req/sec100k/month
Pro20 req/sec (40 burst)Unlimited

​
Error Handling

The API uses standard HTTP status codes:
CodeDescription
200Success
400Bad request - check your parameters
403Forbidden - invalid or missing API key
404Resource not found
429Rate limit exceeded
500Internal server error
Error responses include helpful messages: 
{
  "error": "Invalid filter combination",
  "message": "Only one of market_slug, token_id, or condition_id can be provided"
}

​
Next Steps

API Reference

Explore all available endpoints

Markets Concepts

Learn about market structure and data