GET /v1/funding

Retrieve funding rate history from perpetual futures exchanges.

Min Tier: Free | Credits: 50 base + 3 per row returned

Parameters

Response

Response Headers

Example

Send your API key in the X-API-Key header (recommended) or as the api-key query parameter. Examples below use the header.

import requests

resp = requests.get(
    "https://kwery-api.com/v1/funding",
    headers={"X-API-Key": "YOUR_KEY"},
    params={
        "symbol": "ETH",
        "source": "binance_futures",
        "start": "2026-03-07T00:00:00Z",
        "end": "2026-03-08T00:00:00Z",
        "limit": 10,
    },
)
data = resp.json()

Query parameter alternative: Add api-key=YOUR_KEY to the URL for quick tests; the header is recommended for production.

Example Response

{
  "data": [
    {
      "timestamp": "2026-03-07T00:00:00Z",
      "symbol": "ETH",
      "source": "binance_futures",
      "funding_rate": 0.0001,
      "next_funding_time": "2026-03-07T08:00:00Z"
    },
    {
      "timestamp": "2026-03-07T08:00:00Z",
      "symbol": "ETH",
      "source": "binance_futures",
      "funding_rate": 0.00015,
      "next_funding_time": "2026-03-07T16:00:00Z"
    },
    {
      "timestamp": "2026-03-07T16:00:00Z",
      "symbol": "ETH",
      "source": "binance_futures",
      "funding_rate": -0.00005,
      "next_funding_time": "2026-03-08T00:00:00Z"
    }
  ],
  "meta": {
    "symbol": "ETH",
    "source": "binance_futures",
    "returned": 3,
    "next_cursor": null,
    "has_more": false
  }
}

Source-Specific Behavior

Binance Futures — Funding settles every 8 hours at 00:00, 08:00, and 16:00 UTC. Each row corresponds to one settlement event. The funding_rate is the rate that was applied at timestamp.

Hyperliquid — Funding settles hourly. This produces significantly more rows than Binance for the same time range. When querying both sources without a source filter, results are interleaved chronologically.

Tier Access

Errors