← Back to Indicators

BTC Funding Rate API

Bitcoin perpetual futures funding rate — real-time measure of trader positioning and leverage direction.

Webhook URL
https://api.hunchmachine.com/webhook/indicators?indicator=btc_funding_rate&api_key=YOUR_API_KEY

Description

Tracks the perpetual futures funding rate, a key measure of trader positioning and market bias in derivative markets. Funding rates reflect the balance between long and short traders — positive values mean longs are paying shorts (bullish bias), while negative values indicate shorts paying longs (bearish sentiment).

What this endpoint provides

A simplified funding overview combining the most recent 8-hour rate and the 48-hour average, along with qualitative interpretation fields that summarize leverage conditions and trader sentiment.

Response fields

value

Latest 8-hour funding rate (in %).

funding_avg_48h_pct

Average funding rate over the past 48 hours (smooths short-term spikes).

trend

General directional assessment of the funding environment (bullish, bearish, or neutral).

momentum_state

Indicates if funding pressure is increasing, decreasing, or stable (accelerating, weakening, stable).

interpretation

Human-readable explanation of what current rates imply about market sentiment.

summary

Compact text summary of current and average funding levels plus interpretation.

timestamp

UTC time when the indicator was last updated.

Output example

[
  {
    "indicator": "btc_funding_rate",
    "timestamp": "2025-11-01T02:33:29.794Z",
    "value": 0.01,
    "funding_avg_48h_pct": 0.0062,
    "trend": "neutral",
    "momentum_state": "stable",
    "interpretation": "Neutral funding — balanced market, low leverage pressure.",
    "summary": "Funding: 0.0100% (8h) | 0.0062% (48h avg) | Neutral funding — balanced market, low leverage pressure."
  }
]

Interpretation & Use

Funding rates capture market positioning and sentiment in perpetual futures. • **Positive values** → Longs dominate, indicating bullish bias but potential over-leverage. • **Negative values** → Shorts dominate, often near fear-driven corrections. • **Neutral / near-zero** → Balanced market with low speculative pressure. Automations can monitor value and trend to detect crowd positioning changes (e.g., “funding rising fast” → potential long squeeze), or feed the interpretation field directly to LLMs to inform reasoning about speculative activity and leverage risk.