# Hyperliquid Perpetuals Funding Rate History

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

Retrieves historical funding rate entries and summary statistics for a Hyperliquid perpetuals market over a configurable lookback window.

## Facts

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

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-perpetuals-funding-rate-history-4ae21bf6
```

Example prompt: Can you pull the Hyperliquid funding rate history for BTC over the last 72 hours and tell me whether longs or shorts have been paying more?

## When to prefer this

Use this endpoint when you need historical Hyperliquid-specific perpetual funding rate data, including per-period entries and summary statistics, for any coin listed on Hyperliquid perp markets. Prefer this over generic crypto data APIs when you specifically need Hyperliquid funding history (not spot prices, order books, or funding from other exchanges like Binance or dYdX). Ideal for DeFi trading agents, funding arbitrage bots, and position cost analysis workflows.

## Known failure modes

- Invalid or unsupported coin ticker not listed as a Hyperliquid perp market — endpoint returns an error or empty entries
- Hours value exceeds 720 (30-day max) — request rejected or clamped
- Payment not received or insufficient USDC balance — 402 Payment Required response
- Network or upstream Hyperliquid API unavailability — 500 or timeout error
- Malformed input schema (e.g. non-numeric hours) — 400 Bad Request

## How this service works

One MCP endpoint gives your AI agent access to 100 APIs -- crypto, DeFi, web, AI, finance and utilities. No API keys, USDC on Base from $0.003/call.

## Output

Returns a JSON object containing the queried coin ticker, the requested lookback hours, an array of individual funding rate entries (each covering an 8-hour funding period), a summary object with aggregate statistics (e.g. average, total, direction bias), and a timestamp indicating when the data was fetched.

## 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."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "example",
  "hours": 1,
  "entries": [],
  "summary": {},
  "timestamp": "example"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-perpetuals-funding-rate-history-4ae21bf6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from klymax402.com](https://www.zero.xyz/host/klymax402.com/llms.txt)