Transfer between sub-account business systems

Type: POST
Description: /v4/balance/account/transfer

Parameters

name	type	mandatory	default	description	ranges
bizId	string	true	N/A	Unique ID for idempotent processing	Maximum length: 128
from	enum	true	N/A	Fund transfer out account	bizType enum
to	enum	true	N/A	Fund transfer in account	bizType enum
currency	string	true	N/A	Currency name, must be lowercase (e.g. usdt, btc)
symbol	string	false	N/A	Transfer symbol (must be lowercase). Required if one of the transfer-in or transfer-out accounts is leverage
amount	bigDecimal	true	N/A	Transfer amount
toAccountId	long	true	N/A	Transfer-in account ID (must belong to the same user as the transfer-out account ID)
fromAccountId	long	false	N/A	Transfer-out account ID

Notes

This endpoint performs fund transfers between business system accounts under the same user.

• bizId is recommended to be stored for reconciliation.
• If leverage accounts are involved, symbol must be specified.

Response Example

Response

{
  "rc": 0,
  "mc": "SUCCESS",
  "ma": [],
  "result": 123456 // The returned unique ID of the transfer, recommended to store for reconciliation
}