> ## 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. # Get Pair Trades > Retrieve recent trade history for a specific trading pair or the most active pair linked to a token, with normalized pricing and volume metrics. ### Query Details * For a specific pool: provide its **pair/pool contract address** in the `address` field. * For an asset: use the [Market Asset Query](/rest-api-reference/docs/market-asset-query) format with the asset name or token address. The endpoint will resolve it to the most active pair. *** | Parameter | Type | Description | | -------------------------- | ------ | --------------------------------------------------------------------------------------------------------- | | `blockchain` | string | Blockchain name or ID, formatted as `"evm:1"` for Ethereum mainnet or `"evm:56"` for Binance Smart Chain. | | `asset` | string | Asset name or token contract address to resolve the most active pair automatically. | | `address` | string | Specific pair or pool contract address to query trades for. | | `symbol` | string | Token ticker symbol (optional alternative to asset). | | `limit` | number | Maximum number of trade records to return. | | `amount` | number | Minimum trade amount filter (optional). | | `sortBy` | string | Field to sort the results by (e.g., `amount_usd`, `date`). | | `sortOrder` | | Sort order: `"asc"` for ascending or `"desc"` for descending. | | `offset` | number | Pagination offset to skip a number of trade records. | | `mode` | | Mode of querying (e.g., `"asset"`, `"pair"`). | | `transactionSenderAddress` | string | Filter trades initiated by a specific transaction sender address. | ### Step-by-Step Tutorial and Video Walkthrough * Check out the guide: [Here](https://docs.mobula.io/guides/how-to-track-pair-trades-market-trades-pair) ​ ### Usage Examples * Query by Pool Address and Specific Sender Address ```bash theme={null} curl -X GET https://api.mobula.io/api/1/market/trades/pair?sortOrder=desc&mode=pair&address=0xc4ce8e63921b8b6cbdb8fcb6bd64cc701fb926f2&blockchain=ethereum&transactionSenderAddress=0x33e833f33ced917af1c2879faa95f375a2a66407 ``` ### Query Response Each trade record includes: * **Blockchain & transaction hash** * **Pair address** and timestamp * **Token prices** (quoted token and USD) * **Amounts** in raw units, token units, and USD equivalent * **Trade type & operation** (e.g., buy, sell, swap) * **Sender & transaction initiator addresses** * **Platform**: Trading platform/aggregator identifier (e.g., "axiom", "gmgn", "padre", "trojan", "universalX") or null if not available * **Fees breakdown**: `totalFeesUSD` (total), `gasFeesUSD`, `platformFeesUSD`, `mevFeesUSD` ## OpenAPI ````yaml get /1/market/trades/pair openapi: 3.0.0 info: version: 1.0.0 title: Mobula API description: >- Documentation of the Mobula API **Demo API**: The default server (demo-api.mobula.io) is a demo API with rate limits. For production use, please use api.mobula.io with an API key from https://admin.mobula.io servers: - url: https://demo-api.mobula.io/api/ description: Demo API (rate limited, for testing only) - url: https://api.mobula.io/api/ description: Production API (requires API key) security: [] tags: - name: V2 - Token description: Token details, price, security, ATH, and holder data - name: V2 - Market Data description: Market details, OHLCV history, and lighthouse metrics - name: V2 - Trades description: Token trades, enriched trades, and trade filters - name: V2 - Wallet description: Wallet positions, activity, trades, analysis, and labels - name: V2 - Assets description: Cross-chain asset details and price history - name: V2 - Swap description: Swap quoting and execution - name: V2 - Perps description: Perpetual futures quoting, execution, and positions - name: V2 - Bridge description: Cross-chain bridge quoting and intent status (Alpha Preview) - name: V2 - DeFi description: Bonding pools and pulse data - name: V2 - Search description: Universal fast search - name: V2 - Blockchains description: System metadata and chain listings - name: V1 - Market Data description: Market prices, history, sparklines, pairs, and multi-data - name: V1 - Wallet description: Wallet portfolio, transactions, history, and NFTs - name: V1 - Token description: First buyers - name: V1 - Trades description: Market trades by pair - name: V1 - Metadata description: Token metadata, categories, trendings, and news - name: V1 - Assets description: List all assets - name: V1 - Search description: Search for assets, tokens, and pairs - name: V1 - DeFi description: Bonding pool pulse data - name: V1 - Blockchains description: Blockchain listings, pairs, and stats - name: V1 - Webhooks description: Webhook management - name: V1 - Feed description: Custom feed creation paths: /1/market/trades/pair: get: tags: - V1 - Trades summary: Get market trades parameters: - schema: type: string required: false name: blockchain in: query - schema: type: string required: false name: asset in: query - schema: type: string required: false name: address in: query - schema: type: string required: false name: symbol in: query - schema: type: number nullable: true required: false name: limit in: query - schema: type: number nullable: true required: false name: amount in: query - schema: type: string required: false name: sortBy in: query - schema: type: string enum: - asc - desc default: desc required: false name: sortOrder in: query - schema: type: number nullable: true default: 0 required: false name: offset in: query - schema: type: string enum: - pair - pool - asset default: pair required: false name: mode in: query - schema: type: string required: false name: transactionSenderAddress in: query responses: '200': description: Market trades response content: application/json: schema: type: object properties: data: type: array items: type: object properties: blockchain: type: string hash: type: string pair: type: string date: type: number token_price_vs: type: number token_price: type: number token_amount: type: number token_amount_vs: type: number token_amount_usd: type: number type: type: string enum: - buy - sell - deposit - withdrawal sender: type: string nullable: true transaction_sender_address: type: string nullable: true token_amount_raw: type: string token_amount_raw_vs: type: string operation: type: string enum: - regular - mev - mev_sandwiched - deposit - withdrawal - bond platform: type: object nullable: true properties: id: type: string name: type: string logo: type: string nullable: true required: - id - name - logo totalFeesUSD: type: number nullable: true gasFeesUSD: type: number nullable: true platformFeesUSD: type: number nullable: true mevFeesUSD: type: number nullable: true required: - blockchain - hash - pair - date - token_price_vs - token_price - token_amount - token_amount_vs - token_amount_usd - type - sender - transaction_sender_address - token_amount_raw - token_amount_raw_vs - operation required: - data ````