Skip to main content
GET
/
v0
/
user
/
{address}
/
trades
# Hosted reads need: pmxt_api_key + wallet_address (private_key is only required for writes).
import pmxt

client = pmxt.Polymarket(
    pmxt_api_key="YOUR_PMXT_API_KEY",
    wallet_address="0xYourWallet",
)
for trade in client.fetch_my_trades():
    print(trade.id, trade.side, trade.amount, trade.price, trade.tx_hash)
[
  {
    "id": "<string>",
    "amount": 123,
    "price": 123,
    "fee": 123,
    "timestamp": "<string>",
    "tx_hash": "<string>",
    "chain": "<string>"
  }
]
Available on: Polymarket, Opinion, Limitless. Other venues raise NotSupported in hosted mode — for those, run a local PMXT service.
Use any EVM private key. Your USDC sits in a non-custodial PreFundedEscrow on Polygon — the single funding location for every hosted venue (including Opinion, which PMXT settles cross-chain for you). PMXT cannot move funds without your EIP-712 signature.

Authorizations

​
Authorization
string
header
required

Required when calling the hosted API directly (curl, requests, fetch). SDK users pass credentials via constructor params instead.

Path Parameters

​
address
string
required

EVM wallet address.

Response

Trade history.

​
id
string | null

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

​
side
enum<string> | null

Direction of the fill from the wallet's perspective.

Available options:
buy,
sell
​
amount
number | null

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

​
price
number | null

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

​
fee
number | null

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

​
timestamp
string | null

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

​
tx_hash
string | null

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

​
chain
string | null

Chain the fill settled on (typically polygon).

​
venue
enum<string> | null

Source venue that produced the fill.

Available options:
polymarket,
opinion