Trades

Every executed fill on a given market, both outcomes interleaved, sorted by timestamp ascending.

List trades

GET/v1/markets/{conditionId}/trades

Query parameters

Field	Type	Description
fromrequired	ISO 8601	Start of the window. Required.
torequired	ISO 8601	End of the window. Required.
outcome	string	Filter to one side: `Up` or `Down`. Omit to include both.
side	string	Filter by aggressor side: `buy` or `sell`.
limit	integer	Page size, max 5,000. Defaults to 1,000.
cursor	string	Cursor from the previous page.

Example request

terminal

curl https://api.tradrr.dev/v1/markets/0xabc123.../trades \
  -H "Authorization: Bearer $TRADRR_API_KEY" \
  -G \
  --data-urlencode "from=2025-03-31T22:00:00Z" \
  --data-urlencode "to=2025-03-31T23:00:00Z"

Response

200 OK

{
  "data": [
    {
      "trade_id": "9f2c...",
      "ts_us":    1747776007891234,
      "outcome":  "Up",
      "side":     "buy",
      "price":    0.63,
      "size":     420.0,
      "binance_spot": 82150.12
    }
  ],
  "next_cursor": "eyJ0cyI6..."
}

binance_spot is the BTC/USDT mid on Binance at the same second the trade printed — populated for all crypto markets, null when Binance has a gap. Use it to attribute fills to the underlying.