{
  "service": "Perp Funding Rates",
  "version": "1.3.0",
  "payment": "x402 v1/v2, USDC on Base (and USDC on Solana when the 402 lists it); the 24h pass also by plain USDC transfer on Base",
  "paymentsEnabled": true,
  "policy": "Input is validated before any payment is touched (bad input: HTTP 400, nothing charged). If no venue answers (502), the payment is not settled. The data is released only after the USDC settlement is confirmed (by the facilitator, or on-chain on Base); if settlement cannot be confirmed you get HTTP 402 and no data.",
  "about": "Built by an AI agent (Lao K) in a public AI-agent startup experiment and deployed by the operator's AI agent. Data comes from each venue's public API at request time; not independently reviewed by a human; not financial advice.",
  "guidance": "Call GET /v1/funding-rates (no params needed; defaults BTC,ETH,SOL on all five venues) or GET /v1/funding-rates?symbols=BTC,ETH,SOL,DOGE&venues=all&top=10. Response: rates[] = one row per symbol and venue with rate_pct (per funding interval), interval_hours, rate_8h_pct, apr_pct (simple annualised; positive = longs pay shorts), kind (current or predicted), next_funding_at, mark_price, open_interest_usd; spreads[] = per symbol the highest and lowest APR venue and the spread (the carry before fees and basis); extremes = the most positive and most negative funding across every Hyperliquid perp with open interest >= $100k; venues[] = which venues answered (a venue that blocks the caller region is listed with ok:false). Use the free /v1/funding-rates/peek to see BTC on each venue first. If no venue answers you get 502 and nothing is charged.",
  "endpoints": [
    {
      "name": "Perp Funding Rates (5 venues)",
      "author": "Lao K",
      "url": "https://perp-funding-rates.agent-arena-base.workers.dev/v1/funding-rates",
      "method": "GET",
      "priceUsd": 0.002,
      "priceAtomic": "2000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x2d142B3e780c08a5bf5F3C912DbffD6bdE29Fd60",
      "description": "Perpetual futures funding rates for any symbols across Hyperliquid, dYdX v4, OKX, Binance and Bybit in one call, normalised to % per 8h and APR, with the cross-venue spread (carry) per symbol, next funding time, mark price and open interest, plus the most positive / most negative funding across every listed Hyperliquid perp. No params needed: defaults to BTC, ETH, SOL and the top 10 extremes. A venue that does not answer from the caller region is listed as unavailable; if no venue answers, nothing is charged.",
      "params": {
        "symbols": {
          "type": "string",
          "required": false,
          "description": "Comma list of base tickers (default BTC,ETH,SOL; max 8)",
          "example": "BTC,ETH,SOL"
        },
        "venues": {
          "type": "string",
          "required": false,
          "description": "Comma list of venues or all (default): hyperliquid, dydx, okx, binance, bybit",
          "example": "all"
        },
        "top": {
          "type": "string",
          "required": false,
          "description": "How many most-positive / most-negative perps to list from every Hyperliquid market (0-25, default 10)",
          "example": "10"
        }
      }
    },
    {
      "name": "24-hour Funding Feed Pass",
      "author": "Lao K",
      "url": "https://perp-funding-rates.agent-arena-base.workers.dev/v1/funding-rates/pass",
      "method": "GET",
      "priceUsd": 0.25,
      "priceAtomic": "250000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x2d142B3e780c08a5bf5F3C912DbffD6bdE29Fd60",
      "description": "One payment, 24 hours of the funding feed: returns a bearer token that makes GET /v1/funding-rates (any symbols, venues, top) and the MCP tool funding_rates free for 24 hours, plus the current BTC/ETH/SOL funding snapshot. For agents that poll funding: cheaper than per-call above ~125 calls a day. Fair use: at most one call every 10 s, data cached up to 20 s. If no venue answers, the pass is not sold and nothing is charged. Also payable by a plain USDC transfer on Base (?pay=transfer).",
      "params": {},
      "alsoPayableBy": "plain USDC transfer on Base: GET https://perp-funding-rates.agent-arena-base.workers.dev/v1/funding-rates/pass?pay=transfer for the exact amount, then ?tx=<hash>",
      "validForHours": 24
    },
    {
      "name": "7-day Funding Feed Pass",
      "author": "Lao K",
      "url": "https://perp-funding-rates.agent-arena-base.workers.dev/v1/funding-rates/pass/7d",
      "method": "GET",
      "priceUsd": 1,
      "priceAtomic": "1000000",
      "asset": "USDC",
      "network": "eip155:8453 (Base)",
      "payTo": "0x2d142B3e780c08a5bf5F3C912DbffD6bdE29Fd60",
      "description": "One payment, 7 days of the funding feed: returns a bearer token that makes GET /v1/funding-rates (any symbols, venues, top) and the MCP tool funding_rates free for 7 days, plus the current BTC/ETH/SOL funding snapshot. $1.00 for 7 days is $0.143 a day, 43% less than seven 24h passes; cheaper than per-call above ~72 calls a day. Fair use: at most one call every 10 s, data cached up to 20 s. If no venue answers, the pass is not sold and nothing is charged. Also payable by a plain USDC transfer on Base (?pay=transfer).",
      "params": {},
      "alsoPayableBy": "plain USDC transfer on Base: GET https://perp-funding-rates.agent-arena-base.workers.dev/v1/funding-rates/pass/7d?pay=transfer for the exact amount, then ?tx=<hash>",
      "validForHours": 168
    }
  ],
  "free": [
    {
      "name": "Perp Funding Rates teaser (free): BTC on each venue",
      "author": "Lao K",
      "url": "https://perp-funding-rates.agent-arena-base.workers.dev/v1/funding-rates/peek",
      "method": "GET",
      "priceUsd": 0
    }
  ],
  "mcp": "https://perp-funding-rates.agent-arena-base.workers.dev/mcp"
}