Fetch Events

import pmxt

# API key optional — enables faster catalog-backed lookups
exchange = pmxt.Polymarket(
    pmxt_api_key="YOUR_PMXT_API_KEY",
)
result = exchange.fetch_events(
    query="election",
    limit=10,
    status="active",
)

{
  "success": true,
  "error": {
    "message": "<string>",
    "retryable": true,
    "exchange": "<string>",
    "detail": {}
  },
  "data": [
    {
      "id": "<string>",
      "title": "<string>",
      "description": "<string>",
      "slug": "<string>",
      "markets": [
        {
          "marketId": "<string>",
          "title": "<string>",
          "description": "<string>",
          "outcomes": [
            {
              "outcomeId": "<string>",
              "label": "<string>",
              "price": 123,
              "marketId": "<string>",
              "priceChange24h": 123,
              "metadata": {}
            }
          ],
          "volume24h": 123,
          "liquidity": 123,
          "url": "<string>",
          "eventId": "<string>",
          "slug": "<string>",
          "resolutionDate": "2023-11-07T05:31:56Z",
          "volume": 123,
          "openInterest": 123,
          "image": "<string>",
          "category": "<string>",
          "tags": [
            "<string>"
          ],
          "tickSize": 123,
          "status": "<string>",
          "contractAddress": "<string>",
          "sourceMetadata": {},
          "sourceExchange": "<string>",
          "yes": {
            "outcomeId": "<string>",
            "label": "<string>",
            "price": 123,
            "marketId": "<string>",
            "priceChange24h": 123,
            "metadata": {}
          },
          "no": {
            "outcomeId": "<string>",
            "label": "<string>",
            "price": 123,
            "marketId": "<string>",
            "priceChange24h": 123,
            "metadata": {}
          },
          "up": {
            "outcomeId": "<string>",
            "label": "<string>",
            "price": 123,
            "marketId": "<string>",
            "priceChange24h": 123,
            "metadata": {}
          },
          "down": {
            "outcomeId": "<string>",
            "label": "<string>",
            "price": 123,
            "marketId": "<string>",
            "priceChange24h": 123,
            "metadata": {}
          }
        }
      ],
      "volume24h": 123,
      "url": "<string>",
      "volume": 123,
      "image": "<string>",
      "category": "<string>",
      "tags": [
        "<string>"
      ],
      "sourceMetadata": {},
      "sourceExchange": "<string>"
    }
  ]
}

GET

api

{exchange}

fetchEvents

import pmxt

# API key optional — enables faster catalog-backed lookups
exchange = pmxt.Polymarket(
    pmxt_api_key="YOUR_PMXT_API_KEY",
)
result = exchange.fetch_events(
    query="election",
    limit=10,
    status="active",
)

{
  "success": true,
  "error": {
    "message": "<string>",
    "retryable": true,
    "exchange": "<string>",
    "detail": {}
  },
  "data": [
    {
      "id": "<string>",
      "title": "<string>",
      "description": "<string>",
      "slug": "<string>",
      "markets": [
        {
          "marketId": "<string>",
          "title": "<string>",
          "description": "<string>",
          "outcomes": [
            {
              "outcomeId": "<string>",
              "label": "<string>",
              "price": 123,
              "marketId": "<string>",
              "priceChange24h": 123,
              "metadata": {}
            }
          ],
          "volume24h": 123,
          "liquidity": 123,
          "url": "<string>",
          "eventId": "<string>",
          "slug": "<string>",
          "resolutionDate": "2023-11-07T05:31:56Z",
          "volume": 123,
          "openInterest": 123,
          "image": "<string>",
          "category": "<string>",
          "tags": [
            "<string>"
          ],
          "tickSize": 123,
          "status": "<string>",
          "contractAddress": "<string>",
          "sourceMetadata": {},
          "sourceExchange": "<string>",
          "yes": {
            "outcomeId": "<string>",
            "label": "<string>",
            "price": 123,
            "marketId": "<string>",
            "priceChange24h": 123,
            "metadata": {}
          },
          "no": {
            "outcomeId": "<string>",
            "label": "<string>",
            "price": 123,
            "marketId": "<string>",
            "priceChange24h": 123,
            "metadata": {}
          },
          "up": {
            "outcomeId": "<string>",
            "label": "<string>",
            "price": 123,
            "marketId": "<string>",
            "priceChange24h": 123,
            "metadata": {}
          },
          "down": {
            "outcomeId": "<string>",
            "label": "<string>",
            "price": 123,
            "marketId": "<string>",
            "priceChange24h": 123,
            "metadata": {}
          }
        }
      ],
      "volume24h": 123,
      "url": "<string>",
      "volume": 123,
      "image": "<string>",
      "category": "<string>",
      "tags": [
        "<string>"
      ],
      "sourceMetadata": {},
      "sourceExchange": "<string>"
    }
  ]
}

