Wallet API
Wallet
Get EVM Portfolio

Get EVM Portfolio - Wallet API

Get EVM Portfolio - Returns comprehensive portfolio information for a wallet address

Get EVM Portfolio - [Value: 9185CU]
Returns comprehensive portfolio information for a wallet address, including native token balances, ERC-20 tokens, and DeFi positions across supported chains
GET https://lb.drpc.live/{chain}/{key}/lambda/v2/wallets/{address}/balances
Use cases

Use cases

  • Retrieve all token balances for a wallet on a specific EVM chain
  • Display user portfolio in wallets and dashboards
Constraints

Constraints

  • Supports only EVM-compatible chains
  • Requires valid wallet address and chain parameters
Get started
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
curl --request GET \
  --url https://lb.drpc.live/{chain}/{key}/lambda/v2/wallets/{address}/balances \
  --header 'accept: application/json'
Copy
Response
200
{
  "data": {
    "total_net_worth_usd": 83104610.57318147,
    "portfolio_allocation_usd": {
      "wallet": 696.2668659837276,
      "deposit": 83103914.30631548,
      "borrow": 0
    },
    "assets": [
      {
        "type": "defi",
        "id": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84-ethereum-aave v3 lending-deposit",
        "name": "Aave V3 Lending",
        "defi_id": "Aave V3 Lending",
        "defi_name": "Aave V3",
        "defi_url": "https://app.aave.com",
        "defi_icon_url": "https://static.lambda.p2p.org/protocols/aave-pool-v3.png",
        "chain_id": "ethereum",
        "chain_id_numeric": 1,
        "chain_name": "Ethereum",
        "chain_icon_url": "https://static.lambda.p2p.org/chains/ethereum.png",
        "value_usd": 83103914.30631548,
        "value_usd_change_1d": -764585.7447870523,
        "attributes": {
          "pool_address": "0x87870bca3f3fd6335c3f4ce8392d69350b4fa4e2",
          "rewards_value_usd": 0,
          "rewards_usd_change_1d": 0,
          "deposits": [
            {
              "category": "deposit",
              "token_id": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
              "token_symbol": "stETH",
              "token_name": "Lido Staked ETH",
              "contract_address": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
              "decimals": 18,
              "amount_string": "41719504281041810000000",
              "amount": 41719.50428104181,
              "price_usd": 1991.96792336,
              "value_usd": 83103914.30631548,
              "value_usd_change_1d": -764585.7447870523,
              "attributes": {
                "pnl_links": [],
                "icon_url": "https://static.lambda.p2p.org/tokens/eth/0xae7ab96520de3a18e5e111b5eaab095312d7fe84.png",
                "contract_implementations": [
                  {
                    "chain_id": "ethereum",
                    "chain_id_numeric": 1,
                    "chain_name": "Ethereum",
                    "address": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
                    "decimals": 18
                  },
                  {
                    "chain_id": "arbitrum",
                    "chain_id_numeric": 42161,
                    "chain_name": "Arbitrum",
                    "address": "0xabc...123",
                    "decimals": 18
                  }
                ]
              }
            }
          ],
          "loans": [],
          "rewards": [],
          "pnl_links": []
        }
      },
      {
        "type": "token",
        "id": "base-ethereum-asset-asset",
        "chain_id": "ethereum",
        "chain_id_numeric": 1,
        "chain_name": "Ethereum",
        "chain_icon_url": "https://static.lambda.p2p.org/chains/ethereum.png",
        "value_usd": 696.2668659837276,
        "value_usd_change_1d": -7.308658452814029,
        "attributes": {
          "token_id": "eth",
          "token_symbol": "ETH",
          "token_name": "Ethereum",
          "decimals": 18,
          "amount_string": "349696576689666633",
          "amount": 0.3496965766896666,
          "price_usd": 1991.06,
          "pnl_links": [],
          "contract_implementations": []
        }
      },
      {
        "type": "token",
        "id": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84-ethereum-asset-asset",
        "chain_id": "ethereum",
        "chain_id_numeric": 1,
        "chain_name": "Ethereum",
        "chain_icon_url": "https://static.lambda.p2p.org/chains/ethereum.png",
        "value_usd": 1.9919679233600003e-15,
        "value_usd_change_1d": -1.8326817587199723e-17,
        "attributes": {
          "token_id": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
          "token_symbol": "stETH",
          "token_name": "Lido Staked ETH",
          "contract_address": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84",
          "decimals": 18,
          "amount_string": "1",
          "amount": 0,
          "price_usd": 1991.06,
          "pnl_links": [
            "http://localhost:3301/api/v1/wallets/0x70ac8647e2ef008cb54db8e55657bced850c5032/chains/ethereum/pnl-history?position_id=0xae7ab96520de3a18e5e111b5eaab095312d7fe84&category=erc20"
          ],
          "icon_url": "https://static.lambda.p2p.org/tokens/eth/0xae7ab96520de3a18e5e111b5eaab095312d7fe84.png",
          "contract_implementations": []
        }
      }
    ],
    "meta_tokens": [
      {
        "type": "token",
        "id": "0xd9a442856c234a39a81a089c06451ebaa4306a72-ethereum-asset-asset",
        "chain_id": "ethereum",
        "chain_id_numeric": 1,
        "chain_name": "Ethereum",
        "chain_icon_url": "https://static.lambda.p2p.org/chains/ethereum.png",
        "value_usd": 2636.0385228235514,
        "value_usd_change_1d": 157.8171827220167,
        "attributes": {
          "token_id": "eb4d58b0-1cb0-42bb-b700-2489e078ee26",
          "token_symbol": "pufETH",
          "token_name": "pufETH",
          "contract_address": "0xd9a442856c234a39a81a089c06451ebaa4306a72",
          "decimals": 18,
          "amount_string": "800132917490221744",
          "amount": 0.8001329174902218,
          "price_usd": 3294.50078256,
          "pnl_links": [],
          "icon_url": "https://static.lambda.p2p.org/tokens/eth/0xd9a442856c234a39a81a089c06451ebaa4306a72.png",
          "contract_implementations": [
            {
              "chain_id": "ethereum",
              "chain_id_numeric": 1,
              "chain_name": "Ethereum",
              "address": "0xd9a442856c234a39a81a089c06451ebaa4306a72",
              "decimals": 18
            },
            {
              "chain_id": "soneium",
              "chain_id_numeric": 1868,
              "chain_name": "Soneium",
              "address": "0x6c460b2c6d6719562d5da43e5152b375e79b9a8b",
              "decimals": 18
            }
          ]
        },
        "asset_type": "token"
      }
    ]
  }
}
Copy

