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=842NwDnKYcfMRWAYqsD3hoTWXKKMi28gVABtmaupFcnS&tx_type=swap&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:

KeyData TypeDetailsExample
addressstringThe address of the pair for which transactions are fetched"842NwDnKYcfMRWAYqsD3hoTWXKKMi28gVABtmaupFcnS"
offsetintegerThe offset from which to start fetching transaction data0
limitintegerThe maximum number of transactions to return in the response50
tx_typestringThe type of transactions to filter by"swap"
sort_typestringThe order in which transactions should be sorted"desc"

Example Request:

curl --request GET \
     --url 'https://public-api.birdeye.so/defi/txs/pair?address=842NwDnKYcfMRWAYqsD3hoTWXKKMi28gVABtmaupFcnS&tx_type=swap&sort_type=desc' \
     --header 'X-API-KEY:c2d6c8d2a892b39c0514'

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

Response format

Data TypeDetailsDescription
successbooleanIndicates whether the request was successful
dataobjectContains the items array and pagination information
itemsarrayAn array of transactions. Each transaction is detailed
hasNextbooleanIndicates whether there are more records to fetch

Example Response:

{
  "data": {
    "items": [
      {
        "txHash": "WuKNTaWYuk18K2WFkwcUR2FosNdeY6h9AvX4U93Tt1fsZ9pHNmyT2c3L5RpCMqVqQmThLJhxmdBXzWqi4YdoGXC",
        "source": "raydium",
        "blockUnixTime": 1714116459,
        "address": "842NwDnKYcfMRWAYqsD3hoTWXKKMi28gVABtmaupFcnS",
        "owner": "3jHUxMz7XprojdWFx6RgNzpMmcznUcKSUaKxgyGv3WaW",
        "from": {
          "symbol": "SOL",
          "decimals": 9,
          "address": "So11111111111111111111111111111111111111112",
          "amount": 93000000,
          "type": "transfer",
          "typeSwap": "from",
          "uiAmount": 0.093,
          "price": null,
          "nearestPrice": 144.26075569403358,
          "changeAmount": -93000000,
          "uiChangeAmount": -0.093
        },
        "to": {
          "symbol": "TOM",
          "decimals": 9,
          "address": "2rJSfgxoWP7h3rw3hDUF7HPToY3exb6FdH9xFBg7TeQk",
          "amount": 265575905341,
          "type": "transfer",
          "typeSwap": "to",
          "feeInfo": null,
          "uiAmount": 265.575905341,
          "price": 0.05051757335560479,
          "nearestPrice": 0.050266916041458554,
          "changeAmount": 265575905341,
          "uiChangeAmount": 265.575905341
        }
      }
    ],
    "hasNext": true
  },
  "success": true
}

Transaction Detail

Each transaction within the items array may contain:

txHash: The hash identifier of the transaction.
source: The platform or service where the transaction occurred.
blockUnixTime: The Unix timestamp denoting when the transaction was recorded on the blockchain.
from and to: Objects detailing the transaction's source and destination addresses, amounts, symbols, and other relevant metadata.

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).