getWalletBalances

You can use getWalletBalances method to retrieve all tokens on the connected user wallet address. For the full list of supported networks, see Supported Networks.

Usage

EVM

const data = await holyheldSDK.evm.getWalletBalances(
  '0x...',
);

Solana

const data = await holyheldSDK.solana.getWalletBalances(
  '...',
);

Parameters

Wallet Address

User's wallet address.

• Type: string

EVM

const data = await holyheldSDK.evm.getWalletBalances(
  '0x...', 
);

Solana

const data = await holyheldSDK.solana.getWalletBalances(
  '...', 
);

Returns

The SDK exports WalletBalancesEVM, WalletBalancesSolana, WalletTokenEVM, and WalletTokenSolana types. In practice, getWalletBalances() returns the following concrete shapes:

EVM

import { Network, NetworkKind } from '@holyheld/sdk';

type WalletTokenEVM = {
  name: string;
  address: string;
  symbol: string;
  decimals: number;
  network: Network;
  networkKind: NetworkKind.EVM;
  iconURL: string;
  priceUSD: string;
  balance: string;
  priceInEURForTopUp: string;
  meta: {
    permitData: {
      hasPermit: boolean;
      permitType?: string;
      permitVersion?: string;
    };
  };
};

type WalletBalancesEVM = {
  tokens: WalletTokenEVM[];
};

Solana

import { NetworkKind, SolanaNetwork } from '@holyheld/sdk';

type WalletTokenSolana = {
  name: string;
  address: string;
  symbol: string;
  decimals: number;
  network: SolanaNetwork;
  networkKind: NetworkKind.Solana;
  iconURL: string;
  priceUSD: string;
  balance: string;
  priceInEURForTopUp: string;
  meta: {
    tokenProgramId?: string;
  };
};

type WalletBalancesSolana = {
  tokens: WalletTokenSolana[];
};

Fields

Field	Type	Description
name	string	Token display name, for example USD Coin.
address	string	Token contract or mint address.
symbol	string	Token symbol, for example USDC.
decimals	number	Token decimals.
network	Network / SolanaNetwork	Blockchain network on which this token resides.
networkKind	NetworkKind	Blockchain family: EVM or Solana.
iconURL	string	Token icon URL.
priceUSD	string	Current token price in USD.
balance	string	Wallet balance as a decimal string.
priceInEURForTopUp	string	Token price converted to EUR for top-up calculations.
meta	object	Network-specific metadata.

meta for EVM tokens

type WalletTokenEVMMeta = {
  permitData: {
    hasPermit: boolean;
    permitType?: string;
    permitVersion?: string;
  };
};

meta for Solana tokens

type WalletTokenSolanaMeta = {
  tokenProgramId?: string;
};