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

​
Authentication

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

​
Query parameters

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

​
Example request

cURL

​
Response

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

​
DiscoverItem fields

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

​
number
Items returned in this response.
​
number
Total items matching the query.
​
number
Offset applied to this page.
​
number
Limit applied to this page.

​
Sample response

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}.