GET/trades

Get trades for a user or markets

**Data API v2:** this route has a v2 counterpart, `GET /v2/trades`. See [Migrating to Data API v2](/migrate/data-api-v1-to-v2).

Base URL: https://data-api.polymarket.com
Auth: Public, no key
Rate limit: 200 req / 10s (20 per second)
Limit applies to: /trades

Things to know

Data API v1 has been frozen since 4 September 2026. It still answers, but new fields and endpoints only go to v2. The v2 version of this call is GET /v2/trades.

Parameters

Name	In	Type	Required	Description
limit	query	integer	no	Page size. Values above the maximum are clamped to 10000.
offset	query	integer	no	Starting index for pagination. Requests past the cap are rejected with a 400 (never silently clamped). To read history deeper than offset 10000, page inside `start`/`end` windows — each window has its own offset budget.
takerOnly	query	boolean	no
filterType	query	string	no	Must be provided together with filterAmount.
filterAmount	query	number	no	Must be provided together with filterType.
market	query	object[]	no	Comma-separated list of condition IDs. Mutually exclusive with eventId.
eventId	query	integer[]	no	Comma-separated list of event IDs. Mutually exclusive with market.
user	query	string	no
side	query	string	no
start	query	integer	no	Lower-bound timestamp (epoch seconds) for the trade window. Omit or pass `0` for the default window (most recent ~3 years); pass a positive epoch (e.g. `1`) to retrieve full history on user-scoped requests.
end	query	integer	no	Upper-bound timestamp (epoch seconds) for the trade window. Omit for the default (current time); rows newer than `end` are excluded.

Example

curl -X GET "https://data-api.polymarket.com/trades"

Returns a list of objects with these fields

Field	Type	Description
proxyWallet	string	User Profile Address (0x-prefixed, 40 hex chars)
side	string
asset	string
conditionId	string	0x-prefixed 64-hex string
size	number
price	number
timestamp	integer
title	string
slug	string
icon	string	Market artwork. Falls back to the market image, then to the parent event's icon and image, when the market has no icon of its own.
eventSlug	string
outcome	string
outcomeIndex	integer
name	string
pseudonym	string
bio	string
profileImage	string
profileImageOptimized	string
transactionHash	string

Responses

Status	Meaning
200	Success
400	Bad Request
401	Unauthorized
500	Server Error

Errors this endpoint returns

Related endpoints

GET /v2/trades Data API v2

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.