Skip to main content
GET
Proxy Polymarket's public trade-history API for one market

Authorizations

X-Client-Id
string
header
required

Credential client id (kairos_ck_...). Must be sent together with X-Api-Key and X-Api-Secret.

X-Api-Key
string
header
required

64-char hex API key.

X-Api-Secret
string
header
required

64-char hex API secret.

Query Parameters

market
string
required

Polymarket condition ID (0x...), market ID, or token ID. Non-0x values are resolved to a condition ID before querying upstream. Empty or >128 chars returns 400.

Required string length: 1 - 128
after
integer | null

Inclusive lower bound, Unix seconds. Passed to upstream and re-applied client-side against each trade's timestamp.

before
integer | null

Inclusive upper bound, Unix seconds, passed to the upstream API.

limit
integer
default:100

Max trades returned, passed through to the upstream Polymarket API.

Required range: 1 <= x <= 500

Response

Raw Polymarket trades plus computed metrics. metrics is {} when the market value could not be resolved to a condition ID (no upstream call was made).

trades
object[]
required
metrics
object
required

A TradesMetrics object in the normal case. When market could not be resolved to a condition ID, this is a literal empty object {} and trades is [] — no upstream call was made.