Skip to main content
GET
/
wallets
/
{address}
Get wallet positions
curl --request GET \
  --url https://api.deframe.io/wallets/{address} \
  --header 'x-api-key: <api-key>'
{
  "address": "0xb794F5eA0ba39494cE839613fffBA74279579268",
  "positions": [
    {
      "strategy": {
        "_id": "507f1f77bcf86cd799439011",
        "name": "Aave USDC Lending",
        "slug": "aave-usdc-lending",
        "protocol": "Aave",
        "network": "ethereum",
        "asset": {
          "symbol": "USDC",
          "contract": "0xb794F5eA0ba39494cE839613fffBA74279579268",
          "decimals": 6
        },
        "paused": false,
        "apy": 0.0525,
        "grossAPY": 0.0525,
        "netAPY": 0.0498,
        "tvl": "1000000000"
      },
      "balance": "1000000000000000000",
      "balanceUSD": "1000.00",
      "earned": "1000000000000000000",
      "earnedUSD": "<string>",
      "spotPosition": {
        "currentPosition": {
          "value": "1000000000000000000",
          "decimals": 6,
          "humanized": "10.0487",
          "symbol": "USDC"
        },
        "principal": {
          "value": "1000000000000000000",
          "decimals": 6,
          "humanized": "10.0487",
          "symbol": "USDC"
        },
        "profit": {
          "value": "1000000000000000000",
          "decimals": 6,
          "humanized": "10.0487",
          "symbol": "USDC"
        },
        "cumulativeProfit": {
          "value": "1000000000000000000",
          "decimals": 6,
          "humanized": "10.0487",
          "symbol": "USDC"
        },
        "underlyingBalanceUSD": 10.05,
        "apy": 0.0417,
        "grossAPY": 0.0417,
        "netAPY": 0.0396,
        "avgApy": 0.0412,
        "inceptionApy": 0.0385,
        "requestedToLend": [
          {
            "value": "1000000000000000000",
            "decimals": 6,
            "humanized": "10.0487",
            "symbol": "USDC"
          }
        ],
        "requestedToWithdraw": [
          {
            "value": "1000000000000000000",
            "decimals": 6,
            "humanized": "10.0487",
            "symbol": "USDC"
          }
        ]
      }
    }
  ],
  "totalValueUSD": "5000.00"
}

Authorizations

x-api-key
string
header
required

API key for authentication. Obtain from your Deframe dashboard.

Path Parameters

address
string
required

Wallet address

Example:

"0xb794F5eA0ba39494cE839613fffBA74279579268"

Response

200 - application/json

Wallet positions retrieved

address
string
required

Ethereum address (EVM-compatible)

Example:

"0xb794F5eA0ba39494cE839613fffBA74279579268"

positions
object[]
required
totalValueUSD
string
required
Example:

"5000.00"