Get Private Funding History

GET

https://api-futures.kucoin.com/api/v1/funding-history

api-channel:Private

api-permission:General

api-rate-limit-pool:Futures

sdk-service:Futures

sdk-sub-service:FundingFees

sdk-method-name:getPrivateFundingHistory

api-rate-limit-weight:5

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

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api-futures.kucoin.com/api/v1/funding-history?symbol=XBTUSDTM&startAt=1700310700000&endAt=1702310700000&reverse&offset&forward&maxCount'

Responses

🟢200OK

application/json

Body

Example

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

Modified at 2025-11-10 09:13:58

Get Public Funding History

Introduction