# Hyperliquid Perpetual Futures Historical Funding Rate Series

> Hyperliquid Perpetual Futures Historical Funding Rate Series is a paid API for AI agents from agents.x402stock.xyz, paid per call via MPP, $0.01/call, status unknown (last checked 2026-09-13).

Returns the historical hourly funding-rate time series for a Hyperliquid perpetual futures market, including funding rate, annualized APR, and premium, most recent first.

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/perps/funding/{coin}
- Price: $0.01/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Provider: agents.x402stock.xyz
- Website: https://agents.x402stock.xyz
- Canonical page: https://www.zero.xyz/c/agents-x402stock-xyz-hyperliquid-perpetual-futures-historical-funding-d4dedb2c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yFCIdrtKhk6ZDMmURkByo

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 agents-x402stock-xyz-hyperliquid-perpetual-futures-historical-funding-d4dedb2c
```

Example prompt: Pull the last 72 hours of hourly funding rate history for BTC perpetual futures on Hyperliquid — I want to see the funding rate, annualized APR, and premium for each point.

## When to prefer this

Use this endpoint when you need historical hourly granularity of funding rates for Hyperliquid perpetual futures — specifically when studying funding regimes, carry opportunities, or annualized APR trends. Prefer this over generic crypto APIs when you need Hyperliquid-specific on-chain DEX data with premium and APR pre-computed. No API key required.

## Known failure modes

- Invalid or unsupported coin symbol returns an error or empty history
- hours value exceeding 720 is rejected
- Invalid epoch-ms for start/end causes a bad request error
- Conflicting use of hours with start/end may return unexpected results
- Hyperliquid data unavailability for a given time range may return null values in individual fields

## How this service works

The historical hourly funding-rate series for one perpetual-futures market, each point with the funding rate, annualized APR, and premium, most recent first. Pass the coin in the path (e.g. BTC) and tune the window with `?hours=` (default 24, max 720) or an explicit `?start=`/`?end=` epoch-ms range. Use to study funding regimes and carry. Free on-chain DEX data (venue: Hyperliquid), no key.

## Output

A JSON object containing the coin symbol, venue (Hyperliquid), source, as_of timestamp, count of data points, and a history array of hourly records each with: time (ISO string), funding_rate_hourly (decimal), funding_apr_percent (annualized percentage), and premium (decimal). Records are ordered most recent first.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "coin"
 ],
 "properties": {
  "end": {
   "type": "integer",
   "maximum": 9007199254740991,
   "exclusiveMinimum": 0
  },
  "coin": {
   "type": "string",
   "description": "Hyperliquid perpetual coin symbol, e.g. BTC or ETH."
  },
  "hours": {
   "type": "integer",
   "default": 24,
   "maximum": 720,
   "exclusiveMinimum": 0
  },
  "start": {
   "type": "integer",
   "maximum": 9007199254740991,
   "exclusiveMinimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "source",
  "as_of",
  "venue",
  "coin",
  "count",
  "history"
 ],
 "properties": {
  "coin": {
   "type": "string"
  },
  "as_of": {
   "type": "string"
  },
  "count": {
   "type": "number"
  },
  "venue": {
   "type": "string"
  },
  "source": {
   "type": "string",
   "const": "x402stock"
  },
  "history": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "time",
     "funding_rate_hourly",
     "funding_apr_percent",
     "premium"
    ],
    "properties": {
     "time": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "premium": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "funding_apr_percent": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     },
     "funding_rate_hourly": {
      "anyOf": [
       {
        "type": "number"
       },
       {
        "type": "null"
       }
      ]
     }
    },
    "additionalProperties": false
   }
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-x402stock-xyz-hyperliquid-perpetual-futures-historical-funding-d4dedb2c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.x402stock.xyz](https://www.zero.xyz/host/agents.x402stock.xyz/llms.txt)