---
title: "Fetch My Trades"
method: GET
path: "/v0/user/{address}/trades"
tags: ["Orders & Positions"]
---

# Fetch My Trades

`GET /v0/user/{address}/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`).

## Path parameters

- `address` string, required

## Response `200`

Trade history.

- UserTradeV0[]
  - `id` string, 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.
  - `amount` number, nullable — Shares filled by this trade (`fill.shares` from the operator's fill record).
  - `price` number, nullable — Net average fill price, in probability units [0, 1] -- already includes per-fill venue fees (`fill.avg_price_net`).
  - `fee` number, nullable — Sum of all fee components on the fill (venue + PMXT), in USDC dollars. `null` when the operator did not record fee components.
  - `timestamp` string, nullable — ISO-8601 timestamp of the trade as recorded by the operator.
  - `tx_hash` string, nullable — Polygon settlement transaction hash. Prefers the settlement-tx hash when present; falls back to the first underlying fill transaction.
  - `chain` string, nullable — Chain the fill settled on (typically `polygon`).
  - `venue` 'polymarket' | 'opinion' | 'limitless', nullable — Source venue that produced the fill.

## Other responses

- `401` — Invalid or missing PMXT API key.

## Changes

- **2026-06-24** `6784cc7c8376` — 1 warning
  - added the new `limitless` enum value to the `items/venue` response property for the response status `200`
- **2026-06-09** `6c1e54fea3a3` — 2 info
  - api tag `Orders & Positions` added
  - api tag `Orders & Positions (Hosted)` removed
- **2026-06-09** `d2fae1223132` — 2 warning
  - removed the optional property `items/market_id` from the response with the `200` status
  - removed the optional property `items/outcome_id` from the response with the `200` status

[Change history](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api/changes/v0/user/:address/trades/get.md)

---

[API](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api.md) · [All operations](https://skmtc.dev/pmxt-dev/apis/pmxt-hosted-router-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pmxt-dev/pmxt-hosted-router-api/revisions/9ee3cbe2dc87/schema)