GET
/
trades
curl --request GET \
  --url https://data-api.polymarket.com/trades
[
  {
    "proxyWallet": "0x6af75d4e4aaf700450efbac3708cce1665810ff1",
    "side": "SELL",
    "asset": "28774665463932631392072718054733378944250725021214679767633993409910",
    "conditionId": "0x1731c2d00c722fa4d53d1bddae549f14cf1870e2cf59dc040e779104667",
    "size": 160.26,
    "price": 0.89,
    "timestamp": 1724210494,
    "title": "2024 August hottest on record?",
    "slug": "2024-august-hottest-on-record",
    "icon": "https://polymarket-upload.s3.us-east-2.amazonaws.com/earth+on+fire.png",
    "eventSlug": "2024-august-hottest-on-record",
    "outcome": "Yes",
    "outcomeIndex": 0,
    "name": "gopfan",
    "pseudonym": "Mean-Record",
    "bio": "",
    "profileImage": "https://polymarket-upload.s3.us-east-2.amazonaws.com/rus_gopfan",
    "profileImageOptimized": "",
    "transactionHash": "0x5620f25e2772f0ec2c5b2f2f814f6e20b52b4363286a9043b626324"
  }
]

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

​
user
string

The address of the user in question

​
limit
integer
default:100

The max number of trades to return, defaults to 100, max 500

Required range: 1 <= x <= 500
​
offset
integer
default:0

The starting index for pagination

Required range: x >= 0
​
takerOnly
boolean
default:true

Flag that determines whether to return only taker orders. Defaults to true. Otherwise return maker and taker orders

​
filterType
enum<string>

Flag indicating whether to filter trades by a parameter

Available options:
CASH,
TOKENS
​
filterAmount
number

The amount to filter by. Related to filterType above

​
market
string

The condition ID of the market in question. Supports comma separated values

​
side
enum<string>

The side of the trade

Available options:
BUY,
SELL

Response

200 - application/json

Successful response with trades data

The response is of type object[].