Skip to main content
GET
Swap history for a trader (with lifetime stats)

Authorizations

X-API-Key
string
header
required

Preferred for swaps-api endpoints (/swaps/*, /stats/*, /trending, /pool-events).

Path Parameters

wallet
string
required

Query Parameters

limit
integer
default:100

Maximum swaps per page. A full page can hold a few more than this: it always ends on a whole group of swaps that share one timestamp and slot, so paging with cursor never skips one.

Required range: 1 <= x <= 1000
offset
integer
default:0

Not supported on this route: any value above 0 returns 400. Page with cursor instead.

Required range: x >= 0
cursor
string

Keyset cursor, <ts_ms>:<slot>. Pass the previous response's next_cursor to get the next, older page; omit it for the newest page. A malformed value returns 400.

Pattern: ^[0-9]+:[0-9]+$
Example:

"1790201347000:449834465"

Response

Trader swaps + stats

trader
string
swaps
object[]
stats
object

Lifetime stats for a wallet across all pools and DEXs.

price_semantics
string

A short, machine-readable note on how the price fields in this response are derived. Emitted on every response so a client never has to infer it from the docs. Treat it as informational text, not a stable enum — the wording may change as derivations change.

next_cursor
string

Pass as cursor to get the next page. Present whenever this page is full, and absent once a page reaches the end of the history. The page after the last full page can be empty.