# Orchard Data – Perpetual Futures Funding Rate History

> Orchard Data – Perpetual Futures Funding Rate History is a paid API for AI agents from orchard-data.letom1176.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-28).

Returns historical and current funding rate data for a perpetual futures symbol over a configurable time window

## Facts

- Endpoint: GET https://orchard-data.letom1176.workers.dev/api/funding-history?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/orchard-data-perpetual-futures-funding-rate-history-a16d51f6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0_aWeEy2xmY4-qGTC_OW5

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 orchard-data-perpetual-futures-funding-rate-history-a16d51f6
```

Example prompt: What's the BTC perp funding rate history for the last 48 hours — give me the current rate, annualized rate, open interest, and what share of that window funding was positive?

## When to prefer this

Use this endpoint when you need historical and current perpetual futures funding rate data for crypto assets, especially when you need annualized rates, open interest, and time-windowed positive-funding-share metrics in a single call. Prefer this over generic market data APIs when you specifically need perp funding rate analytics and are operating in an x402 micropayment-compatible agent stack.

## Known failure modes

- Missing required 'symbol' query parameter returns an error
- Invalid or unsupported symbol returns no data or error
- Hours value outside 1-168 range may be rejected or clamped
- Payment failure via x402 (insufficient USDC balance) blocks the request
- Cloudflare Worker downtime causes 5xx errors

## How this service works

Market data and agent tools (web-read, email-verify, token-check) for AI agents, paid per-call via x402 (USDC on Base). Free index at /, free spec here.

## Output

Returns a JSON object with the queried symbol, a window summary (hours, positive funding share, average 8h funding rate %), and current snapshot (open interest, current 8h funding rate %, annualized funding rate %).

## 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": [
      "symbol"
     ],
     "properties": {
      "hours": {
       "type": "number",
       "description": "History window, 1-168 (default 24)"
      },
      "symbol": {
       "type": "string",
       "description": "Perp symbol, e.g. BTC, ETH, SOL, kPEPE"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "symbol": "BTC",
  "window": {
   "hours": 24,
   "positive_share": 0.96,
   "avg_funding_pct_8h": 0.0088
  },
  "current": {
   "open_interest": 42804.8,
   "funding_rate_pct_8h": 0.01,
   "funding_annualized_pct": 10.95
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/orchard-data-perpetual-futures-funding-rate-history-a16d51f6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from orchard-data.letom1176.workers.dev](https://www.zero.xyz/host/orchard-data.letom1176.workers.dev/llms.txt)