List a wallet's swaps
Returns the wallet's settled swaps on Uniswap V4, 1inch Aqua, Orca and Raydium, newest first on every chain, with what it paid and received. Send `venue` or `chainId` to narrow it.
Authorization
ApiKeyAuth Your API key. Authorizing a swap or opening a market takes a key issued to your integration, and the shared key the docs fill in reads and quotes only.
In: header
Path Parameters
The wallet to read: a 0x address, or a base58 address on Solana.
Query Parameters
Only swaps on this chain. When omitted, every EVM chain answers for a 0x wallet, and Solana for a base58 wallet.
Rows per page, 1 to 200, default 50. Outside that range is a 400.
The previous page's nextCursor. A block timestamp in seconds also works and returns the rows older than it.
Only swaps on this venue, by its short id: v4, aqua, orca or raydium. The default all lists every venue.
Response Body
application/json
application/json
curl -X GET "https://example.com/api/swap/history/string"{ "wallet": "0x4444444444444444444444444444444444444444", "swaps": [ { "venue": "aqua", "id": "8453:0xbb1690feb82f6cbd9b3124c247bdf7603d04df1bec999da893242842cd2dc0b8:0x02eddcb2925b96845fec441d9d891ef11cfa1a350d5b1b1b3891ba753bf4e5ec", "chainId": 8453, "timestamp": 1791929269, "transactionHash": "0xbb1690feb82f6cbd9b3124c247bdf7603d04df1bec999da893242842cd2dc0b8", "orderHash": "0x02eddcb2925b96845fec441d9d891ef11cfa1a350d5b1b1b3891ba753bf4e5ec", "tokenIn": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amountIn": "1000000", "tokenOut": "0x4200000000000000000000000000000000000006", "amountOut": "398201755233761" }, { "venue": "v4", "id": "0xa06fbf084c33e181b1b8de07db6dc50f532716a1e8ed377b77c0f77b309a918e", "swapId": "0xa06fbf084c33e181b1b8de07db6dc50f532716a1e8ed377b77c0f77b309a918e", "chainId": 8453, "poolId": "0x5622e547d200169623684248c4e4ac258688aea6dd540acf5fb26965861e8639", "token0": "0x4200000000000000000000000000000000000006", "delta0": "-395205934230333", "token1": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "delta1": "999998", "timestamp": 1791928849, "transactionHash": "0x1bafb8940361a1f555e2105aa42d9b09cca8d5fe1b376758ed675914a42b8fb2", "settled": true, "tokenIn": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "amountIn": "999998", "tokenOut": "0x4200000000000000000000000000000000000006", "amountOut": "395205934230333" } ], "nextCursor": null}{ "error": "string", "code": "string", "message": "string", "details": {}, "requestId": "string"}Authorize a Uniswap V4 swap
Returns a signed authorization that adds Aqua0 liquidity to a Uniswap V4 pool for exactly this swap, passed to the router with the swap. It takes an API key issued to your integration, and the shared and docs keys are refused.
Build a swap transaction
Quotes the route you picked again and returns the transaction for the trader's wallet, with any token approvals first, on Uniswap V4, 1inch Aqua, Orca and Raydium. It takes an API key issued to your integration, and the shared and docs keys are refused.