Get Private Funding History

Description

Submit request to get the funding history.

Tips

The startAt and endAt range cannot exceed 3 months. An error will occur if the specified time window exceeds the range.

If only startAt is entered, the default endAt is the current time. If it exceeds 3 months, an error will be reported.

If only endAt is entered, the system will automatically calculate the start time as end time minus 3 months.

Note: Because data changes frequently, using offset-based pagination instead of time-based pagination (startAt and endAt) may lead to inaccurate or duplicated data. It is recommended to paginate using startAt and endAt for more reliable results. It is recommended to paginate by startAt and endAt

Request

Query Params

symbol

string

required

Symbol of the contract. Please refer to Get Symbol endpoint: symbol

Example:

XBTUSDTM

startAt

integer <int64>

optional

Begin time (milliseconds)

Example:

1700310700000

endAt

integer <int64>

optional

End time (milliseconds)

Example:

1702310700000

reverse

boolean

optional

This parameter functions to judge whether the lookup is forward or not. True means “yes” and False means “no”. This parameter is set as true by default.

offset

integer

optional

Start offset. The unique attribute of the last returned result of the last request. The data of the first page will be returned by default.

forward

boolean

optional

This parameter functions to judge whether the lookup is forward or not. True means “yes” and False means “no”. This parameter is set as true by default.

maxCount

integer

optional

Max. record count. The default record count is 10

Responses

🟢200OK

application/json

Body

code

string

required

data

object

required

hasMore

boolean

required

Whether there are more pages

dataList

array [object {11}]

required

Example

{
  "code": "200000",
  "data": {
    "dataList": [
      {
        "id": 1472387374042586,
        "symbol": "XBTUSDTM",
        "timePoint": 1731470400000,
        "fundingRate": 0.000641,
        "markPrice": 87139.92,
        "positionQty": 1,
        "positionCost": 87.13992,
        "funding": -0.05585669,
        "settleCurrency": "USDT",
        "context": "{\"marginMode\": \"ISOLATED\", \"positionSide\": \"BOTH\"}",
        "marginMode": "ISOLATED"
      }
    ],
    "hasMore": true
  }
}

Get Private Funding History

Request

Request samples

Responses