Perp Gap API

Use when an agent needs to backtest or chart how a stock perp's premium/discount and funding evolved, including weekends and holidays when the stock is shut. One ticker: trade.xyz perp mark/oracle vs stock and xStock, basis, funding, OI, Aster/Lighter/OKX cross-venue gaps; 30-minute snapshots plus ~60d backfill, up to 90 days per call. Bad params return 400/404 before any charge. Errors: 400, 402,

Open endpoint ↗

Price per call: $0.02
Chain: Base
Method: GET
Paid calls · 30 days: 5

Call it from code

This API is run by its own provider and paid directly through x402. We list it so you can find it; we don't route or hold the payment.

import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";

const client = new x402Client();
registerExactEvmScheme(client, { signer: agentAccount });

const pay = wrapFetchWithPayment(fetch, client);
const res = await pay("https://perp-gap-api.perpgap.workers.dev/history", { method: "GET" });
console.log(await res.json());

https://perp-gap-api.perpgap.workers.dev/history