v18

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

Utilities

Get migratable DeFi positions

Returns the address's DeFi positions in one normalised shape, each carrying the largest amount that can actually be withdrawn right now. maxWithdrawable is capped against the venue's full withdraw validation — health factor (with a buffer above the liquidation edge), E-Mode thresholds, zero-LTV collateral, paused reserves and pool liquidity — so a client never asks a user to sign an exit the protocol would reject. Currently covers Aave v3 across every market on the deposit-enabled chains; a failures entry appears when a venue could not be reached, so an empty list is distinguishable from a failed lookup.

get/positions/{address}

Path parameters

addressstring required

EVM address holding the DeFi positions

Example:0x742d35Cc6634C0532925a3b844Bc9e7595f5bE91

EVM address holding the DeFi positions

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.

Response

Normalised DeFi positions

totalUsdnumber required

minDepositUsdnumber required

The USD floor the withdrawn proceeds must clear for this project, resolved from the platform minimum and the project's own minDepositUsd. Proceeds below it are rejected on ingest after the withdrawal has already happened.

Example response

{
  "positions": [
    {
      "chain": "eip155:8453",
      "withdrawableUsd": 40.02
    }
  ],
  "minDepositUsd": 0.04
}