# Agent402 Perpetual Futures Funding Rate

> Agent402 Perpetual Futures Funding Rate is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-15).

Returns current and historical funding rates for a specified perpetual futures market, including hourly, 8-hour, and annualized rates, mark-vs-oracle premium, and windowed statistics.

## Facts

- Endpoint: POST https://agent402.tools/api/perp-funding
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-perpetual-futures-funding-rate-1a4bb10f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_O_fALDQ8cRBmlo-2tP2yt

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 agent402-perpetual-futures-funding-rate-1a4bb10f -d '<json body>'
```

Example prompt: What's the current funding rate for BTC perpetual futures — give me the hourly rate, 8-hour equivalent, and the last 48 hours of history so I can see if the regime has been consistently positive or recently flipped.

## When to prefer this

Choose this endpoint when an agent needs real-time or historical perpetual futures funding rate data — specifically the cost of holding a leveraged position, regime detection (positive vs negative funding), or carry trade analysis. Prefer this over generic market data APIs when you need funding-specific metrics like the 8-hour rate, annualized equivalent, and mark-vs-oracle premium all in one call.

## Known failure modes

- Unknown ticker symbol returns an error or empty result
- Limit value exceeding 500 may be clamped or rejected
- Network or venue outage may return stale or unavailable data
- Case-sensitive input errors resolved by case-insensitive normalization
- No data returned if the market has insufficient history for the requested window

## How this service works

Current and historical funding rate for one perpetual futures market, from a live derivatives venue: hourly rate, the 8-hour and annualized equivalents, the mark-vs-oracle premium, and a window of past prints with average, minimum, maximum and the share that were positive. Use it when an agent needs to know what holding a leveraged position costs right now, or wants to detect a funding regime flip before sizing a trade.

## Output

Returns the current hourly funding rate, 8-hour equivalent, and annualized rate for the specified perp market, the mark-vs-oracle price premium, and a time series of historical hourly funding prints (up to the requested limit) with aggregate statistics: mean, min, max, and the fraction of periods where funding was positive.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string",
   "description": "Perp ticker, e.g. BTC, ETH, SOL (case-insensitive)."
  },
  "limit": {
   "type": "number",
   "description": "Hourly history points to return (default 24, max 500)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "BTC",
  "stats": {
   "points": 24,
   "avgPer8h": 0.0001,
   "avgAprPct": 10.95,
   "avgHourly": 0.0000125,
   "maxHourly": 0.0000125,
   "minHourly": 0.0000125,
   "positiveSharePct": 100
  },
  "markPx": 77267,
  "source": "hyperliquid",
  "current": {
   "per8h": 0.0001,
   "aprPct": 10.95,
   "hourly": 0.0000125,
   "premiumPct": 0.0388
  },
  "history": [
   {
    "time": "2026-08-22T11:00:00.000Z",
    "premium": 0.00043,
    "fundingRate": 0.0000125
   }
  ],
  "fetchedAt": "2026-08-22T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-perpetual-futures-funding-rate-1a4bb10f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)