Funding Fee History

Type: USER-DATA

Weight: 5

GET /fapi/v1/fundingFeeHistory

Funding settlements with the position size they applied to. Sparky extension — Binance has no exact equivalent (it folds funding into income).

Request

GET /fapi/v1/fundingFeeHistory?symbol=BTCUSDT&limit=100&timestamp=<ms>&signature=<hex>

Query params

Name	Type	Required	Default	Notes
symbol	string	no	—
startTime / endTime	long	no	—	ms
limit	integer	no	100	1..1000

Response — 200

[
  {
    "symbol": "BTCUSDT",
    "fundingRate": "0.0001",
    "positionSize": "0.5",
    "fundingFee": "-0.030025",
    "positionSide": "LONG",
    "asset": "USDT",
    "time": 1714261234567,
    "tranId": "550e8400-..."
  }
]

positionSide is LONG or SHORT (never BOTH) — it is the direction of the position that was charged.

Errors

HTTP	code	msg
500	-1000	Database failure.

Authentication failures (INVALID_API_KEY, API_KEY_DISABLED, IP_NOT_ALLOWED, SIGNATURE_INVALID) apply to every signed endpoint and use Sparky's {"success":false,"error":{...}} envelope; see Error Codes.