DeFi Positions

Access a wallet’s DeFi positions along with USD values and metadata across supported EVM chains.

GET /v1/evm/defi/positions/{address}

Get DeFi positions for an address

cURL

curl --request GET \
  --url https://api.sim.dune.com/v1/evm/defi/positions/{address} \
  --header 'X-Sim-Api-Key: <api-key>'

200

{
  "positions": [
    {
      "type": "Erc4626",
      "chain": "ethereum",
      "chain_id": 1,
      "protocol": "Unknown",
      "token": {
        "address": "0xa3931d71877c0e7a3148cb7eb4463524fec27fbd",
        "name": "Savings USDS",
        "symbol": "sUSDS"
      },
      "underlying_token": {
        "address": "0xdc035d45d973e3ec169d2276ddab16f1e407384f",
        "name": "USDS Stablecoin",
        "symbol": "USDS",
        "decimals": 18,
        "holdings": 47.05
      },
      "balance": 43.09,
      "price_usd": 1.092,
      "value_usd": 47.06,
      "preview_redeem": 47.05,
      "convert_to_assets": 47.05,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xdc035d45d973e3ec169d2276ddab16f1e407384f"
    },
    {
      "type": "Tokenized",
      "chain": "ethereum",
      "chain_id": 1,
      "token_type": "AtokenV2",
      "token": {
        "address": "0x030ba81f1c18d280636f32af80b9aad02cf0854e",
        "name": "Aave interest bearing WETH",
        "symbol": "aWETH"
      },
      "underlying_token": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "holdings": 0.05158
      },
      "lending_pool": "0x7d2768de32b0b80b7a3454c06bdac94a69ddc7a9",
      "balance": 0.04962,
      "price_usd": 2116.32,
      "value_usd": 105.01,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    },
    {
      "type": "UniswapV2",
      "chain": "ethereum",
      "chain_id": 1,
      "protocol": "ShibaSwapV2",
      "pool": "0x76ec974feaf0293f64cf8643e0f42dea5b71689b",
      "token0": {
        "address": "0x198065e69a86cb8a9154b333aad8efe7a3c256f8",
        "name": "KOYO",
        "symbol": "KOY",
        "decimals": 18,
        "price_usd": 0.0000765,
        "holdings": 75856.43
      },
      "token1": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18,
        "price_usd": 2035.61,
        "holdings": 0.00283
      },
      "lp_balance": "0x8ac7230489e80000",
      "balance": 10,
      "price_usd": 1.1577,
      "value_usd": 11.577,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0x198065e69a86cb8a9154b333aad8efe7a3c256f8"
    },
    {
      "type": "Nft",
      "chain": "ethereum",
      "chain_id": 1,
      "protocol": "UniswapV3",
      "pool": "0x24a3ab2a20f5e903b5bb3efc3b4a60fcda17b496",
      "token0": {
        "address": "0x6793655c396eaee311fb4d3596b88fd7d195c79e",
        "name": "degeneratorv2",
        "symbol": "DGENV2",
        "decimals": 8
      },
      "token1": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "name": "Wrapped Ether",
        "symbol": "WETH",
        "decimals": 18
      },
      "positions": [
        {
          "tick_lower": -887270,
          "tick_upper": 230270,
          "token_id": "0x1b621",
          "token0": {
            "holdings": 4349.16,
            "rewards": 6.29
          },
          "token1": {
            "price_usd": 2035.61,
            "holdings": 0.04326,
            "rewards": 0.03198
          }
        }
      ],
      "logo": null,
      "value_usd": 176.34
    },
    {
      "type": "NftV4",
      "chain": "ethereum",
      "chain_id": 1,
      "protocol": "UniswapV4",
      "pool_id": "0x9b12b3178fc669bfdb323817678bd93e1248def252c75dbf37395f3260f98148",
      "pool_manager": "0x000000000004444c5dc75cb358380d2e3de08a90",
      "salt": "0x000000000000000000000000000000000000000000000000000000000001ac85",
      "token0": {
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "name": "USD Coin",
        "symbol": "USDC",
        "decimals": 6
      },
      "token1": {
        "address": "0xbd4b6f3b2278d727ae740c5449aaed6a09788e7c",
        "name": "APXCOIN",
        "symbol": "APX",
        "decimals": 18
      },
      "positions": [
        {
          "tick_lower": -887220,
          "tick_upper": 887220,
          "token_id": "0x1ac85",
          "token0": {
            "price_usd": 0.9999,
            "holdings": 59.26,
            "rewards": 0.67
          },
          "token1": {
            "price_usd": 5.12,
            "holdings": 10.55,
            "rewards": 1.27
          }
        }
      ],
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "value_usd": 120.41
    },
    {
      "type": "CompoundV2",
      "chain": "ethereum",
      "chain_id": 1,
      "token": {
        "address": "0x4ddc2d193948926d02f9b1fe9e1daa0718270ed5",
        "name": "Compound Ether",
        "symbol": "cETH"
      },
      "underlying_token": {
        "address": "0x0000000000000000000000000000000000000000",
        "name": "Ether",
        "symbol": "ETH",
        "decimals": 18,
        "holdings": 0.01291
      },
      "comptroller": "0x3d9819210a31b4961b30ef54be2aed79b9c9cd3b",
      "protocol": "Compound",
      "supply": {
        "balance": 0.64218463,
        "price_usd": 40.93,
        "value_usd": 26.28,
        "underlying_holdings": 0.01291
      },
      "value_usd": 26.28,
      "logo": null
    },
    {
      "type": "Morpho",
      "chain": "ethereum",
      "chain_id": 1,
      "morpho": "0xbbbbbbbbbb9cc5e90e3b3af64bdaf62c37eeffcb",
      "market_id": "0x00edbb2e2de487431e8be432f8f51215b01bcda10503617e2ee9c7d674492b47",
      "loan_token": {
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "name": "USD Coin",
        "symbol": "USDC",
        "decimals": 6
      },
      "collateral_token": {
        "address": "0xcd9f5907f92818bc06c9ad70217f089e190d2a32",
        "name": "Senior Royco USDC",
        "symbol": "srRoyUSDC",
        "decimals": 6
      },
      "supply": {
        "balance": 1000,
        "price_usd": 1,
        "value_usd": 1000,
        "underlying_holdings": 1000
      },
      "value_usd": 1000,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"
    },
    {
      "type": "Pendle",
      "chain": "ethereum",
      "chain_id": 1,
      "token_type": "Principal",
      "token": {
        "address": "0x917459337caac939d41d7493b3999f571d20d667",
        "name": "PT Ethena USDe 31JUL2025",
        "symbol": "PT-USDe-31JUL2025",
        "decimals": 18
      },
      "asset": {
        "address": "0x4c9edd5852cd905f086c759e8383e09bff1e68b3",
        "name": "USDe",
        "symbol": "USDe",
        "decimals": 18
      },
      "market": "0x9df192d13d61609d1852461c4850595e1f56e714",
      "balance": 1000,
      "price_usd": 0.9995,
      "value_usd": 999.5,
      "logo": "https://api.sim.dune.com/beta/token/logo/1/0x4c9edd5852cd905f086c759e8383e09bff1e68b3"
    },
    {
      "type": "FluidVault",
      "chain": "base",
      "chain_id": 8453,
      "vault_address": "0xa0f83fc5885cebc0420ce7c7b139adc80c4f4d91",
      "nft_id": "0xfd8",
      "vault_type": "T1",
      "is_liquidated": false,
      "supply0": {
        "token": {
          "address": "0xc1cba3fcea344f92d9239c08c0568f6f2f0ee452",
          "name": "Wrapped liquid staked Ether 2.0",
          "symbol": "wstETH",
          "decimals": 18
        },
        "quote": {
          "balance": 1.5,
          "price_usd": 2400,
          "value_usd": 3600
        }
      },
      "borrow0": {
        "token": {
          "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
          "name": "Ether",
          "symbol": "ETH",
          "decimals": 18
        },
        "quote": {
          "balance": 0.5,
          "price_usd": 2000,
          "value_usd": 1000
        }
      },
      "value_usd": 2600,
      "logo": null
    },
    {
      "type": "VeNft",
      "chain": "base",
      "chain_id": 8453,
      "ve_contract": "0xebf418fe2512e7e6bd9b87a8f0f294acdc67e6b4",
      "token_id": "0x62ff",
      "underlying_token": {
        "address": "0x940181a94a35a4569e4529a3cdfb74e38fd98631",
        "name": "Aerodrome",
        "symbol": "AERO",
        "decimals": 18
      },
      "locked_amount": 3.5276,
      "lock_end": 1751500800,
      "is_permanent": false,
      "value_usd": 1.11,
      "logo": "https://api.sim.dune.com/beta/token/logo/8453/0x940181a94a35a4569e4529a3cdfb74e38fd98631",
      "protocol": "AerodromeVeNFT"
    }
  ],
  "aggregations": {
    "total_value_usd": 22940.04,
    "total_by_chain": {
      "1": 16922.23,
      "8453": 6017.82
    }
  }
}

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 (/v1/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.

Response Structure

Every response contains a positions array and an aggregations object:

{
  "positions": [...],
  "aggregations": {
    "total_value_usd": 4201.34,
    "total_by_chain": {
      "1": 3800.00,
      "8453": 401.34
    }
  }
}

Each entry in positions has a type discriminator field that determines its shape. All positions also include chain (string name, e.g. "ethereum") and chain_id (numeric). Token metadata is returned as nested objects — not flat fields.

Supported Chains

Supported Protocols

Protocol coverage is organized by position type. Each protocol specifies its supported chains and the API response type under which it appears.

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

200

application/json

Successful response

positions · object[] · required

A single DeFi position. The type field discriminates the variant.

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Show child attributes

aggregations · object

Show child attributes

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.

Show child attributes