API Endpoint: /defi/txs/pair

Description: This endpoint provides a comprehensive list of token pair transactions, enabling users to monitor swaps and transfers involving specific token pairs on any networks we support. Transactions are ordered chronologically, and the endpoint supports pagination for easy navigation through the transaction history.

Request Method: GET

Data Coverage: Multi-chain

Request URL:

https://public-api.birdeye.so/defi/txs/pair?address=2QdhepnKRTLjjSqPL1PtKNwqrUkoLee5Gqs8bvZhRdMv&offset=0&limit=10&sort_type=desc

Request Headers:

accept: application/json
x-chain: any chains that Birdeye supports. Example: solana, ethereum
X-API-KEY: YOUR_API_KEY

Parameters:

  • address (string): The address of the token pair for retrieving transactions.
  • offset (integer): Offset for pagination (default is 0).
  • limit (integer): Number of transactions per request (maximum is 10).
  • sort_type (string): Sorting order for transactions (available values: desc, asc).

Response: The response includes a list of transaction items involving the specified token pair, each accompanied by transaction details and source information.

Example Request:

curl -X 'GET' \
  'https://public-api.birdeye.so/defi/txs/pair?address=2QdhepnKRTLjjSqPL1PtKNwqrUkoLee5Gqs8bvZhRdMv&offset=0&limit=10&sort_type=desc' \
  -H 'accept: application/json' \
  -H 'x-chain: solana' \
  -H 'X-API-KEY: 061eef71caa947a3b82c8dbda8bbdf63'

Example Response:

{
  "data": {
    "items": [
      {
        "txHash": "4CWweAHNZBqxXMyZeivquMJmxcBks4LWNu3eRkMJyP8AZ5vzDvqbtaX866t5m6wbDJXgwVKHpNZqb73tuaVpPj5L",
        "source": "raydium_clamm",
        "blockUnixTime": 1692199029,
        "address": "2QdhepnKRTLjjSqPL1PtKNwqrUkoLee5Gqs8bvZhRdMv",
        "owner": "FSduwbdC1cgtVV7ovQFYt3WrVqym2GxC6b9X7ERaFzG9",
        "from": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": 1000000000,
          "type": "transfer",
          "typeSwap": "from",
          "uiAmount": 1,
          "price": null,
          "nearestPrice": 23.219604548282,
          "changeAmount": -1000000000,
          "uiChangeAmount": -1
        },
        "to": {
          "symbol": "USDC",
          "decimals": 6,
          "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "amount": 23220666,
          "type": "transfer",
          "typeSwap": "to",
          "feeInfo": null,
          "uiAmount": 23.220666,
          "price": null,
          "nearestPrice": 1.0001,
          "changeAmount": 23220666,
          "uiChangeAmount": 23.220666
        }
      },
      {
        "txHash": "4aF96yHVgHL1KH65TLrRgMBc7uJ95oUAmMV5dZQFqd3BeU72pKbaiLvYR7rS6rLzTEzJnRbs4JUzo6QHTJc52nPk",
        "source": "raydium_clamm",
        "blockUnixTime": 1692199029,
        "address": "2QdhepnKRTLjjSqPL1PtKNwqrUkoLee5Gqs8bvZhRdMv",
        "owner": "FSduwbdC1cgtVV7ovQFYt3WrVqym2GxC6b9X7ERaFzG9",
        "from": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": 2000000000,
          "type": "transfer",
          "typeSwap": "from",
          "uiAmount": 2,
          "price": null,
          "nearestPrice": 23.219604548282,
          "changeAmount": -2000000000,
          "uiChangeAmount": -2
        },
        "to": {
          "symbol": "USDC",
          "decimals": 6,
          "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
          "amount": 46442080,
          "type": "transfer",
          "typeSwap": "to",
          "feeInfo": null,
          "uiAmount": 46.44208,
          "price": null,
          "nearestPrice": 1.0001,
          "changeAmount": 46442080,
          "uiChangeAmount": 46.44208
        }
      }
    ],
    "hasNext": true
  },
  "success": true
}

Note: Replace the address parameter in the request URL with the actual address of the token pair you want to inquire about. The sort_type parameter determines the sorting order for transactions (descending or ascending).