Skip to main content
The discover endpoint is your primary entry point for browsing prediction markets on Predexy. It returns a paginated list of canonical questions — each one representing a single real-world question aggregated across all platforms that list it. Every item in the response includes a volume-weighted index price, a divergence category indicating how much platforms disagree, and the best buy price available right now.

​
Endpoint

GET https://api.predexy.com/api/v1/discover

​
Authentication

A session JWT is required. Pass it as a bearer token or let the browser send the pdx_access cookie automatically: 
Authorization: Bearer <your_jwt>

​
Query parameters

​
category
string
Filter by market category. Common values: crypto, politics, sports, science, entertainment. Omit to return all categories.
​
limit
number
default:"50"
Maximum items to return. Range 1–200.
​
offset
number
default:"0"
Number of items to skip. Use for pagination.

​
Example request

cURL
curl https://api.predexy.com/api/v1/discover \
  -H "Authorization: Bearer <your_jwt>" \
  -G \
  --data-urlencode "category=crypto" \
  --data-urlencode "limit=5"

​
Response

The response wraps an array of DiscoverItem objects in data and includes pagination state in meta.

​
DiscoverItem fields

​
id
string
required
Canonical question UUID. Use this to fetch full details from GET /api/v1/questions/{id}.
​
title
string
required
Human-readable canonical question text, e.g. "Will BTC reach $100k by 2026?".
​
slug
string
required
URL-safe identifier for the question.
​
category
string
required
Market category label.
​
end_time
string
ISO 8601 timestamp when the market resolves. null for perpetual markets.
​
market_count
number
required
Number of platforms currently listing this question. A value of 3 means three separate platform markets are linked to this canonical question.
​
platform_slugs
string[]
required
Slugs of every platform listing this question, e.g. ["polymarket", "limitless", "predictfun"].
​
index_price
number
Volume-weighted consensus probability, expressed as a decimal from 0 to 1. null if no pricing data is available.
​
divergence
number
Weighted standard deviation of Yes prices across platforms. Higher values mean platforms disagree more. null if fewer than two platforms have pricing data.
​
divergence_category
string
Categorized divergence level: low (under 2%), medium (2–5%), or high (over 5%). null if divergence cannot be computed.
​
best_buy_price
number
The cheapest Yes price available across all linked platforms. null if no pricing data exists.
​
best_buy_platform
string
Slug of the platform offering the cheapest price, e.g. "limitless". null if unavailable.
​
spread_bps
number
Spread between the cheapest and most expensive Yes price, expressed in basis points (1 bps = 0.01%). A value of 400 means a 4% spread. null if fewer than two prices are available.

​
meta fields

​
meta.count
number
Items returned in this response.
​
meta.total
number
Total items matching the query.
​
meta.offset
number
Offset applied to this page.
​
meta.limit
number
Limit applied to this page.

​
Sample response

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "title": "Will BTC reach $100k by 2026?",
      "slug": "will-btc-reach-100k-by-2026",
      "category": "crypto",
      "end_time": "2026-01-01T00:00:00Z",
      "market_count": 3,
      "platform_slugs": ["polymarket", "limitless", "predictfun"],
      "index_price": 0.62,
      "divergence": 0.034,
      "divergence_category": "medium",
      "best_buy_price": 0.58,
      "best_buy_platform": "limitless",
      "spread_bps": 400
    },
    {
      "id": "8e1e4c9d-1234-4abc-9abc-000000000001",
      "title": "Will the Fed cut rates in Q1 2026?",
      "slug": "fed-rate-cut-q1-2026",
      "category": "economics",
      "end_time": "2026-03-31T23:59:59Z",
      "market_count": 2,
      "platform_slugs": ["polymarket", "manifold"],
      "index_price": 0.41,
      "divergence": 0.015,
      "divergence_category": "low",
      "best_buy_price": 0.40,
      "best_buy_platform": "manifold",
      "spread_bps": 200
    }
  ],
  "meta": {
    "count": 2,
    "total": 847,
    "offset": 0,
    "limit": 5
  }
}
Use market_count to quickly identify questions listed on multiple platforms — these are the most likely candidates for arbitrage. Any question with market_count >= 2 and divergence_category of medium or high is worth inspecting further with GET /api/v1/questions/{id}.