Skip to main content
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.

Prerequisites

  • Wallet: Create a wallet to transfer from.
  • Signer: The signing wallet must be registered as a signer on the wallet. You can do this at wallet creation by passing signers, or afterward by adding a signer.
  • Test Tokens: Fund your wallet with USDXM testnet tokens before transferring.
  • API Key: Get an API key with the wallets:transactions.create scope. In staging, all scopes are included by default.

What is a token transfer?

A token transfer moves a token from one wallet address to another onchain. This creates an onchain transaction that costs gas, which Crossmint handles for you. Once the blockchain confirms the transaction, the transfer is final and cannot be reversed.

Sending tokens

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

const RECIPIENT_ADDRESS = "RECIPIENT_WALLET_ADDRESS";
const { wallet } = useWallet();

const { hash, explorerLink } = await wallet.send(RECIPIENT_ADDRESS, "usdxm", "3.14");
See the React SDK reference for more details.
See the API reference for all supported locator formats.

Verify your transfer

Once the transfer completes, you can verify it in two ways:
  1. View the onchain transaction using the explorerLink returned by the send method:
console.log("View transaction:", explorerLink);
// Example: https://sepolia.basescan.org/tx/0xe5844116732d6cd21127bfc100ba29aee02b82cc4ab51e134d44e719ca8d0b48
  1. Check the recipient’s balance programmatically using the check balances API.

Next steps

Monitor transfers with webhooks

Track transactions and receive completion notifications

How to check wallet balances

Query token balances across your wallets

Test the Transfer Tokens API

Try out the API in the interactive playground