- Introduction
- Authentication
- Enums Definitions
- Terms Definitions
- SDK
- Rate Limit
- Change Log
- User Service
- REST
- Account Info
- Account & Funding
- Get Account Summary Info
- Get Apikey Info
- Get Account Type - Spot
- Get Account List - Spot
- Get Account Detail - Spot
- Get Account - Cross Margin
- Get Account - Isolated Margin
- Get Account - Futures
- Get Account Ledgers - Spot/Margin
- Get Account Ledgers - Trade_hf
- Get Account Ledgers - Margin_hf
- Get Account Ledgers - Futures
- Sub Account
- Sub Account API
- Deposit
- Withdrawals
- Transfer
- Trade Fee
- Account & Funding
- Spot Trading
- Market Data
- Get Announcements
- Get Currency
- Get All Currencies
- Get Symbol
- Get All Symbols
- Get Ticker
- Get All Tickers
- Get Trade History
- Get Klines
- Get Part OrderBook
- Get Full OrderBook
- Get Call Auction Part OrderBook
- Get Call Auction Info
- Get Fiat Price
- Get 24hr Stats
- Get Market List
- Get Client IP Address
- Get Server Time
- Get Service Status
- Orders
- Add Order
- Add Order Sync
- Add Order Test
- Batch Add Orders
- Batch Add Orders Sync
- Cancel Order By OrderId
- Cancel Order By OrderId Sync
- Cancel Order By ClientOid
- Cancel Order By ClientOid Sync
- Cancel Partial Order
- Cancel All Orders By Symbol
- Cancel All Orders
- Modify Order
- Get Order By OrderId
- Get Order By ClientOid
- Get Symbols With Open Order
- Get Open Orders
- Get Open Orders By Page
- Get Closed Orders
- Get Trade History
- Get DCP
- Set DCP
- Add Stop Order
- Cancel Stop Order By ClientOid
- Cancel Stop Order By OrderId
- Batch Cancel Stop Orders
- Get Stop Orders List
- Get Stop Order By OrderId
- Get Stop Order By ClientOid
- Add OCO Order
- Cancel OCO Order By OrderId
- Cancel OCO Order By ClientOid
- Batch Cancel OCO Order
- Get OCO Order By OrderId
- Get OCO Order By ClientOid
- Get OCO Order Detail By OrderId
- Get OCO Order List
- Market Data
- Margin Trading
- Futures Trading
- Market Data
- Orders
- Add Order
- Add Order Test
- Batch Add Orders
- Add Take Profit And Stop Loss Order
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Batch Cancel Orders
- Cancel All Orders
- Cancel All Stop orders
- Get Order By OrderId
- Get Order By ClientOid
- Get Order List
- Get Recent Closed Orders
- Get Stop Order List
- Get Open Order Value
- Get Recent Trade History
- Get Trade History
- Positions
- Funding Fees
- Copy Trading
- Earn
- VIP Lending
- Affiliate
- Broker
- Websocket API
- Base Info
- Spot Trading
- Margin Trading
- Futures Trading
- Error Code
- Abandoned Endpoints
- Introduction
- Account & Funding
- Get sub-account List - Summary Info (V1)
- Get sub-account List - Spot Balance (V1)
- Get Deposit Addresses (V2)
- Get Deposit Addresses - V1
- Sub-account Transfer
- Get Deposit History - Old
- Internal Transfer
- Get Futures Account Transfer Out Ledger
- Get Withdrawal History - Old
- Futures Account Transfer Out
- Futures Account Transfer In
- Add Deposit Address - V1
- Withdraw - V1
- Spot Trading
- Margin Trading
- Futures Trading
- Developing
Get Public Funding History
GET
https://api-futures.kucoin.com/api/v1/contract/funding-rates
domain:Futures
api-channel:Public
api-permission:Futures
api-rate-limit-pool:Public
sdk-service:Futures
sdk-sub-service:FundingFees
sdk-method-name:getPublicFundingHistory
api-rate-limit-weight:5
Description
Request
Query Params
symbol
string
required
Example:
XBTUSDTM
from
integer <int64>
required
Example:
1700310700000
to
integer <int64>
required
Example:
1702310700000
Request samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-futures.kucoin.com/api/v1/contract/funding-rates?symbol=XBTUSDTM&from=1700310700000&to=1702310700000'
Responses
🟢200OK
application/json
Body
code
string
required
data
array [object {3}]
required
symbol
string
required
fundingRate
number
required
timepoint
integer <int64>
required
Example
{
"code": "200000",
"data": [
{
"symbol": "XBTUSDTM",
"fundingRate": 0.00021,
"timepoint": 1702296000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000347,
"timepoint": 1702267200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000452,
"timepoint": 1702238400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000513,
"timepoint": 1702209600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000421,
"timepoint": 1702180800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000506,
"timepoint": 1702152000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000768,
"timepoint": 1702123200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000482,
"timepoint": 1702094400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.0004,
"timepoint": 1702065600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000546,
"timepoint": 1702036800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000797,
"timepoint": 1702008000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000576,
"timepoint": 1701979200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000422,
"timepoint": 1701950400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000392,
"timepoint": 1701921600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.00041,
"timepoint": 1701892800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000448,
"timepoint": 1701864000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000368,
"timepoint": 1701835200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000351,
"timepoint": 1701806400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000144,
"timepoint": 1701777600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000425,
"timepoint": 1701748800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": -0.000082,
"timepoint": 1701720000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000464,
"timepoint": 1701691200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000414,
"timepoint": 1701662400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000244,
"timepoint": 1701633600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000199,
"timepoint": 1701604800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000179,
"timepoint": 1701576000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000087,
"timepoint": 1701547200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000016,
"timepoint": 1701518400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": -0.000037,
"timepoint": 1701489600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000015,
"timepoint": 1701460800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000068,
"timepoint": 1701432000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000072,
"timepoint": 1701403200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000145,
"timepoint": 1701374400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000141,
"timepoint": 1701345600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000094,
"timepoint": 1701316800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000108,
"timepoint": 1701288000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000076,
"timepoint": 1701259200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.00001,
"timepoint": 1701230400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.00001,
"timepoint": 1701201600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000116,
"timepoint": 1701172800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000204,
"timepoint": 1701144000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.00023,
"timepoint": 1701115200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000062,
"timepoint": 1701086400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000133,
"timepoint": 1701057600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.00008,
"timepoint": 1701028800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000111,
"timepoint": 1701000000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000074,
"timepoint": 1700971200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000101,
"timepoint": 1700942400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000039,
"timepoint": 1700913600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000011,
"timepoint": 1700884800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000003,
"timepoint": 1700856000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000103,
"timepoint": 1700827200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000003,
"timepoint": 1700798400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000067,
"timepoint": 1700769600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000147,
"timepoint": 1700740800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000078,
"timepoint": 1700712000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000139,
"timepoint": 1700683200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000075,
"timepoint": 1700654400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000111,
"timepoint": 1700625600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000098,
"timepoint": 1700596800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000118,
"timepoint": 1700568000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000116,
"timepoint": 1700539200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.00016,
"timepoint": 1700510400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000192,
"timepoint": 1700481600000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000113,
"timepoint": 1700452800000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000247,
"timepoint": 1700424000000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.00023,
"timepoint": 1700395200000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000263,
"timepoint": 1700366400000
},
{
"symbol": "XBTUSDTM",
"fundingRate": 0.000132,
"timepoint": 1700337600000
}
]
}
Modified at 2025-03-20 06:46:43