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 (determined by baseQuote)
- quote: Contract address of the quote asset in the pool orientation
- amount_base: Absolute (positive) amount of
base
token in the trade (formatted with decimals) - amount_quote: Absolute (positive) amount of
quote
token in the trade (formatted with decimals) - amount_base_raw: Absolute raw amount of base token in smallest units
- amount_quote_raw: Absolute raw amount of quote token in smallest units
- side: Either
buy
(wallet bought the base token) orsell
(wallet sold the base token) - 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 (can be negative or positive)
- 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
- base_token: Enriched details for the base token determined by baseQuote (includes id, name, symbol, decimals, price, volume, market cap, liquidity, and many other stats)
- labels: Wallet labels if available
All amounts (
amount_base
, amount_quote
, amount_base_raw
, amount_quote_raw
) are now returned as absolute (positive) values for easier consumption. The side
field indicates the direction of the trade relative to the base token.The
base_token
field always contains enriched data for the base token as determined by baseQuote logic, regardless of the trade direction (buy
or sell
).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