{"openapi":"3.1.0","info":{"title":"Tape — Hyperliquid Analytics API","version":"1.0.0","description":"Free read-only Hyperliquid perps analytics (rate-limited), plus x402 USDC pay-per-call endpoints and an MCP server at /mcp. Informational only — not financial advice.","contact":{"email":"support@tapeperp.com"}},"servers":[{"url":"https://tapeperp.com"}],"paths":{"/api/signals":{"get":{"summary":"Rules-based long/short setups + market consensus","responses":{"200":{"description":"Signals + consensus"}}}},"/api/pulse":{"get":{"summary":"Market pulse: BTC/ETH marks, total OI/volume, sentiment, breadth","responses":{"200":{"description":"Pulse"}}}},"/api/whales":{"get":{"summary":"Largest recent fills from top Hyperliquid wallets w/ directional flow","responses":{"200":{"description":"Whale prints"}}}},"/api/markets":{"get":{"summary":"Every Hyperliquid perp ranked by funding, OI, volume","responses":{"200":{"description":"Markets radar"}}}},"/api/leaderboard":{"get":{"summary":"Top traders by PnL/ROI/volume across time windows","responses":{"200":{"description":"Leaderboard"}}}},"/api/btc-ta":{"get":{"summary":"Mechanical BTC technical levels (SMA/EMA/RSI/ATR, S/R w/ touch counts, daily pivots + Fibonacci retracements, breakout triggers)","responses":{"200":{"description":"TA"}}}},"/api/rsi-scan":{"get":{"summary":"Wilder RSI(14) 1h + 4h across the top 24 Hyperliquid markets by volume, 5-min cache","responses":{"200":{"description":"RSI scan"}}}},"/api/liquidations":{"get":{"summary":"Live Hyperliquid liquidation feed (rolling 24h) with 1h/4h/24h totals and long/short split. Requires an API key.","description":"Hyperliquid publishes no global liquidation stream; events are recovered from the fills of dynamically-discovered liquidation counterparties, so this is a representative sample, not an exhaustive record. Side reported is the side that was LIQUIDATED (a liquidated long is a forced sell). Terms: https://tapeperp.com/disclosures","security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"parameters":[{"name":"coin","in":"query","schema":{"type":"string"},"description":"Market symbol, e.g. BTC"},{"name":"since","in":"query","schema":{"type":"string"},"description":"Epoch ms, epoch s, or ISO-8601; clamped to the 24h retention window"},{"name":"min_notional","in":"query","schema":{"type":"number","default":1000},"description":"Minimum liquidation notional in USD"},{"name":"side","in":"query","schema":{"type":"string","enum":["long","short"]},"description":"Filter by the side that was liquidated"},{"name":"limit","in":"query","schema":{"type":"integer","default":200,"maximum":1000}}],"responses":{"200":{"description":"Liquidation events, rolling stats and coverage note"},"401":{"description":"Missing or invalid API key"},"404":{"description":"Feature not enabled on this deployment"},"503":{"description":"No API keys provisioned"}}}},"/api/liquidations/heatmap":{"get":{"summary":"Observed liquidation-level buckets for one market. Requires an API key.","description":"Buckets are computed server-side from real per-position liquidation prices in Hyperliquid clearinghouse state across a sample of the largest wallets, weighted by position notional. Positions, wallets and the weighting method are never returned. Every response states the share of open interest observed. Terms: https://tapeperp.com/disclosures","security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"parameters":[{"name":"coin","in":"query","schema":{"type":"string","default":"BTC"}},{"name":"tf","in":"query","schema":{"type":"string","enum":["12h","24h","3d","7d"],"default":"24h"}}],"responses":{"200":{"description":"Bucket grid, realized-liquidation overlay, coverage and methodology"},"401":{"description":"Missing or invalid API key"},"404":{"description":"Feature not enabled on this deployment"},"503":{"description":"Snapshot history not yet available for this market"}}}},"/api/paid/signals":{"get":{"summary":"PAID (x402, $0.03 USDC on Base): live signals + consensus","responses":{"200":{"description":"Signals (after payment)"},"402":{"description":"x402 payment challenge"}}}},"/api/paid/wallet-analysis":{"get":{"summary":"PAID (x402, $0.05 USDC on Base): AI risk read of any Hyperliquid wallet","parameters":[{"name":"address","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$"}}],"responses":{"200":{"description":"Analysis (after payment)"},"402":{"description":"x402 payment challenge"}}}},"/api/paid/whale-prints":{"get":{"summary":"PAID (x402, $0.01 USDC on Base): whale fills + net flow snapshot","responses":{"200":{"description":"Whale prints (after payment)"},"402":{"description":"x402 payment challenge"}}}},"/api/paid/pulse":{"get":{"summary":"PAID (x402, $0.002 USDC on Base): market pulse snapshot","responses":{"200":{"description":"Market pulse (after payment)"},"402":{"description":"x402 payment challenge"}}}}},"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"api_key"}}},"externalDocs":{"url":"https://tapeperp.com/llms.txt","description":"Agent-oriented site summary; MCP server at https://tapeperp.com/mcp; x402 manifest at https://tapeperp.com/api/x402"}}