API / Data

API Documentation

Last updated 2026-08-29 · tapeperp.com

Key-based REST access for the Desk (API/Data) tier — plus the free anonymous endpoints and the pay-per-call x402 surface. Auth: X-API-Key: tk_live_… header, Authorization: Bearer, or ?api_key=. Machine-readable spec: /openapi.json · MCP server: https://tapeperp.com/mcp.

Rate limits

Endpoints

GET /api/markets

Every Hyperliquid perp: mark, funding (hourly + APR), open interest, 24h volume, premium vs oracle. Free.

curl -s https://tapeperp.com/api/markets | jq '.markets[:3]'

GET /api/whales

$100k+ fills from the top-15 wallets by account value over ~36h, with net directional flow. Free (cached 60s).

curl -s https://tapeperp.com/api/whales | jq '.prints[:3]'

GET /api/signals

Rules-based setups (carry, premium, momentum) + market consensus. Free; also delivered to the private Telegram channel for subscribers.

curl -s https://tapeperp.com/api/signals | jq

GET /api/liquidations · Desk key required

Rolling-24h liquidation events with 1h/4h/24h totals and long/short split. coin, since, min_notional, side, limit params.

curl -s -H "X-API-Key: tk_live_…" "https://tapeperp.com/api/liquidations?coin=BTC&min_notional=25000" | jq '.stats'

GET /api/liquidations/heatmap · Desk key required

Observed liquidation-level buckets for one market (coin, tf = 12h/24h/3d/7d), with share-of-OI coverage stated per response.

curl -s -H "X-API-Key: tk_live_…" "https://tapeperp.com/api/liquidations/heatmap?coin=BTC&tf=24h" | jq '.columns[-1]'

GET /api/export/{markets|signals|whales} · Desk key required

Daily 14:00 UTC snapshot as JSON. ?date=YYYY-MM-DD (default: latest). Retained 90 days.

curl -s -H "X-API-Key: tk_live_…" "https://tapeperp.com/api/export/markets?date=2026-08-28" -o markets-2026-08-28.json

Pay-per-call (x402)

No key, no subscription — pay $0.002–$0.05 in USDC (Base) per call via the x402 protocol on /api/paid/* and MCP tools/call. Manifest: /.well-known/x402.

Custom / SLA

Historical depth beyond 90 days, custom feeds, or an SLA: support@tapeperp.com.

Data is informational only, provided as-is from public Hyperliquid endpoints and Tape's own computation. Not financial advice.