Get Funding Rate History
Type: NONE
Weight: 1
GET /fapi/v1/fundingRate
Funding rate history for a symbol. Public endpoint: no X-MBX-APIKEY, timestamp or signature required.
Request
GET /fapi/v1/fundingRate?symbol=BTCUSDT&limit=100
Query params
| Name | Type | Required | Default | Notes |
|---|---|---|---|---|
symbol | string | no | — | Without it the response is the current rate of every symbol (one row each), not a history. |
startTime / endTime | long | no | — | Parsed but ignored — only the latest limit rows are returned. |
limit | integer | no | 100 | max 1000 |
Response — 200
[
{
"symbol": "BTCUSDT",
"fundingRate": "0.0001",
"fundingTime": 1714291200000,
"markPrice": "60050.50"
}
]
Sparky differences
- Time filtering is not applied; trim client-side.
- Omitting
symbolreturns one current row per symbol rather than a time-ordered multi-symbol history. - Funding settles every 8 h by default (
00:00 / 08:00 / 16:00 UTC); the interval is per market — see Funding Info.
Errors
| HTTP | code | msg |
|---|---|---|
400 | -1121 | Invalid symbol. |