Event Catalog - PolyNode

Complete event catalog

curl --request GET \
  --url https://api.polynode.dev/v3/events \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.polynode.dev/v3/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://api.polynode.dev/v3/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://api.polynode.dev/v3/events"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.polynode.dev/v3/events")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "events": [
    {
      "event_slug": "<string>",
      "status": "open",
      "active": true,
      "closed": true,
      "market_count": 2,
      "status_counts": {
        "open": 1,
        "closed": 1,
        "inactive": 1
      },
      "title_variant_count": 1,
      "image_variant_count": 1,
      "icon_variant_count": 1,
      "representative_market": {
        "condition_id": "<string>",
        "slug": "<string>",
        "question": "<string>",
        "end_date": "<string>",
        "tag_slugs": [
          "<string>"
        ]
      },
      "volume_all_time": null,
      "liquidity": null,
      "title": "<string>",
      "latest_market_updated_at": "<string>",
      "image": "<string>",
      "icon": "<string>"
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "limit": 150,
  "next_cursor": "<string>",
  "sort": "updated",
  "order": "desc",
  "filters": {
    "status": "open",
    "event_slug": "<string>"
  }
}

GET

events

Complete event catalog

curl --request GET \
  --url https://api.polynode.dev/v3/events \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.polynode.dev/v3/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://api.polynode.dev/v3/events",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$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://api.polynode.dev/v3/events"

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

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.polynode.dev/v3/events")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "events": [
    {
      "event_slug": "<string>",
      "status": "open",
      "active": true,
      "closed": true,
      "market_count": 2,
      "status_counts": {
        "open": 1,
        "closed": 1,
        "inactive": 1
      },
      "title_variant_count": 1,
      "image_variant_count": 1,
      "icon_variant_count": 1,
      "representative_market": {
        "condition_id": "<string>",
        "slug": "<string>",
        "question": "<string>",
        "end_date": "<string>",
        "tag_slugs": [
          "<string>"
        ]
      },
      "volume_all_time": null,
      "liquidity": null,
      "title": "<string>",
      "latest_market_updated_at": "<string>",
      "image": "<string>",
      "icon": "<string>"
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "limit": 150,
  "next_cursor": "<string>",
  "sort": "updated",
  "order": "desc",
  "filters": {
    "status": "open",
    "event_slug": "<string>"
  }
}

GET /v3/events groups markets by parent event slug and returns one event row with status and member-market counts. Events are ordered by the latest update among their member markets.

Request

GET /v3/events

Query parameters

Parameter	Type	Default	Description
`limit`	integer	100	Rows per page. Values below 1 use 1; values above 300 use 300.
`cursor`	string	none	Opaque `next_cursor` returned by the preceding page.
`status`	string	all	`open`, `closed`, `inactive`, or `all`. Matching is case-insensitive.
`event_slug`	string	none	Exact event slug.
`sort`	string	`updated`	Only `updated` is available.
`order`	string	`desc`	Only `desc` is available.

Offset pagination is not supported on this route.

Example

curl "https://api.polynode.dev/v3/events?event_slug=example-event&limit=1" \
  -H "x-api-key: $POLYNODE_API_KEY"

{
  "events": [
    {
      "event_slug": "example-event",
      "title": "Example event",
      "status": "open",
      "active": true,
      "closed": false,
      "market_count": 2,
      "status_counts": {
        "open": 1,
        "closed": 1,
        "inactive": 0
      },
      "latest_market_updated_at": "2026-08-27T20:00:00Z",
      "title_variant_count": 1,
      "image_variant_count": 1,
      "icon_variant_count": 1,
      "image": "https://example.com/event.png",
      "representative_market": {
        "condition_id": "0x1111111111111111111111111111111111111111111111111111111111111111",
        "slug": "will-the-example-market-resolve-yes",
        "question": "Will the example market resolve Yes?",
        "end_date": null,
        "tag_slugs": ["example"]
      },
      "volume_all_time": null,
      "liquidity": null
    }
  ],
  "rows_returned": 1,
  "has_more": false,
  "limit": 1,
  "next_cursor": null,
  "sort": "updated",
  "order": "desc",
  "filters": {
    "status": null,
    "event_slug": "example-event"
  }
}

Event status

An event is open while any member market is open. It is closed when every member market is closed. Otherwise it is inactive.

Response envelope

The envelope has the same cursor fields as the market catalog, with the page rows in events. Pass next_cursor unchanged and keep the same filters. Stop when has_more is false.

Event fields

Field	Type	Nullable	Description
`event_slug`	string	no	Event slug.
`title`	string	yes	Representative event title.
`status`	string	no	`open`, `closed`, or `inactive`.
`active`, `closed`	boolean	no	Status convenience flags.
`market_count`	integer	no	Member markets.
`status_counts`	object	no	Open, closed, and inactive member-market counts.
`latest_market_updated_at`	string	yes	Latest available update among member markets.
`title_variant_count`	integer	no	Distinct non-empty event titles among member markets.
`image_variant_count`, `icon_variant_count`	integer	no	Distinct non-empty image and icon URLs among member markets.
`image`, `icon`	string	yes	Representative image URLs.
`representative_market`	object	no	One member market with `condition_id`, `slug`, `question`, `end_date`, and `tag_slugs`.
`volume_all_time`, `liquidity`	null	yes	Reserved financial fields. This catalog currently returns `null`; do not treat them as zero.

Errors

Status	Error	When it occurs
`400`	`invalid_request`	Invalid status, event slug, sort, order, or use of `offset`.
`400`	`invalid_cursor`	A cursor is malformed, expired, belongs to the market route, or is used with different filters.
`401`	authentication error	The API key is missing or invalid.
`410`	`invalid_cursor`	The page walk referenced by the cursor is no longer available. Start again without a cursor.
`503`	`temporarily_unavailable`	Markets and events are temporarily unavailable.

Authorizations

x-api-key

string

header

required

Query Parameters

limit

integer

default:100

Required range: 1 <= x <= 300

cursor

string

Opaque next_cursor from the preceding page.

status

enum<string>

default:all

Available options:

open,

closed,

inactive,

all

event_slug

string

Exact event slug.

sort

enum<string>

default:updated

Available options:

updated

order

enum<string>

default:desc

Available options:

desc

Response

Cursor-paginated events

events

object[]

required

Show child attributes

rows_returned

integer

required

Required range: x >= 0

has_more

boolean

required

limit

integer

required

Required range: 1 <= x <= 300

next_cursor

string | null

required

sort

string

required

Allowed value: "updated"

order

string

required

Allowed value: "desc"

filters

object

required

Show child attributes

​Request

​Query parameters

​Example

​Event status

​Response envelope

​Event fields

​Errors

Authorizations

Query Parameters

Response

Request

Query parameters

Example

Event status

Response envelope

Event fields

Errors