RHrhinestonewtf
Utilities

Prepare an Aave withdrawal

Changed on

Prepares an unsigned transaction to withdraw an Aave position to a deposit address.

post/positions/{address}/unwind

Request

Path parameters

addressstring required

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

Example:0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91

Headers

x-api-keystring

API key for authentication

Example:your-api-key
x-api-versionstring

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

Example:2026-04.amazon

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.

Changes

  • aa1767d704faRevision changes
    • info

      the endpoint scheme security internalProjectBearer was added to the API

    • info

      the endpoint scheme security tenantApiKey was added to the API

    • info

      the header request parameter x-api-key became optional

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 676300ac19ffRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status