Prediction Market
Polymarket Events
Returns Polymarket events with nested markets, optionally filtered by event_slug.
Each event includes aggregated status, volume, and a list of markets with side_a/side_b outcomes.
Data refresh: ~30 minutes
get/gateway/v1/prediction-market/polymarket/events
Request
- Base URLhttps://api.asksurf.ai
- AuthHTTP bearer
Query parameters
event_slugstring required
Polymarket event slug (identifies a multi-outcome question with several nested markets). Known World Cup match sibling slugs are expanded to the canonical match group. Discover slugs via /v1/search/prediction-market?platform=polymarket&q={keyword}. For a single Yes/No market, use /polymarket/markets with market_slug instead — this endpoint only accepts event_slug, not market_slug.
Example:what-price-will-bitcoin-hit-before-2027
limitinteger
Results per page
Example:20
offsetinteger
Pagination offset
Response
OK
Example response
{
"$schema": "https://example.com/schemas/DataResponsePolymarketEvent.json"
}Changes
No recorded changes to this operation across all 12 revisions of this API.