Funding Fees

danger

Poloniex futures v1/v2 API will be officially offline on November 30, 2024. You can access the V3 API to provide you with a better trading experience.

Get Funding History

Submit request to get the funding history.

HTTP Request

GET https://futures-api.poloniex.com/api/v1/funding-history

Example

GET https://futures-api.poloniex.com/api/v1/funding-history?symbol=BTCUSDTPERP

API Permission

This endpoint requires the General permission.

REQUEST RATE LIMIT

This API is restricted for each account, the request rate limit is 9 times/3s.

PARAMETERS

Param	Type	Description
symbol	String	Symbol of the contract
startAt	long	[optional] Start time (millisecond)
endAt	long	[optional] End time (millisecond)
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	long	[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	int	[optional] Max record count. The default record count is 10

Example:

  {
    "dataList": [
      {
        "id": 36275152660006,                //id
        "symbol": "BTCUSDTPERP",             //Symbol
        "timePoint": 1557918000000,          //Time point (millisecond) 
        "fundingRate": 0.000013,             //Funding rate
        "markPrice": 8058.27,                //Mark price
        "positionQty": 10,                   //Position size  
        "positionCost": -0.001241,           //Position value at settlement period
        "funding": -0.00000464,              //Settled funding fees. A positive number means that the user received the funding fee, and vice versa.
        "settleCurrency": "XBT"             //settlement currency
      },
      {
        "id": 36275152660004,
        "symbol": "BTCUSDTPERP",
        "timePoint": 1557914400000,
        "fundingRate": 0.00375,
        "markPrice": 8079.65,
        "positionQty": 10,
        "positionCost": -0.0012377,
        "funding": -0.00000465,
        "settleCurrency": "XBT" 
      },
      {
        "id": 36275152660002,
        "symbol": "BTCUSDTPERP",
        "timePoint": 1557910800000,
        "fundingRate": 0.00375,
        "markPrice": 7889.03,
        "positionQty": 10,
        "positionCost": -0.0012676,
        "funding": -0.00000476,
        "settleCurrency": "XBT" 
      }
    ],
    "hasMore": true                         //Whether there are more pages
  }