Skip to main content
GET
Get Wallet Trades
This endpoint is deprecated. Please migrate to GET /2/wallet/trades which provides cleaner responses, built-in pagination, and token filtering. See the migration guide.

Query Details

  • You must provide either the wallet parameter or the wallets parameter.

Response Overview

Each item in data[] 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) or sell (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)
  • raw_pre_balance0 / raw_pre_balance1: Pre-swap raw balances of pool tokens (nullable)
  • raw_post_balance0 / raw_post_balance1: Post-swap raw balances of pool tokens (nullable)
  • labels: Wallet labels if available
  • walletMetadata: Enriched wallet metadata (entity name, logo, labels) from known wallets database. null if not available.
  • platform: Trading platform/aggregator metadata. Object with id, name, logo fields. null if not available.
  • totalFeesUSD: Total fees paid in USD (sum of gas, platform, and MEV fees)
  • gasFeesUSD: Gas fees paid in USD
  • platformFeesUSD: Platform/aggregator fees paid in USD
  • mevFeesUSD: MEV/priority fees paid in USD
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

limit
string
default:100
offset
string
default:0
page
string
default:1
order
string
wallet
string
wallets
string
from
string
to
string

Response

200 - application/json

Wallet Trades response

data
object[]
required