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

​
Overview

The Predexon API provides RESTful endpoints for accessing prediction market data. All endpoints return JSON responses and use standard HTTP methods.

​
Base URL

https://api.predexon.com

​
API Versions

All endpoints are versioned under /v1/. Future versions will be introduced as /v2/, etc.

​
Endpoint Categories

Polymarket

Markets, prices, candlesticks, orderbooks, trades, wallet positions, and P&L.

Cross-Platform Matching

Find equivalent markets across Polymarket and Kalshi.
Kalshi endpoints coming soon. Currently, Kalshi data is available through the cross-platform matching API.

​
Common Parameters

​
Pagination

Most list endpoints support two pagination methods:

​
Offset-based Pagination

ParameterTypeDefaultDescription
limitinteger20-100Number of items to return
offsetinteger0Number of items to skip
{
  "pagination": {
    "limit": 20,
    "offset": 0,
    "total": 1234,
    "has_more": true
  }
}

​
Key-based Pagination

For large datasets or real-time data, use cursor/key-based pagination for better performance:
ParameterTypeDescription
limitintegerNumber of items to return
cursorstringPagination cursor from previous response
{
  "pagination": {
    "limit": 100,
    "next_cursor": "eyJpZCI6MTIzNDV9",
    "has_more": true
  }
}
Pass next_cursor as the cursor parameter in subsequent requests to fetch the next page.

​
Time Parameters

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

​
Sorting

Endpoints with sortable results accept:
ParameterTypeDescription
sortstringField to sort by
orderstringasc or desc

​
Response Format

​
Success Responses

All successful responses return HTTP 200 with JSON body: 
{
  "markets": [...],
  "pagination": {...}
}

​
Error Responses

Errors return appropriate HTTP status codes with a JSON body: 
{
  "error": "Invalid filter combination",
  "message": "Only one of market_slug, token_id, or condition_id can be provided"
}
Status CodeDescription
400Bad Request - Invalid parameters
403Forbidden - Invalid or missing API key
404Not Found - Resource doesn’t exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error
503Service Unavailable - Database issue

​
Health Check

Verify API availability: 
curl https://api.predexon.com/health

​
OpenAPI Specification

The complete OpenAPI 3.0 specification is available for generating client SDKs:

OpenAPI Specification

Download the OpenAPI JSON specification

​
Rate Limits

TierRateQuota
Free1 req/sec100k/month
Pro20 req/sec (40 burst)Unlimited
Implement exponential backoff when you receive 429 responses.