API / Data

API Documentation

Last updated 2026-10-14

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

Anonymous — 60 req/min per IP on free /api/*
Pro key — 300 req/min
Desk key — 1,200 req/min · liquidations + exports access

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; the same feed powers the public Telegram channel @tapeperpanalytics. Pro subscribers also get the private desk feed via @tapeperp1_alerts_bot.

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.15 in USDC (Base) per call via the x402 protocol on /api/paid/* and MCP tools/call. Manifest: /.well-known/x402.json. Agent catalogs: /.well-known/ai-catalog.json · MCP · llms.txt.

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.