# Hyperliquid Perpetual Funding History

> Hyperliquid Perpetual Funding History is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-19).

Returns hourly funding rate history for a Hyperliquid perpetual asset over 1–30 days, with average, max, min, annualized rate, positive-hours percentage, and a daily series.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/hyperliquid-funding-history?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-perpetual-funding-history-a2f51b15
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ziCZ3FRT9yepd7nAtmD0b

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-perpetual-funding-history-a2f51b15 -d '<json body>'
```

Example prompt: What has the funding rate looked like for ETH perps on Hyperliquid over the past 14 days — give me the average, annualized rate, and daily breakdown so I can evaluate a carry trade?

## When to prefer this

Choose this endpoint when you need structured, pre-aggregated funding rate statistics (average, annualized, max/min, positive-hour ratio, daily series) for Hyperliquid perpetuals specifically — particularly for carry or basis trading analysis. Prefer this over raw data sources when you need the aggregation and annualization done automatically without writing your own data pipeline.

## Known failure modes

- Missing required 'currency' field returns validation error
- Days value outside 1–30 range may return error or be clamped
- Unknown or unsupported asset symbol returns no data or error
- Hyperliquid data source unavailable causes upstream failure
- Payment failure (x402) prevents endpoint access

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

A JSON object containing: asset symbol, number of days and hours analyzed, average/max/min hourly funding percentages, annualized funding percentage, percentage of hours with positive funding, and a daily series array with per-day daily funding percentage and annualized rate. Includes a note clarifying funding direction convention.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "days": {
   "type": "integer",
   "description": "Days back (1-30, default 7)"
  },
  "currency": {
   "type": "string",
   "description": "Asset, e.g. BTC, ETH"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "days": 7,
  "note": "Positive funding: longs pay shorts. Source: Hyperliquid (open data).",
  "asset": "ETH",
  "hours": 169,
  "daily_series": [
   {
    "day": "2026-09-25",
    "annualized_pct": 10.95,
    "daily_funding_pct": 0.0125
   },
   {
    "day": "2026-09-26",
    "annualized_pct": 10.95,
    "daily_funding_pct": 0.03
   }
  ],
  "max_hourly_pct": 0.00125,
  "min_hourly_pct": 0.00125,
  "positive_hours_pct": 100,
  "annualized_funding_pct": 10.95,
  "avg_hourly_funding_pct": 0.00125
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-perpetual-funding-history-a2f51b15/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)