Historical Funding

Dev

GET /funding/historical

Historical funding rate time series for one symbol across one or more exchanges, with adaptive downsampling based on the requested range: raw resolution for under 24 hours, hourly buckets for under 30 days, and 4-hour buckets beyond that. Use it to chart funding rate trends, compare venues over time, or backtest carry strategies. Rate limited to 2 requests per second.

Authentication

Requires Dev tier or higher. Dev: maximum 30 days lookback — requests with a wider range are clamped to 30 days and a notice is included in the response. Pro: full historical depth since September 2025.

Parameters

Query parameters

Name	Type	Required	Description
`symbol`	string	✓	Base symbol, e.g. BTC or ETH.
`start`	string (ISO 8601)	–	Start of range. Defaults to end minus 7 days.
`end`	string (ISO 8601)	–	End of range. Defaults to current UTC time.
`exchanges`	string	–	Comma-separated exchange slugs (e.g. binance,bybit), or all. Defaults to all exchanges.

Tier behavior

Dev: Maximum 30 days lookback. Requests beyond this are clamped server-side; the response includes a notices field explaining the adjustment.
Pro: Full historical depth since September 2025. No clamp.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/funding/historical?symbol=BTC&start=2026-06-01T00:00:00Z&exchanges=binance,bybit"

Example response

json

{
  "symbol": "BTC",
  "series": {
    "binance": [
      { "t": "2026-06-01T00:00:00Z", "y": 1.24 },
      { "t": "2026-06-01T08:00:00Z", "y": 1.18 },
      { "t": "2026-06-01T16:00:00Z", "y": 0.95 }
    ],
    "bybit": [
      { "t": "2026-06-01T00:00:00Z", "y": 1.20 },
      { "t": "2026-06-01T08:00:00Z", "y": 1.15 }
    ]
  },
  "notices": []
}

Errors

400 — Missing required parameter `symbol`, or invalid date format.
403 — Dev: requested date range exceeds your tier's 30-day limit and cannot be clamped. Upgrade to Pro for full depth.

For authentication errors (401) and rate limit responses (429), see Errors.