REST API / Core Resources / Events

Events

List all tracked events with their matched market groups. Events are the real-world occurrences that markets are tied to. Each event can have multiple matched market groups across platforms.

GET/v2/events

Query Parameters

event_typestring

Filter: sports, election, economics, or all. Default: all.

statusstring

Filter by status: active (event date today or future), completed (past), or all. Default: active.

tagsstring

For sports events: nfl, nba, mlb, nhl, cfb, epl, etc. Comma-separated.

datestring

Filter by event date (YYYY-MM-DD).

qstring

Search event name.

limitinteger

Default: 20, max: 100.

cursorstring

Pagination cursor from previous response.

Response Schema

eventsobject[]

List of events matching the filters.

idinteger

Internal event ID.

event_namestring

Event name (e.g. "NBA: Lakers vs Celtics").

event_typestring

Category: sports, election, economics.

event_datestring

Date of the event (YYYY-MM-DD).

statusstring

Event status: active (event date is today or future) or completed (event date has passed).

groupsobject[]

Matched market groups for this event.

group_idinteger

Internal match group ID.

titlestring

Group title (e.g. "lakers win").

platform_countinteger

Number of platforms with markets in this group.

platformsstring[]

List of platform names (e.g. ["polymarket", "kalshi"]).

next_cursorstring

Opaque cursor for the next page. Null if no more results.

total_countinteger

Total number of events matching the filters.

Authentication

API Key

To secure your requests, we strongly recommend passing your API key via the X-API-Key header. This prevents sensitive keys from being exposed in access logs or browser history.

Request HeaderX-API-Key: pmx_test_5e8f...

Rate Limits

API rate limits are enforced based on the tier associated with your API key. Limits are tracked on two dimensions: requests per second and requests per month. Each completed request counts toward the global monthly quota. Separate endpoint-group monthly limits (matched markets, arbitrage, EV) only advance when the response body has success: true.

Usage is returned on responses via headers such as:

Response Headers (global)X-RateLimit-Limit-Second: 10X-RateLimit-Remaining-Second: 9X-RateLimit-Limit-Month: 1000X-RateLimit-Remaining-Month: 842Example (endpoint-group, when applicable)X-RateLimit-Limit-Arb-Month: 500X-RateLimit-Remaining-Arb-Month: 412

If you exceed a rate limit, the API returns a 429 status with a Retry-After header indicating when you can resume.

Request

Live API Key

Demo Mode

Verified

Filters

Event Type

Status

Response

—

Click EXECUTE to send a request →