Funding Rates

Hourly funding-rate history, newest first. Window with start_timestamp/end_timestamp (Unix ms).

GET /v3/perps/funding/{instrument}

Funding rates

cURL

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

200

{
  "data": [
    {
      "funding_rate": "0.0000125",
      "timestamp": 1783738800083
    },
    {
      "funding_rate": "0.0000125",
      "timestamp": 1783735200089
    },
    {
      "funding_rate": "0.0000125",
      "timestamp": 1783731600025
    }
  ],
  "instrument_id": 6,
  "more": true,
  "symbol": "BTC-USD"
}

Newest first, one entry per hourly funding event, with instrument_id/symbol alongside the data.

Query parameters

Parameter	Description
after / before	Time window (Unix seconds or ms, detected automatically)
limit	Max rows (default 500, up to 5000)
start_timestamp / end_timestamp	Legacy aliases of after / before (Unix ms)

Responses carry a more flag; page older history by moving before to the oldest timestamp you’ve received.

The current live rate and the next funding time are on the ticker. Rates are per funding interval (hourly) — multiply by 24×365 for an annualized figure.

Authorizations

x-api-key · string · header · required

Path Parameters

instrument · string · required

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

Query Parameters

start_timestamp · integer

Window start, Unix ms (legacy alias of after).

end_timestamp · integer

Window end, Unix ms (legacy alias of before).

after · string

Only rows after this time (Unix seconds or ms). Alias of start_timestamp.

before · string

Only rows before this time (Unix seconds or ms). Alias of end_timestamp.

limit · integer

Max rows to return (default 500, up to 5000).

Response

200 - application/json

Success