Perp funding rate and history · Perp Funding

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://agent402.tools/api/perp-funding", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "coin": "BTC",
    "limit": 24
  }),
});
const data = await res.json();

curl -X POST \
  "https://agent402.tools/api/perp-funding" \
  -H "Content-Type: application/json" \
  -d '{"coin":"BTC","limit":24}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "coin": "BTC",
  "current": {
    "aprPct": 10.95,
    "hourly": 0.0000125,
    "per8h": 0.0001,
    "premiumPct": 0.0388
  },
  "fetchedAt": "2026-08-22T12:00:00.000Z",
  "history": [
    {
      "fundingRate": 0.0000125,
      "premium": 0.00043,
      "time": "2026-08-22T11:00:00.000Z"
    }
  ],
  "markPx": 77267,
  "source": "hyperliquid",
  "stats": {
    "avgAprPct": 10.95,
    "avgHourly": 0.0000125,
    "avgPer8h": 0.0001,
    "maxHourly": 0.0000125,
    "minHourly": 0.0000125,
    "points": 24,
    "positiveSharePct": 100
  }
}