# SwapHunt Funding Rate History

> SwapHunt Funding Rate History is a paid API for AI agents from x402.swaphunt.dev, paid per call via x402, $0.004/call, status unknown (last checked 2026-11-20).

Returns settled funding rate history for a Binance USDT perpetual contract (up to 365 days), with statistics including average, range, share of positive periods, and percentile ranking of the latest rate.

## Facts

- Endpoint: GET https://x402.swaphunt.dev/v1/derivatives/funding-rates/history?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/swaphunt-funding-rate-history-fd100111
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GFeLkYoCeruARoCKF2mOz

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability swaphunt-funding-rate-history-fd100111
```

Example prompt: Is the current ETHUSDT funding rate unusual? Pull the last 180 days of funding rate history and tell me what percentile today's rate falls in, along with the average and whether it's been mostly positive or negative.

## When to prefer this

Use this endpoint when you need to contextualize a current funding rate against historical norms — e.g., deciding whether today's rate is a statistical outlier, assessing carry trade viability, or sizing the funding cost risk of a position. Prefer this over live-rate endpoints when you need statistical context (percentile, average, range) rather than just the current value.

## Known failure modes

- Invalid symbol returns an error or empty result — only Binance USDT perpetuals are supported
- Days parameter outside 1-365 range may be rejected or clamped
- Symbol not traded as a USDT perpetual on Binance will return no data
- Network or upstream Binance API failure may return a 5xx error
- Very new coins with limited history may return fewer data points than requested

## How this service works

Settled funding rates for one Binance USDT perpetual, up to 365 days, with average, range, share of positive periods and the percentile of the latest rate. Annualized at the symbol's own interval (1h, 4h or 8h). Use to judge whether today's funding is unusual for that coin.

## Output

Returns a dataset of settled funding rates for the requested symbol over the lookback window, along with computed statistics: average rate, min/max range, percentage of periods with positive funding, the current rate's percentile rank within that history, and rates annualized based on the symbol's funding interval (1h, 4h, or 8h).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "days": {
       "type": "integer",
       "default": 90,
       "description": "Lookback in days, 1-365"
      },
      "symbol": {
       "type": "string",
       "default": "BTC",
       "description": "Hyperliquid perpetual coin, e.g. BTC (BTCUSDT also accepted)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/swaphunt-funding-rate-history-fd100111/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.swaphunt.dev](https://www.zero.xyz/host/x402.swaphunt.dev/llms.txt)
