v18

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-013469188.5 KB

Utilities

Prepare an Aave position unwind

Returns an unsigned Pool.withdraw transaction that exits an Aave position straight to the project's deposit address, so the existing deposit pipeline ingests the proceeds. Nothing is executed: the holding EOA owns the aTokens, so only it can authorise the withdraw, and the service holds no key on this path. The amount is capped server-side against Aave's full withdraw validation and is refused outright if the proceeds would fall foul of the project's deposit policy — that check happens here because this is the last point before an irreversible signature.

post/positions/{address}/unwind

Path parameters

addressstring required

The EOA holding the position. It signs and sends the returned transaction.

Example:0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91

The EOA holding the position. It signs and sends the returned transaction.

Headers

x-api-keystring required

API key for authentication

Example:your-api-key

API key for authentication

x-api-versionstring

API version identifier (e.g. "2026-04.amazon"). Optional today, will become required in a future release.

Example:2026-04.amazon

API version identifier (e.g. "2026-04.amazon"). Optional today, will become required in a future release.

Request body

accountstring required

The registered deposit account the proceeds go to. The recipient is resolved from this server-side; it is never taken from the request directly.

marketstring required

The Aave market's Pool address, as returned in a position's market.address. Required rather than inferred, because a chain can host several markets.

chainIdinteger required

assetstring required

The supplied underlying token to withdraw

amountstring

Base units to withdraw. Omit for the largest amount currently permitted. An amount above that maximum is rejected rather than silently reduced.

Example request

{
  "chainId": 8453,
  "amount": "1000000000000000000"
}

Response

Unsigned withdraw transaction

amountstring required

Base units the transaction will withdraw

isFullExitboolean required

True when the whole position is being withdrawn, in which case the calldata uses the max-uint sentinel so interest accrued before the transaction lands is swept too.

recipientstring required

The deposit address the proceeds are sent to, resolved from the registered account. Echoed so it is auditable.

constraintsstring[] required

Why the amount is below the supplied balance, if it is. Empty for an unconstrained full exit.