Agent402 / tools / perp-basis

Perp premium and predicted funding

$0.003 per call · USDC via x402 · POST /api/perp-basis

Basis view for one perpetual: mark, oracle and mid price, mark-vs-oracle premium in percent and bps, the impact premium the venue uses for funding, the current hourly funding, and the predicted next funding rate per venue (rate, interval, next funding time, 8h-normalized and annualized) as published by Hyperliquid's predictedFundings feed. No key.

TRY IN PLAYGROUND →

Input

FieldTypeDescription
coin *stringPerp ticker, e.g. BTC, ETH, SOL.

Example output

{
  "source": "hyperliquid",
  "coin": "BTC",
  "markPx": 77267,
  "oraclePx": 77236,
  "midPx": 77266.5,
  "markOraclePremiumPct": 0.0401,
  "markOraclePremiumBps": 4.01,
  "impactPremiumPct": 0.0388,
  "funding": {
    "hourly": 0.0000125,
    "per8h": 0.0001,
    "aprPct": 10.95
  },
  "predictedFunding": [
    {
      "venue": "HlPerp",
      "fundingRate": 0.0000125,
      "fundingIntervalHours": 1,
      "nextFundingTime": "2026-08-22T13:00:00.000Z",
      "per8h": 0.0001,
      "aprPct": 10.95
    }
  ],
  "fetchedAt": "2026-08-22T12:00:00.000Z"
}

Try it - see the 402 challenge (free)

curl -i -X POST https://agent402.tools/api/perp-basis \
  -H "Content-Type: application/json" \
  -d '{"coin":"BTC"}'

The response is HTTP 402 Payment Required with exact payment requirements. Any x402 v2 client pays automatically and retries:

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/perp-basis", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "coin": "BTC"
  }),
});
Wallet-only. This tool reaches the network/browser/storage, so it is paid in USDC via x402 (no proof-of-work tier).

Related tools

Crypto order book

$0.003 · GET /api/crypto-orderbook

L2 order-book snapshot for a spot pair: best bid/ask, mid price, spread (absolute + %), and the top N aggregated price l…

try in playground →

Stablecoin peg monitor

$0.003 · GET /api/stablecoin-peg

Live $1-peg deviation for the top USD stablecoins (USDT, USDC, USDS, DAI, USDe, PYUSD, USDD, TUSD, FDUSD by default, or …

try in playground →

Wallet balance (native + ERC-20)

$0.002 · POST /api/wallet-balance

Look up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon, A…

try in playground →