Transfer Tokens

Prerequisites

Ensure you have a wallet created.
API Key: Ensure you have an API key with the scopes: wallets:transactions.create.

Sending tokens

React
Node.js
React Native
Swift
REST

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

const { wallet } = useWallet();

const { hash, explorerLink } = await wallet.send("2CE1gtMSFEKLvtXeD1mmUKNxMTQXe3TaNsexBTd4jApJ", "solana:usdc", "3.14");

Parameters

walletLocator

string

required

The recipient of the tokens, represented by a wallet locator. A wallet locator can be of the format:

<walletAddress>
email:<email>:<walletType>
userId:<userId>:<walletType>
userId:<userId>:<walletType> (white label user example)
phoneNumber:<phoneNumber>:<walletType>
twitter:<handle>:<walletType>
x:<handle>:<walletType>

tokenLocator

string

required

The token to be transferred, represented as a token locator.A token locator that supports native tokens, fungible tokens, and NFTs across different chains. It can be of the format:

address[:tokenId]
symbol

amount

string

required

The amount of tokens to send in decimal format (e.g. 42.69).

Returns

hash

string

The hash of the transaction.

explorerLink

string

The explorer link of the transaction.

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]:solana",
    { chain: "solana", signer: { type: "email" } }
);

const { hash, explorerLink } = await wallet.send("2CE1gtMSFEKLvtXeD1mmUKNxMTQXe3TaNsexBTd4jApJ", "solana:usdc", "3.14");

Parameters

walletLocator

string

required

The recipient of the tokens, represented by a wallet locator. A wallet locator can be of the format:

<walletAddress>
email:<email>:<walletType>
userId:<userId>:<walletType>
userId:<userId>:<walletType> (white label user example)
phoneNumber:<phoneNumber>:<walletType>
twitter:<handle>:<walletType>
x:<handle>:<walletType>

tokenLocator

string

required

The token to be transferred, represented as a token locator.A token locator that supports native tokens, fungible tokens, and NFTs across different chains. It can be of the format:

address[:tokenId]
symbol

amount

string

required

The amount of tokens to send in decimal format (e.g. 42.69).

Returns

hash

string

The hash of the transaction.

explorerLink

string

The explorer link of the transaction.

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

const { wallet } = useWallet();

const { hash, explorerLink } = await wallet.send("2CE1gtMSFEKLvtXeD1mmUKNxMTQXe3TaNsexBTd4jApJ", "solana:usdc", "3.14");

Parameters

walletLocator

string

required

The recipient of the tokens, represented by a wallet locator. A wallet locator can be of the format:

<walletAddress>
email:<email>:<walletType>
userId:<userId>:<walletType>
userId:<userId>:<walletType> (white label user example)
phoneNumber:<phoneNumber>:<walletType>
twitter:<handle>:<walletType>
x:<handle>:<walletType>

tokenLocator

string

required

The token to be transferred, represented as a token locator.A token locator that supports native tokens, fungible tokens, and NFTs across different chains. It can be of the format:

address[:tokenId]
symbol

amount

string

required

The amount of tokens to send in decimal format (e.g. 42.69).

Returns

hash

string

The hash of the transaction.

explorerLink

string

The explorer link of the transaction.

import CrossmintClient
import Wallet

let sdk = CrossmintSDK.shared

let wallet = try await sdk.crossmintWallets.getOrCreateWallet(
    chain: .solana,
    signer: .email("[email protected]")
)

let result = try await wallet.send("2CE1gtMSFEKLvtXeD1mmUKNxMTQXe3TaNsexBTd4jApJ", "solana:usdc", 3.14)

Parameters

walletLocator

string

required

The recipient of the tokens, represented by a wallet locator.

tokenLocator

string

required

The token to be transferred, represented as a token locator.

amount

string

required

The amount of tokens to send in decimal format (e.g. 42.69).

Returns

hash

string

The hash of the transaction.

explorerLink

string

The explorer link of the transaction.

Transfers must be approved by one of the wallet’s signers. The SDK handles this automatically, but with the REST API you must approve the transaction to complete it.

Create the transaction

Call the transfer token endpoint.

curl --request POST \
    --url https://staging.crossmint.com/api/2025-06-09/wallets/email:[email protected]:solana/tokens/solana:usdc/transfers \
    --header 'Content-Type: application/json' \
    --header 'X-API-KEY: <x-api-key>' \
    --data '{
        "recipient": "9ctaDGQGHhREMvs7rcuuDgqMLEakfrPb5ZAEo9TPwjRP",
        "amount": "3.14",
        "signer": "email:[email protected]"
    }'

See the API reference for more details.

Sign the approval returned in the response

If you are using an api-key as the admin signer you can skip the following steps.

Sign the approval message field returned in the response inside transaction.approvals using the signer.

Approve the transaction

Call the approve transaction endpoint using the signature from the previous step and the transaction id returned in the call from Step 1.

curl --request POST \
    --url https://staging.crossmint.com/api/2025-06-09/wallets/email:[email protected]:solana/transactions/91e90094-9fe0-43a7-bab6-e5725767a3ad/approvals \
    --header 'Content-Type: application/json' \
    --header 'X-API-KEY: <x-api-key>' \
    --data '{
        "approvals": [{
            "signer": "email:[email protected]",
            "signature": "5qY6wXw6zTn7..."
        }]
    }'

See the API reference for more details.

Introduction

Quickstarts ⚡️

Concepts

Guides

API Reference

Prerequisites

Sending tokens

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Returns

Introduction

Quickstarts ⚡️

Concepts

Guides

API Reference

​Prerequisites

​Sending tokens

​Parameters

​Returns

​Parameters

​Returns

​Parameters

​Returns

​Parameters

​Returns

Prerequisites

Sending tokens

Parameters

Returns

Parameters

Returns

Parameters

Returns

Parameters

Returns