All docs
API Reference

REST API

Access real-time market data, events, and predictions through our public REST API. No authentication required for read-only endpoints.

Base URL

https://api.predexmarkets.com

Rate Limits

200 requests per 15 minutes per IP address. Responses include rate limit headers. No authentication required for public endpoints.

Events

GET/api/events

List all active events with filters for category and sort order.

GET/api/events/:id

Get details for a specific event including resolution rules and pool sizes.

Example response:
{
  "events": [
    {
      "id": "abc123",
      "title": "Will BTC reach $150,000 by Dec 2026?",
      "category": "crypto",
      "emoji": "💰",
      "description": "...",
      "resolutionRules": "Resolves YES if BTC closes above $150K on Dec 31, 2026 per Chainlink Oracle.",
      "endDate": "2026-12-31T23:59:00.000Z",
      "yesPool": 2450,
      "noPool": 1200,
      "yesCount": 42,
      "noCount": 18,
      "status": "active"
    }
  ]
}

Crypto Markets

GET/api/market/price/:asset

Get real-time price for a cryptocurrency (e.g., BTC, ETH, BNB).

GET/api/market/round/:asset

Get current 3-minute round info including pool sizes and time remaining.

AI Predictions

GET/api/ai/predict/:eventId

Get AI-generated probability estimate for a specific event.

Example response:
{
  "yesPercent": 65,
  "noPercent": 35,
  "reasoning": "Based on current momentum and historical precedent..."
}

News & Suggestions

GET/api/news

Latest breaking news across 6 categories from trusted sources.

GET/api/suggestions

AI-generated market suggestions based on trending news.

Response Format

All responses are JSON. Successful responses return 200 with data. Errors return appropriate HTTP status codes with an error message.

// Error response
{
  "error": "Event not found"
}

Enterprise API access?

For higher rate limits, historical data, or webhook integrations:

Contact Us