Skip to main content

Query Sub Account Transfer History(SPOT)

HTTP Request

GET /sapi/v1/broker/transfer

Request Parameters

NameTypeMandatoryDescription
fromIdSTRINGNO
toIdSTRINGNO
clientTranIdSTRINGNOclient transfer id
showAllStatusENUMNOtrue or false, default: false
startTimeLONGNO
endTimeLONGNO
pageINTNO
limitINTNOdefault 500, max 500
recvWindowLONGNO
timestampLONGYES

Caution:

  • If showAllStatus is true, the status in response will show four types: INIT,PROCESS,SUCCESS,FAILURE.
  • If showAllStatus is false, the status in response will show three types: INIT,PROCESS,SUCCESS.
  • Either fromId or toId must be sent. Return fromId equal master account by default.

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 100 days before today.
  • endTime is not provided: Calculate 100 days after startTime.
  • startTime is not provided: Calculate 100 days before endTime.

Example Response

[
{
"fromId":"1",
"toId":"2",
"asset":"BTC",
"qty":"1",
"time":1544433328000,
"txnId":"2966662589",
"clientTranId":"abc",
"status": "SUCCESS" // Status Type:INIT,PROCESS,SUCCESS
},
{
"fromId":"1",
"toId":"2",
"asset":"ETH",
"qty":"2",
"time":1544433328000,
"txnId":"296666999",
"clientTranId":"",
"status": "SUCCESS"
}
]