Sign in

v9

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-2491679.8 KB
Orders & Positions

Fetch My Trades

List the wallet's historical fills on Polymarket, Opinion, and Limitless. Each trade carries the executed price (net of venue fees), size, and on-chain settlement tx hash.

Closed orders are modelled as trades in hosted mode — use this endpoint instead of fetchClosedOrders / fetchAllOrders (which raise NotSupported).

get/v0/user/{address}/trades

Path parameters

addressstring required

EVM wallet address.

Response

Trade history.

idstring nullable

Venue-issued trade id. null when the venue does not expose a stable id for this fill.

side'buy' | 'sell' nullable

Direction of the fill from the wallet's perspective.

amountnumber nullable

Shares filled by this trade (fill.shares from the operator's fill record).

pricenumber nullable

Net average fill price, in probability units [0, 1] -- already includes per-fill venue fees (fill.avg_price_net).

feenumber nullable

Sum of all fee components on the fill (venue + PMXT), in USDC dollars. null when the operator did not record fee components.

timestampstring nullable

ISO-8601 timestamp of the trade as recorded by the operator.

tx_hashstring nullable

Polygon settlement transaction hash. Prefers the settlement-tx hash when present; falls back to the first underlying fill transaction.

chainstring nullable

Chain the fill settled on (typically polygon).

venue'polymarket' | 'opinion' | 'limitless' nullable

Source venue that produced the fill.