Faster with an API key — With a PMXT API key this endpoint is served from an indexed catalog (~10 ms) instead of proxying to the venue (~500 ms). No code changes required — same request, same response, just faster. Learn more.

Use cases

Search by keyword

Find all events mentioning “Trump” on Polymarket:

import pmxt

# Optional: pass pmxt_api_key for ~100x faster catalog-backed lookups
api = pmxt.Polymarket()
events = api.fetch_events(query="trump", limit=5)
for event in events:
    print(event.title, event.url)

import { Polymarket } from "pmxtjs";

// Optional: pass pmxtApiKey for ~100x faster catalog-backed lookups
const api = new Polymarket();
const events = await api.fetchEvents({ query: "trump", limit: 5 });
events.forEach((e) => console.log(e.title, e.url));

curl "https://api.pmxt.dev/api/polymarket/fetchEvents?query=trump&limit=5" \
  -H "Authorization: Bearer $PMXT_API_KEY"

Filter by category

Get all crypto-related events on Kalshi:

import pmxt

api = pmxt.Limitless()
events = api.fetch_events(category="Crypto", limit=5)

import { Limitless } from "pmxtjs";

const api = new Limitless();
const events = await api.fetchEvents({ category: "Crypto", limit: 5 });

curl "https://api.pmxt.dev/api/limitless/fetchEvents?category=Crypto&limit=5" \
  -H "Authorization: Bearer $PMXT_API_KEY"

Filter by tags

Get events tagged with geopolitics:

import pmxt

api = pmxt.Polymarket()
events = api.fetch_events(tags=["Geopolitics", "Middle East"], limit=5)

import { Polymarket } from "pmxtjs";

const api = new Polymarket();
const events = await api.fetchEvents({
  tags: ["Geopolitics", "Middle East"],
  limit: 5,
});

curl "https://api.pmxt.dev/api/polymarket/fetchEvents?tags=Geopolitics&tags=Middle+East&limit=5" \
  -H "Authorization: Bearer $PMXT_API_KEY"

Filter active by category

Find active sports events:

import pmxt

api = pmxt.Polymarket()
events = api.fetch_events(
    category="Sports",
    status="active",
    limit=5,
)

import { Polymarket } from "pmxtjs";

const api = new Polymarket();
const events = await api.fetchEvents({
  category: "Sports",
  status: "active",
  limit: 5,
});

curl "https://api.pmxt.dev/api/polymarket/fetchEvents?category=Sports&status=active&limit=5" \
  -H "Authorization: Bearer $PMXT_API_KEY"

Path Parameters

exchange

enum<string>

required

The prediction market exchange to target.

Available options:

polymarket,

kalshi,

kalshi-demo,

limitless,

probable,

baozi,

myriad,

opinion,

metaculus,

smarkets,

polymarket_us,

gemini-titan,

hyperliquid,

suibets,

rain,

hunch,

router

Query Parameters

query

string

For keyword search

limit

number

Maximum number of results to return

cursor

string

Opaque venue pagination cursor, where supported.

offset

number

Pagination offset — number of results to skip

sort

enum<string>

Sort order for results

Available options:

volume,

liquidity,

newest

status

enum<string>

Filter by event status (default: 'active', 'inactive' and 'closed' are interchangeable)

Available options:

active,

inactive,

closed,

all

searchIn

enum<string>

Where to search (default: 'title')

Available options:

title,

description,

both

eventId

string

Direct lookup by event ID

slug

string

Lookup by event slug

series

string

Filter events by their parent series. Accepts the venue-native series id / ticker / slug (e.g. Kalshi "KXATPMATCH", Polymarket "wta"). Passed through to the vendor where supported, otherwise applied to sourceMetadata after fetch.

filter

object

Optional client-side filter applied after fetching

Show child attributes

Response

200 - application/json

Fetch Events response

success

boolean

Example:

true

error

object

Structured error envelope returned inside BaseResponse.error and ErrorResponse.error. Hosted-mode endpoints populate code, retryable, and optionally exchange / detail; legacy local-mode endpoints may still return only message.

Show child attributes

data

object[]

Show child attributes

Close Fetch Events Paginated

Overview

System

Events & Markets

Trading

Orders & Positions

Cross Exchange

Order Book & Trades

Realtime

Data Feeds

Other

Enterprise

Fetch Events

Use cases

Search by keyword

Filter by category

Filter by tags

Filter active by category

Path Parameters

Query Parameters

Response

​Use cases

​Search by keyword

​Filter by category

​Filter by tags

​Filter active by category

Path Parameters

Query Parameters

Response

Use cases

Search by keyword

Filter by category

Filter by tags

Filter active by category