Path params

Parameters
chainstring
[Required] Target EVM chain (e.g. ethereum, polygon)
keystring
[Required] Your dRPC API key
addressstring
[Required] Wallet address

Query params

Parameters
chain_idstring
Filter by specific chain ID as defined in Wallet API. If not provided, data from all supported chains will be included.
asset_typestring
Specify the type of assets to return.
  • TOKEN - Returns only wallet-held tokens (e.g., ERC-20s)
  • DEFI - Returns only DeFi positions
  • ALL [default] - returns both
assets_idsstring
Optional list of specific asset or DeFi protocol IDs to include. Use token IDs (e.g., 'eth') or protocol IDs (e.g., 'sushiswap_v2'). If omitted, all available assets will be returned.
include_zero_price_tokensboolean
If True (default), includes tokens with price equal to 0 (e.g., airdrops, unverified tokens). Set to False to exclude such tokens, which helps reduce spam in portfolios.
include_meta_tokensboolean
If True, the response will include meta tokens—tokens that represent underlying assets in DeFi protocols. These tokens typically indicate positions in liquidity pools, lending platforms, or yield strategies. For example, aEthUSDT represents a USDT position supplied to the AAVE protocol. Default: false.

Request params

ParametersThis method does not accept any parameters.

Response

200

Response params

object
dataobject
[Required] User balances data.
object
total_net_worth_usdnumber
[Required] Total value in usd of all wallet's assets
portfolio_allocation_usdobject
[Required] all the portfolio allocations
object
walletnumber
[Required] Total value of assets that are on the address
depositnumber
[Required] Total value of assets deposited in DeFi
borrownumber
[Required] Total value of borrowed assets
assetsarray
[Required] User's defi positions and tokens.
object
typestring
[Required] Asset type in Wallet API
  • liquid_staking_token - null
  • token - null
  • defi - null
