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 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, Ethereum, BNB Chain, Base, and more.

​
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 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 If you want one specific trade by transaction hash, use: Get Token Trade by Transaction If you want market-level stats like price, liquidity, and volume for the pair, use: Get Market Details

​
Walkthrough to Get Market Trades Pair

​
1. Prepare your query

The Market Trades Pair endpoint requires two parameters:
ParameterDescription
blockchainBlockchain name or ID (example: evm:1, evm:56, ethereum, bsc, base, solana)
addressSpecific 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 Market Trades Pair Demo UI Docs

​
Summary

The 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