# User Universal Transfer Interface

# User Universal Transfer

Interface

    POST /openApi/api/v3/asset/transfer

parameter

Parameter name Type Required or not Remarks
type ENUM yes transfer tpye
asset STRING no coin name e.g. USDT
amount DECIMAL no amount
recvWindow LONG no Execution window time, cannot be greater than 60000
timestamp LONG no current timestamp e.g. 1658748648396
   
      ENUM of transfer types:
     
      FUND_SFUTURES,Funding Account -> Standard Contract
     
      SFUTURES_FUND,Standard Contract -> Funding Account
     
      FUND_PFUTURES,Funding Account -> Professional Contract
     
      PFUTURES_FUND,Professional Contract -> Funding Account
     
      SFUTURES_PFUTURES,Standard Contract -> Professional Contract
     
      PFUTURES_SFUTURES,Professional Contract -> Standard Contract
   

response

parameter name type remarks
tranId LONG Transaction ID
{
    "tranId":13526853623
}

# Query User Universal Transfer History (USER_DATA)

Interface

    GET /openApi/api/v3/asset/transfer

Parameter

Parameter name Type Required or not Remarks
type ENUM yes transfer type
startTime LONG no Starting time 1658748648396
endTime LONG no End Time 1658748648396
current Int no current page default1
size Int no Page size default 10 can not exceed 100
recvWindow LONG no Execution window time, cannot be greater than 60000
timestamp LONG no current timestamp 1658748648396
   
      ENUM of transfer types:
     
      FUND_SFUTURES,Funding Account -> Standard Contract
     
      SFUTURES_FUND,Standard Contract -> Funding Account
     
      FUND_PFUTURES,Funding Account -> Professional Contract
     
      PFUTURES_FUND,Professional Contract -> Funding Account
     
      SFUTURES_PFUTURES,Standard Contract -> Professional Contract
     
      PFUTURES_SFUTURES,Professional Contract -> Standard Contract
   

response

parameter name type remarks
total LONG total
rows Array Array
asset String coin name
amount DECIMAL coin amount
type ENUM transfer type
status String CONFIRMED
tranId LONG Transaction ID
timestamp LONG Transfer time stamp
{
    "total":3,
    "rows":[
        {
            "asset":"USDT",
            "amount":"-100.00000000000000000000",
            "type":"FUND_SFUTURES",
            "status":"CONFIRMED",
            "tranId":1067594500957016069,
            "timestamp":1658388859000
        },
        {
            "asset":"USDT",
            "amount":"-33.00000000000000000000",
            "type":"FUND_SFUTURES",
            "status":"CONFIRMED",
            "tranId":1069064111112065025,
            "timestamp":1658739241000
        },
        {
            "asset":"USDT",
            "amount":"-100.00000000000000000000",
            "type":"FUND_SFUTURES",
            "status":"CONFIRMED",
            "tranId":1069099446076444674,
            "timestamp":1658747666000
        }
    ]
}

# Deposit History(supporting network)

Interface

    GET /openApi/api/v3/capital/deposit/hisrec

Parameter

Parameter name Type Required or not Remarks
coin String no coin name
status Int no status(0:pending,6: credited but cannot withdraw, 1:success)
startTime LONG no Starting time 1658748648396
endTime LONG no End Time 1658748648396
offset Int no offset default0
limit Int no Page size default 1000 cannot exceed 1000
recvWindow LONG no Execution window time, cannot be greater than 60000
timestamp LONG yes current timestamp 1658748648396

response

