Skip to main content
The 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, Ethereum, BNB Chain, Base, and more.

​
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 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 If you need full wallet activity feeds, use: Get Wallet Activity

​
Walkthrough to Get Token Trades

​
1. Prepare your query

ParameterDescription
blockchainBlockchain identifier (example: base, ethereum, bsc)
addressToken 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 Token Trades Demo UI Docs

​
Summary

The 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