Skip to main content
GET
/
v1
/
events
Get Events
curl --request GET \
  --url https://gateway.polymarket.us/v1/events
import requests

url = "https://gateway.polymarket.us/v1/events"

response = requests.get(url)

print(response.text)
const options = {method: 'GET'};

fetch('https://gateway.polymarket.us/v1/events', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gateway.polymarket.us/v1/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://gateway.polymarket.us/v1/events"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://gateway.polymarket.us/v1/events")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://gateway.polymarket.us/v1/events")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
{
  "events": [
    {
      "id": "<string>",
      "ticker": "<string>",
      "slug": "<string>",
      "title": "<string>",
      "subtitle": "<string>",
      "description": "<string>",
      "resolutionSource": "<string>",
      "startDate": "<string>",
      "creationDate": "<string>",
      "endDate": "<string>",
      "image": "<string>",
      "active": true,
      "closed": true,
      "archived": true,
      "liquidity": 123,
      "volume": 123,
      "openInterest": 123,
      "category": "<string>",
      "subcategory": "<string>",
      "createdAt": "<string>",
      "updatedAt": "<string>",
      "volume24hr": 123,
      "volume1wk": 123,
      "volume1mo": 123,
      "volume1yr": 123,
      "closedTime": "<string>",
      "eventDate": "<string>",
      "startTime": "<string>",
      "seriesSlug": "<string>",
      "score": "<string>",
      "elapsed": "<string>",
      "period": "<string>",
      "live": true,
      "ended": true,
      "finishedTimestamp": "<string>",
      "featuredOrder": 123,
      "markets": [
        {
          "id": "<string>",
          "question": "<string>",
          "slug": "<string>",
          "endDate": "<string>",
          "category": "<string>",
          "startDate": "<string>",
          "image": "<string>",
          "description": "<string>",
          "active": true,
          "marketType": "<string>",
          "closed": true,
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "archived": true,
          "orderPriceMinTickSize": 123,
          "gameStartTime": "<string>",
          "manualActivation": true,
          "sportsMarketType": "<string>",
          "line": 123,
          "marketSides": [
            {
              "id": "<string>",
              "identifier": "<string>",
              "createdAt": "<string>",
              "updatedAt": "<string>",
              "description": "<string>",
              "price": "<string>",
              "marketId": 123,
              "long": true,
              "teamId": 123,
              "team": {
                "id": 123,
                "name": "<string>",
                "abbreviation": "<string>",
                "league": "<string>",
                "record": "<string>",
                "logo": "<string>",
                "alias": "<string>",
                "safeName": "<string>",
                "homeIcon": "<string>",
                "awayIcon": "<string>",
                "colorPrimary": "<string>",
                "providerId": 123,
                "ordering": "<string>",
                "longIcon": "<string>",
                "shortIcon": "<string>",
                "displayAbbreviation": "<string>",
                "ranking": "<string>",
                "conference": "<string>",
                "providerIds": [
                  {
                    "providerId": "<string>"
                  }
                ],
                "longIconDark": "<string>",
                "shortIconDark": "<string>",
                "color": {
                  "light": "<string>",
                  "dark": "<string>"
                }
              },
              "quote": {
                "value": 123.45,
                "currency": "<string>"
              },
              "tradable": true
            }
          ],
          "outcomes": "<string>",
          "outcomePrices": "<string>",
          "ep3Status": "<string>",
          "hidden": true,
          "tags": [
            {
              "id": "<string>",
              "label": "<string>",
              "slug": "<string>",
              "createdAt": "<string>",
              "updatedAt": "<string>",
              "image": "<string>",
              "tradable": true,
              "league": {
                "id": 123,
                "name": "<string>",
                "sportId": 123,
                "tagId": 123,
                "image": "<string>",
                "resolution": "<string>",
                "ordering": "<string>",
                "activeSeriesId": 123,
                "isOperational": true,
                "automaticResolution": true,
                "createdAt": "<string>",
                "slug": "<string>",
                "abbreviation": "<string>"
              },
              "sport": {
                "id": 123,
                "name": "<string>",
                "tagId": 123,
                "createdAt": "<string>",
                "slug": "<string>",
                "image": "<string>"
              },
              "parentId": 123,
              "subtags": [
                {}
              ]
            }
          ],
          "title": "<string>",
          "subtitle": "<string>",
          "color": "<string>",
          "darkColor": "<string>",
          "subjectId": 123,
          "subject": {
            "id": 123,
            "name": "<string>",
            "displayName": "<string>",
            "description": "<string>",
            "subjectType": "<string>",
            "image": "<string>",
            "color": "<string>",
            "darkColor": "<string>",
            "createdAt": "<string>",
            "updatedAt": "<string>",
            "slug": "<string>"
          },
          "feeCoefficient": 123,
          "spreadTotalSuffix": "<string>",
          "sortOrder": 123,
          "bestBidQuote": {
            "value": 123.45,
            "currency": "<string>"
          },
          "bestAskQuote": {
            "value": 123.45,
            "currency": "<string>"
          },
          "metadata": {},
          "titleShort": "<string>",
          "ep3SyncedAt": "<string>",
          "minimumTradeQty": 123,
          "volume": 123,
          "volume24hr": 123,
          "volume1wk": 123,
          "volume1mo": 123,
          "volume1yr": 123,
          "rulesDisclaimer": "<string>"
        }
      ],
      "gameId": 123,
      "rescheduledFromGameId": 123,
      "sportradarGameId": "<string>",
      "eventState": {
        "id": 123,
        "gameId": 123,
        "sportradarGameId": "<string>",
        "type": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "score": "<string>",
        "elapsed": "<string>",
        "period": "<string>",
        "live": true,
        "ended": true,
        "finishedTimestamp": "2023-11-07T05:31:56Z",
        "footballState": {
          "down": 123,
          "yard": 123,
          "possessionProviderId": "<string>"
        },
        "ufcState": {
          "weightClass": "<string>",
          "cardSegment": "<string>",
          "eventLogo": "<string>",
          "rounds": 123,
          "order": 123
        },
        "tennisState": {
          "tournamentName": "<string>",
          "round": "<string>"
        },
        "baseballState": {
          "balls": 123,
          "strikes": 123,
          "outs": 123,
          "onFirst": true,
          "onSecond": true,
          "onThird": true,
          "inningHalf": "<string>"
        },
        "cricketState": {
          "innings": [
            {
              "number": 123,
              "battingTeamId": "<string>",
              "runs": 123,
              "wickets": 123,
              "oversCompleted": 123,
              "complete": true,
              "ballsIntoOver": 123
            }
          ],
          "currentInnings": 123,
          "totalOvers": 123,
          "phase": "<string>",
          "chase": {
            "target": 123,
            "runsNeeded": 123,
            "ballsRemaining": 123,
            "currentRunRate": 123,
            "requiredRunRate": 123
          }
        },
        "soccerState": {
          "shootoutAttempts": [
            {
              "competitorId": "<string>",
              "playerId": "<string>",
              "playerName": "<string>"
            }
          ]
        },
        "mainSpreadLine": 123,
        "mainTotalLine": 123,
        "marketGroupStats": [
          {
            "marketGroupId": "<string>",
            "line": 123,
            "current": 123
          }
        ]
      },
      "hidden": true,
      "tags": [
        {
          "id": "<string>",
          "label": "<string>",
          "slug": "<string>",
          "createdAt": "<string>",
          "updatedAt": "<string>",
          "image": "<string>",
          "tradable": true,
          "league": {
            "id": 123,
            "name": "<string>",
            "sportId": 123,
            "tagId": 123,
            "image": "<string>",
            "resolution": "<string>",
            "ordering": "<string>",
            "activeSeriesId": 123,
            "isOperational": true,
            "automaticResolution": true,
            "createdAt": "<string>",
            "slug": "<string>",
            "abbreviation": "<string>"
          },
          "sport": {
            "id": 123,
            "name": "<string>",
            "tagId": 123,
            "createdAt": "<string>",
            "slug": "<string>",
            "image": "<string>"
          },
          "parentId": 123,
          "subtags": [
            {}
          ]
        }
      ],
      "teams": [
        {
          "id": 123,
          "name": "<string>",
          "abbreviation": "<string>",
          "league": "<string>",
          "record": "<string>",
          "logo": "<string>",
          "alias": "<string>",
          "safeName": "<string>",
          "homeIcon": "<string>",
          "awayIcon": "<string>",
          "colorPrimary": "<string>",
          "providerId": 123,
          "ordering": "<string>",
          "longIcon": "<string>",
          "shortIcon": "<string>",
          "displayAbbreviation": "<string>",
          "ranking": "<string>",
          "conference": "<string>",
          "providerIds": [
            {
              "providerId": "<string>"
            }
          ],
          "longIconDark": "<string>",
          "shortIconDark": "<string>",
          "color": {
            "light": "<string>",
            "dark": "<string>"
          }
        }
      ],
      "metadata": {
        "gameState": {
          "id": 123,
          "gameId": 123,
          "sportradarGameId": "<string>",
          "type": "<string>",
          "createdAt": "2023-11-07T05:31:56Z",
          "updatedAt": "2023-11-07T05:31:56Z",
          "score": "<string>",
          "elapsed": "<string>",
          "period": "<string>",
          "live": true,
          "ended": true,
          "finishedTimestamp": "2023-11-07T05:31:56Z",
          "footballState": {
            "down": 123,
            "yard": 123,
            "possessionProviderId": "<string>"
          },
          "ufcState": {
            "weightClass": "<string>",
            "cardSegment": "<string>",
            "eventLogo": "<string>",
            "rounds": 123,
            "order": 123
          },
          "tennisState": {
            "tournamentName": "<string>",
            "round": "<string>"
          },
          "baseballState": {
            "balls": 123,
            "strikes": 123,
            "outs": 123,
            "onFirst": true,
            "onSecond": true,
            "onThird": true,
            "inningHalf": "<string>"
          },
          "cricketState": {
            "innings": [
              {
                "number": 123,
                "battingTeamId": "<string>",
                "runs": 123,
                "wickets": 123,
                "oversCompleted": 123,
                "complete": true,
                "ballsIntoOver": 123
              }
            ],
            "currentInnings": 123,
            "totalOvers": 123,
            "phase": "<string>",
            "chase": {
              "target": 123,
              "runsNeeded": 123,
              "ballsRemaining": 123,
              "currentRunRate": 123,
              "requiredRunRate": 123
            }
          },
          "soccerState": {
            "shootoutAttempts": [
              {
                "competitorId": "<string>",
                "playerId": "<string>",
                "playerName": "<string>"
              }
            ]
          },
          "mainSpreadLine": 123,
          "mainTotalLine": 123,
          "marketGroupStats": [
            {
              "marketGroupId": "<string>",
              "line": 123,
              "current": 123
            }
          ]
        },
        "latestGameUpdate": {
          "id": 123,
          "eventId": 123,
          "sportradarGameId": "<string>",
          "type": "<string>",
          "title": "<string>",
          "subtitle": "<string>",
          "subject": "<string>",
          "team": "<string>",
          "period": "<string>",
          "clock": "<string>",
          "highlightAt": "2023-11-07T05:31:56Z",
          "createdAt": "2023-11-07T05:31:56Z"
        }
      },
      "sortType": "<string>",
      "marketGroups": [
        {
          "id": "<string>",
          "title": "<string>",
          "subtitle": "<string>",
          "parentId": "<string>",
          "order": 123,
          "marketIds": [
            "<string>"
          ],
          "line": 123,
          "current": 123,
          "searchable": true,
          "showAllThreshold": 123,
          "showMarketImages": true
        }
      ],
      "primaryTag": {
        "id": "<string>",
        "label": "<string>",
        "slug": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "image": "<string>",
        "tradable": true,
        "league": {
          "id": 123,
          "name": "<string>",
          "sportId": 123,
          "tagId": 123,
          "image": "<string>",
          "resolution": "<string>",
          "ordering": "<string>",
          "activeSeriesId": 123,
          "isOperational": true,
          "automaticResolution": true,
          "createdAt": "<string>",
          "slug": "<string>",
          "abbreviation": "<string>"
        },
        "sport": {
          "id": 123,
          "name": "<string>",
          "tagId": 123,
          "createdAt": "<string>",
          "slug": "<string>",
          "image": "<string>"
        },
        "parentId": 123,
        "subtags": [
          {}
        ]
      },
      "secondaryTag": {
        "id": "<string>",
        "label": "<string>",
        "slug": "<string>",
        "createdAt": "<string>",
        "updatedAt": "<string>",
        "image": "<string>",
        "tradable": true,
        "league": {
          "id": 123,
          "name": "<string>",
          "sportId": 123,
          "tagId": 123,
          "image": "<string>",
          "resolution": "<string>",
          "ordering": "<string>",
          "activeSeriesId": 123,
          "isOperational": true,
          "automaticResolution": true,
          "createdAt": "<string>",
          "slug": "<string>",
          "abbreviation": "<string>"
        },
        "sport": {
          "id": 123,
          "name": "<string>",
          "tagId": 123,
          "createdAt": "<string>",
          "slug": "<string>",
          "image": "<string>"
        },
        "parentId": 123,
        "subtags": [
          {}
        ]
      },
      "primaryTagSlug": "<string>",
      "secondaryTagSlug": "<string>",
      "livestreamUrl": "<string>",
      "featureAvailability": {
        "lineups": true,
        "timeline": true
      }
    }
  ]
}

Query Parameters

​
limit
integer<int32>

Maximum number of events to return

​
offset
integer<int32>

Number of events to skip for pagination

​
orderBy
string[]

Fields to order results by

​
orderDirection
string

Order direction (asc or desc)

​
id
integer<int32>[]

Filter by event IDs

​
slug
string[]

Filter by event slugs

​
archived
boolean

Filter by archived status

​
active
boolean

Filter by active status

​
closed
boolean

Filter by closed status

​
liquidityMin
number<double>

Minimum liquidity filter

​
liquidityMax
number<double>

Maximum liquidity filter

​
volumeMin
number<double>

Minimum volume filter

​
volumeMax
number<double>

Maximum volume filter

​
startDateMin
string

Minimum start date filter

​
startDateMax
string

Maximum start date filter

​
endDateMin
string

Minimum end date filter

​
endDateMax
string

Maximum end date filter

​
relatedTags
boolean

Include related tags

​
tagSlug
string

Filter by tag slug

​
userId
string

Filter by user ID

​
featured
boolean

Filter by featured status

​
seriesId
integer<int32>[]

Filter by series IDs

​
eventDate
string

Filter by event date

​
startTimeMin
string

Minimum start time filter

​
startTimeMax
string

Maximum start time filter

​
excludeTagId
integer<int32>[]

Tag IDs to exclude

​
featuredOrder
boolean

Order by featured position

​
includeTemplate
boolean

Include template events

​
recurrence
string

Filter by recurrence type

​
gameId
integer<int32>

Filter by game ID

​
rescheduledFromGameId
integer<int32>

Filter by rescheduled from game ID

​
period
string

Filter by event period

​
finishedTimestampMin
string

Minimum finished timestamp filter

​
finishedTimestampMax
string

Maximum finished timestamp filter

​
ended
boolean

Filter by ended status

​
sportradarGameId
string

Filter by Sportradar game ID

​
excludeSeriesId
integer<int32>[]

Series IDs to exclude

​
resolution
boolean

Filter by resolution status

​
categories
string[]

Filter by categories

​
marketTypes
string[]

Filter by market types

​
live
boolean

Filter by live status

​
excludeEventId
integer<int32>[]

Event IDs to exclude

​
includeHidden
boolean

Include hidden events (default: false)

​
tagIds
integer<int32>[]

Filter by tag IDs

​
sportsMarketTypes
string[]

Filter by fine-grained sports_market_type (e.g. moneyline, drawable_outcome, soccer_game_to_advance)

Response

List of events

Response containing list of events

​
events
object[]

List of events