> ## 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.

# How to Track Wallet Swap Trades Across Ethereum, Solana, BNB, Base & More

> Easily retrieve swap trades executed by a wallet using the Mobula API.

The [**Get Wallet Trades**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-trades) endpoint returns a clean list of swap trades for one wallet or multiple wallets across chains like [Solana](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum), [Base](https://docs.mobula.io/blockchains/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.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/bsOV170yDIo" title="YouTube video player" style={{ position: 'absolute', top: 0, left: 0, width: '100%', height: '100%', border: 0 }} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowFullScreen />
</div>

***

## 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](https://admin.mobula.io/)

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**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-activity).\
If you need wallet token balances and PnL, use [**wallet/positions**](https://docs.mobula.io/rest-api-reference/endpoint/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.

| Parameter | Description                                                  |
| --------- | ------------------------------------------------------------ |
| `wallet`  | Single wallet address to query trades for                    |
| `wallets` | Comma-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](https://mobula-demo-endpoint-production.up.railway.app/)

[Wallet Trades Demo UI](https://mobula-demo-endpoint-production.up.railway.app/wallet-trades)

[Docs](https://docs.mobula.io/rest-api-reference/endpoint/wallet-trades)

***

## Summary

The [**Get Wallet Trades**](https://docs.mobula.io/rest-api-reference/endpoint/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](https://admin.mobula.io/)