# Funding Rates Decision API

> Funding Rates Decision API is a paid API for AI agents from funding-rates-x402.data-labs.cloud, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Returns current perpetual futures funding rates across up to 16 crypto derivatives venues, normalized for AI trading agent consumption, via a micropayment-gated endpoint.

## Facts

- Endpoint: GET https://funding-rates-x402.data-labs.cloud/v1/funding/current
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/funding-rates-decision-api-a1e23f44
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YX9GA7GU0zn3kUY8t4jLE

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 funding-rates-decision-api-a1e23f44
```

Example prompt: What are the current funding rates for BTC and ETH across Binance, Bybit, Hyperliquid, and Paradex — I want to compare periodic vs continuous accrual venues to decide where to open a long?

## When to prefer this

Use this endpoint when an AI trading agent needs a real-time, multi-venue normalized view of perpetual futures funding rates to make position sizing or venue-selection decisions. It is particularly valuable when comparing periodic-cadence venues (Binance, Bybit, Gate, etc.) against continuously-accruing venues (Reya, Paradex) in a single call. Prefer this over scraping individual exchange APIs when consistency of schema, normalization of funding interval hours, and a single micropayment-gated call covering 16 venues matters for latency and simplicity.

## Known failure modes

- 402 Payment Required — unpaid request; response body lists per-route price in USDC and payment challenge details
- Invalid or unsupported venue name in the `venues` parameter — venue omitted from results or warning issued
- Unknown symbol in `symbols` parameter — no records returned for that symbol, warning may be included
- All venues unavailable or rate-limit exhausted upstream — empty records array with warnings
- Network timeout or upstream exchange API failure — partial results with warnings indicating which venues failed

## How this service works

Paid funding rate decision API for AI trading agents across up to 16 perp venues. Settled via x402 on Base mainnet (eip155:8453) using the Coinbase Mogami v2 facilitator; unpaid requests receive a 402 challenge that lists the per-route price.

## Output

Returns an array of funding rate records, each containing the venue name, symbol, per-interval funding rate as a decimal, funding cadence type (periodic or continuous_accrual), next funding time as Unix epoch milliseconds (or null), and the funding interval in hours. Also includes a metadata block with the service name, version, and response timestamp, plus a warnings array for any data quality or availability issues.

## Example request

```json
{
 "venues": "Binance,Bybit",
 "symbols": "BTC,ETH"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "venues": {
   "type": "string",
   "description": "Comma-separated list of venues to include. Omit for all configured venues."
  },
  "symbols": {
   "type": "string",
   "description": "Comma-separated list of canonical uppercase base symbols (e.g. `BTC,ETH`). Omit to receive every symbol the configured venues report."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data",
  "meta",
  "warnings"
 ],
 "properties": {
  "raw": {
   "type": "object",
   "additionalProperties": true
  },
  "data": {
   "type": "object",
   "required": [
    "records"
   ],
   "properties": {
    "records": {
     "type": "array",
     "items": {
      "type": "object",
      "required": [
       "venue",
       "symbol",
       "fundingRate",
       "nextFundingTime",
       "funding_kind",
       "funding_interval_hours"
      ],
      "properties": {
       "venue": {
        "enum": [
         "binance",
         "bybit",
         "mexc",
         "gate",
         "bitget",
         "bingx",
         "kucoin",
         "htx",
         "hyperliquid",
         "aster",
         "variational",
         "lighter",
         "pacifica",
         "backpack",
         "reya",
         "paradex",
         "nado",
         "risex"
        ],
        "type": "string"
       },
       "symbol": {
        "type": "string"
       },
       "fundingRate": {
        "type": "number",
        "description": "Per-interval funding rate (decimal)."
       },
       "funding_kind": {
        "enum": [
         "periodic",
         "continuous_accrual"
        ],
        "type": "string",
        "description": "Cadence type. `periodic` venues pay funding on a discrete cadence (1h, 4h, 8h). `continuous_accrual` venues (Reya, Paradex) accrue continuously; the rate is already normalized per `funding_interval_hours`."
       },
       "nextFundingTime": {
        "type": [
         "number",
         "null"
        ],
        "description": "Unix epoch ms of next funding payment, or null if not applicable."
       },
       "funding_interval_hours": {
        "type": "number",
        "minimum": 0
       }
      },
      "additionalProperties": false
     }
    }
   }
  },
  "meta": {
   "type": "object",
   "required": [
    "timestamp",
    "source"
   ],
   "properties": {
    "source": {
     "type": "object",
     "required": [
      "service"
     ],
     "properties": {
      "feature": {
       "type": "string"
      },
      "service": {
       "type": "string",
       "const": "funding-rates"
      },
      "version": {
       "type": "string"
      }
     }
    },
    "timestamp": {
     "type": "string",
     "format": "date-time"
    }
   }
  },
  "warnings": {
   "type": "array",
   "items": {
    "type": "string"
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/funding-rates-decision-api-a1e23f44/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from funding-rates-x402.data-labs.cloud](https://www.zero.xyz/host/funding-rates-x402.data-labs.cloud/llms.txt)
