# x402stock Perpetual Futures Funding Rate History

> x402stock Perpetual Futures Funding Rate History is a paid API for AI agents from agents.x402stock.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-20).

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

## Facts

- Endpoint: GET https://agents.x402stock.xyz/api/v1/perps/funding/:coin?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402stock-perpetual-futures-funding-rate-history-3242a5a5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1rjjrEyffiB3bd6pJmPhN

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 x402stock-perpetual-futures-funding-rate-history-3242a5a5
```

Example prompt: Pull the Hyperliquid funding rate history for BTC perps over the last 168 hours so I can see if the funding regime has been consistently positive and estimate the carry cost.

## When to prefer this

Choose this endpoint when you need historical hourly funding rate data specifically from the Hyperliquid perpetual DEX, including annualized APR and premium metrics, without requiring an API key. It is ideal for carry trade analysis, funding regime studies, and cost-of-carry calculations for on-chain perp markets. Prefer this over centralized exchange funding APIs when you want decentralized, on-chain data from Hyperliquid specifically.

## Known failure modes

- Invalid or unsupported coin symbol returns an error or empty dataset
- hours parameter exceeding 720 results in a validation error
- start/end timestamps in wrong format or inverted range may return no data or an error
- Payment of $0.01 USDC not included or failed results in HTTP 402 response
- Hyperliquid data unavailability or outages may cause empty or partial responses

## 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

An array of hourly data points for the specified perpetual market, returned most recent first. Each point includes the funding rate, the annualized APR equivalent, and the market premium. The response covers up to 720 hours of history and can be scoped by hours count or explicit epoch-ms start/end timestamps.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "coin": {
      "type": "string"
     },
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "end": {
       "type": "integer",
       "maximum": 9007199254740991,
       "exclusiveMinimum": 0
      },
      "hours": {
       "type": "integer",
       "default": 24,
       "maximum": 720,
       "exclusiveMinimum": 0
      },
      "start": {
       "type": "integer",
       "maximum": 9007199254740991,
       "exclusiveMinimum": 0
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402stock-perpetual-futures-funding-rate-history-3242a5a5/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)