Cumulative Funding

The funding-rate series plus a running sum - what a 1-unit long has paid (positive) or earned (negative) over the window.

GET /v3/perps/funding-pnl/{instrument}

Cumulative funding

cURL

curl --request GET \
  --url https://api.polynode.dev/v3/perps/funding-pnl/{instrument} \
  --header 'x-api-key: <api-key>'

200

{
  "data": [
    {
      "cumulative_funding": "0.0000125",
      "funding_rate": "0.0000125",
      "timestamp": 1783490400156
    },
    {
      "cumulative_funding": "0.000025",
      "funding_rate": "0.0000125",
      "timestamp": 1783497600169
    }
  ],
  "instrument_id": 6,
  "symbol": "BTC-USD"
}

The funding-rate series plus a running sum — what a one-unit long has paid (positive) or earned (negative) over the window. Useful for funding-carry and basis analysis.

Entries are oldest first (the cumulative sum runs forward from the start of the window). Bound with after / before to accumulate over exactly the window you want; a plain call starts at the beginning of our archive.

Authorizations

x-api-key · string · header · required

Path Parameters

instrument · string · required

Instrument id (6), symbol (BTC-USD), or bare asset (btc).

Query Parameters

after · string

Only rows after this time (Unix s or ms).

before · string

Only rows before this time (Unix s or ms).

limit · integer

Max rows.

Response

200 - application/json

Success