REST API / Polymarket (Admin) / Open Interest

Open Interest Time Series (Polymarket)

ADMIN-ONLY (gated, not yet public). Historical OI time series for a Polymarket market. WE DO NOT YET COLLECT OI AS A TIME SERIES — this endpoint returns only the latest snapshot from market_outcomes as a single-point series, with `_meta.snapshot_only: true` and `data_available_from: null` flagging the limitation. As of this PR, no Polymarket markets have OI populated in our DB, so this endpoint will return an empty series for most condition_ids. A follow-up will add a periodic OI poller writing to a new market_oi_snapshots hypertable.

GET/v2/polymarket/markets/{condition_id}/open_interest

Query Parameters

condition_idstring (path)Required

Polymarket condition ID (path parameter).

Response Schema

condition_idstring

The requested condition ID.

seriesobject[]

OI snapshots over time. Currently a single-point series (latest snapshot only) when data is present, or empty when no OI is captured for this market.

tinteger

Snapshot capture timestamp (unix seconds).

total_open_interestnumber

Sum of OI across all outcomes.

by_outcomeobject[]

OI broken down per outcome.

outcome_namestring

Internal outcome name.

outcome_labelstring

Display label.

open_interestnumber

OI for this outcome at the snapshot time.

_metaobject

Data warning metadata.

data_available_fromnull

null — no historical OI series available.

snapshot_onlyboolean

true — the series contains only the current snapshot, not real history.

warningstring

Plain-text caveat about the data state.

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

Parameters

Condition IDRequired

Response

—

Click EXECUTE to send a request →