Skip to main content
Every v2 fill where a wallet is either the maker or the taker, newest-first. Same per-trade shape as /clobv2/trades — raw two-sided fields, derived convenience fields, full market enrichment, and the side field always present (telling you whether this wallet was the maker or taker on each fill). Backed by the v2.fill view.

Request

Authentication

Paid tier required. See /clobv2/trades for the auth header formats.

Path parameters

Query parameters

Parameter validation

  • address: regex ^0x[a-f0-9]{40}$ (case-insensitive).
  • limit: 1-1000. offset: 0-10000000.
Bad input → 400 Bad Request.

Response

Response fields

Rate-limit headers

Same as every clobv2 endpoint: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset.

Examples

Error responses

Notes

  • The wallet in the path is case-insensitive — 0xD663F0... works the same as 0xd663f0.... The response always echoes the normalized lowercase form.
  • Results are always sorted by ts_unix DESC (newest first).
  • side is always "maker" or "taker" here, unlike /clobv2/trades where it only appears when you supply wallet=.
  • A wallet that has never traded on v2 returns count: 0 with an empty trades: [] — not a 404.
  • The same trade appears in both participants’ wallet-trade lists — if you need deduplication across both sides, use tx_hash + order_hash as the key.