User Positions

Current on-chain DeFi positions for a wallet across supported protocols.

Send your API key via the X-API-Key header. See Authentication.

Overview

Return a wallet’s current DeFi positions across every supported protocol (Uniswap, Aave, Euler, Morpho, Curvance, Pendle), grouped by protocol with per-position and total USD valuations. Positions are derived from on-chain state.

This is a point-in-time snapshot. For transaction history (deposits and withdrawals over time) use Wallet Activity.

Endpoint

curl

curl -X GET "https://earn.turtle.xyz/v2/wallet/0xe84ef330b7b5c02fb3fbe05f2a31cb331c2b874c/portfolio" \
  -H "X-API-Key: pk_live_xxxxx"

const res = await fetch(
  'https://earn.turtle.xyz/v2/wallet/0xe84ef330b7b5c02fb3fbe05f2a31cb331c2b874c/portfolio',
  { headers: { 'X-API-Key': 'pk_live_xxxxx' } }
);
const { total_stats, protocols } = await res.json();

Path Parameters

address · string · required

EVM wallet address.

Response

{
  "total_stats": {
    "asset_usd_value": "50000.00",
    "debt_usd_value": "0.00",
    "net_usd_value": "50000.00"
  },
  "protocols": [
    {
      "id": "morpho",
      "name": "Morpho",
      "site_url": "https://morpho.org",
      "logo_url": "https://...",
      "stats": { "asset_usd_value": "50000.00", "debt_usd_value": "0.00", "net_usd_value": "50000.00" },
      "portfolio_item_list": [
        {
          "type": "yield",
          "name": "Gauntlet USDC Core",
          "detail": {
            "supply_token_list": [
              { "address": "0xa0b8...eb48", "chain": "1", "symbol": "USDC", "name": "USD Coin", "decimals": 6, "amount": "50000.0", "price": "1.00", "logo_url": "https://..." }
            ]
          },
          "stats": { "asset_usd_value": "50000.00", "debt_usd_value": "0.00", "net_usd_value": "50000.00" },
          "pool": { "id": "0x...", "chain": "1" }
        }
      ]
    }
  ]
}

total_stats · object

Wallet-wide totals across all protocols: asset_usd_value, debt_usd_value, net_usd_value.

protocols · array

One entry per protocol the wallet holds positions in.

protocols[].id · string

Protocol slug (e.g. morpho, aave3, uniswap3).

protocols[].stats · object

Protocol-level USD totals (asset_usd_value, debt_usd_value, net_usd_value).

protocols[].portfolio_item_list · array

Individual positions within the protocol.

protocols[].portfolio_item_list[].type · string

Position type: yield, lending, collateral, or liquidity.

protocols[].portfolio_item_list[].detail · object

Token lists for the position: supply_token_list, and where relevant borrow_token_list / reward_token_list. Each token carries address, chain, symbol, name, decimals, amount, price, logo_url.

protocols[].portfolio_item_list[].pool · object

Pool / vault identifier for the position: id (contract address) and chain.