Skip to main content
GET
/
v1
/
evm
/
defi
/
positions
/
{address}
Get DeFi positions for an address
curl --request GET \
  --url https://api.sim.dune.com/v1/evm/defi/positions/{address} \
  --header 'X-Sim-Api-Key: <api-key>'
{
  "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
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.sim.dune.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Successful response

​
positions
object[]
required

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

​
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.