---
title: "Wallet DeFi Positions"
method: POST
path: "/api/v1/developer/wallet/positions"
tags: ["WALLET", "DEVELOPER"]
---

# Wallet DeFi Positions

`POST /api/v1/developer/wallet/positions`

Get DeFi positions (LP and lending) for up to 5 wallet addresses.

## Query parameters

- `limit` integer — Max number of positions returned. Default is 25.
- `cursor` string — Cursor to request the next page of results.

## Request body

- PayloadAddress[] — List of chain+addresses to get positions for.
  - `chain` string, required — Lowercase chain name
  - `address` string, required — Wallet address

## Response `200`

Successful Response

- WalletPositionsEnvelope — Response envelope for wallet positions with pagination support.
  - `items` union[], required — List of DeFi positions across all requested wallets
    - union
      - LPPosition — Liquidity provider position (e.g., Uniswap V3, Raydium CLMM, Meteora DLMM). Concentrated or standard AMM positions.
        - `chain` string, required — Lowercase chain name
        - `address` string, required — Wallet address that holds this position
        - `position_id` string, required — Unique identifier for the position
        - `protocol` string, required — Protocol name (e.g. uniswap-v3, aave-v3)
        - `total_value_usd` string, nullable — Total USD value of the position
        - `position_type` 'LP'
        - `pool_address` string, required — Pool contract address
        - `fee_tier` string, nullable — Pool fee tier (e.g. 0.3%)
        - `in_range` boolean, nullable — Whether the position is within the active price range
        - `token0` Token, required
          - `object` 'token'
          - `chain` string, required — Lowercase chain name
          - `address` string, required — Token contract address
          - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
          - `price` number, nullable — Current price (USD)
          - `decimals` integer, nullable — Token decimal places
          - `info` TokenInfo
            - `name` string, required — Token name
            - `symbol` string, required — Token symbol
          - `attributes` TokenAttributes
            - `total_liquidity_usd` LiquidityResults
              - …
            - `price_diff_1d` number, nullable — Price change (USD) over last 24h
            - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
            - `price_diff_1h` number, nullable — Price change (USD) over last 1h
            - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
            - `total_supply` number, nullable — Total token supply
            - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
            - `volume_1h` number, nullable — Trading volume over last 1h
            - `volume_1d` number, nullable — Trading volume over last 24h
            - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
            - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
            - `volume_24h` number, nullable — Trading volume over last 24h
            - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
            - `trade_count_1h` integer, nullable — Trade count over last 1h
            - `trade_count_1d` integer, nullable — Trade count over last 24h
            - `all_time_high` number, nullable — All-time high price (USD)
            - `all_time_low` number, nullable — All-time low price (USD)
            - `image_url` string, nullable — Token logo URL
            - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
            - `holders_count` integer, nullable — Number of token holders
            - `stellar_fields` object, nullable — Stellar-specific metadata
        - `token1` Token, required
          - `object` 'token'
          - `chain` string, required — Lowercase chain name
          - `address` string, required — Token contract address
          - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
          - `price` number, nullable — Current price (USD)
          - `decimals` integer, nullable — Token decimal places
          - `info` TokenInfo
            - `name` string, required — Token name
            - `symbol` string, required — Token symbol
          - `attributes` TokenAttributes
            - `total_liquidity_usd` LiquidityResults
              - …
            - `price_diff_1d` number, nullable — Price change (USD) over last 24h
            - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
            - `price_diff_1h` number, nullable — Price change (USD) over last 1h
            - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
            - `total_supply` number, nullable — Total token supply
            - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
            - `volume_1h` number, nullable — Trading volume over last 1h
            - `volume_1d` number, nullable — Trading volume over last 24h
            - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
            - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
            - `volume_24h` number, nullable — Trading volume over last 24h
            - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
            - `trade_count_1h` integer, nullable — Trade count over last 1h
            - `trade_count_1d` integer, nullable — Trade count over last 24h
            - `all_time_high` number, nullable — All-time high price (USD)
            - `all_time_low` number, nullable — All-time low price (USD)
            - `image_url` string, nullable — Token logo URL
            - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
            - `holders_count` integer, nullable — Number of token holders
            - `stellar_fields` object, nullable — Stellar-specific metadata
        - `token0_amount` string, required — Amount of token0 in the position (human-readable decimal string)
        - `token1_amount` string, required — Amount of token1 in the position (human-readable decimal string)
        - `token0_amount_usd` string, nullable — USD value of token0 amount
        - `token1_amount_usd` string, nullable — USD value of token1 amount
        - `unclaimed_fees_token0` string, nullable — Unclaimed fee amount in token0
        - `unclaimed_fees_token1` string, nullable — Unclaimed fee amount in token1
        - `unclaimed_fees_usd` string, nullable — Total unclaimed fees in USD
      - LendingPosition — Lending/borrowing position (e.g., Aave, Compound, Kamino).
        - `chain` string, required — Lowercase chain name
        - `address` string, required — Wallet address that holds this position
        - `position_id` string, required — Unique identifier for the position
        - `protocol` string, required — Protocol name (e.g. uniswap-v3, aave-v3)
        - `total_value_usd` string, nullable — Total USD value of the position
        - `position_type` 'lending'
        - `pool_address` string, required — Lending pool contract address
        - `supplies` LendingAsset[], required — Assets supplied to the pool
          - `token` Token, required
            - `object` 'token'
            - `chain` string, required — Lowercase chain name
            - `address` string, required — Token contract address
            - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
            - `price` number, nullable — Current price (USD)
            - `decimals` integer, nullable — Token decimal places
            - `info` TokenInfo
              - …
            - `attributes` TokenAttributes
              - …
          - `amount` string, required — Token amount (human-readable decimal string)
          - `amount_usd` string, nullable — USD value of the amount
        - `borrows` LendingAsset[], required — Assets borrowed from the pool
          - `token` Token, required
            - `object` 'token'
            - `chain` string, required — Lowercase chain name
            - `address` string, required — Token contract address
            - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
            - `price` number, nullable — Current price (USD)
            - `decimals` integer, nullable — Token decimal places
            - `info` TokenInfo
              - …
            - `attributes` TokenAttributes
              - …
          - `amount` string, required — Token amount (human-readable decimal string)
          - `amount_usd` string, nullable — USD value of the amount
        - `collateral` LendingAsset[], required — Assets posted as collateral
          - `token` Token, required
            - `object` 'token'
            - `chain` string, required — Lowercase chain name
            - `address` string, required — Token contract address
            - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
            - `price` number, nullable — Current price (USD)
            - `decimals` integer, nullable — Token decimal places
            - `info` TokenInfo
              - …
            - `attributes` TokenAttributes
              - …
          - `amount` string, required — Token amount (human-readable decimal string)
          - `amount_usd` string, nullable — USD value of the amount
        - `health_factor` string, nullable — Position health factor (below 1.0 is liquidatable)
      - VaultPosition — Vault/pool share position (e.g., Kamino strategy vaults, Jupiter LP). Users hold share tokens representing proportional claims on vault-managed assets.
        - `chain` string, required — Lowercase chain name
        - `address` string, required — Wallet address that holds this position
        - `position_id` string, required — Unique identifier for the position
        - `protocol` string, required — Protocol name (e.g. uniswap-v3, aave-v3)
        - `total_value_usd` string, nullable — Total USD value of the position
        - `position_type` 'vault'
        - `pool_address` string, required — Vault/pool account address
        - `share_token` Token, required
          - `object` 'token'
          - `chain` string, required — Lowercase chain name
          - `address` string, required — Token contract address
          - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
          - `price` number, nullable — Current price (USD)
          - `decimals` integer, nullable — Token decimal places
          - `info` TokenInfo
            - `name` string, required — Token name
            - `symbol` string, required — Token symbol
          - `attributes` TokenAttributes
            - `total_liquidity_usd` LiquidityResults
              - …
            - `price_diff_1d` number, nullable — Price change (USD) over last 24h
            - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
            - `price_diff_1h` number, nullable — Price change (USD) over last 1h
            - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
            - `total_supply` number, nullable — Total token supply
            - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
            - `volume_1h` number, nullable — Trading volume over last 1h
            - `volume_1d` number, nullable — Trading volume over last 24h
            - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
            - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
            - `volume_24h` number, nullable — Trading volume over last 24h
            - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
            - `trade_count_1h` integer, nullable — Trade count over last 1h
            - `trade_count_1d` integer, nullable — Trade count over last 24h
            - `all_time_high` number, nullable — All-time high price (USD)
            - `all_time_low` number, nullable — All-time low price (USD)
            - `image_url` string, nullable — Token logo URL
            - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
            - `holders_count` integer, nullable — Number of token holders
            - `stellar_fields` object, nullable — Stellar-specific metadata
        - `share_balance` string, required — User's share token balance (human-readable decimal string)
        - `total_shares` string, required — Total share tokens outstanding (human-readable decimal string)
        - `underlying_assets` LendingAsset[], required — Vault's underlying assets with user's pro-rata share
          - `token` Token, required
            - `object` 'token'
            - `chain` string, required — Lowercase chain name
            - `address` string, required — Token contract address
            - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
            - `price` number, nullable — Current price (USD)
            - `decimals` integer, nullable — Token decimal places
            - `info` TokenInfo
              - …
            - `attributes` TokenAttributes
              - …
          - `amount` string, required — Token amount (human-readable decimal string)
          - `amount_usd` string, nullable — USD value of the amount
      - StakedPosition — Staked/held DeFi position (e.g., staking pools, liquid staking, vaults). Simpler than LP - single token staked with optional rewards.
        - `chain` string, required — Lowercase chain name
        - `address` string, required — Wallet address that holds this position
        - `position_id` string, required — Unique identifier for the position
        - `protocol` string, required — Protocol name (e.g. uniswap-v3, aave-v3)
        - `total_value_usd` string, nullable — Total USD value of the position
        - `position_type` 'staked'
        - `pool_address` string, nullable — Staking pool contract address
        - `staked_token` Token, required
          - `object` 'token'
          - `chain` string, required — Lowercase chain name
          - `address` string, required — Token contract address
          - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
          - `price` number, nullable — Current price (USD)
          - `decimals` integer, nullable — Token decimal places
          - `info` TokenInfo
            - `name` string, required — Token name
            - `symbol` string, required — Token symbol
          - `attributes` TokenAttributes
            - `total_liquidity_usd` LiquidityResults
              - …
            - `price_diff_1d` number, nullable — Price change (USD) over last 24h
            - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
            - `price_diff_1h` number, nullable — Price change (USD) over last 1h
            - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
            - `total_supply` number, nullable — Total token supply
            - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
            - `volume_1h` number, nullable — Trading volume over last 1h
            - `volume_1d` number, nullable — Trading volume over last 24h
            - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
            - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
            - `volume_24h` number, nullable — Trading volume over last 24h
            - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
            - `trade_count_1h` integer, nullable — Trade count over last 1h
            - `trade_count_1d` integer, nullable — Trade count over last 24h
            - `all_time_high` number, nullable — All-time high price (USD)
            - `all_time_low` number, nullable — All-time low price (USD)
            - `image_url` string, nullable — Token logo URL
            - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
            - `holders_count` integer, nullable — Number of token holders
            - `stellar_fields` object, nullable — Stellar-specific metadata
        - `staked_amount` string, required — Amount staked (human-readable decimal string)
        - `staked_amount_usd` string, nullable — USD value of staked amount
        - `rewards_token` Token
          - `object` 'token'
          - `chain` string, required — Lowercase chain name
          - `address` string, required — Token contract address
          - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
          - `price` number, nullable — Current price (USD)
          - `decimals` integer, nullable — Token decimal places
          - `info` TokenInfo
            - `name` string, required — Token name
            - `symbol` string, required — Token symbol
          - `attributes` TokenAttributes
            - `total_liquidity_usd` LiquidityResults
              - …
            - `price_diff_1d` number, nullable — Price change (USD) over last 24h
            - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
            - `price_diff_1h` number, nullable — Price change (USD) over last 1h
            - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
            - `total_supply` number, nullable — Total token supply
            - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
            - `volume_1h` number, nullable — Trading volume over last 1h
            - `volume_1d` number, nullable — Trading volume over last 24h
            - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
            - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
            - `volume_24h` number, nullable — Trading volume over last 24h
            - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
            - `trade_count_1h` integer, nullable — Trade count over last 1h
            - `trade_count_1d` integer, nullable — Trade count over last 24h
            - `all_time_high` number, nullable — All-time high price (USD)
            - `all_time_low` number, nullable — All-time low price (USD)
            - `image_url` string, nullable — Token logo URL
            - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
            - `holders_count` integer, nullable — Number of token holders
            - `stellar_fields` object, nullable — Stellar-specific metadata
        - `unclaimed_rewards` string, nullable — Unclaimed reward amount
        - `unclaimed_rewards_usd` string, nullable — USD value of unclaimed rewards
        - `rewards_additive` boolean — Whether unclaimed_rewards_usd is additive to total_value_usd. False for LSTs where the staked token price already captures underlying value.
        - `apy` string, nullable — Annual percentage yield
      - PerpPosition — Perpetual futures position (e.g., Hyperliquid, dYdX).
        - `chain` string, required — Lowercase chain name
        - `address` string, required — Wallet address that holds this position
        - `position_id` string, required — Unique identifier for the position
        - `protocol` string, required — Protocol name (e.g. uniswap-v3, aave-v3)
        - `total_value_usd` string, nullable — Total USD value of the position
        - `position_type` 'perp'
        - `coin` string, required — Traded asset symbol (e.g. BTC, ETH)
        - `size` string, required — Position size in units of the base asset
        - `entry_price` string, required — Average entry price in USD
        - `mark_price` string, nullable — Current mark price in USD
        - `unrealized_pnl` string, required — Unrealized profit/loss in USD
        - `leverage_type` string, nullable — Leverage type (e.g. cross, isolated)
        - `leverage_value` string, nullable — Leverage multiplier (e.g. 10x)
        - `liquidation_price` string, nullable — Price at which the position will be liquidated
        - `margin_used` string, nullable — Margin used by this position in USD
        - `return_on_equity` string, nullable — Return on equity as a decimal (e.g. 0.05 = 5%)
      - RegularPosition — Regular token holding - what tokens a wallet holds and in what amounts. Used for chains like Solana where we just want to show current balances.
        - `position_type` 'regular'
        - `chain` string, required — Lowercase chain name
        - `address` string, required — Wallet address
        - `token` Token, required
          - `object` 'token'
          - `chain` string, required — Lowercase chain name
          - `address` string, required — Token contract address
          - `type` 'native' | 'non_native' | 'evm_erc20' | 'evm_erc721' | 'evm_erc1155' | 'sol_spl' | 'sui_token' | 'near_nep141' | 'near_nep245' | 'stellar_classic' | 'stellar_sac' | 'stellar_wasm', nullable — Token standard type: evm_erc20/evm_erc721/evm_erc1155 (EVMs), sol_spl (Solana), sui_token (Sui), near_nep141/near_nep245 (Near), stellar_classic/stellar_sac/stellar_wasm (Stellar), or native (All)
          - `price` number, nullable — Current price (USD)
          - `decimals` integer, nullable — Token decimal places
          - `info` TokenInfo
            - `name` string, required — Token name
            - `symbol` string, required — Token symbol
          - `attributes` TokenAttributes
            - `total_liquidity_usd` LiquidityResults
              - …
            - `price_diff_1d` number, nullable — Price change (USD) over last 24h
            - `price_diff_pct_1d` number, nullable — Price change (%) over last 24h
            - `price_diff_1h` number, nullable — Price change (USD) over last 1h
            - `price_diff_pct_1h` number, nullable — Price change (%) over last 1h
            - `total_supply` number, nullable — Total token supply
            - `fully_diluted_valuation_usd` number, nullable — Fully diluted valuation (USD)
            - `volume_1h` number, nullable — Trading volume over last 1h
            - `volume_1d` number, nullable — Trading volume over last 24h
            - `volume_usd_1h` number, nullable — Trading volume (USD) over last 1h
            - `volume_usd_1d` number, nullable — Trading volume (USD) over last 24h
            - `volume_24h` number, nullable — Trading volume over last 24h
            - `volume_usd_24h` number, nullable — Trading volume (USD) over last 24h
            - `trade_count_1h` integer, nullable — Trade count over last 1h
            - `trade_count_1d` integer, nullable — Trade count over last 24h
            - `all_time_high` number, nullable — All-time high price (USD)
            - `all_time_low` number, nullable — All-time low price (USD)
            - `image_url` string, nullable — Token logo URL
            - `token_creation_time` string, date-time, nullable — Token creation timestamp (UTC)
            - `holders_count` integer, nullable — Number of token holders
            - `stellar_fields` object, nullable — Stellar-specific metadata
        - `amount` string, required — Token balance (human-readable decimal string)
        - `amount_usd` string, nullable — USD value of the balance
        - `sub_type` string — Position source (e.g. spot, perp_margin)
        - `block_timestamp` string, nullable
        - `block_number` integer, nullable
  - `cursor` string, nullable — Pagination cursor for the next page of results
  - `total` integer, nullable — Total number of positions across all pages

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/allium/apis/allium-account-api.md) · [All operations](https://skmtc.net/allium/apis/allium-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/allium/allium-account-api/versions/6c79c032c85d/schema)