Settlement Funding

Settlement-aligned funding rates, snapped to each exchange's funding settlement intervals — for example 8-hour ticks on Binance, or 1-hour ticks on select DEXes. Returns the rate that was actually settled at each interval rather than point-in-time samples. This is the rigorous endpoint for backtesting and P&L attribution — use it when funding timing matters, such as delta-neutral carry trades or cross-venue funding arbitrage.

Authentication

Requires Dev tier or higher. Dev tier: rolling 30-day window ending now — start and end dates are floored server-side; a notice is included when clamped. Pro and Team: full historical depth since September 2025.

Parameters

Query parameters

Name	Type	Required	Description
`symbol`	string	✓	Base symbol, e.g. BTC.
`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. Omitting or passing all returns empty series for most exchanges — specify your target venues explicitly.

Tier behavior

Dev: Rolling 30-day window ending now. Dates before that floor are raised; end dates in the future are set to now. The response includes a notices field when clamped.
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/settlement?symbol=BTC&exchanges=binance,bybit&start=2026-06-01T00:00:00Z"

Example response

json

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

Errors

400 — Missing required parameter `symbol`, invalid date format, or unrecognized exchange slug.
403 — Your tier does not have access. Upgrade to Dev or higher.
503 — Settlement funding data is temporarily unavailable. Retry with backoff. Historical funding data is available from September 2025 onward; requests before that date may return no data.

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