Get withdrawal status
curl --request GET \
--url https://api.agg.market/execution/withdrawals/{withdrawalId} \
--header 'Authorization: Bearer <token>' \
--header 'x-app-id: <api-key>'{
"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>"
}
]
}Execution
Get withdrawal status
Returns the current persisted state of a withdrawal — used as a fallback when the WS lifecycle channel has missed events.
GET
/
execution
/
withdrawals
/
{withdrawalId}
Get withdrawal status
curl --request GET \
--url https://api.agg.market/execution/withdrawals/{withdrawalId} \
--header 'Authorization: Bearer <token>' \
--header 'x-app-id: <api-key>'{
"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.
Path Parameters
Response
200
DB-backed withdrawal status. Mirrors the WithdrawalStatus Prisma enum.
Available options:
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.
Available options:
unquoted, quoting, quoted, unviable Show child attributes
Show child attributes
⌘I