derivatives.funding_rate
Gauge long/short crowding and spot funding-rate arbitrage with current perpetual futures funding rates from Bybit (Binance fallback) before entering or hedging positions.
Instructions
Get perpetual futures funding rate (Bybit primary, Binance fallback) to
gauge long/short crowding before entering or hedging a position.
Use this when asked about funding rate levels or funding-rate arbitrage/carry
trade opportunities. If you also need the trade annualized into an APR with
a carry-trade breakeven-days estimate, use get_funding_apr_matrix instead -
it already calls this internally, so calling both is redundant. Check the
data_source field to see whether Bybit or the Binance fallback answered;
predicted_rate equals funding_rate because neither exchange exposes a
separate forecast field (not a bug). Also returns mark_price/index_price
(populated on both the Bybit and Binance paths) and open_interest_usd
(Bybit path only - always null on the Binance fallback, since Binance's
premiumIndex endpoint doesn't report open interest).
Args:
symbol: e.g. "BTC", "ETH", or "BTCUSDT" (non-USDT symbols are
normalized to USDT pairs).
Returns:
On success: {"success": true, "funding_rate_percentage",
"funding_interval_hours", "mark_price", "index_price",
"open_interest_usd", "data_source", ...}
On failure: {"success": false, "error": {"type", "message"}}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes |