Skip to main content
GET
/
market
/
trades
cURL
curl --request GET \
  --url http://localhost:10112/market/trades
[
  {
    "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>",
    "usdc_amount": "<string>",
    "shares_amount": "<string>",
    "price": 123,
    "fee": "<string>",
    "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
  }
]

Query Parameters

​
condition_ids
string

Comma-separated condition IDs (max 20)

​
slugs
string

Comma-separated market slugs

​
position_ids
string

Comma-separated position IDs

​
traders
string

Comma-separated trader addresses (max 25)

​
side
integer<int32>

0 = Buy, 1 = Sell

​
outcome
string

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

​
outcome_index
integer<int32>

Outcome index (0 or 1)

​
trade_type
integer<int32>

0 = OrderFilled, 1 = Redemption, 2 = Merge

​
min_usdc_amount
number<double>

Min USDC amount

​
max_usdc_amount
number<double>

Max USDC 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: 50, max: 250)

Required range: x >= 0
​
offset
integer<int32>

Pagination offset

Required range: x >= 0
​
sort_desc
boolean

Sort newest first (default: true)

Response

200 - application/json

Prediction trades matching filters

​
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 - prefer using common::Trader for new code

See common::Trader which corresponds to SQL pm_build_trader() function

​
taker
string
required
​
side
string
required
​
usdc_amount
string
required
​
shares_amount
string
required
​
price
number<double>
required
​
fee
string
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 February 19, 2026