# Agent402 Perpetual Futures Basis & Funding Rate Lookup

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

Returns real-time perpetual futures basis data including mid price, mark price, oracle price, funding rates, and predicted funding for a given crypto asset ticker.

## Facts

- Endpoint: POST https://agent402.tools/api/perp-basis
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-perpetual-futures-basis-funding-rate-lookup-1c146ff8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1F-U8d-ZqDEaSeEoGtKcW

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-basis-funding-rate-lookup-1c146ff8 -d '<json body>'
```

Example prompt: What's the current perpetual funding rate and basis for BTC right now — including the mark-oracle premium and predicted next funding interval?

## When to prefer this

Use this endpoint when you need real-time perpetual futures pricing and funding rate data sourced from Hyperliquid, particularly when you want both current and predicted funding intervals, mark-oracle spread in basis points, and annualized funding APR in a single call. Prefer this over generic crypto price feeds when the specific data needed is perp basis and funding mechanics rather than spot price alone.

## Known failure modes

- Invalid or unsupported ticker symbol — returns error or empty data
- Hyperliquid data source temporarily unavailable — stale or missing fetchedAt
- Network timeout on upstream perp data fetch — delayed or failed response
- Malformed request body missing 'coin' field — likely 400 or validation error

## How this service works

Basis for one perpetual: mark versus oracle premium in percent and basis points, impact premium, current funding and the predicted next funding per venue. Use it when an agent is evaluating a cash-and-carry, comparing funding across venues or deciding whether a perp is trading rich or cheap to spot.

## Output

Returns a JSON object with the coin ticker, mid price, mark price, oracle price, impact premium percent, mark-oracle premium in both bps and percent, current funding rate (per 8h, hourly, and annualized APR), and an array of predicted funding entries each with venue, rate, APR, and next funding timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "coin": {
   "type": "string",
   "description": "Perp ticker, e.g. BTC, ETH, SOL."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "coin": "BTC",
  "midPx": 77266.5,
  "markPx": 77267,
  "source": "hyperliquid",
  "funding": {
   "per8h": 0.0001,
   "aprPct": 10.95,
   "hourly": 0.0000125
  },
  "oraclePx": 77236,
  "fetchedAt": "2026-08-22T12:00:00.000Z",
  "impactPremiumPct": 0.0388,
  "predictedFunding": [
   {
    "per8h": 0.0001,
    "venue": "HlPerp",
    "aprPct": 10.95,
    "fundingRate": 0.0000125,
    "nextFundingTime": "2026-08-22T13:00:00.000Z",
    "fundingIntervalHours": 1
   }
  ],
  "markOraclePremiumBps": 4.01,
  "markOraclePremiumPct": 0.0401
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-perpetual-futures-basis-funding-rate-lookup-1c146ff8/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)
