Query Details
- You must provide either the
wallet
parameter or thewallets
parameter.
Parameter | Required | Description |
---|---|---|
wallet | Cond. | Single wallet address to query trades for. |
wallets | Cond. | Comma-separated list of wallet addresses to query trades for. |
from | Cond. | Start timestamp for trade filtering (Unix ms or ISO 8601). |
to | Cond. | End timestamp for trade filtering (Unix ms or ISO 8601). |
limit | Cond. | Number of results per page (default varies). |
offset | Cond. | Offset for pagination. |
page | Cond. | Page number for pagination. |
order | Cond. | Sort order: asc or desc (default desc ). |
Response Overview
Each item indata[]
represents a single swap involving the queried wallet:
- pool_address: AMM pool contract address where the swap happened
- token0_address / token1_address: The two pool token contract addresses
- base: Contract address of the base asset in the pool orientation
- quote: Contract address of the quote asset in the pool orientation
- amount_base: Signed amount of
base
transferred by the wallet (formatted with decimals) - amount_quote: Signed amount of
quote
transferred by the wallet (formatted with decimals) - side: Either
buy
orsell
relative to the base asset - transaction_hash: Transaction hash of the swap
- transaction_sender_address: Originating wallet address (the queried wallet)
- date: ISO date of the swap
- amount_usd: Trade notional in USD (best-effort; can be 0 for illiquid tokens)
- raw_amount0 / raw_amount1: Raw pool token deltas in smallest units
- amount0 / amount1: Formatted pool token deltas (can be negative or positive)
- price_usd_token0 / price_usd_token1: USD prices at execution time (best-effort)
- ratio: Trade price ratio (quote per base)
- base_token: Enriched details for the base token (id, name, symbol, decimals, price, etc.)
- labels: Wallet labels if available
base
and quote
are contract addresses, not symbols. They are derived from the pool and are stable across swaps for the same pool. Use amount_base
and amount_quote
to map to CEX schemas: size = abs(amount_base)
, quote_volume = abs(amount_quote)
, and price ≈ abs(amount_quote) / abs(amount_base)
.Amount signs follow the wallet perspective: positive means the wallet sent that token (outflow), negative means the wallet received it (inflow). Accordingly,
side
is sell
when amount_base > 0
, and buy
when amount_base < 0
. The cursor item is excluded from results when using cursor-based pagination in other endpoints.Usage Examples
- Query trades for a single wallet with limit and order:
- Query Trades for Multiple Wallets with Limit and Descending Order
Sample Response Item
Query Parameters
Response
200 - application/json
Wallet Trades response