Skip to main content
GET
/
beta
/
evm
/
defi
/
positions
/
{address}
Get DeFi positions for an address
curl --request GET \
  --url https://api.sim.dune.com/beta/evm/defi/positions/{address} \
  --header 'X-Sim-Api-Key: <api-key>'
{
  "positions": [
    {
      "type": "Erc4626",
      "chain_id": 1,
      "token": "0xdcd0f5ab30856f28385f641580bbd85f88349124",
      "token_name": "Autonomous Liquidity USD",
      "token_symbol": "alUSD",
      "underlying_token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "underlying_token_name": "USD Coin",
      "underlying_token_symbol": "USDC",
      "underlying_token_decimals": 6,
      "calculated_balance": 0.0673736869415349,
      "price_in_usd": 0,
      "usd_value": 0,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
    },
    {
      "type": "Tokenized",
      "chain_id": 1,
      "token_type": "AtokenV2",
      "token": "0x030ba81f1c18d280636f32af80b9aad02cf0854e",
      "token_name": "Aave interest bearing WETH",
      "token_symbol": "aWETH",
      "calculated_balance": 0.0496171604159423,
      "price_in_usd": 1.03911373514321,
      "usd_value": 0.0515578728870095,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    },
    {
      "type": "Tokenized",
      "chain_id": 1,
      "token_type": "AtokenV2",
      "token": "0x9ff58f4ffb29fa2266ab25e75e2a8b3503311656",
      "token_name": "Aave interest bearing WBTC",
      "token_symbol": "aWBTC",
      "calculated_balance": 0.00007234,
      "price_in_usd": 29.6320132187639,
      "usd_value": 0.00214357983624538,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    },
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0x09c29277d081a1b347f41277ff53116a30d4ddff",
      "token0": "0x4206975c6d7135ad73129476ebe2b06e42f41f50",
      "token0_name": "FWOG",
      "token0_symbol": "FWOG",
      "token0_decimals": 18,
      "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "lp_balance": "0xca7455529bd53680000",
      "token0_price": 3.981792910653e-11,
      "token1_price": 3553.20946160682,
      "calculated_balance": 59754,
      "price_in_usd": 0.000802696996635525,
      "usd_value": 47.9643563369592,
      "logo": null
    },
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0x2c793e52d3180ce2f97ed050428d6ed8473285ee",
      "token0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token0_name": "Wrapped Ether",
      "token0_symbol": "WETH",
      "token0_decimals": 18,
      "token1": "0xeb1d4fa4ec26392a1da1344ed1a0b6f8476265b3",
      "token1_name": "Thailand",
      "token1_symbol": "THAILAND",
      "token1_decimals": 18,
      "lp_balance": "0x141c5f09864c3968",
      "token0_price": 3553.20946160682,
      "token1_price": 6.93033022151853e-7,
      "calculated_balance": 1.44913767461894,
      "price_in_usd": 0.0993233873678346,
      "usd_value": 0.1439332626055,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    },
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0x3b0ad93e52a232d8d41e13289976895c295e5b97",
      "token0": "0x56c18a87b4ee72317e059bd568005a6355b66b01",
      "token0_name": "Ethereum Army",
      "token0_symbol": "EthereumArmy",
      "token0_decimals": 9,
      "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "lp_balance": "0xf7436a7c1ea8ae82",
      "token0_price": 6.71694037048083e-9,
      "token1_price": 3553.20946160682,
      "calculated_balance": 17.8172016321307,
      "price_in_usd": 310.047164921547,
      "usd_value": 5524.17285287768,
      "logo": null
    },
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0x3d1cb7638d73657f7e554eda1d97703bc29d3c15",
      "token0": "0xa585cb4e6e833d6fa55a992e75b9ee0743b23d69",
      "token0_name": "Tokenswim",
      "token0_symbol": "TKS",
      "token0_decimals": 8,
      "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "lp_balance": "0x425eb51b908b",
      "token0_price": 1.20461416147608,
      "token1_price": 3553.20946160682,
      "calculated_balance": 0.000072974532841611,
      "price_in_usd": 13300248.4891253,
      "usd_value": 970.579420171264,
      "logo": null
    },
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0x3d22ea9eb7d7be6d9c6da7542ae17e24a56c9948",
      "token0": "0x44ac993fcd34a55bcce736ee709a0b1f590327f1",
      "token0_name": "Made In United States of America",
      "token0_symbol": "MIUSA",
      "token0_decimals": 18,
      "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "lp_balance": "0x9b6e64a8ec60000",
      "token0_price": 0.000170221012856972,
      "token1_price": 3553.20946160682,
      "calculated_balance": 0.7,
      "price_in_usd": 1.55542454856754,
      "usd_value": 1.08879718399728,
      "logo": null
    },
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0x4fa956284f1214e7f619a05054ea3b8d4370d225",
      "token0": "0xb005aac185a963c9ad52ecede60ddaea83417b37",
      "token0_name": "Edoge",
      "token0_symbol": "EDOGE",
      "token0_decimals": 9,
      "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "lp_balance": "0x1bc16d674ec80000",
      "token0_price": 7.73273307706922e-9,
      "token1_price": 3553.20946160682,
      "calculated_balance": 2,
      "price_in_usd": 337.500909089399,
      "usd_value": 675.001818178797,
      "logo": null
    },
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0x60da3e999b92ad9ac0749bdb7f7bc4a84b7654b0",
      "token0": "0x7e9e98e12e6aa8a2b457b78613f075bd4cbbd4b1",
      "token0_name": "Pepe Vitalik",
      "token0_symbol": "PITALIK",
      "token0_decimals": 9,
      "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "lp_balance": "0x2386f26fc100000",
      "token0_price": 0.00005223622125649,
      "token1_price": 3553.20946160682,
      "calculated_balance": 0.16,
      "price_in_usd": 27834.7019989285,
      "usd_value": 4453.55231982856,
      "logo": null
    },
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0x85e25bc853a5cf2265dc9d04e2fbbfd32a95a7e5",
      "token0": "0x31448ab1bd9679f8c8029defee824763018566bd",
      "token0_name": "MEOW",
      "token0_symbol": "Vitalik Learn to Meow",
      "token0_decimals": 18,
      "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "lp_balance": "0x66845b21facdd560fe31a",
      "token0_price": 5.36553654627e-12,
      "token1_price": 3553.20946160682,
      "calculated_balance": 7745966.69241483,
      "price_in_usd": 0.000276152558547498,
      "usd_value": 2139.06852053406,
      "logo": null
    },
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0x87ffcda0c507117683f0bc0defb683eebe9c223b",
      "token0": "0x693391144d1e079e20cc64f795e9450c94966171",
      "token0_name": "Layer 2 Index",
      "token0_symbol": "LTI",
      "token0_decimals": 18,
      "token1": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "token1_name": "Dai Stablecoin",
      "token1_symbol": "DAI",
      "token1_decimals": 18,
      "lp_balance": "0x8ac7230489e80000",
      "token0_price": 0.362412002420127,
      "token1_price": 0.998865563776363,
      "calculated_balance": 10,
      "price_in_usd": 1.2092122125549,
      "usd_value": 12.092122125549,
      "logo": null
    },
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0xa7f8de1f0e6964201d412fd172e5740663b35567",
      "token0": "0x8df994371e3cfe3d218d2b8f42b5bf414651fcd8",
      "token0_name": "FLOKI SANTA",
      "token0_symbol": "FLOKIS",
      "token0_decimals": 18,
      "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "lp_balance": "0x3eb908bfa9242f200000",
      "token0_price": 5.410934490399e-10,
      "token1_price": 3553.20946160682,
      "calculated_balance": 296200,
      "price_in_usd": 0.0027889628548969,
      "usd_value": 826.090797620462,
      "logo": null
    },
    {
      "type": "Nft",
      "chain_id": 8453,
      "protocol": "UniswapV3",
      "pool": "0x7a0640ca0c8b07789edaaefda82bf5790109aa44",
      "token0": "0x07449b62ec61f12d6110c36db240436222b02530",
      "token0_name": "DOGE",
      "token0_symbol": "DOGE",
      "token0_decimals": 18,
      "token1": "0x4200000000000000000000000000000000000006",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "positions": [
        {
          "tick_lower": -887272,
          "tick_upper": 887272,
          "token_id": "0x132c81",
          "token0_price": 9.48452516697798e-7,
          "token0_holdings": 613763253.0586,
          "token0_rewards": 21676.3984019538,
          "token1_price": 3570.25944039075,
          "token1_holdings": 0.162913339628563,
          "token1_rewards": 0.000010452682406464
        }
      ],
      "logo": null,
      "usd_value": 1163.82606861717
    },
    {
      "type": "Nft",
      "chain_id": 1,
      "protocol": "UniswapV3",
      "pool": "0x7625d7f67e4e44341ddfb1e698801fd5a1574b48",
      "token0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token0_name": "Wrapped Ether",
      "token0_symbol": "WETH",
      "token0_decimals": 18,
      "token1": "0xd78959df1ff28b45e6b4ea234bdcf9d6609d16e1",
      "token1_name": "Moneda de Caca",
      "token1_symbol": "Mierda",
      "token1_decimals": 18,
      "positions": [
        {
          "tick_lower": 0,
          "tick_upper": 184200,
          "token_id": "0xe8ac0",
          "token0_price": 3553.20946160682,
          "token0_holdings": 0,
          "token0_rewards": 0.000201014351146556,
          "token1_price": 0,
          "token1_holdings": 100000000,
          "token1_rewards": 19678.323702556
        }
      ],
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "usd_value": 0.714246094412699
    },
    {
      "type": "Nft",
      "chain_id": 8453,
      "protocol": "UniswapV3",
      "pool": "0xf3b058e81ac53c475cf6e9d12724e3493fd8ffe7",
      "token0": "0x2ef9f33ae8f8e7f7858ed24965b04ec8fc4e5841",
      "token0_name": "Numbers",
      "token0_symbol": "NMB404",
      "token0_decimals": 18,
      "token1": "0x4200000000000000000000000000000000000006",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "positions": [
        {
          "tick_lower": -39000,
          "tick_upper": 887200,
          "token_id": "0xb3e4",
          "token0_price": 93.9873376113841,
          "token0_holdings": 38.7920703525764,
          "token0_rewards": 0.808474625304572,
          "token1_price": 3570.25944039075,
          "token1_holdings": 0.145798328127171,
          "token1_rewards": 0.171277142433281
        }
      ],
      "logo": null,
      "usd_value": 4853.9914825157
    },
    {
      "type": "Nft",
      "chain_id": 1,
      "protocol": "UniswapV3",
      "pool": "0x24a3ab2a20f5e903b5bb3efc3b4a60fcda17b496",
      "token0": "0x6793655c396eaee311fb4d3596b88fd7d195c79e",
      "token0_name": "degeneratorv2",
      "token0_symbol": "DGENV2",
      "token0_decimals": 8,
      "token1": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token1_name": "Wrapped Ether",
      "token1_symbol": "WETH",
      "token1_decimals": 18,
      "positions": [
        {
          "tick_lower": -887270,
          "tick_upper": 230270,
          "token_id": "0x1b621",
          "token0_price": 0.0719515070037307,
          "token0_holdings": 3047.05602573,
          "token0_rewards": 5.63917856,
          "token1_price": 3553.20946160682,
          "token1_holdings": 0.0616595719741519,
          "token1_rewards": 0.0319835526435363
        }
      ],
      "logo": null,
      "usd_value": 552.379656777724
    },
    {
      "type": "NftV4",
      "chain_id": 1,
      "protocol": "UniswapV4",
      "pool_id": [
        33,
        251,
        41,
        59,
        157,
        197,
        59,
        66,
        250,
        110,
        99,
        250,
        36,
        225,
        33,
        45,
        231,
        108,
        136,
        235,
        122,
        21,
        185,
        76,
        210,
        32,
        252,
        102,
        39,
        72,
        81,
        191
      ],
      "pool_manager": "0x000000000004444c5dc75cb358380d2e3de08a90",
      "salt": [
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        33,
        24
      ],
      "token0": "0x0000000000000000000000000000000000000000",
      "token0_name": "Ether",
      "token0_symbol": "ETH",
      "token0_decimals": 18,
      "token1": "0xf9c8631fba291bac14ed549a2dde7c7f2ddff1a8",
      "token1_name": "Mighty Morphin Power Rangers",
      "token1_symbol": "GoGo",
      "token1_decimals": 18,
      "positions": [
        {
          "tick_lower": -184220,
          "tick_upper": 207220,
          "token_id": "0x2118",
          "token0_price": 3553.20946160682,
          "token0_holdings": 0.000047749999999999,
          "token0_rewards": 0.000008749999999999,
          "token1_price": 0.000003581798534713,
          "token1_holdings": 479952364.515627,
          "token1_rewards": 8399.79998597393
        }
      ],
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "usd_value": 1719.32351868043
    }
  ],
  "aggregations": {
    "total_usd_value": 22940.0436122581,
    "total_by_chain": {
      "1": 16922.2260611252,
      "8453": 6017.81755113287
    }
  }
}
Defi Positions API The DeFi Positions API returns a wallet’s active positions across liquidity pools, lending protocols, yield strategies, and tokenized DeFi assets. The endpoint is available at the beta path (/beta/evm/defi/positions). Each position includes token holdings, USD valuations, underlying asset metadata, and protocol-specific details such as tick ranges, collateral status, or reward accruals.

