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"    }]