# Perpetua Crypto Derivatives Risk Signal API

> Perpetua Crypto Derivatives Risk Signal API is a paid API for AI agents from api.tradeperpetua.xyz, paid per call via x402, $0.15/call, status unknown (last checked 2026-09-13).

Returns AI-generated perpetual futures risk signals (squeeze bias, funding rates, leverage heat, open interest) for major crypto assets, pay-per-call in USDC on Base via x402.

## Facts

- Endpoint: GET https://api.tradeperpetua.xyz/derivatives
- Price: $0.15/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/perpetua-crypto-derivatives-risk-signal-api-05d3635c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6pie4wfAB87STmj-czq5N

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 perpetua-crypto-derivatives-risk-signal-api-05d3635c
```

Example prompt: What's the current squeeze risk and leverage heat for ETH perpetuals — is it leaning long squeeze, short squeeze, or neutral, and how confident is the signal?

## When to prefer this

Choose this endpoint when you need a synthesized, AI-interpreted risk signal for crypto perpetual futures — not raw exchange data. It is ideal when you want squeeze bias classification, leverage heat scoring, and a plain-English rationale in a single low-cost call ($0.05 USDC). Prefer it over raw exchange APIs when you want pre-computed risk interpretation rather than raw order book data, and when you need pay-per-call flexibility without subscription commitments.

## Known failure modes

- Payment not received or insufficient USDC balance — 402 response with payment instructions
- Invalid or unsupported asset symbol — may return an error or default to BTC
- Rate limiting if too many calls in a short period
- Stale or unavailable market data for low-liquidity assets
- Network timeout if underlying data sources are slow

## How this service works

Perp derivatives leverage/squeeze signal: funding (8h + annualized), open interest and 24h change, long/short crowding, taker flow, basis, and a 0 to 100 leverage-heat score with a bias call and rationale. Binance Futures data.

## Output

A JSON object containing: squeeze bias label (long_squeeze_risk, short_squeeze_risk, or neutral), confidence (low/medium/high), a human-readable rationale, mark price, index price, basis percentage, 8-hour funding rate, annualized funding rate, long/short ratio, taker buy/sell ratio, open interest in USD, 24h OI change percentage, 24h price change percentage, and a leverage heat score (0–100).

## 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": {
      "asset": {
       "enum": [
        "BTC",
        "ETH",
        "SOL",
        "BNB",
        "XRP",
        "ADA",
        "DOGE",
        "AVAX",
        "LINK",
        "DOT",
        "TRX",
        "LTC",
        "UNI",
        "ATOM",
        "NEAR",
        "APT",
        "ARB",
        "OP",
        "SUI",
        "AAVE",
        "INJ",
        "POL"
       ],
       "type": "string",
       "default": "BTC",
       "description": "Perp asset symbol, one of BTC, ETH, SOL, BNB, XRP, ADA, DOGE, AVAX, LINK, DOT, TRX, LTC, UNI, ATOM, NEAR, APT, ARB, OP, SUI, AAVE, INJ, POL"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "bias": {
       "enum": [
        "long_squeeze_risk",
        "short_squeeze_risk",
        "neutral"
       ],
       "type": "string"
      },
      "asset": {
       "type": "string"
      },
      "basisPct": {
       "type": "number"
      },
      "markPrice": {
       "type": "number"
      },
      "rationale": {
       "type": "string"
      },
      "confidence": {
       "enum": [
        "low",
        "medium",
        "high"
       ],
       "type": "string"
      },
      "indexPrice": {
       "type": "number"
      },
      "leverageHeat": {
       "type": "number",
       "description": "0 to 100 leverage/fragility heat"
      },
      "longShortRatio": {
       "type": "number"
      },
      "oiChangePct24h": {
       "type": "number"
      },
      "openInterestUsd": {
       "type": "number"
      },
      "fundingRate8hPct": {
       "type": "number"
      },
      "priceChangePct24h": {
       "type": "number"
      },
      "takerBuySellRatio": {
       "type": "number"
      },
      "fundingAnnualizedPct": {
       "type": "number"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/perpetua-crypto-derivatives-risk-signal-api-05d3635c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.tradeperpetua.xyz](https://www.zero.xyz/host/api.tradeperpetua.xyz/llms.txt)