GET
/
getTransactions
Get Transactions
curl --request GET \
  --url https://api-v2.swaps.xyz/api/getTransactions \
  --header 'x-api-key: <api-key>'
{
  "txs": [
    {
      "statusMessage": "success",
      "sender": "0x1234567890123456789012345678901234567890",
      "srcChainId": 1,
      "dstChainId": 42161,
      "srcTxHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "dstTxHash": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "bridgeDetails": {
        "isBridge": true,
        "bridgeTime": 420,
        "txPath": [
          {
            "chainId": 1,
            "txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
            "timestamp": "1640995200000000000",
            "nextBridge": "layerZero"
          }
        ]
      },
      "txId": "0x49b1d3d38176e45864fd55500c6c1879ab318609e1ed0c8eb9abd818e6c811fd",
      "org": {
        "appId": "app_123",
        "affiliateId": "affiliate_123",
        "appFees": [
          {
            "recipient": "<string>",
            "token": "<string>",
            "amount": "<string>"
          }
        ]
      },
      "usdValue": 100.5,
      "srcTx": {
        "toAddress": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "chainId": 1,
        "value": "1000000000000000000n",
        "timestamp": "1640995200000000000",
        "paymentToken": {
          "name": "Ethereum",
          "symbol": "ETH",
          "decimals": 18,
          "amount": "1000000000000000000n",
          "address": "0x1234567890123456789012345678901234567890"
        }
      },
      "dstTx": {
        "toAddress": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "txHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "chainId": 1,
        "value": "1000000000000000000n",
        "timestamp": "1640995200000000000",
        "paymentToken": {
          "name": "Ethereum",
          "symbol": "ETH",
          "decimals": 18,
          "amount": "1000000000000000000n",
          "address": "0x1234567890123456789012345678901234567890"
        }
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 150,
    "totalPages": 6
  }
}

Authorizations

​
x-api-key
string
header
required

Limited demo key for API Playground: 5c951bc81da566bbd030ba8e20724063.

Query Parameters

​
appIds
string

Comma-separated list of your app IDs. By default, a request to this endpoint will return transactions across all appIds in your org. Each API key has a unique app ID. Multiple app IDs can exist within a single org ID.

Example:

"0x5344e5a7,0x5314e6a7"

​
walletAddress
string

Wallet address to filter transactions by user

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

​
chainIds
string

Comma-separated list of chain IDs to filter by

Example:

"1,42161,10"

​
page
integer
default:1

Page number for pagination

Required range: x >= 1
Example:

1

​
limit
integer
default:25

Number of results per page (max 500)

Required range: 1 <= x <= 500
Example:

25

​
period
enum<string>
default:allTime

Time period filter

Available options:
day,
week,
month,
allTime
Example:

"week"

​
startDate
string

Start date filter (Unix timestamp)

Example:

"1640995200"

​
endDate
string

End date filter (Unix timestamp)

Example:

"1672531200"

Response

200 - application/json

Transaction history response

The response is of type object.