curl --request POST \
--url https://api.agg.market/execution/withdraw \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-app-id: <api-key>' \
--data '
{
"amountRaw": "<string>",
"destinationAddress": "<string>",
"destinationChainId": 2,
"max": true
}
'{
"withdrawalId": "<string>",
"requested": {
"amountRaw": "<string>"
},
"completedAmountRaw": "<string>",
"destination": {
"chainId": 2,
"address": "<string>"
},
"legs": [
{
"sourceChainId": 123,
"destChainId": 123,
"amountRaw": "<string>",
"txHash": "<string>",
"bridgeOperationId": "<string>",
"sourceTokenSymbol": "<string>",
"errorMessage": "<string>"
}
],
"expected": {
"outputRaw": "<string>",
"feeRaw": "<string>",
"etaSeconds": 123
},
"errorMessage": "<string>",
"sources": [
{
"sourceId": "<string>",
"chainId": 123,
"tokenAddress": "<string>",
"decimals": 18,
"amountRaw": "<string>",
"txHash": "<string>",
"bridgeOperationId": "<string>"
}
]
}Withdraw funds
Withdraws funds to an external address and returns submitted transfer details.
curl --request POST \
--url https://api.agg.market/execution/withdraw \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'x-app-id: <api-key>' \
--data '
{
"amountRaw": "<string>",
"destinationAddress": "<string>",
"destinationChainId": 2,
"max": true
}
'{
"withdrawalId": "<string>",
"requested": {
"amountRaw": "<string>"
},
"completedAmountRaw": "<string>",
"destination": {
"chainId": 2,
"address": "<string>"
},
"legs": [
{
"sourceChainId": 123,
"destChainId": 123,
"amountRaw": "<string>",
"txHash": "<string>",
"bridgeOperationId": "<string>",
"sourceTokenSymbol": "<string>",
"errorMessage": "<string>"
}
],
"expected": {
"outputRaw": "<string>",
"feeRaw": "<string>",
"etaSeconds": 123
},
"errorMessage": "<string>",
"sources": [
{
"sourceId": "<string>",
"chainId": 123,
"tokenAddress": "<string>",
"decimals": 18,
"amountRaw": "<string>",
"txHash": "<string>",
"bridgeOperationId": "<string>"
}
]
}Authorizations
Your application ID. Required for all app-tier and user-tier routes.
JWT access token returned by POST /auth/verify. Required for user-tier routes.
Body
Positive integer string in the token's native decimals.
^[1-9][0-9]*$Stable-coin symbol the withdrawal is denominated in.
USDC, USDC.e, USDT Recipient address. EVM destinations: 0x-prefixed 20-byte hex. Solana: base58 (32–44 chars).
^(0x[a-fA-F0-9]{40}|[1-9A-HJ-NP-Za-km-z]{32,44})$Chain ID where the recipient address should receive funds.
x >= 1Cap to the deliverable maximum (withdraw-max intent).
Response
200
DB-backed withdrawal status. Mirrors the WithdrawalStatus Prisma enum.
pending, bridging, transferring, completed, partial, failed Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Withdrawal pricing state. 'quoted' rows have a fresh preflight quote; 'unviable' means at least one source leg is too small for required fees.
unquoted, quoting, quoted, unviable Show child attributes
Show child attributes