Wallet History

The Wallet History API allows you to retrieve all cross-chain transaction records associated with a specific wallet address. This provides a comprehensive view of a user's historical interactions with

API Endpoint

Method	Endpoint
GET	https://v2.api.squidrouter.com/v2/history/wallet

Parameters

Parameter	Type	Required	Description
address	string	Yes	The EVM or Cosmos wallet address to query.
x-integrator-id	header	Yes	Your unique integrator ID. Requests count toward your Rate Limit (RPS).

Key Features

• Global History: Returns all transactions associated with the wallet across all integrators.

• Time Range: Returns history for the last 3 months.

• No Pagination: This endpoint returns the full result set in a single response.

Example Request

curl --location 'https://v2.api.squidrouter.com/v2/history/wallet?address=ADD_ADDRESS_HERE' \
--header 'x-integrator-id: your-integrator-id'

const getWalletHistory = async (address, integratorId) => {
  try {
    const result = await axios.get("https://v2.api.squidrouter.com/v2/history/wallet", {
      params: { address },
      headers: { "x-integrator-id": integratorId },
    });
    return result.data;
  } catch (error) {
    console.error("Error fetching history:", error.response?.data || error.message);
    throw error;
  }
};

Example Response

[
    {
        "transactionId": "0x081e2b20246ce3a6798e617b12e9bbe45d4487441cfab6273422dbd69f56c501",
        "bridgeType": "rfq",
        "createdAt": "2026-01-13T22:41:03.988Z",
        "fromChainId": "999",
        "quote": {
            "route": {
                "estimate": {
                    "fromAmount": "3916444925567914",
                    "toAmount": "90851975792151072",
                    "fromAmountUSD": "0.09",
                    "toAmountUSD": "0.09",
                    "fromToken": {
                        "address": "0x5555555555555555555555555555555555555555",
                        "chainId": "999",
                        "decimals": 18,
                        "logoURI": "https://raw.githubusercontent.com/0xsquid/assets/main/images/tokens/whype.svg",
                        "name": "Wrapped HYPE",
                        "symbol": "WHYPE",
                        "coingeckoId": "wrapped-hype",
                        "usdPrice": 25.169077678,
                        "type": "evm"
                    },
                    "toToken": {
                        "address": "0x55d398326f99059ff775485246999027b3197955",
                        "chainId": "56",
                        "decimals": 18,
                        "logoURI": "https://raw.githubusercontent.com/0xsquid/assets/main/images/tokens/usdt.svg",
                        "name": "USDT",
                        "symbol": "USDT",
                        "coingeckoId": "tether",
                        "usdPrice": 0.9998056774098082,
                        "type": "evm"
                    },
                    "estimatedRouteDuration": 10
                }
            }
        },
        "quoteId": "bb398cb754d3015474ad673658845af1",
        "statusResponse": {
            "id": "0x081e2b20246ce3a6798e617b12e9bbe45d4487441cfab6273422dbd69f56c501",
            "status": "success",
            "squidTransactionStatus": "success",
            "transactionUrl": "https://hyperevmscan.io/tx/0x081e2b20246ce3a6798e617b12e9bbe45d4487441cfab6273422dbd69f56c501"
        },
        "toChainId": "56",
        "updatedAt": "2026-01-13T22:41:03.988Z",
        "totalFeesUSD": 0.008399678805983213
    }
]