# cryptofeed402 BTC Funding Rate History

> cryptofeed402 BTC Funding Rate History is a paid API for AI agents from cryptofeed402.site, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-30).

Returns historical perpetual funding rate data for a Hyperliquid perp ticker (e.g. BTC) over a configurable time window and interval.

## Facts

- Endpoint: GET https://cryptofeed402.site/funding/history/BTC?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cryptofeed402-btc-funding-rate-history-879f846f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eYPTZZz5Le7-ZZ5652Akx

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 cryptofeed402-btc-funding-rate-history-879f846f
```

Example prompt: Pull the last 7 days of BTC perpetual funding rate history from Hyperliquid with 1-hour intervals and show me the annualized rate trend and summary stats.

## When to prefer this

Use this endpoint when you need historical perpetual funding rate time-series data specifically from Hyperliquid for any supported perp ticker. Prefer this over spot price endpoints when the goal is analyzing carry costs, funding arbitrage, or long-term rate trends. Choose the interval parameter based on your resolution needs (1h for granular, 1d for macro views). This is purpose-built for AI agents via x402 micropayment, so it suits automated pipelines that need historical funding data without manual authentication setup.

## Known failure modes

- 402 Payment Required if USDC payment via x402 is not provided or is insufficient
- Invalid symbol format returns an error (must match ^(?:[A-Za-z]{1,10}:)?[A-Za-z0-9]{1,20}$)
- Hours parameter out of range (must be 1-720 for 1h, 1-2160 for 4h/8h/1d)
- Invalid date format for from/to parameters
- No data available for very old or future date ranges
- Ticker not listed on Hyperliquid returns empty or error response

## How this service works

AI-to-AI crypto data. Paid routes use x402 (USDC on Base mainnet eip155:8453, asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913); unpaid calls return 402 with payment requirements. Not financial advice.

## Output

A JSON object containing the ticker symbol, total data point count, venue name (hyperliquid), interval in hours, a window/coverage summary, aggregated stats (min/max/mean annualized %), and an array of time-series points each with timestamp, premium, 8h rate, hourly rate, and annualized percentage.

## 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"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "symbol"
     ],
     "properties": {
      "symbol": {
       "type": "string",
       "pattern": "^(?:[A-Za-z]{1,10}:)?[A-Za-z0-9]{1,20}$",
       "description": "Hyperliquid perp ticker, case-insensitive; HIP-3 as dex:TICKER (xyz:TSLA)"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "to": {
       "type": "string",
       "description": "End, YYYY-MM-DD or ISO 8601 UTC; default now"
      },
      "from": {
       "type": "string",
       "description": "Start, YYYY-MM-DD or ISO 8601 UTC (instead of hours)"
      },
      "hours": {
       "type": "string",
       "pattern": "^[0-9]{1,4}$",
       "description": "Last N hours, 1-720 for 1h (default 168), 1-2160 for 4h/8h/1d"
      },
      "interval": {
       "enum": [
        "1h",
        "4h",
        "8h",
        "1d"
       ],
       "type": "string",
       "description": "1h raw settlements (default) or UTC buckets"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "symbol",
      "count",
      "points"
     ],
     "properties": {
      "as_of": {
       "type": "string"
      },
      "count": {
       "type": "integer"
      },
      "stats": {
       "type": "object"
      },
      "venue": {
       "type": "string"
      },
      "points": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "time": {
          "type": "string"
         },
         "premium": {
          "type": [
           "number",
           "null"
          ]
         },
         "rate_8h": {
          "type": "number"
         },
         "rate_hourly": {
          "type": "number"
         },
         "annualized_pct": {
          "type": "number"
         }
        }
       }
      },
      "symbol": {
       "type": "string"
      },
      "window": {
       "type": "object"
    
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 168,
  "stats": {
   "max_annualized_pct": 21.9,
   "min_annualized_pct": -3.1,
   "mean_annualized_pct": 10.2
  },
  "venue": "hyperliquid",
  "points": [
   {
    "time": "2026-10-20T00:00:00.000Z",
    "premium": -0.0002,
    "rate_8h": 0.0001,
    "rate_hourly": 0.0000125,
    "annualized_pct": 10.95
   }
  ],
  "symbol": "BTC",
  "interval_hours": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cryptofeed402-btc-funding-rate-history-879f846f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from cryptofeed402.site](https://www.zero.xyz/host/cryptofeed402.site/llms.txt)