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.

Authorization

X-API-Key<token>

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

venue*string

v4 to price or sign one Uniswap V4 pool.

poolId*string

The Uniswap V4 pool id, as 32-byte hex.

chainId*integer

The chain's numeric id, for example 8453 for Base.

token0*string

The pool's token0 (its currency0), as a 0x address.

token1*string

The pool's token1 (its currency1), as a 0x address.

swapDirection?string

zeroForOne sells token0 and oneForZero sells token1. Required on a quote, and zeroForOne when omitted on authorize.

fee?integer

Optional check of the pool's fee, in hundredths of a basis point. A different value is refused.

tickSpacing?integer

Optional check of the pool's tick spacing. A different value is refused.

requestedAmount0?string

The token0 amount of the trade, in the token's smallest unit, as a decimal string. tradeType says whether it is sold or bought.

requestedAmount1?string

The token1 amount of the trade, in the token's smallest unit, as a decimal string. tradeType says whether it is sold or bought.

devCustomData?string

Ignored.

trader?string

The wallet that sends the swap. Only the Aqua0 app's requests record it, and an API key's request ignores it.

classId?string

Optional. When sent, it must be the pool's own strategy id, the pool id read as a decimal number.

amountSpecified*string

The swap amount the signature binds, as a signed decimal string. Negative means exact in and positive exact out, and tradeType must agree.

sqrtPriceLimitX96*string

The swap's price limit, as a decimal uint160 string. The signature binds it.

tradeType?string

exactIn (the default) fixes the amount sold. exactOut fixes the amount bought, and a quote then caps the cost at the sold side, where 0 means no cap.

slippageBps?integer

Your slippage, in basis points from 0 to 10000, kept for the record. The swap's own amountOutMinimum is what protects the trader.

requestId?string

Your id for this request, 1 to 128 characters. Sending the same id and body again returns the same authorization until its deadline.

maxPriceImpactBps?integer

The most price impact you accept, in basis points from 0 to 1500, held against the quote's priceImpact.lossBps. A swap above it is refused with PRICE_IMPACT_ABOVE_MAX, and the default is 1500.

Response Body

`application/json`

curl -X POST "https://example.com/api/swap/authorize" \  -H "Content-Type: application/json" \  -d '{    "venue": "v4",    "poolId": "0x5622e547d200169623684248c4e4ac258688aea6dd540acf5fb26965861e8639",    "chainId": 8453,    "token0": "0x4200000000000000000000000000000000000006",    "token1": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",    "swapDirection": "oneForZero",    "fee": 3000,    "tickSpacing": 60,    "requestedAmount1": "1000000",    "trader": "0x4444444444444444444444444444444444444444",    "classId": "38960560214548620419581884607967218229413556116830054641371650059665611327033",    "amountSpecified": "-1000000",    "sqrtPriceLimitX96": "1461446703485210103287273052203988822378723970341",    "tradeType": "exactIn",    "slippageBps": 50  }'

{  "venue": "v4",  "authorization": {    "swapId": "0xa06fbf084c33e181b1b8de07db6dc50f532716a1e8ed377b77c0f77b309a918e",    "poolId": "0x5622e547d200169623684248c4e4ac258688aea6dd540acf5fb26965861e8639",    "classId": "38960560214548620419581884607967218229413556116830054641371650059665611327033",    "nonce": "42",    "deadline": "1791928909",    "executor": "0x6fF5693b99212Da76ad316178A184AB56D299b43",    "sqrtPriceStartX96": "3960994633772755407296098",    "signature": "0xfdcfefcac14c902f22d4bdd91a6f008c46604d3a62e3a8cb9ff441cdda630d171b69a0a113d67d234a56d6041e4a2c0a5d256daaadd516e26e8f7a762f9f07aa1b",    "ranges": [      {        "lp": "0x1111111111111111111111111111111111111111",        "position": 0,        "tickLower": -199140,        "tickUpper": -197100,        "liquidity": "1093427319265"      }    ]  },  "hookData": "0x02dfe74a2cb04a2c6a71d638e9f410dd0f3b846e3cf9c99f3239274c7fb4345b000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000002c0000000000000000000000000000000000000000000000000000000000000038000000000000000000000000000000000000000000000000000000000000002200000000000000000000000000000000000000000000000000000000000000020a06fbf084c33e181b1b8de07db6dc50f532716a1e8ed377b77c0f77b309a918e5622e547d200169623684248c4e4ac258688aea6dd540acf5fb26965861e86395622e547d200169623684248c4e4ac258688aea6dd540acf5fb26965861e86390000000000000000000000000000000000000000000000000000000000000000fffffffffffffffffffffffffffffffffffffffffffffffffffffffffff0bdc0000000000000000000000000fffd8963efd1fc6a506488495d951d5263988d250000000000000000000000000000000000000000000346c5f3090f523fa75662000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000006aceaa4d0000000000000000000000006ff5693b99212da76ad316178a184ab56d299b43000000000000000000000000444444444444444444444444444444444444444400000000000000000000000000000000000000000000000000000000000001800000000000000000000000000000000000000000000000000000000000000041fdcfefcac14c902f22d4bdd91a6f008c46604d3a62e3a8cb9ff441cdda630d171b69a0a113d67d234a56d6041e4a2c0a5d256daaadd516e26e8f7a762f9f07aa1b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000100000000000000000000000011111111111111111111111111111111111111110000000000000000000000000000000000000000000000000000000000000000fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffcf61cfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffcfe14000000000000000000000000000000000000000000000000000000fe9558d1e10000000000000000000000000000000000000000000000000000000000000000"}

{  "error": "string",  "code": "string",  "message": "string",  "details": {},  "requestId": "string"}

{  "error": "string",  "code": "string",  "message": "string",  "details": {},  "requestId": "string"}

{  "error": "string",  "code": "string",  "message": "string",  "details": {},  "requestId": "string"}

{  "error": "string",  "code": "string",  "message": "string",  "details": {},  "requestId": "string"}

Authorize a Uniswap V4 swap

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

409application/json

429application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`