The data model
Every venue lists its own copy of a real-world question. AGG stores each venue’s listing and links equivalent ones together into a matched cluster.
You trade an outcome. Quotes, direct orders, and limit orders all take a
venueMarketOutcomeId. Orderbook and midpoint reads take the market id or the outcome id,
depending on the route. The two are not interchangeable.
Each object also carries externalIdentifier, the venue’s own id (a Kalshi ticker, a Polymarket
token id).
Market status is one of unopened, paused, open, closed, or resolved. Only open
markets can be traded. How a closed or resolved market pays out, including splits and voids, is
covered in Market resolution & voids.
Find a market to trade
data[] carries venueMarketOutcomes[]. Take the outcome’s id. Prices are not
on the listing; read them from GET /midpoints or a quote. For full filters and search modes see
Building market views and the
List venue markets reference.
24-hour price change
Each outcome carriespriceChange24h: how far its price moved over the last 24 hours, in
absolute probability points. 0.05 means the outcome is up 5 cents; -0.12 means down 12 cents.
It is not a percentage.
nullmeans unknown, never zero. Some venues publish no 24-hour change, so we sample their prices ourselves; their markets readnullfor roughly their first 24 hours.- The value is refreshed out of band, so it can trail the live price. Use
GET /midpointsfor the live price itself. How often it refreshes depends on the venue:- Polymarket: about every 5 minutes for the 5,000 most traded markets, and every few minutes for other active markets. Quiet markets can take hours.
- Myriad: every few minutes.
- Kalshi and Hyperliquid: about every 30 minutes.
- Venues we sample ourselves: about every 15 minutes.
/searchresults do not include it; read it from/venue-markets,/venue-eventsor/venue-market-outcomes.
Across venues
See Identifiers for cross-venue joins and durable references. To turn a venue’s own id into an outcome, callGET /venue-market-outcomes (Look up venue market outcomes by external identifier).
Settlement can differ
Venues do not always settle the same question the same way, for example on timing or on a cancelled match.GET /venue-events/:id returns a per-venue breakdown of those differences. Show
it before users trade across venues.
Discover markets by topic
Use these guides when building a focused discovery experience:- Live crypto markets: browse recurring price windows and add the underlying asset’s reference price.
- News feeds: connect articles to the markets they discuss.
- Correlated markets: find markets connected by related outcome signals, beyond title matching.
Guides
Matched clusters
Why a cluster can look empty.
Look up by venue identifier
Resolve a Kalshi ticker or Polymarket token id to the full cluster.
aggKey
When that filter applies.
Settlement key differences
Show how each venue settles a matched market.