Skip to main content
GET
Get markouts grouped by counterparty

Authorizations

Authorization
string
header
required

Raw database-backed API key.

Query Parameters

user
string
required

A 20-byte 0x wallet address, @username, or bare Polymarket username.

Required string length: 1 - 255
from
string<date-time>

Inclusive RFC3339 window start. Defaults to seven days before to.

to
string<date-time>

Inclusive RFC3339 window end. Defaults to the current time.

market_id
string

Restrict target-user fills by up to 20 comma-separated selectors: market slugs, 0x-prefixed condition IDs, decimal outcome token IDs, or category:<dotted-slug>. Mixed selectors are ORed. Exact market identifiers do not expand to grouped markets; category parents include descendants through inherited category membership.

Maximum string length: 5299
token_id
string

Restrict target-user fills to one decimal outcome token ID.

Pattern: ^[0-9]+$
min_usdc
number<double>
default:0

Exclude counterparties below this matched USDC amount.

Required range: x >= 0
limit
integer
default:100
Required range: 1 <= x <= 1000

Response

Counterparty-level markout aggregates ordered by matched USDC.

user_address
string
required
Pattern: ^0x[0-9a-f]{40}$
rows
object[]
required
totals
object
required
window
object
required
limit
integer
required
min_usdc
number<double>
required