Polymarket Event Search

GET /gateway/v1/search/polymarket

Polymarket Event Search

cURL

curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/search/polymarket

200

{
  "data": [
    {
      "event_slug": "<string>",
      "market_count": 123,
      "markets": [
        {
          "condition_id": "<string>",
          "market_slug": "<string>",
          "status": "<string>",
          "title": "<string>",
          "volume_1_month": 123,
          "volume_1_week": 123,
          "volume_1_year": 123,
          "volume_total": 123,
          "category": "<string>",
          "close_time": 123,
          "completed_time": 123,
          "description": "<string>",
          "end_time": 123,
          "event_slug": "<string>",
          "game_start_time": 123,
          "image": "<string>",
          "negative_risk_id": "<string>",
          "polymarket_link": "<string>",
          "resolution_source": "<string>",
          "side_a": {
            "id": "<string>",
            "label": "<string>"
          },
          "side_b": {
            "id": "<string>",
            "label": "<string>"
          },
          "start_time": 123,
          "subcategory": "<string>",
          "tags": [
            "<string>"
          ],
          "winning_side": "<string>"
        }
      ],
      "status": "<string>",
      "title": "<string>",
      "volume_total": 123,
      "category": "<string>",
      "description": "<string>",
      "end_time": 123,
      "image": "<string>",
      "settlement_sources": "<string>",
      "start_time": 123,
      "subcategory": "<string>",
      "tags": [
        "<string>"
      ]
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "https://example.com/schemas/DataResponsePolymarketEvent.json"
}

Query Parameters

q · string

Search keyword matching market question, event title, or description

Maximum string length: 200

Example:

"bitcoin"

tags · string

Comma-separated tag labels to filter by (matches any). Commonly used tags: Crypto, Politics, Sports, Science, Pop Culture

Maximum string length: 500

Example:

"politics"

category · enum<string>

Filter by Surf-curated category

Available options: crypto, culture, early_polymarket_trades, economics, financials, politics, stem, sports, unknown

Example:

"politics"

status · enum<string> · default: active

Market status filter: active, finalized, ended, initialized, or closed

Available options: active, finalized, ended, initialized, closed

Example:

"active"

limit · integer<int64> · default: 20

Results per page

Required range: 1 <= x <= 100

Example:

20

offset · integer<int64> · default: 0

Pagination offset

Required range: x >= 0

Example:

0

Response

200

application/json

OK

data · object[] | null · required

Show child attributes

meta · object · required

Show child attributes

$schema · string<uri> · read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponsePolymarketEvent.json"