get_funding_percentile
Read-only
Current perpetual funding rate for a symbol, ranked vs its own multi-year history as a percentile (0-100). Answers: "Is BTC funding unusually high?", "What percentile is ETH funding at?". Returns rate_bps (basis points, 8h-normalized, cross-venue; positive = longs pay shorts), percentile (0-100), streak_h (hours the rate has kept its sign), and the coverage (venues + history depth backing the rank). Read-only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| symbol | Yes | Asset symbol: BTC, ETH, SOL, BNB, XRP, DOGE, HYPE, ZEC or ENA (case-insensitive; a `USDT` suffix is accepted, e.g. `BTCUSDT`). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as_of | Yes | Assembly wall-time of the underlying state, RFC3339 UTC. | |
| symbol | Yes | Uppercase symbol, e.g. `BTC`. | |
| coverage | Yes | Availability of the funding metric (venues, window depth, reason). | |
| rate_bps | No | Current cross-venue funding rate, 8h-normalized, in bps. | |
| streak_h | No | Same-sign streak of the rate, in hours. | |
| percentile | No | Rank (0–100) of the current rate in its own trailing distribution. | |
| source_age_ms | No | Age of that source when the state was assembled. | |
| source_event_ts_ms | No | Oldest source event backing the cross-venue value, epoch ms. |