Perp premium and predicted funding
POST /api/perp-basisBasis 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.
Input
| Field | Type | Description |
|---|---|---|
coin * | string | Perp 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"
}),
});
Related tools
Crypto order book
GET /api/crypto-orderbookL2 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
GET /api/stablecoin-pegLive $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)
POST /api/wallet-balanceLook up the native coin balance (ETH/MATIC) plus every ERC-20 holding for a wallet address on Ethereum, Base, Polygon, A…
try in playground →