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",
  "from": "<string>",
  "to": "<string>",
  "contractAddress": "<string>",
  "tokenId": "<string>",
  "quantity": "<string>"
}'
{
  "message": "Verification request sent to user",
  "actionId": "<string>"
}

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
chain
enum<string>
default: ethereum
Available options:
arbitrum,
arbitrumnova,
arbitrum-sepolia,
base,
base-sepolia,
bsc,
ethereum,
ethereum-sepolia,
optimism,
optimism-sepolia,
polygon,
polygon-amoy,
zkyoto,
zora,
zora-sepolia
from
string

The wallet address for the current owner

to
string

The wallet address the token should be transferred to

contractAddress
string

The contract address of the token to transfer

tokenId
string

The numeric tokenId of the token to be transferred

quantity
string

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

Response

202 - application/json
message
string

A message indicating the result.

actionId
string

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

Get NFTs from WalletTransfer NFT (userId)