API Documentation
Quickstart for agents
MCP endpoint: https://tapeperp.com/mcp (streamable HTTP). initialize, tools/list, and basic MCP read tools/call are free. No API key and no payment.
llms.txt URL
https://tapeperp.com/llms.txtClaude Desktop, add to claude_desktop_config.json
{
"mcpServers": {
"tape": {
"url": "https://tapeperp.com/mcp"
}
}
}Cursor, add to mcp.json
{
"mcpServers": {
"tape": {
"url": "https://tapeperp.com/mcp"
}
}
}Other clients, add the same mcp.json
{
"mcpServers": {
"tape": {
"url": "https://tapeperp.com/mcp"
}
}
}Generic MCP client: POST JSON-RPC to https://tapeperp.com/mcp. Call initialize, then tools/list, then tools/call. A free tool returns the result. A priced tool returns HTTP 402 with the USDC price and how to pay (PAYMENT-SIGNATURE or X-PAYMENT header).
Claude Code
claude mcp add --transport http tape https://tapeperp.com/mcpSignals and whale prints are free on REST (/api/signals and /api/whales) but paid via MCP (tape_market_signals $0.03, tape_whale_prints $0.01). Wallet reads are $0.01. Grok voice is $0.10.
Free REST
curl -s "https://tapeperp.com/api/markets?limit=3"curl -s "https://tapeperp.com/api/pulse"curl -s "https://tapeperp.com/api/leaderboard?limit=5&format=concise"curl -s "https://tapeperp.com/api/signals?limit=5"OpenAPI 3.1: https://tapeperp.com/openapi.json
Human docs: https://tapeperp.com/docs
Agent card: https://tapeperp.com/.well-known/agent-card.json
Plugin manifest: https://tapeperp.com/.well-known/ai-plugin.json
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)
Basic MCP read tools are $0 per call. Priced tools settle in USDC on Base, one call at a time. Manifest: /.well-known/x402.json.
- tape_analytics: $0 USDC on Base. Billing period: per call. How to cancel: No charge and no subscription. Nothing to cancel. Included: Analytics bundle (consensus, pulse, funding extremes, alert queue). Same fields as the public REST analytics endpoint.. Free.
- tape_live_alerts: $0 USDC on Base. Billing period: per call. How to cancel: No charge and no subscription. Nothing to cancel. Included: Alert queue. Same fields as the public REST alert feed.. Free.
- tape_market_pulse: $0 USDC on Base. Billing period: per call. How to cancel: No charge and no subscription. Nothing to cancel. Included: Market pulse. Same fields as the public REST pulse endpoint.. Free.
- tape_markets_radar: $0 USDC on Base. Billing period: per call. How to cancel: No charge and no subscription. Nothing to cancel. Included: Markets radar. Same fields as the public REST markets endpoint.. Free.
- tape_leaderboard: $0 USDC on Base. Billing period: per call. How to cancel: No charge and no subscription. Nothing to cancel. Included: Sampled leaderboard. Same fields as the public REST leaderboard endpoint. This is not Hyperliquid's official leaderboard.. Free.
- tape_treasury_curve: $0 USDC on Base. Billing period: per call. How to cancel: No charge and no subscription. Nothing to cancel. Included: US Treasury curve. Same fields as the public REST curve endpoint.. Free.
- tape_liquidations: $0 USDC on Base. Billing period: per call. How to cancel: No charge and no subscription. Nothing to cancel. Included: Liquidation sample. Same fields as the public REST liquidations endpoint.. Free.
- tape_liquidation_heatmap: $0 USDC on Base. Billing period: per call. How to cancel: No charge and no subscription. Nothing to cancel. Included: Liquidation heatmap for BTC, ETH, SOL, or HYPE. Same fields as the public REST heatmap endpoint.. Free.
- tape_wallet_analysis: $0.01 USDC on Base. Billing period: per call. How to cancel: Stop calling. There is no subscription for this tool. Included: One Gemini wallet risk report. An active Pro pass ($9 for 7 days or $39 for 30 days in USDC, or $39 per month by card) or Desk pass ($299 per month by card) includes Gemini wallet reads for that term. Cancel a card plan from the account page before the next Stripe renewal. A USDC pass ends when its term ends and does not renew..
- tape_wallet_analysis voice=grok: $0.10 USDC on Base. Billing period: per call. How to cancel: Stop calling. There is no subscription for this voice. Included: One wallet risk report in the Grok voice. Not included with Pro or Desk..
- tape_market_signals: $0.03 USDC on Base. Billing period: per call. How to cancel: Stop calling. There is no subscription for this tool. Included: One market-signals scan. Signals are mechanical data screens, not recommendations to buy or sell. Do not trade on them alone..
- tape_whale_prints: $0.01 USDC on Base. Billing period: per call. How to cancel: Stop calling. There is no subscription for this tool. Included: Whale prints for the requested window..
Pro is $9 for 7 days or $39 for 30 days in USDC on Base, or $39 per month by card. Desk is $299 per month by card. Cancel a card subscription from your account page before the next Stripe renewal. A USDC pass ends when its term ends and does not renew.
Custom / SLA
Historical depth beyond 90 days, custom feeds, or an SLA: support@tapeperp.com.
For educational purposes only. Not trading advice. Not investment advice. Tapeperp is independent and not affiliated with, endorsed by, or sponsored by Hyperliquid. Independent. Not affiliated with Hyperliquid Labs or the Hyperliquid Foundation. Gemini wallet reads are $0.01 per call. Market signals are $0.03 per call. Whale prints are $0.01 per call. Grok voice is $0.10 per call. Basic MCP read tools (analytics, alerts, pulse, markets radar, leaderboard, Treasury curve, liquidations, liquidation heatmap) are $0 per call. Per-call tools are billed each call and do not renew. Cancel a per-call tool by stopping the call. Pro is $9 for 7 days or $39 for 30 days in USDC, or $39 per month by card, and includes Gemini wallet reads for that term. Desk is $299 per month by card. Card plans renew automatically each month until canceled. Cancel anytime from the account page before the next renewal. USDC passes do not renew. A priced call includes the single tool result named above. Data is provided as-is with no uptime or accuracy guarantee. Data is informational only, provided as-is from public Hyperliquid endpoints and Tape's own computation. Not financial advice. Last updated 2026-11-14 06:22:38 UTC