Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.predexon.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Base URL

https://api.predexon.com
All endpoints return JSON and authenticate via the x-api-key header. Get your free API key →

​
Endpoint Categories

Canonical Markets

Beta cross-venue canonical market containers and outcome-level predexon_ids for routing and discovery.

Polymarket

Markets, prices, candlesticks, orderbooks, trades, wallet analytics, and smart money.

Cross-Platform Matching

Find equivalent markets across Polymarket and Kalshi.

Kalshi · Dflow · Binance

Markets, trades, orderbooks, and tick data across platforms.

All Endpoints

Complete directory of all 38 Data API + 11 Trading API endpoints.

​
Guides

If you want conceptual background instead of endpoint reference, use the guide pages in the Docs tab.

Prediction Markets

Learn the market, outcome, token, and venue concepts used throughout the Data API.

Cross-Platform Matching

Understand how equivalent markets are linked across venues.

Trading Labels

Interpret normalized trading labels and venue metadata.

Which API Should I Use?

Choose between Data API, Trading API, WebSocket, and integrations.

​
Pagination

Most list endpoints support one of two methods:
ParameterTypeDefaultDescription
limitinteger20–100Number of items to return
offsetinteger0Items to skip
{
  "pagination": {
    "limit": 20, "offset": 0, "total": 1234, "has_more": true
  }
}

​
Time Parameters

Time-based endpoints accept Unix timestamps in seconds:
ParameterTypeDescription
start_timeintegerStart of time range
end_timeintegerEnd of time range
Some endpoints (like orderbooks) use milliseconds. Check individual endpoint docs.

​
Response Format

{
  "markets": [...],
  "pagination": {...}
}

​
Health Check

curl https://api.predexon.com/health
# {"status": "healthy"}

​
Rate Limits & Free Endpoints

Most endpoints are free. Core market data, trades, orderbooks, and pricing endpoints are free and unlimited on all plans.
TierRate LimitMonthly RequestsOveragePrice
Free1 req/sec1,000-$0/month
Dev20 req/sec1,000,000$5 / 100K$49/month
Pro100 req/sec5,000,000$2.50 / 100K$249/month
EnterpriseCustomUnlimited-$499+/month

​
Free Endpoints (All Plans)

Universally free: all list-market endpoints (/v2/{venue}/markets), all orderbook history endpoints (/v2/{venue}/orderbooks), and all Trading API endpoints (trade.predexon.com/api/*). Trading API calls never count toward your Data API quota.
  • /v2/polymarket/markets - List markets
  • /v2/polymarket/markets/keyset - List markets (keyset pagination)
  • /v2/polymarket/events - List events
  • /v2/polymarket/events/keyset - List events (keyset pagination)
  • /v2/polymarket/crypto-updown - Crypto up/down markets
  • /v2/polymarket/market-price/{token_id} - Market price
  • /v2/polymarket/candlesticks/{condition_id} - Candlesticks (condition-level)
  • /v2/polymarket/candlesticks/token/{token_id} - Candlesticks (per-token)
  • /v2/polymarket/volume-chart/{condition_id} - Volume chart
  • /v2/polymarket/orderbooks - Orderbook history
  • /v2/polymarket/trades - Trades history
  • /v2/polymarket/activity - Wallet activity
  • /v2/polymarket/markets/{token_id}/volume - Volume time series
  • /v2/polymarket/markets/{condition_id}/open_interest - Open interest
  • /v2/polymarket/positions - All positions
  • /v2/polymarket/wallet/pnl/{wallet} - Wallet P&L (summary + time series)
  • /v2/polymarket/wallet/{address}/cluster - Connected wallets cluster
  • /v2/polymarket/uma/markets - UMA markets list
  • /v2/polymarket/uma/market/{condition_id} - UMA market detail
  • /v2/polymarket/builders/leaderboard - Builder leaderboard
  • /v2/polymarket/builders/{builder_code} - Builder stats
  • /v2/polymarket/builders/{builder_code}/markets - Builder top markets
  • /v2/polymarket/builders/{builder_code}/timeseries - Builder timeseries
  • /v2/kalshi/markets - List markets
  • /v2/kalshi/trades - Trades history
  • /v2/kalshi/orderbooks - Orderbook history
  • /v2/limitless/markets - List markets
  • /v2/limitless/orderbooks - Orderbook history
  • /v2/opinion/markets - List markets
  • /v2/opinion/orderbooks - Orderbook history
  • /v2/predictfun/markets - List markets
  • /v2/predictfun/orderbooks - Orderbook history
  • /v2/dflow/trades - Trades history
  • /v2/markets/search - Search markets across all venues
  • /v2/markets/listings - Canonical venue listings
  • /v2/outcomes/{predexon_id} - Canonical outcome resolve
Every endpoint under trade.predexon.com/api/* is free and does not count toward your monthly Data API quota. This includes account creation, venue enablement, order placement and management, balance queries, deposits, withdrawals, redemptions, and fee policy management.

​
Gated Endpoints (Dev+)

  • Cross-Platform Matching - /v2/matching-markets/*
  • Smart Money & Analytics - Leaderboards, cohort stats, wallet profiles, smart activity
  • Binance Data - /v2/binance/*
See predexon.com/pricing for full plan comparison.

​
Global Constraints

ConstraintValue
Max search length100 characters (minimum 3)
Max array filter items50 items
Offset has no upper limit. Individual endpoint limits vary - see each endpoint for specific limit ranges.

​
OpenAPI Specification

OpenAPI Specification

Download the OpenAPI 3.0 JSON specification for generating client SDKs.