Skip to main content
GET
/
polymarket
/
trader
/
trades
/
{address}
Get trader trades
curl --request GET \
  --url https://api.struct.to/v1/polymarket/trader/trades/{address}
[
  {
    "id": "<string>",
    "hash": "<string>",
    "block": 1,
    "confirmed_at": 1,
    "trader": {
      "address": "<string>",
      "name": "<string>",
      "pseudonym": "<string>",
      "profile_image": "<string>",
      "x_username": "<string>",
      "verified_badge": true
    },
    "taker": "<string>",
    "side": "<string>",
    "usd_amount": 123,
    "shares_amount": 123,
    "price": 123,
    "fee": 123,
    "exchange": "<string>",
    "trade_type": "<string>",
    "log_index": 1,
    "order_hash": "<string>",
    "position_id": "<string>",
    "condition_id": "<string>",
    "outcome": "<string>",
    "outcome_index": 123,
    "question": "<string>",
    "slug": "<string>",
    "probability": 123
  }
]

Path Parameters

address
string
required

Trader wallet address

Query Parameters

condition_ids
string

Comma-separated condition IDs (max 20)

slugs
string

Comma-separated market slugs

position_ids
string

Comma-separated position IDs

side
enum<string>

Trade side: 0 (Buy), 1 (Sell)

Available options:
0,
1
outcome
string

Outcome name filter (e.g. Yes, No)

outcome_index
enum<string>

Outcome index: 0 (Yes), 1 (No)

Available options:
0,
1
trade_type
enum<string>

Trade type: 0 (OrderFilled), 1 (Redemption), 2 (Merge)

Available options:
0,
1,
2,
4
min_usd_amount
number<double>

Min USD amount

max_usd_amount
number<double>

Max USD amount

min_shares_amount
number<double>

Min shares amount

max_shares_amount
number<double>

Max shares amount

min_price
number<double>

Min price (0.0-1.0)

max_price
number<double>

Max price (0.0-1.0)

from
integer<int64>

Start timestamp (ms)

to
integer<int64>

End timestamp (ms)

all
boolean

Return all-time trades, not just last 30 days (default: false)

limit
integer<int32>

Results per page (default: 10, max: 250)

Required range: x >= 0
pagination_key
integer<int32>

Offset-based pagination key (integer offset into result set)

Required range: x >= 0
sort_desc
boolean

Sort newest first (default: true)

ai
boolean

Return truncated response optimized for AI consumers (default: false)

Response

200 - application/json

Trader's trade history with advanced filtering (same as /market/trades but filtered by trader)

id
string
required
hash
string
required
block
integer<int64>
required
Required range: x >= 0
confirmed_at
integer<int64>
required
Required range: x >= 0
trader
object
required

Trader profile info - backwards compatibility

taker
string
required
side
string
required
usd_amount
number<double>
required
shares_amount
number<double>
required
price
number<double>
required
fee
number<double>
required
exchange
string
required
trade_type
string
required
log_index
integer<int64>
required
Required range: x >= 0
order_hash
string
required
position_id
string
required
condition_id
string | null
outcome
string | null
outcome_index
integer<int32> | null
question
string | null
slug
string | null
probability
number<double> | null
Last modified on March 17, 2026