> ## 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 Token Trades Across Ethereum, Solana, BNB, Base & More

> Use the Token Trades endpoint to retrieve recent trades for a specific token or pool.

The [**Token Trades**](https://docs.mobula.io/rest-api-reference/endpoint/token-trades) endpoint lets you retrieve recent trades for a specific token or pool.

This makes it easy to monitor live trading activity across chains like [Solana](https://docs.mobula.io/blockchains/solana), [Ethereum](https://docs.mobula.io/blockchains/ethereum), [BNB Chain](https://docs.mobula.io/blockchains/bsc), [Base](https://docs.mobula.io/blockchains/base), and more.

***

<div style={{ position: 'relative', paddingBottom: '56.25%', height: 0, overflow: 'hidden' }}>
  <iframe src="https://www.youtube.com/embed/UovMMVJ380M" 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:

* Retrieve trades for a specific token or pool with pagination
* Query trades using two modes:
  * **pair**: query trades for a specific pool or pair address
  * **asset**: query trades across top pools for a token asset
* Filter results by swap types, wallet labels, sender addresses, date range, and USD amount
* Return detailed trade fields, including the market address, token amounts, prices, and fees

***

## What you’ll need

Note: All Mobula endpoints require an API key.\
Get a free API key: [Here](https://admin.mobula.io/)

Optional:

* DexScreener (to find token addresses and active traders)

***

## When to use Token Trades

Use Token Trades when you want to:

* Track recent buys and sells for a token or a specific pool
* Filter trades by swap type like regular, deposit, or withdrawal
* Investigate activity from specific wallets using sender address filters
* Monitor large trades using minimum and maximum USD amount filters
* Paginate through trade history for analytics or dashboards

If you need wallet-level swap history, use: [**Get Wallet Trades**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-trades)

If you need full wallet activity feeds, use: [**Get Wallet Activity**](https://docs.mobula.io/rest-api-reference/endpoint/wallet-activity)

***

## Walkthrough to Get Token Trades

### 1. Prepare your query

| Parameter    | Description                                          |
| ------------ | ---------------------------------------------------- |
| `blockchain` | Blockchain identifier (example: base, ethereum, bsc) |
| `address`    | Token or pool address depending on mode              |

Optional parameters you can use:

* `mode`: pair (default) to query a specific pool, or asset to query trades across top pools for a token
* `limit`: Number of results per page (default: 10, max: 1000)
* `offset`: Offset for pagination (default: 0)
* `sortOrder`: asc or desc (default: desc)
* `swapTypes`: Filter by swap types (example: REGULAR, DEPOSIT, WITHDRAWAL)
* `transactionSenderAddresses`: Filter by transaction sender addresses (max: 25)
* `label`: Filter by wallet label (example: PRO\_TRADER, SMART\_TRADER, FRESH\_TRADER, DEV)
* `minAmountUSD`: Minimum trade amount in USD
* `maxAmountUSD`: Maximum trade amount in USD
* `fromDate`: Start date filter (ISO 8601 or Unix timestamp)
* `toDate`: End date filter (ISO 8601 or Unix timestamp)

### 2. Find a wallet address to test

To retrieve real token trade activity:

* Open DexScreener
* Pick a token
* Click **Top Traders**
* Select an active wallet
* Open it in the blockchain explorer
* Copy the wallet address

This address is useful when filtering by sender addresses.

### 3. Fill the API form

Once your blockchain and token or pool address are ready:

* Enter the blockchain value (example: solana, ethereum, base)
* Paste the token or pool address into the `address` field
* (Optional) set swapTypes, labels, or USD size filters
* Click **Send** to retrieve the token trades

***

## Reviewing the response

Each item in data\[] represents a single trade:

* `id`: Unique swap identifier for the trade
* `operation`: Swap operation type such as regular, deposit, or withdrawal
* `type`: Trade direction like buy or sell
* `baseTokenAmount` / `quoteTokenAmount`: Token amounts traded in formatted units
* `baseTokenAmountUSD` / `quoteTokenAmountUSD`: USD value for each side of the trade
* `date`: Trade timestamp in milliseconds
* `transactionHash`: On-chain transaction hash
* `marketAddress`: Pool or market address where the trade occurred
* `swapSenderAddress`: Address that executed the swap
* `transactionSenderAddress`: Transaction originator address (tx.from)
* `swapRecipient`: Wallet that receives the output tokens
* `baseTokenPriceUSD` / `quoteTokenPriceUSD`: Token prices at execution time
* `labels`: Wallet labels attached to the swap participant
* `totalFeesUSD`: Total fees paid in USD, including gas, platform, and MEV fees

***

## Try It Live with Mobula Token Trades Demo (UI)

[Demo UI Homepage](https://mobula-demo-endpoint-production.up.railway.app/)

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

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

***

## Summary

The [**Token Trades**](https://docs.mobula.io/rest-api-reference/endpoint/token-trades) endpoint helps you:

* Retrieve recent token or pool trades with pagination
* Filter trades by swap type, wallet labels, sender addresses, date range, and USD amount
* Use swapRecipient when available for accurate wallet attribution
* Visualize trades instantly in the demo UI

***

## Try Mobula for Free

Try our free API today and start building in minutes.\
Get your free API key: [Here](https://admin.mobula.io/)