curl --request POST \
  --url https://testnet.walletkit.com/nfts/transfer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "network": "Ethereum",
  "from": "<string>",
  "contract_address": "<string>",
  "recipient": "<string>",
  "token_id": "<string>",
  "developer_secret": "<string>",
  "user_pin": "<string>"
}'
{
  "transaction_id": "<string>",
  "network": "Ethereum",
  "status": "<string>"
}

Headers

X-WalletKit-Project-ID
string
required

Your WalletKit Project ID can be found on the API Keys page in the WalletKit Dashboard.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
network
enum<string>
required
Available options:
Ethereum,
Polygon,
Base,
Avalanche,
Polkadot,
Vara
from
string
required

from address of the transfer

contract_address
string
required

collection contract address

recipient
string
required

recipient of the NFT transfer

token_id
string | null
developer_secret
string | null

On testnet, the developer_secret is always "testnet-secret". On mainnet, the developer_secret is set by the developer during account activation.

user_pin
string | null

A 6-digit numeric pin that is only known to the user, set during wallet creation. This pin is required to sign transactions from this wallet.

Response

200
application/json
transaction_id
string
required
network
enum<string>
required
Available options:
Ethereum,
Polygon,
Base,
Avalanche,
Polkadot,
Vara
status
string
required