Skip to main content
GET
Get Opinion Markets
List Opinion markets with filtering and sorting. Returns tradeable markets only (standalone binaries + categorical outcomes). Categorical parent markets are excluded.

Event Grouping

  • event_id, event_slug, and event_title come from the parent market for categorical outcomes. These are null for standalone binaries.
  • Opinion calls these “parent markets” natively - Predexon normalizes to “event” for cross-venue consistency.

Notes

  • collection is non-null for recurring markets (e.g. hourly crypto). Contains title, symbol, and frequency.
  • price in outcomes is null when the indexer hasn’t populated prices yet.

Authorizations

x-api-key
string
header
required

Query Parameters

status
enum<string> | null

Filter by status: open or closed

Available options:
open,
closed
market_type
enum<string> | null

Filter by market type: binary or categorical

Available options:
binary,
categorical
search
string | null

Search in title (minimum 3 characters)

Required string length: 3 - 100
labels
string[] | null

Filter by label(s)

Maximum array length: 50
min_volume
number | null

Minimum total volume (USD)

Required range: x >= 0
condition_id
string[] | null

Filter by condition ID(s)

Maximum array length: 50
market_slug
string[] | null

Filter by market slug(s)

Maximum array length: 50
market_id
integer[] | null

Filter by market ID(s)

Maximum array length: 50
predexon_id
string[] | null

Filter by predexon ID(s)

Maximum array length: 50
token_id
string[] | null

Filter by token ID(s)

Maximum array length: 50
event_id
integer[] | null

Filter by event/parent market ID(s)

Maximum array length: 50
event_slug
string[] | null

Filter by event slug(s)

Maximum array length: 50
sort
enum<string>
default:volume

Sort by

Available options:
volume,
volume_24h,
volume_7d,
created,
created_asc,
expiration
limit
integer
default:20

Number of markets to return

Required range: 1 <= x <= 100
pagination_key
string | null

Cursor for next page (from previous response)

Response

Successful Response

Response for Opinion markets list endpoint.

markets
OpinionMarket · object[]
required
pagination
CursorPagination · object
required

Cursor-based pagination for endpoints that don't support offset.