Unified Transfer

Unified Transfer

Transfer funds between accounts. The transfer type is determined by type. Consolidates internal (same UID), UID-to-UID, and subaccount transfer endpoints.

Request URL

POST /deepcoin/v2/asset/unified-transfer

Common Request Parameters

Field Name	Required	Type	Description
type	true	string	Transfer type: internal / uid / subaccount
ccy	true	string	Currency
amt	true	string	Amount
clientId	false	string	Client idempotency ID
internal	false	object	Required when type=internal. See internal parameters below
uid	false	object	Required when type=uid. See uid parameters below
subaccount	false	object	Required when type=subaccount. See subaccount parameters below

---

type=internal (Same UID Account Transfer)

internal parameters:

Field Name	Required	Type	Description
uid	true	int64	User UID, must match the API Key owner
fromAcctType	true	int	Source account type: 1=Spot 2=Wallet 3=Rebate 5=Inverse Swap 7=Linear Swap 10=Trial Fund
toAcctType	true	int	Destination account type, same enum as above

Request example:

{
  "type": "internal",
  "ccy": "USDT",
  "amt": "100",
  "clientId": "transfer_20260528_001",
  "internal": {
    "uid": 36020176,
    "fromAcctType": 7,
    "toAcctType": 1
  }
}

---

type=uid (UID-to-UID Transfer)

Support adding recipient UIDs to the address book.

uid parameters:

Field Name	Required	Type	Description
from	true	int64	Source UID, must match the API Key owner
to	true	int64	Destination UID
receiverAccount	false	string	Receiver account
receiverAccountType	false	string	Receiver account type: email / phone

Request example:

{
  "type": "uid",
  "ccy": "USDT",
  "amt": "100",
  "clientId": "transfer_20260528_002",
  "uid": {
    "from": 36023126,
    "to": 36023127,
    "receiverAccount": "user@example.com"
  }
}

---

type=subaccount (Subaccount Transfer)

subaccount parameters:

Field Name	Required	Type	Description
from	true	string	Source UID
to	true	string	Destination UID
fromAcctType	true	string	Source account type
toAcctType	true	string	Destination account type

Request example:

{
  "type": "subaccount",
  "ccy": "USDT",
  "amt": "100",
  "clientId": "transfer_20260528_003",
  "subaccount": {
    "from": "36023126",
    "to": "36023128",
    "fromAcctType": "7",
    "toAcctType": "1"
  }
}

---

Response Parameters

Field Name	Type	Description
transferId	string	Transfer ID
clientId	string	Client idempotency ID
status	string	Transfer status
cTime	string	Creation time

Response Example

{
  "transferId": "40ce50f2-a96d-4efc-8168-148fd82df25f",
  "clientId": "transfer_20260528_001",
  "status": "success",
  "cTime": "1739263130000"
}