- 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
Report incorrect code
Copy
Ask AI
import { useWallet } from '@crossmint/client-sdk-react-ui';
const { wallet } = useWallet();
const { nativeToken, usdc, tokens } = await wallet.balances(["usdc"]);
Path 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.Report incorrect code
Copy
Ask AI
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(
"email:[email protected]:evm",
{ chain: "base-sepolia", signer: { type: "email" } }
);
const { nativeToken, usdc, tokens } = 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.Report incorrect code
Copy
Ask AI
import { useWallet } from '@crossmint/client-sdk-react-native-ui';
const { wallet } = useWallet();
const { nativeToken, usdc, tokens } = 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.Report incorrect code
Copy
Ask AI
import CrossmintClient
import Wallet
let sdk = CrossmintSDK.shared
let wallet = try await sdk.crossmintWallets.getOrCreateWallet(
chain: .baseSepolia,
signer: .email("[email protected]")
)
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.Report incorrect code
Copy
Ask AI
curl --request GET \
--url 'https://staging.crossmint.com/api/2025-06-09/wallets/email:[email protected]: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
Report incorrect code
Copy
Ask AI
import { useWallet } from '@crossmint/client-sdk-react-ui';
const { wallet } = useWallet();
const nfts = await wallet.experimental_nfts({ page: 1, perPage: 10 });
Parameters
The number of NFTs to return per page.
The page number to return.
Returns
The NFTs.
Report incorrect code
Copy
Ask AI
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(
"email:[email protected]:evm",
{ chain: "base-sepolia", signer: { type: "email" } }
);
const nfts = await wallet.experimental_nfts({ page: 1, perPage: 10 });
Parameters
The number of NFTs to return per page.
The page number to return.
Returns
The NFTs.
Report incorrect code
Copy
Ask AI
import { useWallet } from '@crossmint/client-sdk-react-native-ui';
const { wallet } = useWallet();
const nfts = await wallet.experimental_nfts({ page: 1, perPage: 10 });
Parameters
The number of NFTs to return per page.
The page number to return.
Returns
The NFTs.
Report incorrect code
Copy
Ask AI
import CrossmintClient
import Wallet
let sdk = CrossmintSDK.shared
let wallet = try await sdk.crossmintWallets.getOrCreateWallet(
chain: .baseSepolia,
signer: .email("[email protected]")
)
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.
Report incorrect code
Copy
Ask AI
curl --request GET \
--url 'https://staging.crossmint.com/api/2022-06-09/wallets/email:[email protected]:base/nfts?page=1&perPage=20' \
--header 'X-API-KEY: <x-api-key>'