Historical by Exchange

Dev

GET /funding/historical-by-exchange

Per-exchange funding data in two modes: snapshot returns current Redis rates for all symbols on the exchange; recent returns up to 6 hours of ClickHouse time series. Snapshot mode is near-instant from Redis. Recent mode is useful for charting short-term rate movement on a single venue without pulling the full multi-exchange historical endpoint.

Authentication

Requires Dev tier or higher. Dev: snapshot mode only — passing mode=recent returns 403. Pro: both snapshot and recent mode, with up to 6 hours of history.

Parameters

Query parameters

Name	Type	Required	Description
`exchange`	string	✓	Lowercase exchange slug, e.g. binance.
`mode`	string	–	snapshot (default) or recent.
`start`	string (ISO 8601)	–	For recent mode only. Defaults to 3 hours ago. Maximum range is 6 hours.
`end`	string (ISO 8601)	–	For recent mode only. Defaults to now.

Tier behavior

Dev: Snapshot mode only. Passing mode=recent returns 403.
Pro: Snapshot and recent mode. Up to a 6-hour window on recent.

Example request

bash

curl -H "X-Api-Key: lk_live_your_key_here" \
  "https://api.loris.tools/funding/historical-by-exchange?exchange=binance&mode=snapshot"

Example response

json

{
  "exchange": "binance",
  "symbols": ["BTC", "ETH", "SOL", "DOGE"],
  "mode": "snapshot",
  "current_rates": {
    "BTC": 1.23,
    "ETH": -0.45,
    "SOL": 2.10
  },
  "data": [],
  "notices": []
}

Errors

400 — Unknown exchange slug, or recent mode with a range exceeding 6 hours.
403 — Dev tier attempting recent mode. Upgrade to Pro.

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

Historical Funding