Get trades for a user or markets

GET /trades

Get trades for a user or markets

cURL

curl --request GET \
  --url https://data-api.polymarket.com/trades

import requests

url = "https://data-api.polymarket.com/trades"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://data-api.polymarket.com/trades', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://data-api.polymarket.com/trades",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://data-api.polymarket.com/trades"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://data-api.polymarket.com/trades")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://data-api.polymarket.com/trades")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

200

[
  {
    "proxyWallet": "0x56687bf447db6ffa42ffe2204a05edaa20f55839",
    "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>"
  }
]

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

Query Parameters

limit · integer · default: 100

Page size. Values above the maximum are clamped to 10000.

Required range: 0 <= x <= 10000

offset · integer · default: 0

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.

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

Pattern: ^0x[a-fA-F0-9]{64}$

eventId · integer[]

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

Required range: x >= 1

user · string

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

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

side · enum<string>

Available options: BUY, SELL

start · integer

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. Market/event-scoped requests keep the ~3-year floor — start can only narrow their window, not extend it.

Required range: x >= 0

end · integer

Upper-bound timestamp (epoch seconds) for the trade window. Omit for the default (current time); rows newer than end are excluded.

Required range: x >= 0

Response

200

application/json

Success

proxyWallet · string

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

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

side · enum<string>

Available options: BUY, SELL

asset · string

conditionId · string

0x-prefixed 64-hex string

Pattern: ^0x[a-fA-F0-9]{64}$

Example:

"0xdd22472e552920b8438158ea7238bfadfa4f736aa4cee91a6b86c39ead110917"

size · number

price · number

timestamp · integer<int64>

title · string

slug · string

icon · string

eventSlug · string

outcome · string

outcomeIndex · integer

name · string

pseudonym · string

bio · string

profileImage · string

profileImageOptimized · string

transactionHash · string