> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.
# Overview
> Track realtime DeFi positions across liquidity pools, lending protocols, and staking platforms.
## Supported Chains
| Chain | Chain ID | Status |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------ |
| 
Arbitrum | `arbitrum` | ✅ Live |
| 
Avalanche | `avalanche` | ✅ Live |
| 
Base | `base` | ✅ Live |
| 
Blast | `blast` | ✅ Live |
| 
BSC | `bsc` | ✅ Live |
| 
Celo | `celo` | ✅ Live |
| 
Ethereum | `ethereum` | ✅ Live |
| 
Hyperliquid | `hyperliquid` | ✅ Live |
| 
MegaETH | `megaeth` | ✅ Live |
| 
Monad | `monad` | ✅ Live |
| 
Optimism | `optimism` | ✅ Live |
| 
Plasma | `plasma` | ✅ Live |
| 
Polygon | `polygon` | ✅ Live |
| 
Solana | `solana` | ✅ Live |
| 
Soneium | `soneium` | ✅ Live |
| 
Unichain | `unichain` | ✅ Live |
| 
World Chain | `worldchain` | ✅ Live |
| 
X Layer | `x_layer` | ✅ Live |
| 
zkSync | `zksync` | ✅ Live |
| 
Zora | `zora` | ✅ Live |
## 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
Track concentrated liquidity positions in PancakeSwap V3 pools.
**Features:**
* NFT-based position tracking (Uniswap V3 fork)
* Tick range and liquidity
* Fee tier and position status
Track concentrated liquidity positions on Raydium.
**Features:**
* Concentrated liquidity position tracking
* Tick range and liquidity
* Fee tier and position status
Track dynamic liquidity market maker positions on Meteora.
**Features:**
* DLMM bin-based position tracking
* Active bin range and liquidity
* Fee tier and position status
### 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
### Hyperliquid Positions
Track spot token holdings on Hyperliquid.
**Features:**
* Spot token balances
* Realtime price data
Track staking positions on Hyperliquid.
**Features:**
* Staked token balances
* Unclaimed rewards
* APY tracking
Track perpetual futures positions on Hyperliquid.
**Features:**
* Open perp positions
* Entry price and mark price
* Unrealized PnL
### Solana Positions
Track standard Solana positions across various programs.
**Features:**
* Token account positions
* Program-specific positions
* Realtime balance updates
## 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`, `perps`
```json theme={null}
{
"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"
}
```
```json theme={null}
{
"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"
}
```
```json theme={null}
{
"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"
}
```
```json theme={null}
{
"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"
}
```
## Coming Soon
Additional position types in development:
Monitor staking positions across EVM chains
Solana lending position tracking