# Crypto Perpetual Funding Rate History

> Crypto Perpetual Funding Rate History is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns historical perpetual futures funding rates for a crypto coin over recent periods, including the latest value, average, and trend direction, sourced from OKX.

## Facts

- Endpoint: GET https://api.x402node.dev/market/funding-history
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/crypto-perpetual-funding-rate-history-05f990ac
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0lDnCk6CRsNiHVaj_zkb5

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 crypto-perpetual-funding-rate-history-05f990ac
```

Example prompt: Can you pull the funding rate history for BTC perpetuals from OKX and tell me whether funding has been persistently positive or negative recently, along with the average rate and trend?

## When to prefer this

Use this endpoint when you need a time-series view of funding rates rather than a single snapshot — particularly for carry trade analysis, identifying persistent long/short bias in a market, or backtesting funding-based strategies. Prefer this over the live funding rate endpoint when historical trend and average matter more than just the current rate.

## Known failure modes

- Unknown or unsupported coin symbol returns an error or empty result
- OKX data unavailability causes upstream timeout or partial data
- Missing required coin parameter returns a 400 bad request
- Payment not processed or x402 auth failure blocks the response

## How this service works

Historical perpetual funding rates for a coin over recent periods with the latest value, average and trend, built from OKX. Lets an agent see whether funding has been persistently positive or negative rather than a single snapshot. Live time series for funding and carry analysis. funding rate history, funding trend, carry, perp

## Output

A time series of historical funding rates for the requested coin's perpetual futures contract, along with the latest funding rate, the average rate over the period, and a trend indicator showing whether funding is persistently positive, negative, or mixed — enabling carry analysis.

## 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",
     "properties": {
      "limit": {
       "type": "string",
       "description": "periods, default 30"
      },
      "symbol": {
       "type": "string",
       "description": "coin symbol e.g. BTC (default BTC)"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/crypto-perpetual-funding-rate-history-05f990ac/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)