Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mobula.io/llms.txt

Use this file to discover all available pages before exploring further.

The Get Wallet Trades endpoint returns a clean list of swap trades for one wallet or multiple wallets across chains like Solana, Ethereum, Base, and more, with time range filtering, ordering, and pagination. It is ideal for developers building trading history views, wallet analytics dashboards, copy trading tools, and on-chain trader profiling.

​
What this endpoint does

With this API, you can:
  • Fetch swap trades for a single wallet or multiple wallets combined
  • Filter trades by a specific time window using from and to
  • Paginate results using page or offset
  • Control result size with limit
  • Sort trades using order=asc or order=desc
  • Get enriched trade context including:
    • pool and token addresses
    • buy/sell side
    • USD notional (best effort)
    • trade ratio and execution pricing (best effort)
    • enriched base token data (market and liquidity stats)
    • wallet labels and platform identifier when available
Unlike wallet activity feeds, this endpoint is focused specifically on swap trades.

​
What you’ll need

  • Basic knowledge of REST APIs
  • A wallet address (or multiple wallet addresses)
  • A Mobula API key
Note: All Mobula endpoints require an API key.
Get a free API key: Here Optional:
  • DexScreener (to find active wallets that are actively trading)

​
When to use Get Wallet Trades

Use this endpoint when you want to:
  • Build a wallet’s swap trade history (buy and sell activity)
  • Analyze trade frequency, trade sizes, and token rotation
  • Power trading analytics dashboards (volume, count, average sizing)
  • Support copy trading and trader profiling workflows
  • Pull wallet swap trades in a specific time range for research or alerts
If you need transfers, vault actions, and swap detection in one feed, use wallet/activity.
If you need wallet token balances and PnL, use wallet/positions.

​
Walkthrough — Get Wallet Trades for a Wallet

​
1. Prepare your query

You can provide either single or multiple wallets to analyse one or more wallets.
ParameterDescription
walletSingle wallet address to query trades for
walletsComma-separated list of wallet addresses to query trades for
Optional parameters you can use to control output:
  • from: start timestamp (Unix ms or ISO 8601)
  • to: end timestamp (Unix ms or ISO 8601)
  • limit: number of results per page
  • page: page number for pagination
  • offset: offset for pagination
  • order: asc or desc (default is desc)
Tip: use from and to when you want trades for a specific period instead of the wallet’s full history.

​
2. Find a wallet address to test

To retrieve real wallet data:
  1. Open DexScreener
  2. Search for any token
  3. Open the Top Traders section
  4. Select an active wallet
  5. Open it in a block explorer
  6. Copy the wallet address
This address is used as the wallet parameter.

​
3. Set your time range (optional)

If you want to restrict results:
  • Fill from and to with Unix ms timestamps or ISO 8601 dates
This is useful for:
  • “last 24 hours” trade history
  • weekly performance checks
  • event-based analysis

​
4. Fill the API form

Once the wallet field is filled (and optional time range / pagination is set), click Send to retrieve the wallet’s swap trades data.

​
Reviewing the wallet trades response

Each item in data[] represents a single swap trade involving the queried wallet. Key fields you will typically use:
  • Trade identity: transaction_hash, date, chain_id, pool_address
  • Pair details: token0_address, token1_address, base, quote
  • Direction: side is buy or sell relative to the base token
  • Sizing: amount_base, amount_quote (returned as absolute positive values)
  • USD value: amount_usd (best effort, can be 0 for illiquid tokens)
  • Execution context: ratio, price_usd_token0, price_usd_token1 (best effort)
  • Enrichment: base_token includes token stats (price, liquidity, volume, market cap, and more)
  • Context: labels (if available), platform (if available)
Note: amounts are returned as absolute values for easier consumption. Use side to interpret direction.

​
Try It Live with Mobula Wallet Trades Demo (UI)

You can also test this endpoint using our demo UI: Demo UI Homepage Wallet Trades Demo UI Docs

​
Summary

The Get Wallet Trades endpoint helps you build swap-focused trading history and analytics with:
  • Single wallet or multi-wallet support
  • Time range filtering (from, to)
  • Pagination controls (page, offset, limit)
  • Buy/sell direction via side
  • Enriched token context via base_token
  • Optional wallet labels and platform tags
If you’re building trading dashboards, trader profiling, or copy trading tooling, this endpoint is a strong foundation.

​
Try Mobula for Free

Try our free API today and start building in minutes.
Get your free API key: Here