Skip to main content
POST
Wallet DeFi Positions

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, SushiSwap V2/V3, Raydium CLMM, Meteora DLMM, Orca Whirlpool, and more)
  • lending — Lending/borrowing positions (Aave V3, Compound V3, Morpho Blue, Term Finance, Kamino Lend, Loopscale)
  • staked — Liquid-staking and restaking positions (Lido, Rocket Pool, EtherFi, Kelp, Mantle mETH, Swell, Benqi sAVAX, Kinetiq kHYPE, Symbiotic vaults, Pendle PT, Sanctum LSTs, Marinade, Jito, etc.)
  • regular — Simple token holdings (Solana balances, Hyperliquid spot)
  • perps — Perpetual futures positions (Hyperliquid)

Supported Chains

Supported Protocols

EVM — Concentrated-liquidity LPs (NFT positions)

EVM — Lending

EVM — V2 AMM / pool LPs

EVM — Yield & restaking

EVM — Liquid staking tokens (LSTs)

Solana

Hyperliquid

Full account state via Hyperliquid API — perps, spot holdings, and staking. No sub-protocols.

Loopscale

Solana-based lending protocol — exposed as its own chain identifier.

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
  • Up to 5 address/chain pairs may be submitted per request
  • Use the returned cursor query parameter to paginate through large result sets
  • LST and Kamino vault registries are refreshed in the background, so new tokens become recognized without a deploy

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

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.

Example:
cursor
string | null

Pagination cursor for the next page of results

total
integer | null

Total number of positions across all pages