# Hyperliquid Perpetual Funding Rate History

> Hyperliquid Perpetual Funding Rate History is a paid API for AI agents from agent-data-tools.revmesh2074.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-30).

Returns hourly funding rates and annualized APR for a Hyperliquid perpetual over up to 500 hours of history

## Facts

- Endpoint: GET https://agent-data-tools.revmesh2074.workers.dev/hyperliquid/funding-history?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Provider: agent-data-tools.revmesh2074.workers.dev
- Website: https://agent-data-tools.revmesh2074.workers.dev
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetual-8ee1c993
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-5G_ASaAt1VAH4m6xt5pK

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 agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetual-8ee1c993
```

Example prompt: Pull the last 72 hours of hourly funding rates for BTC on Hyperliquid and tell me the average annualized APR over that window.

## When to prefer this

Use this endpoint when you need historical hourly funding rate data for a Hyperliquid perpetual — for trend analysis, regime detection, carry comparison, or backtesting funding-arbitrage strategies. For the current live funding rate, use the hyperliquid_market endpoint instead. Prefer this over generic crypto data providers when you specifically need Hyperliquid's native funding rate series with premium breakdowns and pre-computed APR.

## Known failure modes

- Invalid coin symbol returns an error or empty rates array
- Hours value outside 1-500 range may return an error or be clamped
- Hyperliquid API downtime causes upstream fetch failure
- Requesting a very new or illiquid coin may return limited or no data

## How this service works

Past hourly funding rates of a Hyperliquid perpetual (BTC, ETH, SOL…): each rate with its premium and time, plus the average rate and its annualised APR over the window. Up to 500 hours back (default 24). Read from Hyperliquid's public API. Use to compare carry over time, spot funding regime changes, or backtest basis and funding-arbitrage strategies; for the current rate use hyperliquid_market.

## Output

Returns a JSON object containing the coin symbol, the number of data points, the requested hours window, an array of hourly funding rate records (each with timestamp, premium, and hourly funding rate), the data source, the average hourly funding rate across the window, and the annualized APR percentage.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string",
   "description": "Coin symbol such as BTC, ETH, SOL or HYPE (default ETH)"
  },
  "hours": {
   "type": "integer",
   "description": "Hours of history, 1-500 (default 24)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "hours": {
   "type": "number"
  },
  "rates": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "time": {
      "type": "string"
     },
     "premium": {
      "type": "number"
     },
     "fundingRateHourly": {
      "type": "number"
     }
    }
   }
  },
  "source": {
   "type": "string"
  },
  "averageAprPct": {
   "type": "number"
  },
  "averageRateHourly": {
   "type": "number"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent-data-tools-revmesh2074-workers-dev-hyperliquid-perpetual-8ee1c993/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data-tools.revmesh2074.workers.dev](https://www.zero.xyz/host/agent-data-tools.revmesh2074.workers.dev/llms.txt)