# 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.