funding_rate_history

Get historical funding rate data for perpetual futures. Useful for analyzing funding rate trends, identifying periods of extreme rates, and backtesting funding rate arbitrage strategies.

Usage hints:

• Both exchange and symbol are required
• Use from/to date filters for specific time ranges
• Combine with cex_candle to correlate funding rates with price movements
• High absolute funding rates often precede price reversals

REST endpoint

GET /api/v1/funding-rate/history — see REST reference.

Parameters

Name	Type	Required	Default	Description	Example
exchange	string	yes		Specifes exchange	"..."
symbol	string	yes		Specifies symbol	"..."
page	string	no	1	Specifies page (default: 1)	"1"
limit	string	no	1000	Specifies limit (default: 1000)	"1000"
from	string	no		Specifies from	"..."
to	string	no		Specifies to	"..."
sort	string	no	asc	Specifies sort (asc, desc) (default: asc)	"asc"

Example invocation

JSON-RPC tools/call payload:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "funding_rate_history",
    "arguments": {
      "exchange": "...",
      "symbol": "...",
      "page": "1",
      "limit": "1000",
      "sort": "asc"
    }
  }
}