Skip to main content
GET
/
v1
/
search
Search
curl --request GET \
  --url https://gateway.polymarket.us/v1/search
{
  "events": [
    {
      "id": "<string>",
      "ticker": "<string>",
      "slug": "<string>",
      "title": "<string>",
      "subtitle": "<string>",
      "description": "<string>",
      "resolutionSource": "<string>",
      "startDate": "<string>",
      "endDate": "<string>",
      "image": "<string>",
      "icon": "<string>",
      "active": true,
      "closed": true,
      "archived": true,
      "featured": true,
      "liquidity": 123,
      "volume": 123,
      "openInterest": 123,
      "category": "<string>",
      "subcategory": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "volume24hr": 123,
      "volume1wk": 123,
      "volume1mo": 123,
      "eventDate": "<string>",
      "startTime": "<string>",
      "eventWeek": 123,
      "seriesSlug": "<string>",
      "score": "<string>",
      "elapsed": "<string>",
      "period": "<string>",
      "live": true,
      "ended": true,
      "finishedTimestamp": "<string>",
      "gameStatus": "<string>",
      "gameId": 123,
      "sportradarGameId": "<string>",
      "latestHighlight": {
        "id": 123,
        "eventId": 123,
        "type": "<string>",
        "highlightAt": "2023-11-07T05:31:56Z",
        "title": "<string>",
        "subtitle": "<string>",
        "description": "<string>",
        "clock": "<string>",
        "score": "<string>",
        "icon": {
          "largeIcon": "<string>",
          "smallIcon": "<string>"
        },
        "teamIcon": {
          "largeIcon": "<string>",
          "smallIcon": "<string>"
        }
      },
      "eventState": {
        "id": 123,
        "gameId": 123,
        "sportradarGameId": "<string>",
        "type": "<string>",
        "score": "<string>",
        "elapsed": "<string>",
        "period": "<string>",
        "live": true,
        "ended": true,
        "finishedTimestamp": "2023-11-07T05:31:56Z",
        "footballState": {
          "down": 123,
          "yard": 123,
          "possessionProviderId": "<string>"
        }
      },
      "participants": [
        {
          "id": "<string>",
          "type": "PARTICIPANT_TYPE_NOMINEE",
          "nominee": {
            "id": "<string>",
            "name": "<string>"
          },
          "player": {
            "id": "<string>",
            "name": "<string>",
            "team": {
              "id": 123,
              "name": "<string>",
              "abbreviation": "<string>",
              "league": "<string>",
              "record": "<string>",
              "logo": "<string>",
              "alias": "<string>",
              "safeName": "<string>",
              "homeIcon": "<string>",
              "awayIcon": "<string>",
              "colorPrimary": "<string>",
              "providerIds": [
                {
                  "provider": "PROVIDER_SPORTSDATAIO",
                  "providerId": "<string>"
                }
              ]
            }
          },
          "team": {
            "id": 123,
            "name": "<string>",
            "abbreviation": "<string>",
            "league": "<string>",
            "record": "<string>",
            "logo": "<string>",
            "alias": "<string>",
            "safeName": "<string>",
            "homeIcon": "<string>",
            "awayIcon": "<string>",
            "colorPrimary": "<string>",
            "providerIds": [
              {
                "provider": "PROVIDER_SPORTSDATAIO",
                "providerId": "<string>"
              }
            ]
          }
        }
      ],
      "hidden": true
    }
  ]
}

Query Parameters

​
query
string

The search query string. Searches across event titles, market questions, team names, and descriptions. Example: Super Bowl, Lakers vs Celtics

​
limit
integer<int32>

Maximum number of results to return per page. Default: 10. Example: 25

​
seriesIds
integer<int32>[]

Filter results to specific series by their IDs. Only returns events belonging to the specified series. Example: [1, 2, 3] for NFL, NBA, MLB series

​
marketType
string[]

Filter by market types within matching events. Example values: binary, scalar

​
startTimeMin
string<date-time>

Filter events starting on or after this timestamp. ISO 8601 format. Example: 2025-01-20T00:00:00Z

​
startTimeMax
string<date-time>

Filter events starting on or before this timestamp. ISO 8601 format. Example: 2025-01-31T23:59:59Z

​
closedTimeMin
string<date-time>

Filter events that closed on or after this timestamp. ISO 8601 format. Useful for finding recently resolved events

​
closedTimeMax
string<date-time>

Filter events that closed on or before this timestamp. ISO 8601 format. Useful for finding historical events

​
status
enum<string>

Filter by event status. Values: active (open for trading), closed (resolved), upcoming (not yet started)

Available options:
active,
closed,
upcoming
​
page
integer<int32>

Page number for pagination (1-indexed). Use with limit to navigate through results. Example: 2 for the second page

Response

Search results

​
events
object[]

Events results