ASasksurf
Search

Search Prediction Markets

Browse and search prediction markets across all supported platforms.

Filter by platform, category, status, keyword search, and smart money direction. Each result includes volume, open interest, trade counts, and smart money signals.

Supports single-market lookup via condition_id or market_ticker.

Data refresh: ~5 minutes.

get/gateway/v1/search/prediction-market

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

condition_idstring

Polymarket condition ID for single-market lookup

market_tickerstring

Kalshi market ticker for single-market lookup

platform'polymarket' | 'kalshi'

Filter by platform (omit for both)

category'crypto' | 'culture' | 'economics' | 'financials' | 'politics' | 'stem' | 'sports'

Filter by Surf-curated category

status'active' | 'closed' | 'finalized'

Market status filter

sort_by'volume_1d' | 'volume_7d' | 'volume_30d' | 'open_interest' | 'trade_count_7d' | 'days_to_resolution'

Sort field

order'asc' | 'desc'

Sort direction

smart_money'bullish' | 'bearish'

Filter by smart money direction (Polymarket only)

qstring

Search markets by keyword in question text or ticker. Results include slug and event fields when available, but machine slugs are not searched.

limitinteger

Results per page

offsetinteger

Pagination offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

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

Changes

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