idstring
[Required] id of a asset in Wallet API
namestring
name of defi position. Possible types: Lending, Liquidity Pool, Deposit, Yield, Staked, Farming
defi_idstring
id of a DeFi in Wallet API
defi_namestring
Community name of DeFi
defi_urlstring
Link to the DeFi website
defi_icon_urlstring
URL to download icon of the DeFi.
chain_idstring
id of a chain in Wallet API
chain_id_numericnumeric
[Required] Numeric id of the chain
chain_namestring
[Required] Community name of a chain
chain_icon_urlstring
URL to download icon of the chain.
value_usdnumber
[Required] Total asset usd value on a wallet
value_usd_change_1dnumber
[Required] USD value changes in last day
attributesobject
[Required] Defi position token attributes
object
pnl_linksarray_of_strings
Links to get PNL for token or its token wrappers
icon_urlstring
URL to download icon of the token
contract_implementationsarray_of_objects
List of contract addresses for this token across supported chains
object
chain_idstring
[Required] Unique identifier of the chain in Lambda API (e.g., ethereum, arbitrum, polygon)
chain_id_numericinteger
Numeric chain ID (e.g., 1 for Ethereum, 42161 for Arbitrum)
chain_namestring
[Required] Community name of the chain (e.g., Ethereum, Arbitrum)
addressstring
[Required] Token contract address on the given chain
decimalsinteger
[Required] Number of decimal places the token uses on this chain
loansarray_of_objects
[Required] List of loan tokens in this position
object
categorystring
[Required] The position category indicating the type of DeFi interaction
token_idstring
[Required] Unique identifier for the token
token_symbolstring
[Required] Token symbol
token_namestring
[Required] Full name of the token
contract_addressstring
Smart contract address of the token on the blockchain
decimalsinteger
[Required] Number of decimal places used by the token
amount_stringstring
[Required] Token amount in smallest unit without decimal conversion (raw blockchain value)
amountnumber
[Required] Human-readable token amount after decimal conversion
price_usdnumber
[Required] Price of one token in USD
value_usdnumber
[Required] Total USD value of the token position
value_usd_change_1dnumber
[Required] 24-hour change in USD value due to price fluctuations
attributesobject
[Required] Defi position token attributes
object
pnl_linksarray_of_strings
Links to get PNL for token or its token wrappers
icon_urlstring
URL to download icon of the token
contract_implementationsarray_of_objects
List of contract addresses for this token across supported chains
object
chain_idstring
[Required] Unique identifier of the chain in Lambda API (e.g., ethereum, arbitrum, polygon)
chain_id_numericinteger
Numeric chain ID (e.g., 1 for Ethereum, 42161 for Arbitrum)
chain_namestring
[Required] Community name of the chain (e.g., Ethereum, Arbitrum)
addressstring
[Required] Token contract address on the given chain
decimalsinteger
[Required] Number of decimal places the token uses on this chain
rewardsarray_of_objects
[Required] List of rewards in this position
object
categorystring
[Required] The position category indicating the type of DeFi interaction
token_idstring
[Required] Unique identifier for the token
token_symbolstring
[Required] Token symbol
token_namestring
[Required] Full name of the token
contract_addressstring
Smart contract address of the token on the blockchain
decimalsinteger
[Required] Number of decimal places used by the token
amount_stringstring
[Required] Token amount in smallest unit without decimal conversion (raw blockchain value)
amountnumber
[Required] Human-readable token amount after decimal conversion
price_usdnumber
[Required] Price of one token in USD
value_usdnumber
[Required] Total USD value of the token position
value_usd_change_1dnumber
[Required] 24-hour change in USD value due to price fluctuations
attributesobject
[Required] Defi position token attributes
object
pnl_linksarray_of_strings
Links to get PNL for DeFi position
composite_symbolstring
Token pair symbol for liquidity pool positions
asset_typestring
[Required] Inferred asset type. Possible values:
  • token - Standard wallet token (ERC-20)
  • lp - Liquidity pool position
  • staking - Staked or locked tokens
  • loan - Borrowed position
  • reward - Rewards or airdrops
  • stream - Vesting or streaming contract
  • yield - Yield farming position
  • farming - Farming position
  • vesting - Vesting position
  • deposit - Generic DeFi deposit (non-LP)
  • unknown - Unable to classify
meta_tokensarray_of_objects
[Required] List of tokens that represent underlying assets in DeFi protocols.
object
typestring
[Required] Asset type in Wallet API
  • liquid_staking_token - null
  • token - null
  • defi - null
idstring
[Required] id of a asset in Wallet API
chain_idstring
id of a chain in Wallet API
chain_id_numericnumeric
[Required] Numeric id of the chain
chain_namestring
[Required] Community name of a chain
chain_icon_urlstring
URL to download icon of the chain.
value_usdnumber
[Required] Total asset usd value on a wallet
value_usd_change_1dnumber
[Required] USD value changes in last day
attributesobject
[Required] Asset-specific fields
object
token_idstring
[Required] ID of the token.
token_symbolstring
[Required] Symbol of the token.
token_namestring
[Required] Name of the token
contract_addressstring
[Required] Address of the token.
decimalsinteger
[Required] Number of decimal.
amount_stringinteger
[Required] Amount of tokens without decimals..
amountnumber
[Required] Token balance.
price_usdnumber
[Required] Token price in USD.
pnl_linksarray_of_strings
Links to get PNL for token inside the DeFi position.
icon_urlstring
URL to download icon of the token.
contract_implementationsarray_of_objects
List of contract addresses for this token across supported chains.
object
chain_idstring
[Required] The unique identifier of the chain in Wallet API where this token implementation exists. Example: 'ethereum', 'arbitrum', 'polygon'.
chain_id_numericinteger
[Required] The numeric chain ID. Example: 1 for Ethereum, 42161 for Arbitrum.
chain_namestring
[Required] The community name of the chain. Example: 'Ethereum', 'Arbitrum'.
addressstring
[Required] The token contract address on the given chain. Example: '0xa0b8...'.
decimalsstring
[Required] Number of decimal places the token uses on this chain. Used to convert between base units and human-readable format. Example: 6 for USDC, 18 for ETH.
asset_typestring
[Required] Inferred asset type. Possible values:
  • token - Standard wallet token (ERC-20)
  • lp - Liquidity pool position
  • staking - Staked or locked tokens
  • loan - Borrowed position
  • reward - Rewards or airdrops
  • stream - Vesting or streaming contract
  • yield - Yield farming position
  • farming - Farming position
  • vesting - Vesting position
  • deposit - Generic DeFi deposit (non-LP)
  • unknown - Unable to classify
Get Supported Chain By IdGet non-EVM Portfolio