Skip to main content

Get Income History(USER DATA)

HTTP Request

GET /fapi/v1/income

Weight

100

Request Parameters

NameTypeMandatoryDescription
symbolSTRINGNO
incomeTypeSTRINGNO"TRANSFER","WELCOME_BONUS", "REALIZED_PNL","FUNDING_FEE", "COMMISSION", and "INSURANCE_CLEAR"
startTimeLONGNOTimestamp in ms to get funding from INCLUSIVE.
endTimeLONGNOTimestamp in ms to get funding until INCLUSIVE.
limitINTNODefault 100; max 1000
recvWindowLONGNO
timestampLONGYES
  • If incomeType is not sent, all kinds of flow will be returned
  • If startTime and endTime are not sent, the most recent limit datas will be returned.
  • If the number of data between startTime and endTime is larger than limit, response will be return as startTime + limit.

Example Response

[
{
"symbol": "",
"incomeType": "TRANSFER",
"income": "-0.37500000",
"asset": "USDT",
"info":"",
"time": 1570608000000,
},
{
"symbol": "BTCUSDT",
"incomeType": "COMMISSION",
"income": "-0.01000000",
"asset": "USDT",
"info":"",
"time": 1570636800000,
}
]