Overview

This is a beta endpoint currently under active development. We’re working to stabilize the API and will minimize breaking changes wherever possible, but they may still occur as we refine the interface.For production support or migration assistance, reach out at hello@allium.so.

Supported Protocols

Liquidity Pool Positions

Uniswap V2

Track LP positions in Uniswap V2 pools across all supported chains.Features:

Position ownership and balances
Pool composition and reserves
Fee tier information

Uniswap V3

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

Uniswap V4

Track hook-enabled liquidity positions in Uniswap V4.Features:

Hook-based position logic
Custom pool configurations
Advanced liquidity management

Historical backfill in progress

PancakeSwap V3

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

Lending Positions

Aave V3

Track lending and borrowing positions on Aave V3.Features:

Supplied assets and balances
Borrowed positions
Collateral and health factors

Compound V3

Track positions on Compound V3 (Comet) markets.Features:

Base asset positions
Collateral tracking
Market-specific data

Solana Positions

Solana Regular Positions

Track standard Solana positions across various programs.Features:

Token account positions
Program-specific positions
Realtime balance updates

Supported Chains

Chain	Chain ID	Status
Arbitrum	`arbitrum`	🌱 Beta
Avalanche	`avalanche`	🌱 Beta
Base	`base`	🌱 Beta
Blast	`blast`	🌱 Beta
BSC	`bsc`	🌱 Beta
Celo	`celo`	🌱 Beta
Ethereum	`ethereum`	🌱 Beta
MegaETH	`megaeth`	🌱 Beta
Monad	`monad`	🌱 Beta
Optimism	`optimism`	🌱 Beta
Plasma	`plasma`	🌱 Beta
Polygon	`polygon`	🌱 Beta
Solana	`solana`	🌱 Beta
Soneium	`soneium`	🌱 Beta
Unichain	`unichain`	🌱 Beta
World Chain	`worldchain`	🌱 Beta
X Layer	`x_layer`	🌱 Beta
zkSync	`zksync`	🌱 Beta
Zora	`zora`	🌱 Beta

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"
}

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

Realtime API

Stream Transformation API

Beam API

Explorer API

Deep Dives

Supported Protocols

Liquidity Pool Positions

Lending Positions

Solana Positions

Supported Chains

Data Model

Coming Soon

Hyperliquid Spot

EVM Staking

Solana LP & Lending

Hyperliquid Staking & Perps

Realtime API

Stream Transformation API

Beam API

Explorer API

Deep Dives

​Supported Protocols

​Liquidity Pool Positions

​Lending Positions

​Solana Positions

​Supported Chains

​Data Model

​Coming Soon

Hyperliquid Spot

EVM Staking

Solana LP & Lending

Hyperliquid Staking & Perps

Supported Protocols

Liquidity Pool Positions

Lending Positions

Solana Positions

Supported Chains

Data Model

Coming Soon