GET
/
trades
Get trades for a user or markets
curl --request GET \
  --url https://data-api.polymarket.com/trades
[
  {
    "proxyWallet": 8.992731955465627e+47,
    "side": "BUY",
    "asset": "<string>",
    "conditionId": 1.0002170361022097e+77,
    "size": 123,
    "price": 123,
    "timestamp": 123,
    "title": "<string>",
    "slug": "<string>",
    "icon": "<string>",
    "eventSlug": "<string>",
    "outcome": "<string>",
    "outcomeIndex": 123,
    "name": "<string>",
    "pseudonym": "<string>",
    "bio": "<string>",
    "profileImage": "<string>",
    "profileImageOptimized": "<string>",
    "transactionHash": "<string>"
  }
]

Query Parameters

​
limit
integer
default:100
Required range: 0 <= x <= 10000
​
offset
integer
default:0
Required range: 0 <= x <= 10000
​
takerOnly
boolean
default:true
​
filterType
enum<string>

Must be provided together with filterAmount.

Available options:
CASH,
TOKENS
​
filterAmount
number

Must be provided together with filterType.

Required range: x >= 0
​
market
string[]

Comma-separated list of condition IDs. Mutually exclusive with eventId.

0x-prefixed 64-hex string

​
eventId
integer[]

Comma-separated list of event IDs. Mutually exclusive with market.

​
user
string

User Profile Address (0x-prefixed, 40 hex chars)

Example:

8.992731955465627e+47

​
side
enum<string>
Available options:
BUY,
SELL

Response

200
application/json

Success

The response is of type object[].