POST
/
v1-alpha1
/
wallets
/
transfer
curl --request POST \
  --url https://staging.crossmint.com/api/v1-alpha1/wallets/transfer \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "chain": "arbitrum",
  "contractAddress": "<string>",
  "from": "<string>",
  "quantity": "<string>",
  "to": "<string>",
  "tokenId": "<string>"
}'
{
  "actionId": "<string>",
  "message": "Verification request sent to user"
}

This is an alpha API and subject to change.

This API enables you to initiate a transfer request. Wallets that are created with email can be logged into via Crossmint.com by the user who owns that email address.

Requests to transfer NFTs within wallets created with email must be approved by the user. Upon calling this API an email will be sent to the user enabling them to approve or decline the transfer.

Authorizations

X-API-KEY
string
headerrequired

Obtained in the Crossmint developer console

Body

application/json
  • EVM

  • Solana

chain
enum<string>
default: ethereum
Available options:
arbitrum,
arbitrumnova,
arbitrum-sepolia,
base,
base-sepolia,
bsc,
ethereum,
ethereum-sepolia,
optimism,
optimism-sepolia,
polygon,
zkatana,
zora,
zora-sepolia
contractAddress
string

The contract address of the token to transfer

from
string

The wallet address for the current owner

quantity
string

Required for ERC-1155 only, not relevant for ERC-721 tokens

to
string

The wallet address the token should be transferred to

tokenId
string

The numeric tokenId of the token to be transferred

Response

202 - application/json
actionId
string

An ID that can be used to poll the actions API.

message
string

A message indicating the result.