Skip to main content

Get Income History(USER_DATA)

API Description

Get income history

HTTP Request

GET /dapi/v1/income

Request Weight

20

Request Parameters

NameTypeMandatoryDescription
symbolSTRINGNO
incomeTypeSTRINGNO"TRANSFER","WELCOME_BONUS", "FUNDING_FEE", "REALIZED_PNL", "COMMISSION", "INSURANCE_CLEAR", and "DELIVERED_SETTELMENT"
startTimeLONGNOTimestamp in ms to get funding from INCLUSIVE.
endTimeLONGNOTimestamp in ms to get funding until INCLUSIVE.
pageINTNO
limitINTNODefault 100; max 1000
recvWindowLONGNO
timestampLONGYES
  • If incomeType is not sent, all kinds of flow will be returned
  • "trandId" is unique in the same "incomeType" for a user
  • The interval between startTime and endTime can not exceed 200 days:
    • If startTime and endTime are not sent, the last 200 days will be returned

Response Example

[
{
"symbol": "", // trade symbol, if existing
"incomeType": "TRANSFER", // income type
"income": "-0.37500000", // income amount
"asset": "BTC", // income asset
"info":"WITHDRAW", // extra information
"time": 1570608000000,
"tranId":"9689322392", // transaction id
"tradeId":"" // trade id, if existing
},
{
"symbol": "BTCUSD_200925",
"incomeType": "COMMISSION",
"income": "-0.01000000",
"asset": "BTC",
"info":"",
"time": 1570636800000,
"tranId":"9689322392",
"tradeId":"2059192"
}
]