# Hyperliquid Historical Funding Rates

> Hyperliquid Historical Funding Rates is a paid API for AI agents from hyperliquid.use.x402atlas.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns hourly historical funding rates, premiums, and timestamps for a single Hyperliquid perpetual asset over a specified time window.

## Facts

- Endpoint: GET https://hyperliquid.use.x402atlas.com/funding
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hyperliquid-historical-funding-rates-e23b60ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vZEI3h07FmJN7oTISM4Fr

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-rates-e23b60ab
```

Example prompt: Pull the hourly funding rate history for BTC on Hyperliquid for the past 7 days — I want to see the funding rate and premium for each period.

## When to prefer this

Use this endpoint when you need historical per-hour funding rate and premium data for a specific Hyperliquid perpetual over a configurable time window. Prefer it over predicted/live funding endpoints when backtesting strategies, auditing past carry costs, or analyzing funding rate trends. It is the right choice for time-series funding analysis rather than snapshot or cross-venue comparison.

## Known failure modes

- Missing required 'coin' query parameter returns an error
- Invalid or unrecognized coin symbol returns empty or error response
- Start/end timestamps outside available data range may return empty funding array
- Malformed epoch integer values (e.g. negative) rejected by schema validation
- Payment not received or x402 flow incomplete results in 402 response

## How this service works

Historical funding rates for one Hyperliquid perpetual over a time window — funding rate, premium and timestamp per hour.

## Output

An array of hourly funding entries for the requested perpetual asset, each containing the coin symbol, ISO 8601 timestamp, funding rate (string for full precision), and premium (string for full precision), along with the total count of entries and the time the query was generated.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "coin"
     ],
     "properties": {
      "end": {
       "type": "integer",
       "minimum": 0,
       "description": "Optional end (ms epoch)"
      },
      "coin": {
       "type": "string",
       "maxLength": 32,
       "description": "Perp asset symbol (e.g. BTC)"
      },
      "start": {
       "type": "integer",
       "minimum": 0,
       "description": "Optional start (ms epoch); defaults to 7 days ago"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "coin": {
       "type": "string"
      },
      "count": {
       "type": "integer",
       "description": "Number of funding entries returned"
      },
      "funding": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "coin": {
          "type": "string"
         },
         "time": {
          "type": "string",
          "format": "date-time"
         },
         "premium": {
          "type": "string",
          "description": "Premium (string for full precision)"
         },
         "funding_rate": {
          "type": "string",
          "description": "Funding rate (string for full precision)"
         }
        }
       }
      },
      "queried_at": {
       "type": "string",
       "format": "date-time",
       "description": "When this response was generated"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "BTC",
  "count": 1,
  "funding": [
   {
    "coin": "BTC",
    "time": "2026-07-10T11:00:00Z",
    "premium": "0.0001",
    "funding_rate": "0.0000125"
   }
  ],
  "queried_at": "2026-07-10T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hyperliquid-historical-funding-rates-e23b60ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hyperliquid.use.x402atlas.com](https://www.zero.xyz/host/hyperliquid.use.x402atlas.com/llms.txt)