Funding Rate

Funding-rate data, exposed via four related endpoints. The /fapi/v1/fundingRate form is a transparent Binance mirror (nginx forwards to fapi.binance.com); the /funding/rates* family is served by the platform's FastAPI gateway and uses a slightly different shape per call.

GET /fapi/v1/fundingRate — historical funding rates (Binance mirror)

Passthrough of Binance USDⓈ-M Futures /fapi/v1/fundingRate. Authentication: public.

Query parameters

Name	Type	Required	Default	Notes
symbol	string	No	—	If omitted, returns rates across all symbols.
limit	integer	No	Binance default 500	Maximum 1000 per Binance.
startTime	integer	No	—	Unix milliseconds.
endTime	integer	No	—	Unix milliseconds.

Response — 200 OK

Array (Binance shape):

[
  {
    "symbol": "BTCUSDT",
    "fundingTime": 1745928000000,
    "fundingRate": "0.00010000",
    "markPrice": "67890.12"
  }
]

Example

curl -s "https://api-dev.pipai.org/fapi/v1/fundingRate?symbol=BTCUSDT&limit=10"

---

GET /funding/rates — current funding rate for all symbols

Authentication: public. No query parameters.

Response — 200 OK

Returns whatever the platform's Binance client returns for get_funding_rates(). Typically an array of {symbol, fundingRate, ...} rows for the latest interval.

Example

curl -s "https://api-dev.pipai.org/funding/rates"

---

GET /funding/rates/{symbol} — current funding rate for one symbol

Authentication: public.

Path parameters

Name	Type	Required	Notes
symbol	string	Yes	Uppercase futures symbol.

Response — 200 OK

Single object for that symbol.

Example

curl -s "https://api-dev.pipai.org/funding/rates/BTCUSDT"

---

GET /funding/rates/{symbol}/history — historical funding rates for one symbol

Authentication: public.

Path parameters

Name	Type	Required	Notes
symbol	string	Yes	Uppercase futures symbol.

Query parameters

Name	Type	Required	Default	Notes
start_time	integer	No	—	snake_case. Unix milliseconds.
end_time	integer	No	—	snake_case. Unix milliseconds.
limit	integer	No	100

Response — 200 OK

Array of historical funding-rate rows for that symbol.

Errors (all four endpoints)

HTTP	Cause
502	Upstream Binance request failed.

Example

curl -s "https://api-dev.pipai.org/funding/rates/BTCUSDT/history?limit=50"