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

> Use the Market Trades Pair endpoint to retrieve recent trade history for a specific trading pair or pool, with filtering, sorting, and pagination.

The [**Market Trades Pair**](https://docs.mobula.io/rest-api-reference/endpoint/market-trades-pair) endpoint lets you retrieve recent trade history for a specific trading pair or pool.

You can query directly by pair address, or resolve the most active pair linked to a token.

This is useful for building market activity views with normalized pricing and volume metrics 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/nVqaMMMU3bA" 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 recent trade history for a specific trading pair or pool
* Resolve the most active pair linked to a token when querying by `asset` mode
* Return normalized pricing and volume metrics per trade record
* Support pagination and sorting, plus optional filtering by minimum amount and sender

***

## What you’ll need

* Basic knowledge of REST APIs
* A pair or pool address
* 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 pair addresses to test)

***

## When to use Market Trades Pair

Use this endpoint when you want to:

* Display recent trades for a specific pair or pool
* Build a live feed of buys and sells for a market
* Filter trades by minimum USD size using `amount`
* Sort trades by date or amount and paginate results
* Investigate trades from a specific initiator address using `transactionSenderAddress`

If you want token-level trades (not pair-specific), use: [**Get Token Trades**](https://docs.mobula.io/rest-api-reference/endpoint/token-trades)

If you want one specific trade by transaction hash, use: [**Get Token Trade by Transaction**](https://docs.mobula.io/rest-api-reference/endpoint/token-trade)

If you want market-level stats like price, liquidity, and volume for the pair, use: [**Get Market Details**](https://docs.mobula.io/rest-api-reference/endpoint/market-details)

***

## Walkthrough to Get Market Trades Pair

### 1. Prepare your query

The Market Trades Pair endpoint requires two parameters:

| Parameter    | Description                                                                             |
| ------------ | --------------------------------------------------------------------------------------- |
| `blockchain` | Blockchain name or ID (example: `evm:1`, `evm:56`, `ethereum`, `bsc`, `base`, `solana`) |
| `address`    | Specific pair or pool contract address to query trades for                              |

Optional parameters you can use:

* `mode`: Query mode. Common values include `pair` or `asset` (default is `pair`)
* `asset`: Asset name or token contract address to resolve the most active pair automatically (used with `mode=asset`)
* `symbol`: Token ticker symbol as an alternative to `asset`
* `limit`: Maximum number of trade records to return
* `offset`: Pagination offset (default: `0`)
* `amount`: Minimum trade amount filter
* `sortBy`: Field to sort by (example: `amount_usd`, `date`)
* `sortOrder`: Sort order `asc` or `desc` (default: `desc`)
* `transactionSenderAddress`: Filter trades initiated by a specific transaction sender address

Tip: If you use `mode=asset`, you can provide `asset` (or `symbol`) and the endpoint will resolve it to the most active pair automatically.

### 2. Find a pair address to test with DexScreener

To get a real pair address:

* Open DexScreener
* Pick a token
* Open one of its pairs
* Copy the pair or pool contract address

This address is used as the `address` parameter.

### 3. Fill the API form

Once your pair address is ready:

* Enter `blockchain`
* Paste the pair address into `address`
* (Optional) set `limit`, `offset`, `amount`, `sortBy`, `sortOrder`, or `transactionSenderAddress`
* Click **Send**…

***

## Reviewing the response

Each item in `data[]` represents a trade record and typically includes:

* `blockchain`: Chain where the trade happened
* `hash`: On-chain transaction hash
* `pair`: Pair or pool address
* `date`: Trade timestamp
* `type` / `operation`: Trade direction and operation type (buy, sell, swap, etc.)
* Token prices: price fields for the quoted token and USD pricing when available
* Amounts: amounts in raw units, token units, and USD equivalent
* Sender fields: swap sender and transaction initiator address fields
* `platform`: Platform or aggregator used (example: axiom, gmgn, padre, trojan, universalX) when available
* Fee breakdown: `totalFeesUSD`, `gasFeesUSD`, `platformFeesUSD`, `mevFeesUSD` when available

***

## Try It Live with Mobula Market Trades Pair Demo (UI)

You can also test this endpoint using our demo UI:

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

[Market Trades Pair Demo UI](https://mobula-demo-endpoint-production.up.railway.app/market-trades-pair)

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

***

## Summary

The [**Market Trades Pair**](https://docs.mobula.io/rest-api-reference/endpoint/market-trades-pair) endpoint helps you:

* Retrieve recent trade history for a specific pair or pool using `blockchain` and `address`
* Optionally resolve the most active pair linked to a token using `mode=asset`
* Filter, sort, and paginate trade records for market activity dashboards
* Visualize results instantly in the Market Trades Pair 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/)