AGG is currently in alpha. APIs, components, and docs may change.
Agg.market — Prediction Market Aggregator logo

Look up venue market outcomes by external identifier

Resolves venue-side outcome keys (e.g. Polymarket tokenid) to AGG outcomes, including matchedVenueMarketOutcomes counterpart references across venues.

GEThttps://api.agg.market/venue-market-outcomes

Resolves venue-side outcome keys (e.g. Polymarket token_id) to AGG outcomes, including matchedVenueMarketOutcomes counterpart references across venues. Batch up to 20 keys. Outcome keys are globally unique, so venue is optional and narrows only. Kalshi carries its ticker on exactly one of the two outcomes per market, so Kalshi No-side outcomes cannot be resolved here — fetch the market via GET /venue-markets?venue=kalshi&externalIdentifier= and read both outcomes from it.

Loading code example
Loading code example

Authorizations

appIdstringheaderrequired

API key passed in the header.

Query Parameters

externalIdentifieranyrequired
venue"kalshi" | "polymarket" | "limitless" | "opinion" | "predict" | "probable" | "myriad" | "hyperliquid"
Allowed values: "kalshi" | "polymarket" | "limitless" | "opinion" | "predict" | "probable" | "myriad" | "hyperliquid"

Response

application/json

200

dataarray<object>required
data.idstringrequired
data.venueMarketIdstringrequired
data.externalIdentifierstring
data.labelstringrequired
data.titlestring
data.pricenumberdeprecated

No longer returned. Fetch live prices from GET /midpoints (pass this outcome's parent venueMarketId in `ids` and match on `outcomes[].venueMarketOutcomeId`), or subscribe to the WebSocket midpoint stream.

Required range: x >= 0, x <= 1
data.winnerboolean
data.matchedVenueMarketOutcomesarray<object>
data.matchDecisionobject
nextCursorstringrequired
hasMorebooleanrequired