Transfer Token

Sends a token to a specified address. If the token has a different sender and owner, the sender must be authorized to send the token. You can authorize an account to send tokens via v2/contract/{contract-address-or-alias}/approve/{token-id}.

You will see Submitted in the response even when you enter a wrong token ID. But that does not mean that it is successfully Committed. To confirm transaction status, use Get Transaction Receipt from the Wallet API.

Sender

sender is the address that sends the transaction. If it is an account in the default account-pool of KIP-17 or Wallet Service, you can omit the KRN header.
Otherwise you need to include the KRN header (x-krn: krn:{chain-id}:wallet:{account-id}:account-pool:{pool name}).

Request
Security:
basic
path Parameters
contract-address-or-alias
required
string

Contract address (in hex.) or alias.

token-id
required
string

Token ID

header Parameters
x-chain-id
required
string

Kaia Network Chain ID (1001 or 8217)

x-krn
string

KRN (KAS Resource Name) unique to an Account Pool

Request Body schema: application/json
sender
required
string

The Kaia account address of the sender.

owner
required
string

The Kaia account address of the current owner.

to
required
string

The Kaia account address of the recipient.

Responses
200

Your request was successful.

400

Your request is not valid.

401

The credential you entered is invalid.

post/v2/contract/{contract-address-or-alias}/token/{token-id}
Request samples
application/json
{
  • "sender": "0x9eaf20b40e0f1ced5dbba6f5cfb0d3e12b0534f4",
  • "owner": "0x9eaf20b40e0f1ced5dbba6f5cfb0d3e12b0534f4",
  • "to": "0xDc277E2D89b92336A4ee80be3c7142443FDaDE47"
}
Response samples
application/json

Your request was successful.

{
  • "status": "Submitted",
  • "transactionHash": "0x72b05d3b27e17a132e60681f4a2ad487868181b0623fbaa841875ecb36f62b8f"
}