Check Balances

Token Balances
NFT 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

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.

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"]);

See the SDK reference for all parameters and return types.

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.

import com.crossmint.kotlin.CrossmintSDK
import com.crossmint.kotlin.types.EVMChain
import com.crossmint.kotlin.types.getOrThrow

CrossmintSDK.configure(apiKey = "YOUR_CROSSMINT_API_KEY")
val sdk = CrossmintSDK.shared
val wallet = sdk.wallets.getWallet(chain = EVMChain.BaseSepolia).getOrThrow()

val balances = wallet.balances(listOf("usdc")).getOrThrow()
println("Native: ${balances.nativeToken.amount}")
println("USDC: ${balances.usdc.amount}")
for (token in balances.tokens) {
    println("${token.symbol}: ${token.amount}")
}

import CrossmintClient
import Wallet

CrossmintSDK.configure(apiKey: "<YOUR_API_KEY>")
let sdk = CrossmintSDK.shared

guard let wallet = try await sdk.crossmintWallets.getWallet(
    chain: .baseSepolia
) else {
    return
}

let balances = try await wallet.balances()

Parameters

string[]

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

Returns

Balances

The balances of the wallet.

Show properties

TokenBalance

The native token balance.

Show properties

string

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

string

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

string

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

string

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

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.

TokenBalance

The USDC balance.

Show properties

string

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

string

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

string

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

string

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

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.

TokenBalance[]

The tokens balances.

Show properties

string

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

string

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

string

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

string

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

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.

import 'package:crossmint_flutter/crossmint_flutter_ui.dart';

final controller = CrossmintWalletContext.of(context).requireWalletController;
final wallet = controller.createEvmWallet();

final balances = await wallet.balances(tokens: <String>['usdc']);
print('USDC: ${balances.usdc.amount}');
print('Native: ${balances.nativeToken.amount}');

Swap createEvmWallet for createSolanaWallet or createStellarWallet on the matching chain. See the Flutter SDK reference for more details.

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>'

const url = 'https://staging.crossmint.com/api/2025-06-09/wallets/email:user@example.com:evm/balances?tokens=usdc&chains=base-sepolia';

const options = {
    method: 'GET',
    headers: {
        'X-API-KEY': '<x-api-key>'
    }
};

try {
    const response = await fetch(url, options);
    const data = await response.json();
    console.log(data);
} catch (error) {
    console.error(error);
}

import requests

url = "https://staging.crossmint.com/api/2025-06-09/wallets/email:user@example.com:evm/balances"

querystring = {"tokens":"usdc","chains":"base-sepolia"}

headers = {"X-API-KEY": "<x-api-key>"}

response = requests.get(url, params=querystring, headers=headers)

print(response.json())

See the API reference for more details.

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

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

const { wallet } = useWallet();

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

See the React SDK reference for more details.

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 });

See the SDK reference for all parameters and return types.

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

const { wallet } = useWallet();

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

See the React Native SDK reference for more details.

import 'package:crossmint_flutter/crossmint_flutter_ui.dart';

final controller = CrossmintWalletContext.of(context).requireWalletController;
final wallet = controller.createEvmWallet();

final nfts = await wallet.nfts(page: 1, perPage: 10);

See the Flutter SDK reference for more details.

import CrossmintClient
import Wallet

CrossmintSDK.configure(apiKey: "<YOUR_API_KEY>")
let sdk = CrossmintSDK.shared

guard let wallet = try await sdk.crossmintWallets.getWallet(
    chain: .baseSepolia
) else {
    return
}

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

Parameters

number

The number of NFTs to return per page.

number

The page number to return.

Returns

Promise<GetNftsResponse>

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>'

const url = 'https://staging.crossmint.com/api/2022-06-09/wallets/email:user@example.com:base/nfts?page=1&perPage=20';

const options = {
    method: 'GET',
    headers: {
        'X-API-KEY': '<x-api-key>'
    }
};

try {
    const response = await fetch(url, options);
    const data = await response.json();
    console.log(data);
} catch (error) {
    console.error(error);
}

import requests

url = "https://staging.crossmint.com/api/2022-06-09/wallets/email:user@example.com:base/nfts"

querystring = {"page":"1","perPage":"20"}

headers = {"X-API-KEY": "<x-api-key>"}

response = requests.get(url, params=querystring, headers=headers)

print(response.json())

See the API reference for more details.

Introduction

Quickstarts ⚡

Concepts

Guides

API Reference

Prerequisites

Retrieving Wallet Balances

Parameters

Returns

Prerequisites

Retrieving NFTs

Parameters

Returns