RHrhinestonewtf
Utilities

List withdrawable positions

Changed on

Returns DeFi positions and the amounts currently available to withdraw.

get/positions/{address}

Request

Path parameters

addressstring required

EVM address holding the DeFi positions

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

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
}

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

  • 676300ac19ffRevision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status