​
Supported Protocols

Protocol coverage is organized by position type. Each protocol specifies its supported chains and the API response type under which it appears.
Protocol / StandardEthereum (1)Base (8453)Arbitrum (42161)Unichain (130)Optimism (10)Polygon (137)
Uniswap V2✓✓✓✓✓✓
Uniswap V2 Forks✓✓✓✓✓✓
Uniswap V3✓✓✓✓✓✓
Uniswap V4✓✓✓✓✓✓
ERC‑4626 Vaults✓✓✓✓✓✓
Aave v2✓————✓
Aave v3✓✓✓—✓✓
Legend: ✓ = Supported | — = Protocol not deployed on this chain

​
Liquidity Pool Positions

Liquidity pool positions represent token pairs deposited into automated market makers (AMMs). These positions may be fungible ERC-20 LP tokens or non-fungible NFT-based positions for concentrated liquidity.
Type: UniswapV2
Chains: Ethereum (1), Base (8453), Arbitrum (42161), Unichain (130), Optimism (10), Polygon (137)
Recognized Forks: SushiSwapV2, PancakeSwapV2, ShibaSwapV2, RingSwap, CroDefiSwap, DXSwap, SquadSwap, TrebleSwapV2, BaseSwap, SharkSwap, RocketSwap, Aerodrome, Infusion, GammaSwap
Description: Fungible LP tokens representing constant-product AMM positions. Includes balances of both tokens in the pair and total USD value. Both Uniswap V2 and its forks are detected by factory address and returned under the same UniswapV2 type, with the specific protocol name indicated in the protocol field.Example Response (Uniswap V2):
{
  "wallet_address": "0x3ddfa8ec3052539b6c9549f12cea2c295cff5296",
  "positions": [
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "UniswapV2",
      "pool": "0x2d0ba902badaa82592f0e1c04c71d66cea21d921",
      "token0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token0_name": "Wrapped Ether",
      "token0_symbol": "WETH",
      "token0_decimals": 18,
      "token1": "0xc669928185dbce49d2230cc9b0979be6dc797957",
      "token1_name": "BitTorrent",
      "token1_symbol": "BTT",
      "token1_decimals": 18,
      "lp_balance": "0x9fb1af75d00c86824442",
      "token0_price": 3604.8860123436993,
      "token1_price": 4.791346462915666e-07,
      "calculated_balance": 7500.0,
      "price_in_usd": 0.499768653034215,
      "usd_value": 3748.26,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    }
  ],
  "aggregations": {
    "total_usd_value": 3748.26,
    "total_by_chain": {
      "1": 3748.26
    }
  }
}
Example Response (SushiSwap V2):
{
  "wallet_address": "0x5dd596c901987a2b28c38a9c1dfbf86fffc15d77",
  "positions": [
    {
      "type": "UniswapV2",
      "chain_id": 1,
      "protocol": "SushiSwapV2",
      "pool": "0x54bcf4948e32a8706c286416e3ced37284f17fc9",
      "token0": "0x66c0dded8433c9ea86c8cf91237b14e10b4d70b7",
      "token0_name": "MarsToken",
      "token0_symbol": "Mars",
      "token0_decimals": 18,
      "token1": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "token1_name": "Tether USD",
      "token1_symbol": "USDT",
      "token1_decimals": 6,
      "lp_balance": "0x2",
      "token0_price": 7.981024983046692e-06,
      "token1_price": 0.9976281228808364,
      "calculated_balance": 2e-18,
      "price_in_usd": 6009.914272265951,
      "usd_value": 1.2019828544531902e-14,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0x66c0dded8433c9ea86c8cf91237b14e10b4d70b7"
    }
  ],
  "aggregations": {
    "total_usd_value": 1.2019828544531902e-14,
    "total_by_chain": {
      "1": 1.2019828544531902e-14
    }
  }
}
Type: Nft
Chains: Ethereum (1), Base (8453), Arbitrum (42161), Unichain (130), Optimism (10), Polygon (137)
Description: NFT-based concentrated liquidity positions. Each position includes tick ranges, token holdings, unclaimed fees, and per-position USD valuations. Both Uniswap V3 and its forks are detected by factory address and returned under the same Nft type, with the specific protocol name indicated in the protocol field.Example Response (Uniswap V3):
{
  "wallet_address": "0x020ca66c30bec2c4fe3861a94e4db4a498a35872",
  "positions": [
    {
      "type": "Nft",
      "chain_id": 1,
      "protocol": "UniswapV3",
      "pool": "0x286431024acfab509d5d6beb64066c52e205f460",
      "token0": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "token0_name": "Wrapped Ether",
      "token0_symbol": "WETH",
      "token0_decimals": 18,
      "token1": "0xe957ea0b072910f508dd2009f4acb7238c308e29",
      "token1_name": "Ethcoin",
      "token1_symbol": "ETHC",
      "token1_decimals": 18,
      "positions": [
        {
          "tick_lower": -887200,
          "tick_upper": 887200,
          "token_id": "0xd28a4",
          "token0_price": 3604.962479958635,
          "token0_holdings": 0.8508188676223404,
          "token0_rewards": 0.0,
          "token1_price": 0.045373374904882045,
          "token1_holdings": 68599.0469105992,
          "token1_rewards": 0.0
        }
      ],
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "usd_value": 6179.740368611638
    }
  ],
  "aggregations": {
    "total_usd_value": 6179.740368611638,
    "total_by_chain": {
      "1": 6179.740368611638
    }
  }
}
Type: Nft
Chains: Ethereum (1), Base (8453), Arbitrum (42161), Unichain (130), Optimism (10), Polygon (137)
Description: Next-generation concentrated liquidity positions with hook support. Similar structure to V3 with additional metadata for pool hooks and custom logic.

