This page has been updated for Wallets SDK V1. If you are using the previous version,
see the previous version of this page or the V1 migration guide.
- Token Balances
- NFT Balances
Prerequisites
- Ensure you have a wallet created.
- API Key: Ensure you have an API key with the scopes:
wallets.readandwallets:balance.read.
Retrieving Wallet Balances
- React
- Node.js
- React Native
- Swift
- REST
import { useWallet } from '@crossmint/client-sdk-react-ui';
const { wallet } = useWallet();
const { nativeToken, usdc, tokens } = await wallet.balances(["usdc"]);
import { CrossmintWallets, createCrossmint } from "@crossmint/wallets-sdk";
const crossmint = createCrossmint({
apiKey: "<your-server-api-key>",
});
const crossmintWallets = CrossmintWallets.from(crossmint);
const wallet = await crossmintWallets.getWallet(
"<wallet-address>",
{ chain: "base-sepolia" }
);
const { nativeToken, usdc, tokens } = await wallet.balances(["usdc"]);
import { useWallet } from '@crossmint/client-sdk-react-native-ui';
const { wallet } = useWallet();
const { nativeToken, usdc, tokens } = await wallet.balances(["usdc"]);
import CrossmintClient
import Wallet
let sdk = CrossmintSDK.shared
let wallet = try await sdk.crossmintWallets.getWallet(
chain: .baseSepolia
)
let balances = try await wallet.balances(["usdc"])
Parameters
The tokens to get the balances for. This can be a token symbol or a token address.
Returns
The balances of the wallet.
Show properties
Show properties
The native token balance.
Show properties
Show properties
The amount of the token in decimal format (e.g. "42.69").
The amount of the token in its smallest indivisible unit (e.g. 1000000 for 1 USDC when
decimals = 6).The symbol of the token (e.g. USDC, ETH, etc.).
The contract address (EVM, Stellar) or mint hash (Solana) of the token.
The number of digits after the decimal point (e.g. 6 for USDC).
rawAmount divided by 10 to the power of
decimals gives the amount.The USDC balance.
Show properties
Show properties
The amount of the token in decimal format (e.g. "42.69").
The amount of the token in its smallest indivisible unit (e.g. 1000000 for 1 USDC when
decimals = 6).The symbol of the token (e.g. USDC, ETH, etc.).
The contract address (EVM, Stellar) or mint hash (Solana) of the token.
The number of digits after the decimal point (e.g. 6 for USDC).
rawAmount divided by 10 to the power of
decimals gives the amount.The tokens balances.
Show properties
Show properties
The amount of the token in decimal format (e.g. "42.69").
The amount of the token in its smallest indivisible unit (e.g. 1000000 for 1 USDC when
decimals = 6).The symbol of the token (e.g. USDC, ETH, etc.).
The contract address (EVM, Stellar) or mint hash (Solana) of the token.
The number of digits after the decimal point (e.g. 6 for USDC).
rawAmount divided by 10 to the power of
decimals gives the amount.curl --request GET \
--url 'https://staging.crossmint.com/api/2025-06-09/wallets/email:user@example.com:evm/balances?tokens=usdc&chains=base-sepolia' \
--header 'X-API-KEY: <x-api-key>'
Prerequisites
- Ensure you have a wallet created.
- API Key: Ensure you have an API key with the scopes:
wallets.read,wallets.nfts.read.
Retrieving NFTs
- React
- Node.js
- React Native
- Swift
- REST
import { useWallet } from '@crossmint/client-sdk-react-ui';
const { wallet } = useWallet();
const nfts = await wallet.nfts({ page: 1, perPage: 10 });
import { CrossmintWallets, createCrossmint } from "@crossmint/wallets-sdk";
const crossmint = createCrossmint({
apiKey: "<your-server-api-key>",
});
const crossmintWallets = CrossmintWallets.from(crossmint);
const wallet = await crossmintWallets.getWallet(
"<wallet-address>",
{ chain: "base-sepolia" }
);
const nfts = await wallet.nfts({ page: 1, perPage: 10 });
import { useWallet } from '@crossmint/client-sdk-react-native-ui';
const { wallet } = useWallet();
const nfts = await wallet.nfts({ page: 1, perPage: 10 });
import CrossmintClient
import Wallet
let sdk = CrossmintSDK.shared
let wallet = try await sdk.crossmintWallets.getWallet(
chain: .baseSepolia
)
let nfts = try await wallet.nfts(page: 1, nftsPerPage: 10)
Parameters
The number of NFTs to return per page.
The page number to return.
Returns
The NFTs.
curl --request GET \
--url 'https://staging.crossmint.com/api/2022-06-09/wallets/email:user@example.com:base/nfts?page=1&perPage=20' \
--header 'X-API-KEY: <x-api-key>'