GET
/
trades
Get trades for a user or markets
curl --request GET \
  --url https://data-api.polymarket.com/trades
[
  {
    "proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "side": "BUY",
    "asset": "<string>",
    "conditionId": "0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917",
    "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>"
  }
]
Polymarket provides a simple alternative to the CLOB API for accessing trade data through a basic GET request that doesn’t require L2 headers. This endpoint allows users to retrieve trades from all markets and users. See the schema and example response below for implementation details.

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:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

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

Response

Success

The response is of type object[].