​
Lending Positions

Lending positions include supplied collateral (e.g., aTokens, cTokens) and outstanding debt across major lending protocols.
Type: Tokenized
Token Types: AtokenV2, AaveV2VariableDebt
Chains: Ethereum (1), Polygon (137)
Description: Supply positions (aTokens) and variable debt positions on Aave v2. Each position includes the underlying asset, calculated balance, and USD value.Example Response:
{
  "wallet_address": "0x8b529ef78046008f9d1fbc91c7407030de96ee32",
  "positions": [
    {
      "type": "Tokenized",
      "chain_id": 1,
      "token_type": "AaveV2VariableDebt",
      "token": "0x619beb58998ed2278e08620f97007e1116d5d25b",
      "token_name": "Aave variable debt bearing USDC",
      "token_symbol": "variableDebtUSDC",
      "calculated_balance": 4.565517,
      "price_in_usd": 0.00042242904592455,
      "usd_value": 0.0019286069904623138,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    }
  ],
  "aggregations": {
    "total_usd_value": 0.0019286069904623138,
    "total_by_chain": {
      "1": 0.0019286069904623138
    }
  }
}
Type: Tokenized
Token Types: AtokenV3, AaveV3VariableDebt
Chains: Ethereum (1), Base (8453), Arbitrum (42161), Optimism (10), Polygon (137)
Description: Supply positions (aTokens) and variable debt positions on Aave v3. Includes underlying token metadata and USD valuations.Example Response:
{
  "wallet_address": "0xc0979af67786f30dea9335665592d6813b21b819",
  "positions": [
    {
      "type": "Tokenized",
      "chain_id": 1,
      "token_type": "AtokenV3",
      "token": "0xbdfa7b7893081b35fb54027489e2bc7a38275129",
      "token_name": "Aave Ethereum weETH",
      "token_symbol": "aEthweETH",
      "calculated_balance": 2.045,
      "price_in_usd": 3911.29585515,
      "usd_value": 7998.60,
      "logo": null
    }
  ],
  "aggregations": {
    "total_usd_value": 7998.60,
    "total_by_chain": {
      "1": 7998.60
    }
  }
}

