跳至主要内容

創建萬能劃轉

支持子子帳戶間劃轉或母子帳號間劃轉。

警告
  • 支持使用母帳戶或者子帳號api key請求
    • 若要使用子帳號api key, 需要有"母子帳戶劃轉"(SubMemberTransferList)權限
    • 當使用子帳號api key劃轉時, 僅能劃轉到母帳號下
  • 如果您遇到錯誤碼是131228並且錯誤信息是your balance is not enough, 請前往查詢賬戶單個幣種余額接口確認安全限額.
  • 不支持同一個uid之間的劃轉.
  • 資金賬戶轉出目前僅支持加密貨幣轉賬,不支持法定貨幣劃轉.

HTTP 請求

POST /v5/asset/transfer/universal-transfer

請求參數

參數是否必需類型說明
transferIdtruestringUUID. 請求手動生成UUID
cointruestring幣種
amounttruestring劃轉金額
fromMemberIdtrueinteger轉出UID
toMemberIdtrueinteger轉入UID
fromAccountTypetruestring轉出帳戶類型
toAccountTypetruestring轉入帳戶類型

響應參數

參數類型說明
transferIdstringUUID
statusstring劃轉狀態
  • STATUS_UNKNOWN
  • SUCCESS
  • PENDING
  • FAILED

  • 請求示例

    POST /v5/asset/transfer/universal-transfer HTTP/1.1
    Host: api-testnet.bybit.com
    X-BAPI-API-KEY: XXXXX
    X-BAPI-TIMESTAMP: 1672189449697
    X-BAPI-RECV-WINDOW: 5000
    X-BAPI-SIGN: XXXXX
    Content-Type: application/json

    {
    "transferId": "be7a2462-1138-4e27-80b1-62653f24925e",
    "coin": "ETH",
    "amount": "0.5",
    "fromMemberId": 592334,
    "toMemberId": 691355,
    "fromAccountType": "CONTRACT",
    "toAccountType": "UNIFIED"

    }

    響應示例

    {
    "retCode": 0,
    "retMsg": "success",
    "result": {
    "transferId": "be7a2462-1138-4e27-80b1-62653f24925e",
    "status": "SUCCESS"
    },
    "retExtInfo": {},
    "time": 1672189450195
    }