# Transfer

This chapter introduces how to send TOP token to another account.

Request

topio transfer

Request Parameters

Parameter Name Required Default Value Type Description
account_addr Yes - String The target account address, a normal user account or contract account.
top_num Yes - Double Transfer amount(>0), in TOP.
note No An empty String String Transfer note.

Options

Optioin Name Default Value Type Description
-t, --tx_deposit 0.1 Double Transaction deposit, the default and minimum is 0.1 TOP.
-h, --help - - Check the command's help information.

Response Parameters

Response Parameters Type Description
Transaction hash String The transaction hash that can be used to retrieve the transaction consensus status.

Request Sample

topio transfer T800002276a7d58218ac4978733e5cca927a7d86cb7c87 20

Response Sample

Return the transaction hash, and check whether the transfer was successful by inquiring whether the transaction was successful and whether the account balance changed accordingly through topio Querytx and topio chain queryAccount.

  • Successful
Transaction hash: 0x461cd0c9abe808c4f0ab1bd4b540ea35d72d741c56c52856a3bff06678b7ce72
Please use command 'topio querytx' to query transaction status later on!!!

Sample:

An account with a balance of 10,000 TOP transfered 20 TOP to another account.

Execute get Account to query the account's balance, is reduced by 20 TOP.

Execute topio querytx to query the transaction by transaction hash, the consensus final status is a "success", then succeed to transfer.

  • Failed

When the transaction is failed, the transaction hash is also returned.

Transaction hash: 0x9f31fb199cc710a22d83c09d08eb79488610af03a5ed362cab26339ab1aa1cf5
Please use command 'topio querytx' to query transaction status later on!!!

Execute topio querytx to query the transaction by transaction hash, the consensus final status is a "failure", then failed to transfer.