{"openapi":"3.1.0","info":{"title":"HyperNatt Terminal — Radar, Native Depth + Swap for AI agents","version":"2.9.0","description":"HyperNatt Terminal — agent MCP: liquidation radar, recorded liquidity, wall history and aggressor flow for BTC/ETH, and Li.Fi cross-chain swap. get_liq_radar whitelist BTC ETH SOL BNB XRP HYPE ZEC (omit = BTC). Shows where leveraged liquidations stack (price magnets) — market structure context classic public indicators do not show. get_native_depth walks the filmed book for a BTC or ETH size (REF plus separate aggregated views and recorded history). Read-only, not trade advice. No custody.\n\nFull HyperNatt platform (vault, assistant, ecosystem): https://hypernatt.com — this MCP is one agent-facing brick.\n\nSecurity: no custody, no key access, read-only data, x402 you control, public code — verify yourself (SECURITY.md).\n\n4 tools · v2.9.1 · Streamable HTTP. Call get_agent_manifest first.\n\nNATIVE DEPTH: get_native_depth reports fill, remaining, four separate liquidity views, fixed-price wall changes and observed aggressor flow over 30s/300s. Not a trade signal. No orders.\n\nLIQ RADAR: after manifest, call get_liq_radar (optional symbol). SWAP: use YOUR agent hot wallet as fromAddress. When execution_readiness.can_execute is true, prefer swap_actions_v1. x402 USDC pays API calls only; swaps need gas + token on the source chain.\n\nDaily MCP trial: radar 7 tokens + native BTC/ETH = up to 9 independent trials; then 0.001 USDC per call. Read trial_policy_v2 and free_tier_status_v1 on the same MCP connection for current availability. A zero daily_cap is the separate credit pool, not the intro allowance.\n\nPricing: free get_agent_manifest; get_liq_radar and get_native_depth $0.001/call via x402 (Base + Solana), or eligible credits. Swap free at MCP layer (you sign on-chain).\n\nHumans: Claude → Settings → Integrations → Add connector → MCP URL on the domain above (/mcp/protocol), then ask: \"Call get_agent_manifest, then get_liq_radar — what is the liq context?\"\n\nDocumentation: github.com/DIALLOUBERESEARCH/hypernatt-terminal","contact":{"name":"HyperNatt","email":"contact@hypernatt.com","url":"https://hypernatt.com"},"x-guidance":"HyperNatt Terminal serves a forced-order / liquidation map (BTC ETH SOL BNB XRP HYPE ZEC) from a live Hyperliquid vault operator — market structure classic public indicators do not show. Call get_agent_manifest first (value prop + scenarios + glossary). Paid get_liq_radar returns HTTP 402 with an x402 challenge (USDC $0.001/call on Base eip155:8453 EIP-3009 OR Solana SVM exact via @x402/svm; an EVM signer cannot pay Solana). Read-only, no custody, not trade advice. Vault performance pages are separate from this MCP."},"servers":[{"url":"https://hypernatt.com"}],"x-discovery":{"ownershipProofs":["0x5a78ace5dd133316c8aaf7e156fbfc57e1209cf9"]},"components":{"securitySchemes":{"x402":{"type":"apiKey","in":"header","name":"X-Payment","description":"x402 payment payload (USDC on Base EIP-3009 or Solana SVM exact). Omit to receive a 402 challenge. Solana is not an EVM signature — use @x402/svm."}}},"paths":{"/mcp/protocol":{"post":{"operationId":"mcpProtocol","summary":"MCP Streamable HTTP transport: free initialization and tool catalog","description":"Connect an MCP client here. Send JSON-RPC initialize first, retain the Mcp-Session-Id response header, then use the MCP protocol. Connection and tools/list are public; tools/call remains subject to each tool's pricing and trial policy. This is not a standalone paid REST call. Call get_agent_manifest to discover the six tools and current prices.","security":[],"parameters":[{"name":"Mcp-Session-Id","in":"header","required":false,"schema":{"type":"string"},"description":"Session returned by initialize; required for subsequent messages."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"method":{"type":"string"},"params":{"type":"object","additionalProperties":true}}},"example":{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"discovery-client","version":"1.0.0"}}}}}},"responses":{"200":{"description":"MCP JSON-RPC response, as JSON or server-sent events.","headers":{"Mcp-Session-Id":{"description":"Retain this session identifier after initialize.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/event-stream":{"schema":{"type":"string"}}}},"202":{"description":"MCP notification accepted."},"400":{"description":"Invalid JSON-RPC message or session not initialized."},"403":{"description":"Session does not belong to this client."},"404":{"description":"Unknown or expired MCP session; initialize again."}}}},"/api/m2m/native-depth/quote":{"post":{"operationId":"get_native_depth","summary":"BTC/ETH perpetual market context: four simultaneous recorded liquidity views (REF, M2, M5, AGG4), size coverage, fixed-price wall changes and observed aggressor buy/sell flow over 30s or 300s. Aggregated views see wider price ranges at coarser precision; never add their overlapping volumes. Combine with liquidation radar. Read agent_readout and quality first. No strategy signal, full-book claim or fill guarantee.","description":"Read-only recorded liquidity context for BTC/ETH. HTTP pay-per-call; use MCP for daily trials or credits.","security":[{"x402":[]}],"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["symbol","side","quantity_base"],"properties":{"symbol":{"type":"string","enum":["BTC","ETH"],"description":"BTC or ETH only."},"side":{"type":"string","enum":["buy","sell"]},"quantity_base":{"type":"string","maxLength":96,"pattern":"^-?[0-9]+(?:\\.[0-9]+)?$","description":"Token base units, not USDC."},"lookback_s":{"type":"integer","enum":[30,300],"description":"Fixed-price wall history and observed flow window, 30 or 300 seconds; default 300."}}},"example":{"symbol":"BTC","side":"buy","quantity_base":"0.001"}}}},"responses":{"200":{"description":"Native depth prepared before settlement.","content":{"application/json":{"schema":{"type":"object","required":["ok","product","result"],"properties":{"ok":{"type":"boolean"},"product":{"type":"string"},"result":{"type":"object","additionalProperties":true}},"additionalProperties":true}}}},"400":{"description":"Invalid input or unsupported symbol; no settlement."},"402":{"description":"Payment Required (x402). Pay $0.001 USDC exact on Base (eip155:8453, EIP-3009) OR Solana (SVM exact, @x402/svm — not an EVM signature). Retry with X-Payment."},"413":{"description":"Input exceeds 1MiB; no settlement."},"502":{"description":"Preparation failed; no settlement."},"503":{"description":"Native depth unavailable."}}}},"/api/m2m/liq-radar":{"get":{"summary":"Forced-order map. If cluster_grammar is present, read it before liq_radar. class=noise (<3%) is bait; class=true (~7%+) is the low-leverage stack. BTC ETH SOL BNB XRP HYPE ZEC (omit = BTC). Read-only.","security":[{"x402":[]}],"parameters":[{"name":"symbol","in":"query","required":false,"schema":{"type":"string"},"description":"HL coin. Omit = BTC. Whitelist BTC ETH SOL BNB XRP HYPE ZEC (or *USDT)."}],"responses":{"200":{"description":"Forced-order / liq map JSON. Core fields always present; cluster_grammar and cluster arrays optional.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["ok","product","payload_schema","symbol","liq_radar"],"properties":{"ok":{"type":"boolean"},"product":{"type":"string"},"payload_schema":{"type":"string"},"symbol":{"type":"string"},"binance_symbol":{"type":"string"},"issued_at":{"type":"string"},"provenance":{"type":"object","additionalProperties":true},"cluster_grammar":{"type":"object","additionalProperties":true},"default_symbol":{"type":"string"},"supported_symbols":{"type":"array","items":{"type":"string"}},"qty_unit":{"type":"string"},"liq_radar":{"type":"object","additionalProperties":true}}}}}},"402":{"description":"Payment Required (x402). Pay $0.001 USDC exact on Base (eip155:8453, EIP-3009) OR Solana (SVM exact, @x402/svm — not an EVM signature). Retry with X-Payment."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC"}}},"/api/m2m/swap/quote":{"get":{"summary":"NattSwap cross-chain swap quote via Li.Fi (any pair, any chain) — route + fees + execution instructions for trading agents","security":[{"x402":[]}],"parameters":[{"name":"fromChain","in":"query","required":true,"schema":{"type":"string"},"description":"Source chain id (e.g. 8453 for Base)"},{"name":"toChain","in":"query","required":true,"schema":{"type":"string"},"description":"Destination chain id"},{"name":"fromToken","in":"query","required":true,"schema":{"type":"string"}},{"name":"toToken","in":"query","required":true,"schema":{"type":"string"}},{"name":"fromAmount","in":"query","required":true,"schema":{"type":"string"},"description":"Amount in atomic units"},{"name":"fromAddress","in":"query","required":true,"schema":{"type":"string"},"description":"Agent hot wallet that will sign the swap"},{"name":"toAddress","in":"query","required":true,"schema":{"type":"string"}},{"name":"slippage","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Swap quote JSON. success is always present on HTTP 200; quote and execution_readiness are optional objects.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"required":["success"],"properties":{"success":{"type":"boolean"},"quote":{"type":"object","additionalProperties":true},"execution_readiness":{"type":"object","additionalProperties":true},"instructions":{"type":"object","additionalProperties":true},"next_step":{"type":"object","additionalProperties":true},"wallet_onboarding_v1":{"type":"object","additionalProperties":true},"error":{"type":"string"}}}}}},"402":{"description":"Payment Required (x402). Pay $0.001 USDC exact on Base (eip155:8453, EIP-3009) OR Solana (SVM exact, @x402/svm — not an EVM signature). Retry with X-Payment."}},"x-payment-info":{"protocols":["x402"],"price":{"mode":"fixed","currency":"USD","amount":"0.001"},"network":"eip155:8453","networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"asset":"USDC"}}},"/api/m2m/agent/manifest":{"get":{"summary":"Free catalog of all 4 terminal tools, intent-based journeys, arguments, prices and glossary. Call first.","security":[],"responses":{"200":{"description":"OK"}}}}}}