| Meta |
| GET |
/test |
Test connectivity |
Example Response
true
CURL
curl -X GET "<host>/test" -H "Accept: application/json"
|
| GET |
/time |
Server time |
CURL
curl -X GET "<host>/time" -H "Accept: application/json"
|
| Users |
| GET |
/@{user} |
User profile stats |
Path Parameters
user (string) – Polymarket username
Example Response
{
"name": "Car",
"address": "0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b",
"pnl": 1503640.99,
"volume": 178611370.0,
"portfolioValue": 596365.9
}
CURL
curl -X GET "<host>/@Car" -H "Accept: application/json"
|
| GET |
/@{user}/pnl |
Total profit/loss (optional /{period}) |
Path
/pnl or /pnl/{DAY|WEEK|MONTH|ALL}
Example Response
1503640.99
Period response
{"value": 12345.67, "period": "WEEK"}
CURL
curl -X GET "<host>/@Car/pnl"
curl -X GET "<host>/@Car/pnl/WEEK"
curl -X GET "<host>/@Car/rank/MONTH"
|
| GET |
/@{user}/volume |
Trading volume (optional /{period}) |
Path
/volume or /volume/{DAY|WEEK|MONTH|ALL}
alias: /vol/{period}
Example Response
400
Period response
{"value": 400, "period": "DAY"}
CURL
curl -X GET "<host>/@Car/volume"
curl -X GET "<host>/@Car/volume/DAY"
curl -X GET "<host>/@Car/volume/WEEK"
|
| GET |
/@{user}/{field} |
Single field from profile |
Example
curl -X GET "<host>/@Car/name"
Example Response
"Car"
|
| GET |
/@{user}/stats |
Multi-period pnl, rank, volume + portfolio value |
Example Response
{
"name": "Car",
"address": "0x7c3d…",
"portfolioValue": 596365.9,
"periods": {
"DAY": {"pnl": -175.38, "rank": "1577924", "volume": 400},
"WEEK": {"pnl": 1848.83, "rank": "…"},
"MONTH": {"pnl": "…", "rank": "846"},
"ALL": {"pnl": 1503640.99, "rank": "…", "volume": 178611370}
}
}
CURL
curl -X GET "<host>/@Car/stats"
|
| GET |
/@{user}/trades |
Recent trades (optional /{BUY|SELL}) |
Path
/trades or /trades/BUY or /trades/SELL
Query
limit (int, optional)
CURL
curl -X GET "<host>/@Car/trades?limit=20"
curl -X GET "<host>/@Car/trades/BUY?limit=10"
|
| GET |
/@{user}/trades.rss |
Recent trades as RSS (also .xml) |
CURL
curl -X GET "<host>/@Car/trades.rss"
|
| GET |
/@{user}/positions |
Open positions |
CURL
curl -X GET "<host>/@Car/positions?limit=50"
|
| GET |
/@{user}/closed |
Closed positions |
CURL
curl -X GET "<host>/@Car/closed?limit=50"
|
| GET |
/@{user}/gains |
Open positions by cash PnL (best first; also /drawdowns) |
Query
limit (default 50)
Example Response
[
{
"title": "Will JD Vance win…",
"outcome": "No",
"cashPnl": 135566.18,
"currentValue": 368898.68,
"curPrice": 0.7905
}
]
CURL
curl -X GET "<host>/@Car/gains?limit=10"
curl -X GET "<host>/@Car/drawdowns?limit=10"
|
| GET |
/@{user}/winners |
Closed positions by realized PnL (best first; also /losers) |
Query
limit (default 50, max 50)
Example Response
[
{
"title": "US x Iran permanent peace deal",
"slug": "…",
"outcome": "Yes",
"realizedPnl": 79459.02,
"avgPrice": 0.42
}
]
CURL
curl -X GET "<host>/@Car/winners?limit=10"
curl -X GET "<host>/@Car/losers?limit=10"
|
| GET |
/@{user}/activity |
User activity (optional /{TYPE} e.g. TRADE) |
Path
/activity or /activity/TRADE (also MAKER_REBATE, YIELD, …)
CURL
curl -X GET "<host>/@Car/activity?limit=50"
curl -X GET "<host>/@Car/activity/TRADE?limit=20"
|
| GET |
/@{user}/value |
Portfolio value |
CURL
curl -X GET "<host>/@Car/value"
|
| GET |
/@{user}/rank |
Leaderboard rank |
CURL
curl -X GET "<host>/@Car/rank"
|
| GET |
/@{user}/traded |
Markets traded count |
CURL
curl -X GET "<host>/@Car/traded"
|
| GET |
/@{user}/redeemable |
Redeemable/resolvable positions |
Query
limit (default 50)
Example Response
[
{
"title": "Will Bayer Leverkusen win on 2026-08-01?",
"slug": "…",
"outcome": "No",
"size": 100,
"curPrice": 0,
"redeemable": true
}
]
CURL
curl -X GET "<host>/@Car/redeemable?limit=10"
|
| GET |
/@{user}/top-positions |
Open positions sorted by current value |
Query
limit (default 50)
Example Response
[
{
"title": "Will JD Vance win…",
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"outcome": "No",
"currentValue": 368898.68,
"cashPnl": 135566.18,
"curPrice": 0.7905
}
]
CURL
curl -X GET "<host>/@Car/top-positions?limit=10"
|
| GET |
/@{user}/exposure |
Open positions rolled up by event (exposure board) |
Query
limit (default 50) — max events returned
Example Response
[
{
"eventSlug": "presidential-election-winner-2028",
"positionCount": 12,
"marketCount": 6,
"currentValue": 890123.45,
"initialValue": 750000.0,
"cashPnl": 140123.45
}
]
CURL
curl -X GET "<host>/@Car/exposure?limit=20"
|
| GET |
/@{user}/markets |
Open positions rolled up by market slug |
Query
limit (default 50) — max markets returned
Example Response
[
{
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"title": "Will JD Vance win the 2028 US Presidential Election?",
"eventSlug": "presidential-election-winner-2028",
"positionCount": 1,
"outcomeCount": 1,
"size": 466665,
"currentValue": 97766.32,
"initialValue": 233332.5,
"cashPnl": -135566.18
}
]
CURL
curl -X GET "<host>/@Car/markets?limit=20"
|
| GET |
/@{user}/flow |
BUY vs SELL pressure from the user's recent trades |
Path
/@{user}/flow
/@{user}/flow/{BUY|SELL}
Query
limit (default 50) — trades sampled for flow stats
Example Response
{
"buyCount": 32,
"sellCount": 18,
"tradeCount": 50,
"buyNotional": 12450.5,
"sellNotional": 8320.1,
"notional": 20770.6,
"netNotional": 4130.4,
"imbalance": 0.199,
"sample": 50
}
CURL
curl -X GET "<host>/@Car/flow?limit=50"
curl -X GET "<host>/@Car/flow/BUY?limit=30"
|
| GET |
/@{user}/summary |
Compact trader snapshot (pnl/rank/value/positions) |
Query
limit (default 100) — max open positions sampled for counts
Example Response
{
"name": "Car",
"address": "0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b",
"pnl": 1502723.61,
"volume": 178617113.45,
"portfolioValue": 595904.23,
"rank": "111",
"positionCount": 42,
"positionsValue": 580000.0,
"unrealizedPnl": -12000.5,
"marketsTraded": 8103
}
CURL
curl -X GET "<host>/@Car/summary"
|
| GET |
/@{user}/event/{slug} |
User positions/closed/trades in one event |
Path
/@{user}/event/{slug}
/@{user}/event/{slug}/positions
/@{user}/event/{slug}/closed
/@{user}/event/{slug}/trades
/@{user}/event/{slug}/trades/{BUY|SELL}
Query
limit
Example Response
[
{
"title": "Will JD Vance win the 2028 US Presidential Election?",
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"eventSlug": "presidential-election-winner-2028",
"outcome": "Yes",
"size": 466665,
"cashPnl": -135566.18
}
]
CURL
curl -X GET "<host>/@Car/event/presidential-election-winner-2028?limit=20"
curl -X GET "<host>/@Car/event/presidential-election-winner-2028/closed?limit=20"
curl -X GET "<host>/@Car/event/presidential-election-winner-2028/trades?limit=20"
|
| GET |
/@{user}/market/{slug} |
User positions/trades in one market (path-first) |
Path
/@{user}/market/{slug}
/@{user}/market/{slug}/positions
/@{user}/market/{slug}/trades
/@{user}/market/{slug}/trades/{BUY|SELL}
Query
limit
CURL
curl -X GET "<host>/@Car/market/will-jd-vance-win-the-2028-us-presidential-election"
curl -X GET "<host>/@Car/market/will-jd-vance-win-the-2028-us-presidential-election/trades?limit=20"
|
| GET |
/profile/{0xaddress} |
Profile by address (mirrors /@user) |
Subpaths
/pnl /pnl/{period} /rank /rank/{period} /volume /volume/{period} /stats /trades /trades/{BUY|SELL} /trades.rss
/positions /top-positions /markets /exposure /flow /summary /gains /drawdowns /redeemable /closed /winners /losers
/activity /activity/{TYPE} /value /traded /market/{slug}[/positions|/trades] /event/{slug}[/positions|/closed|/trades] /{field}
CURL
curl -X GET "<host>/profile/0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b"
|
| Markets |
| GET |
/market/{slug} |
Market by slug |
Subpaths
/{field} /summary /status /fees /changes /volumes /event /siblings /bidask /flow /vwap /range /outcomes /quotes /parity /depth /imbalance /books /lasts /mids /spreads /move
/holders /holders/{outcome} /top-holders /prices /prices/{interval} /trades /trades/{BUY|SELL} /trades.rss /positions /tags /oi /comments
/{outcome} — midpoint/last/bid/ask snapshot
/{outcome}/book|midpoint|price|spread|last-trade-price|tick-size|fee-rate|neg-risk|prices|move|depth|imbalance|vwap|range
/{outcome}/prices/{interval} /{outcome}/move/{interval} /{outcome}/range/{interval} /{outcome}/price/{BUY|SELL} /{outcome}/depth /{outcome}/imbalance /{outcome}/vwap
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election"
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/midpoint"
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/book"
|
| GET |
/market/{slug}/volumes |
Multi-period volume + liquidity (24h/1w/1m/1y) |
Example Response
{
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"question": "Will JD Vance win the 2028 US Presidential Election?",
"volume": {
"24h": 10287.77,
"1w": 189063.35,
"1m": 588989.26,
"1y": 14763893.47,
"total": 15126715.64
},
"liquidity": 463724.49
}
CURL
curl -X GET "<host>/market/will-jd-vance-win-the-2028-us-presidential-election/volumes"
|
| GET |
/market/{slug}/changes |
Price changes (1h/1d/1w/1m/1y) for a market |
Example Response
{
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"question": "Will JD Vance win the 2028 US Presidential Election?",
"changes": {"1w": 0.009, "1m": 0.009, "1y": -0.0655}
}
CURL
curl -X GET "<host>/market/will-jd-vance-win-the-2028-us-presidential-election/changes"
|
| GET |
/market/{slug}/status |
Trading + resolution status (also /resolution) |
Example Response
{
"slug": "will-donald-trump-win-the-2028-us-presidential-election",
"question": "Will Donald Trump win the 2028 US Presidential Election?",
"active": true,
"closed": false,
"endDate": "2028-11-07T00:00:00Z",
"umaResolutionStatus": "proposed",
"acceptingOrders": true,
"enableOrderBook": true,
"orderMinSize": 5,
"tickSize": 0.001,
"umaBond": 50000,
"umaReward": 20
}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/status"
|
| GET |
/market/{slug}/fees |
Trading fees, tick size, and liquidity rewards (also /rewards) |
Example Response
{
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"feesEnabled": true,
"feeType": "politics_fees",
"makerBaseFee": 1000,
"takerBaseFee": 1000,
"orderMinSize": 5,
"tickSize": 0.001,
"feeSchedule": {"rate": 0.04, "takerOnly": true, "rebateRate": 0.25},
"rewardsMinSize": 50,
"rewardsMaxSpread": 5.5,
"clobRewards": [{"rewardsDailyRate": 40, "startDate": "2026-08-06"}]
}
CURL
curl -X GET "<host>/market/will-jd-vance-win-the-2028-us-presidential-election/fees"
|
| GET |
/market/{slug}/event |
Parent event slim snapshot (from market slug) |
Example Response
{
"id": "31552",
"title": "Presidential Election Winner 2028",
"slug": "presidential-election-winner-2028",
"volume24hr": 501997.28,
"liquidity": 60126206.05,
"negRisk": true,
"marketSlug": "will-donald-trump-win-the-2028-us-presidential-election"
}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/event"
|
| GET |
/market/{slug}/siblings |
Other markets in the parent event (also /related-markets) |
Query
limit, offset, closed (default open only)
Example Response
[
{
"groupItemTitle": "JD Vance",
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"outcomePrices": ["0.2095", "0.7905"],
"bestBid": 0.209,
"bestAsk": 0.21,
"volume24hr": 10287.77
}
]
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/siblings?limit=10"
|
| GET |
/market/{slug}/bidask |
Compact best bid/ask/mid/spread per outcome (also /tob) |
Example Response
[
{"outcome":"Yes","bid":0.021,"ask":0.022,"spread":0.001,"mid":0.0215},
{"outcome":"No","bid":0.978,"ask":0.979,"spread":0.001,"mid":0.9785}
]
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/bidask"
|
| GET |
/market/{slug}/outcomes |
Outcomes with token ids and prices |
Example Response
[
{"outcome":"Yes","outcomeIndex":0,"tokenId":"1180…","price":0.0215},
{"outcome":"No","outcomeIndex":1,"tokenId":"7265…","price":0.9785}
]
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/outcomes"
|
| GET |
/market/{slug}/quotes |
Live mid/bid/ask/last for every outcome |
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/quotes"
|
| GET |
/market/{slug}/books |
Order books for every outcome |
Query
depth (optional) – max bid/ask levels per side
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/books?depth=5"
|
| GET |
/market/{slug}/trades |
Recent market trades (optional /{BUY|SELL}) |
Path
/trades
/trades/{BUY|SELL}
/trades.rss or /trades.xml
Query
limit (optional, default 50)
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/trades?limit=20"
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/trades/BUY?limit=10"
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/trades.rss"
|
| GET |
/market/{slug}/prices |
Price history (default first outcome; path-first) |
Path
/prices or /prices/{1h|1d|1w|max}
/{outcome}/prices[/{interval}]
Query
interval, fidelity, outcome (optional on /prices)
Example Response
{
"slug": "will-donald-trump-win-the-2028-us-presidential-election",
"outcome": "Yes",
"interval": "1d",
"count": 120,
"change": -0.0015,
"history": [{"t": 1785891562, "p": 0.023}]
}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/prices/1d"
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/prices/max"
|
| GET |
/market/{slug}/depth |
Top-of-book bid/ask levels with sizes |
Query
depth (optional, default 5) – levels per side
Example Response
[
{
"outcome": "Yes",
"bestBid": 0.021,
"bestBidSize": 12500,
"bestAsk": 0.022,
"bestAskSize": 8400,
"bids": [{"price": 0.021, "size": 12500}],
"asks": [{"price": 0.022, "size": 8400}]
}
]
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/depth?depth=3"
|
| GET |
/market/{slug}/mids |
Midpoint for every outcome (batch) |
Example Response
[
{"outcome":"Yes","mid":0.0215},
{"outcome":"No","mid":0.9785}
]
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/mids"
|
| GET |
/market/{slug}/spreads |
Spread for every outcome (batch) |
Example Response
[
{"outcome":"Yes","spread":0.001},
{"outcome":"No","spread":0.001}
]
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/spreads"
|
| GET |
/market/{slug}/lasts |
Last trade price for every outcome |
Example Response
[
{"outcome":"Yes","outcomeIndex":0,"price":0.021,"side":"SELL"},
{"outcome":"No","outcomeIndex":1,"price":0.979,"side":"BUY"}
]
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/lasts"
|
| GET |
/market/{slug}/flow |
BUY vs SELL tape flow (notional + imbalance) |
Query
limit (default 100) — recent trades sampled for flow stats
Example Response
{
"slug": "will-donald-trump-win-the-2028-us-presidential-election",
"title": "Will Donald Trump win the 2028 US Presidential Election?",
"buyCount": 58,
"sellCount": 42,
"tradeCount": 100,
"buySize": 12500.5,
"sellSize": 9800.2,
"buyNotional": 268.4,
"sellNotional": 201.1,
"notional": 469.5,
"netNotional": 67.3,
"imbalance": 0.143,
"sample": 100
}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/flow?limit=100"
|
| GET |
/market/{slug}/vwap |
Volume-weighted average price from recent tape |
Path
/market/{slug}/vwap
/market/{slug}/vwap/{BUY|SELL}
/market/{slug}/{outcome}/vwap
/market/{slug}/{outcome}/vwap/{BUY|SELL}
Query
limit (default 100) — trades sampled
outcome — optional outcome filter on market-level path
side — BUY|SELL (path preferred)
Example Response
{
"slug": "will-donald-trump-win-the-2028-us-presidential-election",
"title": "Will Donald Trump win the 2028 US Presidential Election?",
"vwap": 0.0218,
"size": 18420.5,
"notional": 401.5,
"tradeCount": 100,
"buyCount": 58,
"sellCount": 42,
"sample": 100
}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/vwap?limit=100"
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/vwap?limit=50"
|
| GET |
/market/{slug}/move |
Price move over an interval (also /{outcome}/move) |
Path
/move or /move/{1h|1d|1w|max}
/{outcome}/move[/{interval}]
Example Response
{
"slug": "will-donald-trump-win-the-2028-us-presidential-election",
"outcome": "Yes",
"interval": "1d",
"open": 0.023,
"close": 0.0215,
"change": -0.0015,
"changePct": -0.0652,
"count": 1436
}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/move/1d"
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/move/1w"
|
| GET |
/market/{slug}/range |
OHLC high/low/open/close over an interval |
Path
/range or /range/{1h|1d|1w|max}
/ohlc[/{interval}] /high-low[/{interval}]
/{outcome}/range[/{interval}]
Example Response
{
"slug": "will-donald-trump-win-the-2028-us-presidential-election",
"outcome": "Yes",
"interval": "1d",
"open": 0.023,
"high": 0.0245,
"low": 0.021,
"close": 0.0215,
"range": 0.0035,
"change": -0.0015,
"changePct": -0.0652,
"count": 1436
}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/range/1d"
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/range/1w"
|
| GET |
/market/{slug}/parity |
Outcome mid/bid/ask sums vs 1.0 (arb signal) |
Example Response
{
"slug": "will-donald-trump-win-the-2028-us-presidential-election",
"outcomes": [
{"outcome":"Yes","midpoint":0.0215,"bestBid":0.021,"bestAsk":0.022},
{"outcome":"No","midpoint":0.9785,"bestBid":0.978,"bestAsk":0.979}
],
"sumMid": 1.0,
"edgeMid": 0.0,
"sumBid": 0.999,
"edgeBid": 0.001
}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/parity"
|
| GET |
/market/{slug}/imbalance |
Bid vs ask size pressure per outcome (order-flow signal) |
Query
depth (levels to sum; default 1, max 20)
Example Response
[
{
"outcome": "Yes",
"bestBid": 0.021,
"bestBidSize": 434.53,
"bestAsk": 0.022,
"bestAskSize": 3212.05,
"bidSize": 434.53,
"askSize": 3212.05,
"imbalance": -0.76,
"depth": 1
}
]
imbalance = (bidSize − askSize) / (bidSize + askSize); positive = more bid size.
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/imbalance"
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/imbalance?depth=5"
|
| GET |
/market/{slug}/comments |
Comments for the market’s parent event (by market slug) |
Query
limit, offset
Example Response
[
{
"id": "1771423",
"body": "…",
"userName": "Treeman666",
"reactionCount": 12,
"createdAt": "2025-07-29T16:29:30.951589Z"
}
]
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/comments?limit=10"
|
| GET |
/competitive |
Open markets closest to 50/50 (also /competitive/markets) |
Query
limit (default 20), offset, min_volume (optional 24h floor)
Example Response
[
{
"question": "…",
"slug": "doge-updown-4h-…",
"outcomePrices": ["0.5", "0.5"],
"competitive": 1,
"spread": 0.02,
"volume24hr": 12045.5
}
]
CURL
curl -X GET "<host>/competitive?limit=10"
curl -X GET "<host>/competitive?limit=10&min_volume=1000"
|
| GET |
/movers/{period} |
Biggest absolute price moves (also /gainers, /losers) |
Path
/movers
/movers/{1h|1d|1w|1m|1y}
/gainers/{period} — largest positive moves
/losers/{period} — largest negative moves
Query
limit (default 20), offset
Example Response
[
{
"slug": "mlb-wsh-phi-2026-08-05",
"question": "Washington Nationals vs. Philadelphia Phillies",
"change": 0.54,
"period": "1d",
"outcomePrices": ["0.72", "0.28"],
"volume24hr": 1099138.65
}
]
CURL
curl -X GET "<host>/movers/1d?limit=10"
curl -X GET "<host>/gainers/1w?limit=10"
curl -X GET "<host>/losers/1d?limit=10"
|
| GET |
/hot |
Top open markets by 24h volume (also /hot/markets) |
Query
limit (default 20), offset
Example Response
[
{
"question": "…",
"slug": "mlb-cws-bos-2026-08-05",
"volume24hr": 1099138.65,
"outcomePrices": ["0.52", "0.48"],
"bestBid": 0.51,
"bestAsk": 0.53
}
]
CURL
curl -X GET "<host>/hot?limit=10"
curl -X GET "<host>/hot/events?limit=10"
|
| GET |
/hot/events |
Top open events by 24h volume |
Query
limit (default 20), offset
CURL
curl -X GET "<host>/hot/events?limit=10"
|
| GET |
/featured |
Featured open events (also /featured/events) |
Query
limit (default 20), offset
Example Response
[
{
"id": "31552",
"title": "Presidential Election Winner 2028",
"slug": "presidential-election-winner-2028",
"volume24hr": 504682.99,
"featured": true
}
]
CURL
curl -X GET "<host>/featured?limit=10"
curl -X GET "<host>/featured/markets?limit=10"
|
| GET |
/featured/markets |
Featured open markets |
Query
limit (default 20), offset
CURL
curl -X GET "<host>/featured/markets?limit=10"
|
| GET |
/tight |
Tightest-spread open markets (also /tight/markets) |
Query
limit (default 20), offset, min_volume (optional 24h volume floor)
Example Response
[
{
"question": "…",
"slug": "will-elissa-slotkin-win-the-2028-democratic-presidential-nomination",
"spread": 0.001,
"bestBid": 0.094,
"bestAsk": 0.095,
"volume24hr": 481684.61
}
]
CURL
curl -X GET "<host>/tight?limit=10"
curl -X GET "<host>/tight?limit=10&min_volume=10000"
|
| GET |
/liquid |
Deepest open markets by liquidity (also /liquid/markets) |
Query
limit (default 20), offset
Example Response
[
{
"question": "…",
"slug": "will-kim-kardashian-win-the-2028-democratic-presidential-nomination",
"liquidity": 2906229.72,
"volume24hr": 6971.02,
"outcomePrices": ["0.0045", "0.9955"]
}
]
CURL
curl -X GET "<host>/liquid?limit=10"
|
| GET |
/new |
Newest open markets (also /new/markets) |
Query
limit (default 20), offset
Example Response
[
{
"question": "…",
"slug": "zec-updown-5m-…",
"createdAt": "2026-08-06T00:57:41.990419Z",
"outcomePrices": ["0.5", "0.5"]
}
]
CURL
curl -X GET "<host>/new?limit=10"
|
| GET |
/ending |
Open markets with soonest end date (also /closing-soon, /ending/markets) |
Query
limit (default 20), offset
Example Response
[
{
"question": "…",
"slug": "…",
"endDate": "2026-08-06T23:00:00Z",
"outcomePrices": ["0.45", "0.55"],
"volume24hr": 12000.5
}
]
CURL
curl -X GET "<host>/ending?limit=10"
|
| GET |
/ending/events |
Open events with soonest end date (also /closing-soon/events) |
Query
limit (default 20), offset
Example Response
[
{
"title": "Bank of Mexico Decision in August",
"slug": "bank-of-mexico-decision-in-august",
"endDate": "2026-08-06T00:00:00Z",
"volume24hr": 45210.2
}
]
CURL
curl -X GET "<host>/ending/events?limit=10"
|
| GET |
/markets |
List markets |
Query
limit, offset, closed, order, ascending, tag
Path-first tag
/markets/tag/{slug}
CURL
curl -X GET "<host>/markets?limit=20&closed=false"
curl -X GET "<host>/markets/tag/politics?limit=10"
|
| GET |
/markets/tag/{slug} |
Markets filtered by tag (path-first) |
Query
limit, offset, closed, order, ascending
CURL
curl -X GET "<host>/markets/tag/politics?limit=10"
|
| GET |
/markets/{id} |
Market by id |
CURL
curl -X GET "<host>/markets/561243"
|
| GET |
/token/{token_id} |
Resolve market from CLOB token id |
Subpaths
/{field}
CURL
curl -X GET "<host>/token/32338220190071351435772801779725302244575775216413325951443816017994629993401"
|
| GET |
/simplified-markets |
Simplified CLOB markets with token prices |
Query
next_cursor (optional), limit (optional client-side slice)
CURL
curl -X GET "<host>/simplified-markets?limit=5"
|
| GET |
/sampling-markets |
Sampling simplified markets (also /sampling-simplified-markets) |
CURL
curl -X GET "<host>/sampling-markets?limit=10"
|
| Events |
| GET |
/event/{slug} |
Event by slug |
Subpaths
/{field} /summary /status /volumes /oi /markets /quotes /board /bidask /changes /movers /top /underdogs /liquid /tight /parity /trades /flow /vwap /top-holders /tags /comments /live-volume
CURL
curl -X GET "<host>/event/presidential-election-winner-2028"
curl -X GET "<host>/event/presidential-election-winner-2028/summary"
curl -X GET "<host>/event/presidential-election-winner-2028/markets"
curl -X GET "<host>/event/presidential-election-winner-2028/trades?limit=20"
curl -X GET "<host>/event/presidential-election-winner-2028/top?limit=10"
curl -X GET "<host>/event/presidential-election-winner-2028/underdogs?limit=10"
curl -X GET "<host>/event/presidential-election-winner-2028/liquid?limit=10"
curl -X GET "<host>/event/presidential-election-winner-2028/tight?limit=10"
curl -X GET "<host>/event/presidential-election-winner-2028/parity?limit=10"
curl -X GET "<host>/event/presidential-election-winner-2028/tags"
curl -X GET "<host>/event/presidential-election-winner-2028/quotes?limit=10"
curl -X GET "<host>/event/presidential-election-winner-2028/comments?limit=10"
|
| GET |
/event/{slug}/summary |
Slim event snapshot (+ marketCount) |
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/summary"
|
| GET |
/event/{slug}/status |
Event trading status (+ open/closed market counts) |
Example Response
{
"id": "31552",
"title": "Presidential Election Winner 2028",
"slug": "presidential-election-winner-2028",
"active": true,
"closed": false,
"endDate": "2028-11-07T00:00:00Z",
"negRisk": true,
"marketCount": 128,
"openMarketCount": 50,
"closedMarketCount": 78
}
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/status"
|
| GET |
/event/{slug}/volumes |
Event volume/liquidity/OI snapshot |
Example Response
{
"slug": "presidential-election-winner-2028",
"title": "Presidential Election Winner 2028",
"volume": {"24h": 427437.82, "total": 677377296.18},
"liquidity": 60444215.23,
"openInterest": 64805840.73,
"marketCount": 128
}
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/volumes"
|
| GET |
/event/{slug}/oi |
Open interest board for top open markets in the event |
Aliases
/event/{slug}/open-interest
Query
limit (default 20, max 50), offset, closed (default open only)
Example Response
{
"slug": "presidential-election-winner-2028",
"title": "Presidential Election Winner 2028",
"total": 12500000.5,
"marketCount": 5,
"markets": [
{
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"title": "JD Vance",
"openInterest": 2500000.0,
"volume24hr": 10146.21
}
]
}
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/oi?limit=5"
|
| GET |
/event/{slug}/changes |
Price-change board for open markets (multi-period) |
Path
/event/{slug}/changes
/event/{slug}/changes/{1h|1d|1w|1m|1y}
Query
limit, offset, closed (default open only)
order=change|volume24hr
Example Response
[
{
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"question": "Will JD Vance win the 2028 US Presidential Election?",
"title": "JD Vance",
"changes": {"1h": 0.001, "1d": -0.004, "1w": 0.012},
"bestBid": 0.209,
"bestAsk": 0.21,
"volume24hr": 10146.21
}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/changes?limit=15"
curl -X GET "<host>/event/presidential-election-winner-2028/changes/1d?limit=10"
|
| GET |
/event/{slug}/top-holders |
Top whales across top open markets in the event |
Query
limit (default 20) — holders returned after merge
markets (default 5, max 15) — markets scanned by volume24hr
closed (default open only)
Example Response
[
{
"address": "0xabc…",
"amount": 1250000.5,
"outcome": "Yes",
"marketSlug": "will-jd-vance-win-the-2028-us-presidential-election",
"marketTitle": "JD Vance"
}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/top-holders?limit=10&markets=3"
|
| GET |
/event/{slug}/markets |
Event markets only |
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/markets"
|
| GET |
/event/{slug}/movers/{period} |
Price movers within an event (1h/1d/1w/1m) |
Path
/event/{slug}/movers
/event/{slug}/movers/{1h|1d|1w|1m|1y}
Query
limit, offset, closed, mode=movers|gainers|losers
Example Response
[
{
"groupItemTitle": "JD Vance",
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"change": 0.009,
"period": "1w",
"outcomePrices": ["0.2095", "0.7905"]
}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/movers/1w?limit=10"
curl -X GET "<host>/event/presidential-election-winner-2028/movers/1d?mode=gainers&limit=10"
|
| GET |
/event/{slug}/top |
Event markets ranked by first-outcome price |
Query
limit, offset
Example Response
[
{
"groupItemTitle": "JD Vance",
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"outcomePrices": ["0.2095", "0.7905"],
"bestBid": 0.209,
"bestAsk": 0.21
}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/top?limit=10"
|
| GET |
/event/{slug}/underdogs |
Event markets ranked by first-outcome price ascending (longshots) |
Query
limit, offset
Example Response
[
{
"groupItemTitle": "Longshot Candidate",
"slug": "will-…-win-the-2028-us-presidential-election",
"outcomePrices": ["0.0015", "0.9985"],
"bestBid": 0.001,
"bestAsk": 0.002
}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/underdogs?limit=10"
|
| GET |
/event/{slug}/liquid |
Event markets ranked by liquidity (deepest books first) |
Query
limit, offset, closed (optional; default open only)
Example Response
[
{
"groupItemTitle": "JD Vance",
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"liquidity": 457243.58,
"spread": 0.001,
"outcomePrices": ["0.2095", "0.7905"]
}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/liquid?limit=10"
|
| GET |
/event/{slug}/tight |
Event markets ranked by tightest spread (execution quality) |
Query
limit, offset, closed (optional; default open only)
Example Response
[
{
"groupItemTitle": "Marco Rubio",
"slug": "will-marco-rubio-win-the-2028-us-presidential-election",
"spread": 0.001,
"bestBid": 0.131,
"bestAsk": 0.132,
"liquidity": 309329.02
}
]
Skips dead books (spread ≥ 0.5 or missing bid/ask).
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/tight?limit=10"
|
| GET |
/event/{slug}/parity |
Sum of Yes (first-outcome) prices vs 1.0 across markets (multi-outcome arb) |
Query
closed (optional; default open only)
tradeable (default true — skip dead 0–1 books)
detail (default true), limit, offset
Example Response
{
"slug": "presidential-election-winner-2028",
"title": "Presidential Election Winner 2028",
"sumYes": 0.98,
"edgeYes": 0.02,
"marketCount": 48,
"skipped": 80,
"negRisk": true,
"markets": [
{"groupItemTitle": "JD Vance", "slug": "will-jd-vance-…", "yes": 0.2095}
]
}
edgeYes > 0 means tradeable Yes prices sum under 1.0; < 0 means overround.
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/parity?limit=15"
|
| GET |
/event/{slug}/quotes |
Price board for every market in the event |
Query
limit, offset (optional; sorted by volume24hr desc)
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/quotes?limit=15"
|
| GET |
/event/{slug}/board |
Ultra-slim dashboard board (title/yes/bid/ask/spread) |
Query
limit, offset, closed (default open only)
order=volume24hr|yes|spread
Example Response
[
{
"title": "JD Vance",
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"yes": 0.2095,
"bid": 0.209,
"ask": 0.21,
"spread": 0.001,
"volume24hr": 10146.21
}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/board?limit=15"
curl -X GET "<host>/event/presidential-election-winner-2028/board?order=yes&limit=10"
|
| GET |
/event/{slug}/bidask |
Compact TOB board (bid/ask/spread/mid/last) for open markets |
Aliases
/event/{slug}/tob
Query
limit, offset, closed (default open only)
order=volume24hr|yes|spread|mid
Example Response
[
{
"title": "JD Vance",
"slug": "will-jd-vance-win-the-2028-us-presidential-election",
"bid": 0.209,
"ask": 0.21,
"spread": 0.001,
"mid": 0.2095,
"last": 0.21,
"yes": 0.2095,
"volume24hr": 10146.21
}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/bidask?limit=15"
curl -X GET "<host>/event/presidential-election-winner-2028/bidask?order=spread&limit=10"
|
| GET |
/event/{slug}/tags |
Tags on an event |
Example Response
[
{"id": "101206", "label": "World Elections", "slug": "world-elections"},
{"id": "2", "label": "Politics", "slug": "politics"}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/tags"
|
| GET |
/event/{slug}/trades |
Recent trades across top markets in the event |
Path
/trades
/trades/{BUY|SELL}
Query
limit (default 50), markets (max markets to scan, default 5)
Example Response
[
{
"side": "BUY",
"title": "Will Thomas Massie win…?",
"slug": "will-thomas-massie-win-the-2028-us-presidential-election",
"outcome": "Yes",
"size": 100,
"price": 0.021,
"timestamp": 1785984294
}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/trades?limit=20"
curl -X GET "<host>/event/presidential-election-winner-2028/trades/BUY?limit=10&markets=3"
|
| GET |
/event/{slug}/flow |
BUY vs SELL tape flow pressure across top markets |
Query
limit (default 100 trades sample), markets (max markets to scan, default 5)
Example Response
{
"slug": "presidential-election-winner-2028",
"title": "Presidential Election Winner 2028",
"buyCount": 62,
"sellCount": 38,
"tradeCount": 100,
"buyNotional": 12450.5,
"sellNotional": 8320.1,
"notional": 20770.6,
"netNotional": 4130.4,
"imbalance": 0.199,
"marketsScanned": 5,
"sample": 100
}
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/flow?limit=100&markets=5"
|
| GET |
/event/{slug}/vwap |
Volume-weighted avg price from recent event tape |
Path
/event/{slug}/vwap
/event/{slug}/vwap/{BUY|SELL}
Query
limit (default 100 trades sample), markets (max markets to scan, default 5)
Example Response
{
"slug": "presidential-election-winner-2028",
"title": "Presidential Election Winner 2028",
"vwap": 0.0842,
"size": 152000.5,
"notional": 12800.3,
"tradeCount": 100,
"buyCount": 62,
"sellCount": 38,
"marketsScanned": 5,
"sample": 100
}
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/vwap?limit=100&markets=5"
|
| GET |
/event/{slug}/comments |
Comments on an event (by slug) |
Query
limit, offset
Example Response
[
{
"id": "1771423",
"body": "I don’t know who will win, but I know it won’t be JD Vance. Lmao",
"userName": "Treeman666",
"proxyWallet": "0x022c…",
"reactionCount": 12,
"createdAt": "2025-07-29T16:29:30.951589Z"
}
]
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/comments?limit=10"
|
| GET |
/events |
List events |
Query
limit, offset, closed, order, ascending, tag
Path-first tag
/events/tag/{slug}
CURL
curl -X GET "<host>/events?limit=20"
curl -X GET "<host>/events/tag/politics?limit=10"
|
| GET |
/events/tag/{slug} |
Events filtered by tag (path-first) |
Query
limit, offset, closed, order, ascending
CURL
curl -X GET "<host>/events/tag/sports?limit=10"
|
| GET |
/events/{id} |
Event by id |
CURL
curl -X GET "<host>/events/31552"
|
| Prices / CLOB (path-first by market slug + outcome) |
| GET |
/market/{slug}/{outcome}/book |
Order book for an outcome |
Example Response
{"outcome":"Yes","bids":[{"price":0.021,"size":434.53}],"asks":[{"price":0.022,"size":3212.05}]}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/book"
|
| GET |
/market/{slug}/{outcome}/depth |
Top N bid/ask levels for one outcome |
Query
depth (default 5, max 50) — number of levels per side
Example Response
{
"slug": "will-donald-trump-win-the-2028-us-presidential-election",
"outcome": "Yes",
"outcomeIndex": 0,
"depth": 3,
"bids": [{"price": 0.021, "size": 434.53}, {"price": 0.02, "size": 1200}],
"asks": [{"price": 0.022, "size": 3212.05}, {"price": 0.023, "size": 900}]
}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/depth?depth=5"
|
| GET |
/market/{slug}/{outcome}/imbalance |
Bid vs ask size pressure for one outcome |
Query
depth (default 1, max 20) — book levels summed per side
Example Response
{
"slug": "will-donald-trump-win-the-2028-us-presidential-election",
"outcome": "Yes",
"outcomeIndex": 0,
"bestBid": 0.021,
"bestBidSize": 721.27,
"bestAsk": 0.022,
"bestAskSize": 3527.19,
"bidSize": 721.27,
"askSize": 3527.19,
"imbalance": -0.66,
"depth": 1
}
imbalance = (bidSize − askSize) / (bidSize + askSize); positive = more bid size.
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/imbalance?depth=3"
|
| GET |
/market/{slug}/{outcome}/midpoint |
Midpoint for an outcome |
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/midpoint"
|
| GET |
/market/{slug}/{outcome}/price/{BUY|SELL} |
Best bid (BUY) or ask (SELL) for an outcome |
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/price/BUY"
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/price/SELL"
|
| GET |
/market/{slug}/{outcome}/spread |
Bid/ask spread for an outcome |
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/spread"
|
| GET |
/market/{slug}/{outcome}/last-trade-price |
Last trade price for an outcome |
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/last-trade-price"
|
| GET |
/market/{slug}/{outcome}/tick-size |
Minimum tick size for an outcome |
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/tick-size"
|
| GET |
/market/{slug}/{outcome}/fee-rate |
Fee rate for an outcome |
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/fee-rate"
|
| GET |
/market/{slug}/{outcome}/neg-risk |
Whether the outcome token is neg-risk |
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/yes/neg-risk"
|
| GET |
/market/{slug}/prices/{interval} |
Price history (prefer slug path; also /{outcome}/prices) |
Path
/market/{slug}/prices/{1h|1d|1w|max}
/market/{slug}/{outcome}/prices/{interval}
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/prices/1d"
|
| GET |
/trades |
Trades by user and/or market |
Query
user, market, side, limit
CURL
curl -X GET "<host>/trades?user=0x7c3db723f1d4d8cb9c550095203b686cb11e5c6b&limit=20"
|
| Discovery |
| GET |
/search/{q} |
Search events/profiles/tags (optional /events|/profiles|/tags) |
Path
/search/{q} or /search/{q}/events|/profiles|/tags
also ?q= for query form
Query
limit, profiles
Example Response
{
"events": [{"title": "…", "slug": "…"}],
"profiles": [{"name": "Car", "address": "0x…"}],
"pagination": {"hasMore": true, "totalResults": 3784}
}
CURL
curl -X GET "<host>/search/trump"
curl -X GET "<host>/search/trump/events?limit=5"
curl -X GET "<host>/search/Car/profiles?limit=5"
|
| GET |
/leaderboard/{period}/{order} |
Trader leaderboard (path-first period + order) |
Path
/leaderboard
/leaderboard/{ALL|DAY|WEEK|MONTH}
/leaderboard/{period}/{PNL|VOL}
Query
limit, offset (also ?period= ?order= if not in path)
Example Response
[
{
"rank": "1",
"name": "RWCS",
"address": "0x4ab9…",
"pnl": 102266.86,
"volume": 0
}
]
CURL
curl -X GET "<host>/leaderboard/DAY/PNL?limit=10"
curl -X GET "<host>/leaderboard/WEEK/VOL?limit=10"
curl -X GET "<host>/leaderboard?limit=25&period=ALL"
|
| GET |
/tags |
List tags |
CURL
curl -X GET "<host>/tags?limit=50"
|
| GET |
/tag/{slug} |
Tag by slug (+ /related, /markets, /events) |
Subpaths
/related /markets /events
Query on /markets and /events
limit, offset, closed, order, ascending
CURL
curl -X GET "<host>/tag/politics"
curl -X GET "<host>/tag/politics/related"
curl -X GET "<host>/tag/politics/markets?limit=10"
curl -X GET "<host>/tag/politics/events?limit=10"
curl -X GET "<host>/markets/tag/politics?limit=10"
curl -X GET "<host>/events/tag/politics?limit=10"
|
| GET |
/series |
List series |
Query
limit, offset
CURL
curl -X GET "<host>/series?limit=20"
|
| GET |
/series/{id|slug} |
Series by id or slug (+ /events, /markets, /volumes, /board, /comments) |
Subpaths
/{field} /events /markets /volumes /board /comments /eventCount
Example Response
{"id":"1","ticker":"nfl","slug":"nfl","title":"NFL","volume24hr":7943.58,"eventCount":14}
CURL
curl -X GET "<host>/series/1"
curl -X GET "<host>/series/nfl"
curl -X GET "<host>/series/mlb/volumes"
curl -X GET "<host>/series/nfl/events?limit=10"
curl -X GET "<host>/series/mlb/markets?limit=10"
curl -X GET "<host>/series/nfl/comments?limit=10"
|
| GET |
/series/{id|slug}/volumes |
Series volume/liquidity snapshot |
Example Response
{
"id": "3",
"slug": "mlb",
"title": "MLB",
"volume": {"24h": 13490375.07, "total": 7777475.55},
"liquidity": 6739233.35,
"eventCount": 17,
"openEventCount": 14
}
CURL
curl -X GET "<host>/series/mlb/volumes"
|
| GET |
/series/{id|slug}/board |
Slim trader board of series events |
Query
limit, offset, closed (default open only)
order=volume24hr|end
Example Response
[
{
"title": "Angels vs. Orioles",
"slug": "mlb-laa-bal-2026-08-06",
"volume24hr": 134903.5,
"liquidity": 250000.0,
"endDate": "2026-08-06T07:00:00Z"
}
]
CURL
curl -X GET "<host>/series/mlb/board?limit=10"
curl -X GET "<host>/series/nfl/board?order=end&limit=10"
|
| GET |
/series/{id|slug}/markets |
Flatten markets across series events (open by default) |
Query
limit (default 50), offset, closed (default false=open)
events — max events to expand (default 5, max 20)
Example Response
[
{
"slug": "mlb-laa-bal-2026-08-06-first-five-winner-away",
"groupItemTitle": "Los Angeles Angels",
"outcomePrices": ["0.355", "0.645"],
"bestBid": 0.32,
"bestAsk": 0.39,
"spread": 0.07,
"eventSlug": "mlb-laa-bal-2026-08-06-first-five-winner",
"eventTitle": "Angels vs. Orioles"
}
]
CURL
curl -X GET "<host>/series/mlb/markets?limit=10&events=5"
curl -X GET "<host>/series/btc-up-or-down-daily/markets?limit=10"
|
| GET |
/sports/{sport} |
Sport meta (+ /series, /events, /board, /markets) |
Path
/sports
/sports/{sport}
/sports/{sport}/series
/sports/{sport}/events
/sports/{sport}/board
/sports/{sport}/markets
Query on /events, /board and /markets
limit, offset, closed (board/markets default open)
order=volume24hr|end on /board
events — max events to expand for /markets (default 5)
CURL
curl -X GET "<host>/sports/nfl"
curl -X GET "<host>/sports/nfl/series"
curl -X GET "<host>/sports/mlb/events?limit=10"
curl -X GET "<host>/sports/mlb/board?limit=10"
curl -X GET "<host>/sports/mlb/markets?limit=10&events=3"
|
| GET |
/sports/{sport}/board |
Slim sports event board (vol/liquidity/end) |
Query
limit (default 20), offset, closed (default open only)
order=volume24hr|end
Example Response
[
{
"title": "Angels vs. Orioles",
"slug": "mlb-laa-bal-2026-08-06",
"volume24hr": 13514.69,
"liquidity": 12876.45,
"endDate": "2026-08-06T16:35:00Z"
}
]
CURL
curl -X GET "<host>/sports/mlb/board?limit=10"
curl -X GET "<host>/sports/nba/board?order=end&limit=10"
|
| GET |
/teams/{league} |
Teams for a league (also /teams?league=) |
Query
limit, offset
Example Response
[
{"id":100049,"name":"Dallas Cowboys","league":"nfl","abbreviation":"dal","record":"7-9-1"}
]
CURL
curl -X GET "<host>/teams/nfl?limit=20"
curl -X GET "<host>/teams?limit=50"
|
| GET |
/comments |
List comments (prefer path-first /event|market/{slug}/comments) |
Query
limit, offset, entity_type, entity_id
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/comments?limit=20"
curl -X GET "<host>/comments?entity_type=Event&entity_id=31552&limit=20"
|
| Resolution |
| GET |
/disputed |
Active disputed markets |
CURL
curl -X GET "<host>/disputed?limit=50"
|
| GET |
/proposed |
Active proposed markets |
CURL
curl -X GET "<host>/proposed?limit=50"
|
| GET |
/resolved |
Recently resolved markets |
Query
limit (default 50), offset, order (default updatedAt), ascending
Example Response
[
{
"question": "…",
"slug": "wta-cirstea-joint-2026-08-06-completed-match",
"umaResolutionStatus": "resolved",
"closed": true,
"outcomePrices": ["1", "0"],
"updatedAt": "2026-08-06T01:38:15Z"
}
]
CURL
curl -X GET "<host>/resolved?limit=20"
|
| GET |
/market/{slug}/holders |
Holders by outcome token (also /holders/{Yes|No}) |
Path
/holders — grouped by outcome token (labels included)
/holders/{Yes|No|0|1} — flat list for one outcome
/top-holders — flat ranked across all outcomes
Query
limit (optional)
CURL
curl -X GET "<host>/market/will-jd-vance-win-the-2028-us-presidential-election/holders?limit=10"
curl -X GET "<host>/market/will-jd-vance-win-the-2028-us-presidential-election/holders/Yes?limit=10"
curl -X GET "<host>/market/will-jd-vance-win-the-2028-us-presidential-election/top-holders?limit=10"
|
| GET |
/market/{slug}/top-holders |
Flat ranked holders with outcome labels |
Query
limit, outcome (optional filter)
Example Response
[
{
"name": "98better",
"address": "0xa8a9…",
"amount": 532055.24,
"outcome": "Yes",
"outcomeIndex": 0
}
]
CURL
curl -X GET "<host>/market/will-jd-vance-win-the-2028-us-presidential-election/top-holders?limit=10"
|
| GET |
/market/{slug}/oi |
Open interest for a market (prefer slug path) |
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/oi"
|
| GET |
/market/{slug}/positions |
Positions in a market (prefer slug path) |
Query
user, status (OPEN|CLOSED|ALL), sortBy, sortDirection, limit, offset
CURL
curl -X GET "<host>/market/will-donald-trump-win-the-2028-us-presidential-election/positions?limit=10"
|
| GET |
/event/{slug}/live-volume |
Live volume for an event (prefer slug path) |
CURL
curl -X GET "<host>/event/presidential-election-winner-2028/live-volume"
|