Skip to main content
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

​
proxyWallet
string

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

Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

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

0x-prefixed 64-hex string

Example:

"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"

​
size
number
​
price
number
​
timestamp
integer
​
title
string
​
slug
string
​
icon
string
​
eventSlug
string
​
outcome
string
​
outcomeIndex
integer
​
name
string
​
pseudonym
string
​
bio
string
​
profileImage
string
​
profileImageOptimized
string
​
transactionHash
string
⌘I