跳到主要内容

Query Universal Transfer History

HTTP Request

GET /sapi/v1/broker/universalTransfer

Request Parameters

NameTypeMandatoryDescription
fromIdSTRINGNO
toIdSTRINGNO
clientTranIdSTRINGNOclient transfer id
startTimeLONGNO
endTimeLONGNO
pageINTNOdefault 1
limitINTNOdefault 500, max 500
showAllStatusBooleanNOTRUE or FALSE
recvWindowLONGNO
timestampLONGYES

Caution:

  • Either fromId or toId must be sent.
  • If either fromId or toId is the master account itself, it will not return in response.
  • If showAllStatus is true, the status in response will show four types: INIT,PROCESS,SUCCESS,FAILURE.

Query scope is limited to 100 days:

  • Both startTime and endTime are provided: If it exceeds, the endTime will be re-calculated 100 days after the startTime.
  • Neither startTime nor endTime are provided: Calculate 30 days before today.
  • endTime is not provided: Calculate as Current time.
  • startTime is not provided: Calculate 30 days before endTime.

Example Response

[
{
"toId":"444016824578949121",
"asset":"BTC",
"qty":"0.1",
"time":1544433328000,
"status":"SUCCESS",
"txnId":"12831078279",
"clientTranId":"abc",
"fromAccountType": "SPOT",
"toAccountType": "USDT_FUTURE"
},
{
"toId":"444016824578949121",
"asset":"USDT",
"qty":"2",
"time":1544433328000,
"status":"SUCCESS",
"txnId":"296666999",
"clientTranId":"",
"fromAccountType": "SPOT",
"toAccountType": "USDT_FUTURE"
}
]