Fetch DeFi Positions

Retrieve DeFi positions for a wallet across multiple protocols and chains

POST /api/v1/developer/wallet/positions

Wallet DeFi Positions

cURL

curl --request POST \
  --url https://api.allium.so/api/v1/developer/wallet/positions \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
[
  {
    "chain": "solana",
    "address": "125Z6k4ZAxsgdG7JxrKZpwbcS1rxqpAeqM9GSCKd66Wp"
  }
]
'

200

{
  "items": [
    {
      "address": "0xab16781a13fe343a275f4bb5c883a64ceda52917",
      "chain": "ethereum",
      "fee_tier": "500",
      "in_range": true,
      "pool_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
      "position_id": "uniswap_v3-ethereum-637818",
      "position_type": "LP",
      "protocol": "uniswap_v3",
      "token0": {
        "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "chain": "ethereum",
        "decimals": 6,
        "info": {
          "name": "USD Coin",
          "symbol": "USDC"
        },
        "object": "token",
        "type": "evm_erc20"
      },
      "token0_amount": "2100.543210",
      "token0_amount_usd": "2100.54",
      "token1": {
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "chain": "ethereum",
        "decimals": 18,
        "info": {
          "name": "Wrapped Ether",
          "symbol": "WETH"
        },
        "object": "token",
        "type": "evm_erc20"
      },
      "token1_amount": "1.234567890123456789",
      "token1_amount_usd": "2421.33",
      "total_value_usd": "4521.87",
      "unclaimed_fees_token0": "3.210000",
      "unclaimed_fees_token1": "0.001234567890123456",
      "unclaimed_fees_usd": "5.63"
    }
  ],
  "cursor": "<string>",
  "total": 123
}

Position Types

The response contains a flat array of positions in items. Each position has a position_type discriminator:

• LP — Liquidity pool positions (Uniswap V2/V3/V4, PancakeSwap V3, Raydium CLMM, Meteora DLMM)
• lending — Lending/borrowing positions (Aave V3, Compound V3)
• staked — Staking positions (Lido, Hyperliquid, etc.)
• regular — Simple token holdings (Solana balances, Hyperliquid spot)
• perps — Perpetual futures positions (Hyperliquid)

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

Important Notes

• USD value fields (total_value_usd, token0_amount_usd, staked_amount_usd, etc.) may return null when price data is temporarily unavailable
• Positions are sorted by type priority (lending > LP > staked > regular), then by USD value descending
• Each entry in the request array is an address/chain pair — to query the same address on multiple chains, include separate entries for each chain
• Use the returned cursor query parameter to paginate through large result sets

Authorizations

X-API-KEY · string · header · required

Query Parameters

limit · integer · default: 25

Max number of positions returned. Default is 25.

Required range: x <= 100

cursor · string

Cursor to request the next page of results.

Body

application/json

Required array length: 1 - 5 elements

chain · string · required

Lowercase chain name

address · string · required

Wallet address

Response

200

application/json

Successful Response

Response envelope for wallet positions with pagination support.

items · (LPPosition · object | LendingPosition · object | VaultPosition · object | StakedPosition · object | PerpPosition · object | RegularPosition · object)[] · required

List of DeFi positions across all requested wallets

Liquidity provider position (e.g., Uniswap V3, Raydium CLMM, Meteora DLMM). Concentrated or standard AMM positions.

LPPosition

LendingPosition

VaultPosition

StakedPosition

PerpPosition

RegularPosition

Show child attributes

Example:

{
  "address": "0xab16781a13fe343a275f4bb5c883a64ceda52917",
  "chain": "ethereum",
  "fee_tier": "500",
  "in_range": true,
  "pool_address": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
  "position_id": "uniswap_v3-ethereum-637818",
  "position_type": "LP",
  "protocol": "uniswap_v3",
  "token0": {
    "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
    "chain": "ethereum",
    "decimals": 6,
    "info": { "name": "USD Coin", "symbol": "USDC" },
    "object": "token",
    "type": "evm_erc20"
  },
  "token0_amount": "2100.543210",
  "token0_amount_usd": "2100.54",
  "token1": {
    "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "chain": "ethereum",
    "decimals": 18,
    "info": { "name": "Wrapped Ether", "symbol": "WETH" },
    "object": "token",
    "type": "evm_erc20"
  },
  "token1_amount": "1.234567890123456789",
  "token1_amount_usd": "2421.33",
  "total_value_usd": "4521.87",
  "unclaimed_fees_token0": "3.210000",
  "unclaimed_fees_token1": "0.001234567890123456",
  "unclaimed_fees_usd": "5.63"
}

cursor · string | null

Pagination cursor for the next page of results

total · integer | null

Total number of positions across all pages