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 URL
    https://api.asksurf.ai
  • Auth
    HTTP 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

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponsePolymarketEvent.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.