Check Balances

Retrieve and manage wallet balances using Crossmint’s APIs

You are viewing docs for the previous version of the Wallets SDK. We recommend upgrading to V1. See the updated version of this page or the V1 migration guide.

Token Balances

Prerequisites

• Ensure you have a wallet created.
• API Key: Ensure you have an API key with the scopes: wallets.read and wallets:balance.read.

Retrieving Wallet Balances

React

import { useWallet } from '@crossmint/client-sdk-react-ui';

const { wallet } = useWallet();

const { nativeToken, usdc, tokens } = await wallet.balances(["usdc"]);

See the React SDK reference for more details.

Node.js

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", signer: { type: "external-wallet" } }
);

const { nativeToken, usdc, tokens } = await wallet.balances(["usdc"]);

See the SDK reference for all parameters and return types.

React Native

import { useWallet } from '@crossmint/client-sdk-react-native-ui';

const { wallet } = useWallet();

const { nativeToken, usdc, tokens } = await wallet.balances(["usdc"]);

See the React Native SDK reference for more details.

Swift

import CrossmintClient
import Wallet

let sdk = CrossmintSDK.shared

let wallet = try await sdk.crossmintWallets.getOrCreateWallet(
    chain: .baseSepolia,
    signer: .email("[e-mail]")
)

let balances = try await wallet.balances(["usdc"])

Parameters

tokens · string[]

The tokens to get the balances for. This can be a token symbol or a token address.

Returns

balances · Balances

The balances of the wallet.

Show properties

nativeToken · TokenBalance

The native token balance.

Show properties

amount · string

The amount of the token in decimal format (e.g. "42.69").

rawAmount · string

The amount of the token in its smallest indivisible unit (e.g. 1000000 for 1 USDC when decimals = 6).

symbol · string

The symbol of the token (e.g. USDC, ETH, etc.).

contractAddress|mintHash · string

The contract address (EVM, Stellar) or mint hash (Solana) of the token.

decimals · number

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.

usdc · TokenBalance

The USDC balance.

Show properties

amount · string

The amount of the token in decimal format (e.g. "42.69").

rawAmount · string

The amount of the token in its smallest indivisible unit (e.g. 1000000 for 1 USDC when decimals = 6).

symbol · string

The symbol of the token (e.g. USDC, ETH, etc.).

contractAddress|mintHash · string

The contract address (EVM, Stellar) or mint hash (Solana) of the token.

decimals · number

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.

tokens · TokenBalance[]

The tokens balances.

Show properties

amount · string

The amount of the token in decimal format (e.g. "42.69").

rawAmount · string

The amount of the token in its smallest indivisible unit (e.g. 1000000 for 1 USDC when decimals = 6).

symbol · string

The symbol of the token (e.g. USDC, ETH, etc.).

contractAddress|mintHash · string

The contract address (EVM, Stellar) or mint hash (Solana) of the token.

decimals · number

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.

REST

cURL

curl --request GET \
    --url 'https://staging.crossmint.com/api/2025-06-09/wallets/email:[e-mail]:evm/balances?tokens=usdc&chains=base-sepolia' \
    --header 'X-API-KEY: <x-api-key>'

See the API reference for more details.

NFT Balances

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

import { useWallet } from '@crossmint/client-sdk-react-ui';

const { wallet } = useWallet();

const nfts = await wallet.experimental_nfts({ page: 1, perPage: 10 });

See the React SDK reference for more details.

Node.js

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", signer: { type: "external-wallet" } }
);

const nfts = await wallet.experimental_nfts({ page: 1, perPage: 10 });

See the SDK reference for all parameters and return types.

React Native

import { useWallet } from '@crossmint/client-sdk-react-native-ui';

const { wallet } = useWallet();

const nfts = await wallet.experimental_nfts({ page: 1, perPage: 10 });

See the React Native SDK reference for more details.

Swift

import CrossmintClient
import Wallet

let sdk = CrossmintSDK.shared

let wallet = try await sdk.crossmintWallets.getOrCreateWallet(
    chain: .baseSepolia,
    signer: .email("[e-mail]")
)

let nfts = try await wallet.nfts(page: 1, nftsPerPage: 10)

Parameters

nftsPerPage · number

The number of NFTs to return per page.

page · number

The page number to return.

Returns

nfts · Promise<GetNftsResponse>

The NFTs.

REST

cURL

curl --request GET \
    --url 'https://staging.crossmint.com/api/2022-06-09/wallets/email:[e-mail]:base/nfts?page=1&perPage=20' \
    --header 'X-API-KEY: <x-api-key>'

See the API reference for more details.