# Bitcoin Derivatives Snapshot — Binance Futures Data

> Bitcoin Derivatives Snapshot — Binance Futures Data is a paid API for AI agents from 4yearcycle.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns a real-time snapshot of Binance USDT-margined futures data including mark price, funding rate, open interest, and long/short ratios for up to 25 crypto symbols.

## Facts

- Endpoint: GET https://4yearcycle.com/x402/derivatives
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bitcoin-derivatives-snapshot-binance-futures-data-3e12d912
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_c4M4_l5xX7OS6s0-yg0Ci

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 bitcoin-derivatives-snapshot-binance-futures-data-3e12d912
```

Example prompt: Pull the latest Binance perpetual futures snapshot for BTCUSDT, ETHUSDT, and SOLUSDT — I want to see the current funding rates, long/short ratios, and open interest for each.

## When to prefer this

Use this endpoint when you need real-time Binance perpetual futures market data — funding rates, open interest, and long/short sentiment — for up to 25 crypto pairs in a single call. Prefer it over general price APIs when derivatives-specific signals (funding rate, long/short ratio) are needed for trading decisions or market sentiment analysis.

## Known failure modes

- Invalid symbol format (must match ^[A-Z0-9]+(,[A-Z0-9]+)*$) returns a validation error
- Requesting more than 25 symbols exceeds the maximum and may be rejected
- Binance API lookup failure may cause openInterest or longShortRatio fields to return null
- Payment failure or insufficient USDC balance results in 402 error
- Symbol not available on Binance USDT-margined futures returns empty or error row

## How this service works

Interactive Bitcoin 4-year halving cycle chart on a polar disc. Live price, 200W MA, Mayer Multiple, RSI, MACD, Pi Cycle and optional paid cycle projections.

## Output

A JSON object with a 'rows' array where each entry contains: symbol, markPrice, indexPrice, openInterest (in base coins), lastFundingRate (decimal), fundingRatePct (percent), longAccountPct, longShortRatio, and nextFundingTime (epoch ms). Also includes a count of returned symbols and a generatedAt timestamp.

## 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": [],
     "properties": {
      "symbols": {
       "type": "string",
       "pattern": "^[A-Z0-9]+(,[A-Z0-9]+)*$",
       "examples": [
        "BTCUSDT,ETHUSDT",
        "BTCUSDT,ETHUSDT,SOLUSDT"
       ],
       "description": "Comma-separated Binance USDT-margined futures symbols. Defaults to the top 10 by liquidity (BTCUSDT, ETHUSDT, SOLUSDT, BNBUSDT, XRPUSDT, DOGEUSDT, ADAUSDT, AVAXUSDT, LINKUSDT, SUIUSDT). Maximum 25."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "count",
      "generatedAt",
      "rows"
     ],
     "properties": {
      "rows": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "symbol",
         "markPrice",
         "lastFundingRate"
        ],
        "properties": {
         "symbol": {
          "type": "string",
          "description": "Binance USDT-margined futures symbol"
         },
         "markPrice": {
          "type": "number",
          "description": "Mark price in USDT"
         },
         "indexPrice": {
          "type": "number",
          "description": "Index price in USDT"
         },
         "openInterest": {
          "type": [
           "number",
           "null"
          ],
          "description": "Open interest in base units (coins), null if lookup failed"
         },
         "fundingRatePct": {
          "type": "number",
          "description": "Last funding rate in percent"
         },
         "longAccountPct": {
          "type": [
           "number",
           "null"
          ],
          "description": "Percentage of accounts long, null if lookup failed"
         },
         "longShortRatio": {
          "type": [
           "number",
           "null"
          ],
          "description": "Long/short account ratio, null if lookup failed"
         },
         "l
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "rows": [
   {
    "symbol": "BTCUSDT",
    "markPrice": 97123.4,
    "indexPrice": 97118.2,
    "openInterest": 105773.773,
    "fundingRatePct": 0.005,
    "longAccountPct": 60.18,
    "longShortRatio": 1.51,
    "lastFundingRate": 0.00005,
    "nextFundingTime": 1787100000000
   },
   {
    "symbol": "ETHUSDT",
    "markPrice": 3120.5,
    "indexPrice": 97118.2,
    "openInterest": 450012.3,
    "fundingRatePct": 0.005,
    "longAccountPct": 60.18,
    "longShortRatio": 1.51,
    "lastFundingRate": 0.00005,
    "nextFundingTime": 1787100000000
   },
   {
    "symbol": "SOLUSDT",
    "markPrice": 142.8,
    "indexPrice": 97118.2,
    "openInterest": 20123456.1,
    "fundingRatePct": 0.005,
    "longAccountPct": 60.18,
    "longShortRatio": 1.51,
    "lastFundingRate": 0.00005,
    "nextFundingTime": 1787100000000
   }
  ],
  "count": 3,
  "generatedAt": 1787047200000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bitcoin-derivatives-snapshot-binance-futures-data-3e12d912/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 4yearcycle.com](https://www.zero.xyz/host/4yearcycle.com/llms.txt)