Markets
Market data endpoints — browse, search, and filter
The Markets API provides access to prediction market data aggregated from Polymarket and Kalshi. All market endpoints are public and do not require authentication, except for posting comments and tracking views.
Endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/markets | Public | List markets with filters and pagination |
| GET | /api/v1/markets/movers | Public | Get top movers by price change |
| GET | /api/v1/markets/:slug | Public | Get market detail by slug |
| GET | /api/v1/markets/:id/top-traders | Public | Get top traders for a market |
| GET | /api/v1/markets/:id/activity | Public | Get exchange trade activity |
| GET | /api/v1/markets/:id/order-book | Public | Get order book (bids and asks) |
| GET | /api/v1/markets/:id/chart | Public | Get OHLC chart data |
| GET | /api/v1/markets/:id/related | Public | Get related markets |
| GET | /api/v1/markets/:id/news | Public | Get news articles linked to a market |
| GET | /api/v1/markets/:id/comments | Public | Get comments on a market |
| POST | /api/v1/markets/:id/comments | Bearer | Post a comment on a market |
| POST | /api/v1/markets/:id/comments/:commentId/like | Bearer | Like or unlike a comment |
| GET | /api/v1/markets/:id/holders | Public | Get market holders |
| POST | /api/v1/markets/:id/view | Bearer | Track a market page view for missions |
List Markets
Fetch a paginated list of markets with optional filters.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
category | string | -- | Filter by category: politics, crypto, sports, entertainment, science, economics, world |
source | string | -- | Filter by source platform: polymarket, kalshi |
sort | string | volume | Sort order: volume, newest, ending_soon, liquidity |
cursor | string | -- | Cursor for pagination |
limit | number | 50 | Number of results (1-500) |
// GET /api/v1/markets?category=politics&sort=volume&limit=10
// Response 200
{
"markets": [
{
"id": "clxyz123...",
"slug": "will-the-fed-cut-rates-june-2026",
"title": "Will the Fed cut rates in June 2026?",
"category": "economics",
"source": "polymarket",
"yesPrice": 0.63,
"noPrice": 0.37,
"volume": 1250000.00,
"liquidity": 450000.00,
"priceChange24h": 0.05,
"endDate": "2026-06-30T00:00:00.000Z",
"status": "active"
}
],
"nextCursor": "eyJpZCI6MTB9"
}Top Movers
Get markets with the largest price changes over a given period.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
period | string | 1D | Time period: 1H, 6H, 1D |
// GET /api/v1/markets/movers?period=1D
// Response 200
{
"gainers": [...],
"losers": [...]
}Chart Data
Get OHLC (open/high/low/close) candlestick data for a market. Bucket sizes vary by timeframe: 6H uses 1-minute candles, 1D uses 5-minute, 1W uses 30-minute, 1M uses 1-hour, ALL uses 1-day.
Query Parameters:
| Parameter | Type | Default | Description |
|---|---|---|---|
timeframe | string | 1D | Chart timeframe: 6H, 1D, 1W, 1M, ALL |
Notes
- Market prices are decimal values between 0 and 1, representing the probability of the YES outcome
- The
slugparameter on the detail endpoint accepts a URL-friendly market slug, not the UUID - Chart data is sourced from both real-time price snapshots (for short timeframes) and historical backfill from exchange APIs (for longer timeframes)
- All financial values (volume, liquidity) use
Decimalprecision and are returned as numbers