Retrieve a paginated list of markets with filtering, sorting, and optional nested tags/events/metrics
Filter by condition ID(s) - comma-separated (max 50)
Filter by question ID(s) - comma-separated (max 50)
Filter by market ID(s) - comma-separated (max 50)
Filter by market slug(s) - comma-separated (max 50)
Filter by event slug(s) - comma-separated (max 50)
Filter by position ID(s) - comma-separated (max 50)
Search in title (3-100 characters)
Filter by status: open, closed, or all (default: all)
open, closed, all Sort: volume, txns, unique_traders, liquidity, holders, end_time, start_time, created_time, relevance
volume, txns, unique_traders, liquidity, holders, end_time, start_time, created_time, relevance Sort direction: asc, desc (default: desc)
asc, desc Metrics timeframe: 1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d (default: 24h)
1m, 5m, 30m, 1h, 6h, 24h, 7d, 30d Minimum total volume USD
Maximum total volume USD
Minimum liquidity USD
Maximum liquidity USD
Minimum transactions in selected timeframe
Maximum transactions in selected timeframe
Minimum unique traders in selected timeframe
Maximum unique traders in selected timeframe
Minimum total holders
Maximum total holders
Comma-separated category filters (max 50)
Comma-separated categories to exclude
Filter by tag(s) - comma-separated (max 50)
Comma-separated tags to exclude
Filter markets with end_time >= start_time (Unix timestamp)
Filter markets with end_time <= end_time (Unix timestamp)
Include tags array (default: true)
Include event object (default: true)
Include all timeframe metrics (default: true)
Results limit (default: 10, max: 100)
Cursor-based pagination key
Return truncated response optimized for AI consumers (default: false)
List of markets with metadata, outcomes, tags, event, and metrics. Response includes pagination: { has_more, pagination_key } for cursor-based pagination.
Outcome for market API responses