Skip to main content
GET
/
1
/
wallet
/
trades
Get Wallet Trades
curl --request GET \
  --url https://explorer-api.mobula.io/api/1/wallet/trades
{
  "data": [
    {
      "chain_id": "<string>",
      "swap_type": "<string>",
      "raw_amount0": "<string>",
      "raw_amount1": "<string>",
      "amount0": 123,
      "amount1": 123,
      "ratio": 123,
      "price_usd_token0": 123,
      "price_usd_token1": 123,
      "date": "<string>",
      "amount_usd": 123,
      "pool_address": "<string>",
      "token0_address": "<string>",
      "token1_address": "<string>",
      "transaction_sender_address": "<string>",
      "transaction_hash": "<string>",
      "base": "<string>",
      "quote": "<string>",
      "side": "<string>",
      "amount_quote": 123,
      "amount_base": 123
    }
  ]
}

Query Details

  • You must provide either the wallet parameter or the wallets parameter.
ParameterRequiredDescription
walletCond.Single wallet address to query trades for.
walletsCond.Comma-separated list of wallet addresses to query trades for.
fromCond.Start timestamp for trade filtering (Unix ms or ISO 8601).
toCond.End timestamp for trade filtering (Unix ms or ISO 8601).
limitCond.Number of results per page (default varies).
offsetCond.Offset for pagination.
pageCond.Page number for pagination.
orderCond.Sort order: asc or desc (default desc).

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
  • 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 or sell 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:
curl -X GET "https://explorer-api.mobula.io/api/1/wallet/trades?wallet=0x1234abcd5678efgh&limit=10&order=desc"
  • Query Trades for Multiple Wallets with Limit and Descending Order
curl -X GET "explorer-api.mobula.io/api/1/wallet/trades?wallets=0xaF88370abD82EC6943cdB3D4ec7b764B92c35B43&limit=10&order=desc"

Sample Response Item

{
  "chain_id": "evm:8453",
  "swap_type": "REGULAR",
  "raw_amount0": "-1200000000",
  "raw_amount1": "3500000000000000000000",
  "amount0": -1200,
  "amount1": 3500,
  "ratio": 2.9166666667,
  "price_usd_token0": 1.0,
  "price_usd_token1": 0.000342,
  "date": "2025-08-01T12:34:56.000Z",
  "amount_usd": 1200.0,
  "pool_address": "0xPool...",
  "token0_address": "0xToken0...",
  "token1_address": "0xToken1...",
  "transaction_sender_address": "0xWallet...",
  "transaction_hash": "0xTx...",
  "base": "0xBaseToken...",
  "quote": "0xQuoteToken...",
  "side": "buy",
  "amount_quote": -1200,
  "amount_base": 3500,
  "base_token": { "symbol": "BASE", "decimals": 18, "price": 0.000342 },
  "labels": ["smart-money"]
}

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