Skip to main content
GET
SDK
One wallet’s trades of a token in one pool. A wallet matches the trades it owns and the trades it paid the fee for. Compare owner and feePayer to tell them apart. Each trade has its signature, its exact position on chain (slot, txIndex, swapIndex), USD and SOL prices, market cap and the trader (wallet, with owner and feePayer). Full pages add both legs with exact raw amounts and the owner’s balance change, fees and tips, compute and route. Each mint on the page is listed once in tokens, each pool once in pools and each known wallet once in wallets. A page can come back short or even empty with hasNextPage: true. Keep following nextCursor until hasNextPage is false.

SDK Example

Authorizations

x-api-key
string
header
required

API Key for authentication

Path Parameters

token
string
default:6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN
required

Token mint address.

pool
string
default:9d9mb8kooFfaD3SctgZtkxQypkshx6ezhbKio89ixyy2
required

Pool address.

wallet
string
default:F7R61te4Ac8xZ4pfkJUdF6iaaHy9tnM8nVRUPv8H8EMi
required

Wallet address.

Query Parameters

limit
integer
default:100

Trades per page, up to 500. Default 100.

Required range: 1 <= x <= 500
cursor
string

nextCursor of the previous page, unchanged. Keep the other parameters the same between pages. Cursors from the /trades routes do not work here.

sortDirection
enum<string>
default:DESC

DESC for newest first (default) or ASC for oldest first.

Available options:
DESC,
ASC
time_from
integer

Only trades at or after this time, in Unix seconds.

time_to
integer

Only trades at or before this time, in Unix seconds. A time_to before time_from returns 400.

fields
enum<string>
default:full

basic returns lighter pages: trades without from, to, fees, compute and route, no pools or wallets map, and only name, symbol, decimals, image and supply in tokens.

Available options:
full,
basic
enrich
enum<string>

With fields=basic, identity adds the wallets map. Full pages always include it.

Available options:
identity
arbitrage
boolean
default:false

Adds an arbitrage array next to trades: arbitrage transactions through this token (and the pool or wallet of the route) in the slots the page's trades span. Consecutive pages cover those slots with no gap or overlap unless arbitrageComplete is false. Arbitrage is never in trades or in volume.

Response

A page of trades.

trades
object[]
required
tokens
object
required

Each mint on the page, once, by mint address: the traded tokens and their quote tokens.

nextCursor
string | null
required

Pass as cursor for the next page. Null when there is none.

hasNextPage
boolean
required

A page can be short or empty and still have a next page.

sortDirection
enum<string>
required
Available options:
DESC,
ASC
pools
object

The page's pools, by pool address. Left out with fields=basic.

wallets
object

Known wallets on the page, by the wallet field of each trade. With fields=basic, only with enrich=identity.

arbitrage
object[]

Only with arbitrage=true: arbitrage through the token in the slots the page's trades span, in the page's order, at most 500. Each leg carries its own decimals.

arbitrageComplete
boolean

Only with arbitrage=true. False when the search stopped early or failed.

arbitrageFromSlot
integer | null

Only with arbitrage=true. Lowest slot searched.

arbitrageToSlot
integer | null

Only with arbitrage=true. Highest slot searched. Null on the first page of a DESC request.