Skip to main content

​
What are testnet tokens?

Testnet tokens are tokens deployed on blockchain testnets for development and testing purposes. These tokens do not have real-world monetary value, allowing you to simulate on-chain behavior—such as sending, receiving, and paying gas fees—without financial risk. You can use testnet tokens to validate your integration before moving to production.

​
What is USDXM?

USDXM is Crossmint’s staging/testnet stablecoin, designed specifically for testing. Think about USDXM as the USDC of testnets. Crossmint has deployed the USDXM contract on all supported testnets making it easier for you to test tokens in staging. USDXM is only available in staging environments and is not available in production.

​
How to fund your wallet?

There are several options to fund your wallets on staging with USDXM

​
Option 1: Fund with the SDK

The stagingFund method is the easiest way to add USDXM to your wallet programmatically. This method funds the wallet with USDXM only, is only available in staging environments. 
import { useWallet } from '@crossmint/client-sdk-react-ui';

const { wallet } = useWallet();

const balances = await wallet.stagingFund(10);
console.log("Wallet funded! New balances:", balances);

​
Parameters

​
amount
number
required
The amount of USDXM to add to the wallet.
​
chain
Chain
Optional. The chain to fund. If omitted, uses the wallet’s default chain.

​
Returns

​
balances
FundWalletResponse
A response containing the wallet’s updated balances after funding.

​
Option 2: Fund via API

You can also fund staging wallets directly using the HTTP API. This is useful for server-side integrations or when you need more control over the funding process. 
curl --request POST \
    --url https://staging.crossmint.com/api/v1-alpha2/wallets/{walletLocator}/balances \
    --header 'Content-Type: application/json' \
    --header 'X-API-KEY: <x-api-key>' \
    --data '{
        "amount": 10,
        "token": "usdxm",
        "chain": "base-sepolia"
    }'

​
Request parameters

​
walletLocator
string
required
The wallet to fund. Can be a wallet address or a locator like email:[email protected]:evm.
​
amount
number
required
The amount of USDXM to add.
​
token
string
required
The token to fund with. Use usdxm for staging environments.
​
chain
string
required
The chain to fund on (e.g., base-sepolia, polygon-amoy).

​
Getting your API key

You can get your staging API key from the Crossmint Console. Navigate to your project settings and create an API key with the wallets:balance.create scope. See the API reference for more details.

​
Option 3: Use the faucet web app

For quick manual testing without writing code, you can use Crossmint’s hosted faucet web app to get staging tokens.

USDXM Faucet

Get testnet USDXM tokens instantly through a simple web interface.
 To use the faucet:
  1. Visit https://usdc-faucet.vercel.app/
  2. Enter your wallet address or connect your wallet
  3. Select the chain you want to receive tokens on
  4. Request tokens
The faucet is intended for development use only and may have rate limits to prevent abuse.

​
When should I use which option?

OptionBest for
SDK (stagingFund)Automated flows, integration tests, and when you’re already using the Crossmint SDK
APIServer-side integrations, custom tooling, or when you need direct HTTP access
Faucet web appQuick manual testing, getting started quickly, or when you don’t want to write code

Transfer Tokens

Learn how to transfer tokens between wallets

Check Balances

Retrieve and manage wallet balances