Transfer

API Scopes

Need Permission to view account balance information

Transfer of user

POST /viewer/transfer

Intruduction

For Master-account

• Support mutual transfer between fund accounts, spot accounts, and contract accounts
• Support transfer from the fund/spot account of the sub-account specified in the sub-account field to the fund/spot account of the current account
• Support transfer from the current account's fund/spot account to the fund/spot account of the sub-account specified in the sub-account field
• Support the sub-account specified in the sub-account field to transfer between their own fund, spot, and contract accounts

For Sub-account

• Support mutual transfer between fund accounts, spot accounts, and contract accounts

Parameters

Name	Type	Require	Description	Example
symbol	string	true	symbol	USDT
amount	string	true	must larger than 0
guid	string	true	unique id created by users to identify their transfers, e.g. UUID.
from	string	true	account type of payer，one of SPOT/FUND/CONTRACT
to	string	true	account type of payee，one of SPOT/FUND/CONTRACT
type	string	false	transfer type, one of NORMAL/MASTER_TO_SUB/SUB_TO_MASTER/SUB_INTERNAL. default is NORMAL, means transfer between current customer, whether it is a master-account or sub-account. MASTER_TO_SUB means tranfer from current master-account to the sub-account. SUB_TO_MASTER means transfer from the sub-account to current master-account. SUB_INTERNAL means the current master account controls the designated sub-account to transfer between itself	NORMAL
sub_account	string	false	The user name of the sub-account under the current master-account, when type is NORMAL, it should be empty, and when type is others it is required

Response example.

{
    "code": 0,
    "data": null
}

Get Transfer of user

Get /viewer/transfer

Intruduction

Get transfer by GUID

Parameters

Name	Type	Require	Description	Example
guid	string	true	unique id created by users to identify their transfers, e.g. UUID.

Response

Name	Type	Description	Example
guid	string	unique id created by users to identify their transfers, e.g. UUID.
symbol	string	asset symbol, eg: USDT.
amount	string	transfer amount.
state	string	transfer state，one of PENDING/SUCCEED/FAILED.
created_at	string	transfer create time.
updated_at	string	transfer latest update time.

Response example

{
   "code": 0,
   "data": {
      "guid": "41b42816-e795-4f73-bbd0-332b010e5902",
      "symbol": "USDT",
      "amount": "1",
      "state": "FAILED",
      "created_at": "2024-01-12T04:00:43Z",
      "updated_at": "2024-01-12T04:00:43Z"
   }
}