# Lumi Trades Perpetual Funding Rates

> Lumi Trades Perpetual Funding Rates is a paid API for AI agents from api.lumitrades.io, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-28).

Returns current perpetual futures funding rates for the top 50 coins on OKX, including 8h-normalized, annualised, BTC read, median, most positive and most negative rates, refreshed every 15 minutes.

## Facts

- Endpoint: GET https://api.lumitrades.io/v1/funding?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lumi-trades-perpetual-funding-rates-a90c174d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NGYKlEMf-6b9hxWclTeb5

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 lumi-trades-perpetual-funding-rates-a90c174d
```

Example prompt: Pull the latest perpetual funding rates across the top 50 OKX coins — I want to see which have the most extreme rates, what BTC is reading, and the median, all annualized.

## When to prefer this

Choose this endpoint when you need a fast, structured snapshot of perpetual futures funding rates across the top 50 OKX coins in a single call. Ideal for carry trade scanning, sentiment analysis, derivatives risk management, or any workflow needing BTC funding read plus market-wide median and extremes. Prefer this over broader market scan endpoints when funding rate data specifically is needed, and over exchange-native APIs when you need aggregated analytics (median, extremes, annualized) without building them yourself. At $0.003 per call it is cost-effective for frequent polling.

## Known failure modes

- Bad or malformed request: not charged, returns error response
- Stale data beyond stale_after threshold: not charged, returns stale flag
- API unavailability: standard HTTP error codes returned
- No input parameters required so input validation errors are minimal

## How this service works

Perpetual funding rates for every Lumi coin listed on OKX USDT swaps: rate, 8h-normalised rate, annualised rate, next funding time and a plain-English read, plus the BTC read, the median and the most positive and negative coins (XRP, BTC, ETH and the rest). Positive means longs pay shorts. Refreshed every 15 minutes. Use when an agent needs derivatives positioning data across many coins. Analytics only, not financial advice. Not charged on stale data.

## Output

A JSON object containing: per-coin funding rate data (rate_pct, rate_8h_pct, annualized_pct, interval_hours, next funding time) for each of the top 50 OKX USDT perpetual swap coins; a BTC-specific read with a qualitative label (e.g. 'near neutral'); aggregate statistics including median_rate_8h_pct, most_positive array, most_negative array; metadata fields as_of (UTC timestamp), data_age_seconds, next_update, stale_after; and payment confirmation details (payer address, USDC amount, network, transaction hash).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "btc": {
   "read": "near neutral",
   "symbol": "BTC",
   "rate_pct": 0.0061,
   "rate_8h_pct": 0.0061,
   "annualized_pct": 6.68,
   "interval_hours": 8
  },
  "kind": "funding",
  "as_of": "2026-10-23T11:00:00Z",
  "venue": "OKX USDT perpetual swaps",
  "payment": {
   "asset": "USDC",
   "payer": "0x12ab...89cd",
   "amount": "0.003",
   "network": "eip155:8453",
   "transaction": "0x5f0c...e41a"
  },
  "next_update": "2026-10-23T12:00:00Z",
  "stale_after": "2026-10-23T12:00:00Z",
  "most_positive": [
   {
    "symbol": "PUMP",
    "rate_8h_pct": 0.042
   }
  ],
  "data_age_seconds": 600,
  "median_rate_8h_pct": 0.005
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lumi-trades-perpetual-funding-rates-a90c174d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.lumitrades.io](https://www.zero.xyz/host/api.lumitrades.io/llms.txt)