Alpha Release - The DeFi Positions API is in alpha. Contact us for early access.
Allium’s DeFi Positions API provides realtime tracking of DeFi positions across multiple protocols and chains. Monitor liquidity pool positions, lending positions, and staking positions with unified data models.
Supported Networks: Ethereum, Solana, and other EVM chainsKey Features
Multi-Protocol Support Track positions across Uniswap, Aave, Compound, Solana programs, and more
Realtime Updates Get up-to-date position data with low-latency updates
Unified Data Model Consistent schema across different DeFi protocols and chains
Supported Protocols Liquidity Pool Positions
Track LP positions in Uniswap V2 pools across all supported chains. Features:
Position ownership and balances
Pool composition and reserves
Fee tier information
Track concentrated liquidity positions with range information. Features:
NFT-based position tracking
Tick range and liquidity
Fee tier and position status
Historical backfill in progress
Track hook-enabled liquidity positions in Uniswap V4. Features:
Hook-based position logic
Custom pool configurations
Advanced liquidity management
Historical backfill in progress
Lending Positions
Track lending and borrowing positions on Aave V3. Features:
Supplied assets and balances
Borrowed positions
Collateral and health factors
Track positions on Compound V3 (Comet) markets. Features:
Base asset positions
Collateral tracking
Market-specific data
Solana Positions
Track standard Solana positions across various programs. Features:
Token account positions
Program-specific positions
Realtime balance updates
Coming Soon Additional position types in development:
Hyperliquid Spot Track spot trading positions on Hyperliquid
EVM Staking Monitor staking positions across EVM chains
Solana LP & Lending Extended Solana DeFi position tracking
Hyperliquid Staking & Perps Staking and perpetual positions on Hyperliquid
Data Model The API returns positions as a flat array in items, with fields varying by position_type. Each position includes token objects with realtime price data.
Position types: LP, regular, lending, staked LP
Regular
Lending
Staked
{ "position_type" : "LP" , "chain" : "ethereum" , "address" : "0x1234567890abcdef1234567890abcdef12345678" , "position_id" : "604387" , "protocol" : "uniswap_v3" , "total_value_usd" : "15234.56" , "pool_address" : "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640" , "fee_tier" : "500" , "in_range" : true , "token0" : { "chain" : "ethereum" , "address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" , "price" : 1.0 , "decimals" : 6 , "symbol" : "USDC" }, "token1" : { "chain" : "ethereum" , "address" : "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" , "price" : 3245.12 , "decimals" : 18 , "symbol" : "WETH" }, "token0_amount" : "5000.123456" , "token1_amount" : "1.543210987654321" , "token0_amount_usd" : "5000.12" , "token1_amount_usd" : "10234.44" , "unclaimed_fees_token0" : "12.345678" , "unclaimed_fees_token1" : "0.001234567890123" , "unclaimed_fees_usd" : "16.35" }
{ "position_type" : "regular" , "chain" : "solana" , "address" : "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU" , "token" : { "chain" : "solana" , "address" : "So11111111111111111111111111111111111111112" , "price" : 142.35 , "decimals" : 9 , "symbol" : "SOL" }, "amount" : "25.123456789" , "amount_usd" : "3575.82" }
{ "position_type" : "lending" , "chain" : "ethereum" , "address" : "0x1234567890abcdef1234567890abcdef12345678" , "position_id" : "aave_v3_0x1234" , "protocol" : "aave_v3" , "total_value_usd" : "42500.00" , "pool_address" : "0x87870bca3f3fd6335c3f4ce8392d69350b4fa4e2" , "supplies" : [ { "token" : { "chain" : "ethereum" , "address" : "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" , "price" : 3245.12 , "decimals" : 18 , "symbol" : "WETH" }, "amount" : "10.5" , "amount_usd" : "34073.76" } ], "borrows" : [ { "token" : { "chain" : "ethereum" , "address" : "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48" , "price" : 1.0 , "decimals" : 6 , "symbol" : "USDC" }, "amount" : "8500.00" , "amount_usd" : "8500.00" } ], "collateral" : [ { "token" : { "chain" : "ethereum" , "address" : "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" , "price" : 3245.12 , "decimals" : 18 , "symbol" : "WETH" }, "amount" : "10.5" , "amount_usd" : "34073.76" } ], "health_factor" : "2.45" }
{ "position_type" : "staked" , "chain" : "ethereum" , "address" : "0x1234567890abcdef1234567890abcdef12345678" , "position_id" : "lido_steth_0x1234" , "protocol" : "lido" , "total_value_usd" : "16225.60" , "pool_address" : "0xae7ab96520de3a18e5e111b5eaab095312d7fe84" , "staked_token" : { "chain" : "ethereum" , "address" : "0xae7ab96520de3a18e5e111b5eaab095312d7fe84" , "price" : 3245.12 , "decimals" : 18 , "symbol" : "stETH" }, "staked_amount" : "5.0" , "staked_amount_usd" : "16225.60" , "rewards_token" : { "chain" : "ethereum" , "address" : "0xae7ab96520de3a18e5e111b5eaab095312d7fe84" , "price" : 3245.12 , "decimals" : 18 , "symbol" : "stETH" }, "unclaimed_rewards" : "0.0123" , "unclaimed_rewards_usd" : "39.91" , "apy" : "3.2" }
Use Cases
Portfolio Tracking Build comprehensive portfolio views across all DeFi positions
Risk Management Monitor collateralization ratios and position health
Analytics Dashboards Create protocol-specific or cross-protocol analytics
Wallet Applications Display user positions in wallet interfaces
Getting Started The DeFi Positions API is in alpha. To get access, contact us or reach out to your account manager. Ready to start querying positions? Check out the endpoint documentation to learn how to fetch positions for specific wallets and protocols.
Rate Limits & Compute Units The DeFi Positions API follows standard compute unit pricing based on the complexity of queries and data returned. 
