统一划转

统一划转

账户间资金划转，按 type 区分类型。整合同 UID 账户间划转、UID 间划转和子母账号划转接口。

请求地址

POST /deepcoin/v2/asset/unified-transfer

通用请求参数

字段名	是否必填	类型	字段描述
type	是	string	划转类型：internal / uid / subaccount
ccy	是	string	币种
amt	是	string	金额
clientId	否	string	客户端幂等 ID
internal	否	object	type=internal 时必填，同 UID 账户间划转参数
uid	否	object	type=uid 时必填，UID 间划转参数
subaccount	否	object	type=subaccount 时必填，子母账号划转参数

---

type=internal（同 UID 账户间划转）

internal 参数：

字段名	是否必填	类型	字段描述
uid	是	int64	用户 UID，必须与 API Key 所属用户一致
fromAcctType	是	int	转出账户类型：1=现货 2=钱包 3=返佣 5=反向合约 7=正向合约 10=体验金
toAcctType	是	int	转入账户类型，枚举同上

请求示例：

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

---

type=uid（UID 间划转）

需要添加转账 UID 到地址簿。

uid 参数：

字段名	是否必填	类型	字段描述
from	是	int64	转出 UID，必须与 API Key 所属用户一致
to	是	int64	转入 UID
receiverAccount	否	string	收款账户
receiverAccountType	否	string	收款账户类型：email / phone

请求示例：

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

---

type=subaccount（子母账号划转）

subaccount 参数：

字段名	是否必填	类型	字段描述
from	是	string	转出 UID
to	是	string	转入 UID
fromAcctType	是	string	转出账户类型
toAcctType	是	string	转入账户类型

请求示例：

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

---

响应参数

字段名	类型	字段描述
transferId	string	划转 ID
clientId	string	客户端幂等 ID
status	string	划转状态
cTime	string	创建时间

响应示例

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