​
Yield Positions

Yield positions represent deposits into vaults, structured products, or yield-generating strategies.
Type: Erc4626
Chains: Ethereum (1), Base (8453), Arbitrum (42161), Unichain (130), Optimism (10), Polygon (137)
Description: Tokenized vaults conforming to the ERC-4626 standard. Includes vault share balances, underlying asset metadata, and USD valuations. Examples include Yearn v3 vaults and Pendle Yield Principal Tokens (PTs) when wrapped as ERC-4626.Example Response:
{
  "wallet_address": "0x9cb21ce0ff81e55db73bbb36d5a9eac9d50a938b",
  "positions": [
    {
      "type": "Erc4626",
      "chain_id": 1,
      "token": "0xbc65ad17c5c0a2a4d159fa5a503f4992c7b545fe",
      "token_name": "Spark USDC Vault",
      "token_symbol": "sUSDC",
      "underlying_token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "underlying_token_name": "USD Coin",
      "underlying_token_symbol": "USDC",
      "underlying_token_decimals": 6,
      "calculated_balance": 948.1633593101873,
      "price_in_usd": 1.0690361554703132,
      "usd_value": 1013.6209123947798,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
    }
  ],
  "aggregations": {
    "total_usd_value": 1013.6209123947798,
    "total_by_chain": {
      "1": 1013.6209123947798
    }
  }
}

​
Compute Units

Each request consumes 10 Compute Units per processed chain ID. Filtering to fewer chains lowers usage. Aggregations are calculated server-side and included in the same response.
To learn more specifics, please visit the Compute Units page.

Authorizations

​
X-Sim-Api-Key
string
header
required

API key for authentication. Obtain your key from the Dune dashboard at sim.dune.com.

Path Parameters

​
address
string
required

Wallet address to inspect for DeFi positions.

Pattern: ^0x[a-fA-F0-9]{40}$

Query Parameters

​
chain_ids
string

Filter by chain(s). Accepts numeric chain IDs and/or tags. Provide a single value (e.g. ?chain_ids=1 or ?chain_ids=mainnet) or a comma-separated list (e.g. ?chain_ids=1,8453,testnet). Chain names are not accepted. If this query parameter is omitted, results include positions from chains with the default tag. See the Supported Chains Tags section.

Response

Successful response

​
positions
object[]
required
​
aggregations
object
​
warnings
object[]

Array of warnings that occurred during request processing. Warnings indicate non-fatal issues (e.g., unsupported chain IDs) where the request can still be partially fulfilled.