# Hyperliquid Historical Funding Rate API

> Hyperliquid Historical Funding Rate API is a paid API for AI agents from hl-funding.api.klymax402.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns historical 8-hour funding rate data for a specified Hyperliquid perpetual market coin over a configurable lookback window

## Facts

- Endpoint: GET https://hl-funding.api.klymax402.com/api/history
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-historical-funding-rate-api-537cd32e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_d8W6e--SFzNatUzyAj1eG

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 hyperliquid-historical-funding-rate-api-537cd32e
```

Example prompt: Pull the last 7 days of Hyperliquid funding rate history for BTC — I want to see how the 8-hour funding periods have trended over 168 hours.

## When to prefer this

Use this endpoint when you need time-series historical funding rate data for a specific Hyperliquid perpetual market over a flexible lookback window. Prefer it over the sibling arbitrage endpoint when you want raw funding history rather than pre-computed cross-coin comparisons. Ideal for carry cost analysis, position management, backtesting funding strategies, and trend visualization.

## Known failure modes

- Invalid or unsupported coin ticker returns an error or empty result if the symbol doesn't match a Hyperliquid perp market
- Hours value exceeding 720 may be rejected or capped
- Missing coin parameter returns a validation error
- Payment failure (x402) prevents request from completing
- Network or upstream Hyperliquid data unavailability causes timeout or error

## How this service works

Historical funding rate data for a specific Hyperliquid coin

## Output

Returns a time-series of historical funding rate entries for the specified Hyperliquid perpetual market, each representing one 8-hour funding period. Entries include the funding rate value and timestamp for each period within the requested lookback window (up to 90 entries for a 720-hour window).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string",
   "description": "Coin ticker symbol (e.g. BTC, ETH, SOL, DOGE). Must match a Hyperliquid perp market."
  },
  "hours": {
   "type": "number",
   "description": "Lookback window in hours. Default: 24. Max: 720 (30 days). Each funding period is 8 hours, so 24h returns ~3 entries."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-historical-funding-rate-api-537cd32e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hl-funding.api.klymax402.com](https://www.zero.xyz/host/hl-funding.api.klymax402.com/llms.txt)