parameter name type remarks
amount DECIMAL Recharge amount
coin String coin name
network String recharge network
status Int Status Status 0-Confirmed-10-To be confirmed (under review) 20-Applied for block 30-Approved and passed 40-Approval failed 50-Exported 60-Preliminary confirmation of recharge (final confirmation becomes 0) 70-Approved failed and returned assets
address String recharge address
addressTag String Remark
txId LONG transaction id
insertTime LONG transaction hour
transferType LONG Transaction Type 0 = Recharge
unlockConfirm LONG confirm times for unlocking
confirmTimes LONG Network confirmation times
[
    {
        "amount":"0.00999800",
        "coin":"PAXG",
        "network":"ETH",
        "status":1,
        "address":"0x788cabe9236ce061e5a892e1a59395a81fc8d62c",
        "addressTag":"",
        "txId":"0xaad4654a3234aa6118af9b4b335f5ae81c360b2394721c019b5d1e75328b09f3",
        "insertTime":1599621997000,
        "transferType":0,
        "unlockConfirm":"12/12", // confirm times for unlocking
        "confirmTimes":"12/12"
    },
    {
        "amount":"0.50000000",
        "coin":"IOTA",
        "network":"IOTA",
        "status":1,
        "address":"SIZ9VLMHWATXKV99LH99CIGFJFUMLEHGWVZVNNZXRJJVWBPHYWPPBOSDORZ9EQSHCZAMPVAPGFYQAUUV9DROOXJLNW",
        "addressTag":"",
        "txId":"ESBFVQUTPIWQNJSPXFNHNYHSQNTGKRVKPRABQWTAXCDWOAKDKYWPTVG9BGXNVNKTLEJGESAVXIKIZ9999",
        "insertTime":1599620082000,
        "transferType":0,
        "unlockConfirm":"1/12",
        "confirmTimes":"1/1"
    }
]

# Withdraw History (supporting network)

Interface

    GET /openApi/api/v3/capital/withdraw/history

Parameter

Parameter name Type Required or not Remarks
coin String no coin name
withdrawOrderId String no Custom ID, if there is none, this field will not be returned
status Int no Status (0: Confirmation Email has been sent, 2: Waiting for confirmation 3: Rejected 4: Processing 5: Withdrawal transaction failed 6 Withdrawal completed)
startTime LONG no Starting time 1658748648396
endTime LONG no End Time 1658748648396
offset Int no offset default 0
limit Int no Page size default 1000 cannot exceed 1000
recvWindow LONG no Execution window time, cannot be greater than 60000
timestamp LONG yes current timestamp 1658748648396

response

parameter name type remarks
address String address
amount DECIMAL Withdrawal amount
applyTime Date Withdrawal time
coin String coin name
id String The id of the withdrawal
withdrawOrderId String Custom ID, if there is none, this field will not be returned
network String Withdrawal network
transferType Int Transaction Type 1 = Withdrawal
status Int Status Status 0-Confirmed-10-To be confirmed (under review) 20-Applied for block 30-Approved and passed 40-Approval failed 50-Exported 60-Preliminary confirmation of recharge (final confirmation becomes 0) 70-Approved failed and returned assets
transactionFee String handling fee
confirmNo Int Withdrawal confirmation times
info String Reason for withdrawal failure
txId String Withdrawal transaction id
[
    {
        "address": "0x94df8b352de7f46f64b01d3666bf6e936e44ce60",
        "amount": "8.91000000",   
        "applyTime": "2019-10-12 11:12:02",  
        "coin": "USDT",
        "id": "b6ae22b3aa844210a7041aee7589627c",  
        "withdrawOrderId": "WITHDRAWtest123", 
        "network": "ETH",
        "transferType": 0 
        "status": 6,
        "transactionFee": "0.004", 
        "confirmNo":3,  
        "info": "The address is not valid. Please confirm with the recipient", 
        "txId": "0xb5ef8c13b968a406cc62a93a8bd80f9e9a906ef1b3fcf20a2e48573c17659268"  
    },
    {
        "address": "1FZdVHtiBqMrWdjPyRPULCUceZPJ2WLCsB",
        "amount": "0.00150000",
        "applyTime": "2019-09-24 12:43:45",
        "coin": "BTC",
        "id": "156ec387f49b41df8724fa744fa82719",
        "network": "BTC",
        "transferType": 0, 
        "status": 6,
        "transactionFee": "0.004",
        "confirmNo": 2,
        "info": "",
        "txId": "60fd9007ebfddc753455f95fafa808c4302c836e4d1eebc5a132c36c1d8ac354"
    }
]
Last Updated: 7/27/2022, 11:04:42 AM