HyperNatt Terminal gives AI agents paid market-liquidity context and cross-chain swap routing over MCP.
Call get_agent_manifest free to discover tools, pricing, trial status, and task journeys.
Use get_liq_radar for liquidation clusters, OI/L-S context, and observed liquidations across BTC, ETH, SOL, BNB, XRP, HYPE, and ZEC.
Use get_native_depth for BTC/ETH recorded liquidity views, wall history, size coverage, and aggressor flow over 30s or 300s windows.
Use swap_via_nattswap to request a Li.Fi cross-chain route and execution steps; the agent signs its own transaction.
Paid radar/depth calls cost $0.001 USDC via x402 Base or Solana, with eligible daily trials and optional credits.
Liquidation radar (7 tokens) and recorded liquidity, wall history and aggressor flow (BTC and ETH) for AI agents + Li.Fi cross-chain swap. Pay-per-call via x402.
Understand liquidation terrain, then ask whether a BTC or ETH size is feasible on the filmed book (REF plus separate aggregated views and recorded history). For cross-chain swaps, request a Li.Fi route that your agent signs. Your agent chooses the task and controls execution.
Built by one person. Code is public. Backend is private. No custody. Not trade advice.
Full HyperNatt platform (vault, assistant): https://hypernatt.com — this repo is one agent-facing brick.
Public runtime and docs are synced from the monorepo. Repository: https://github.com/DIALLOUBE-RESEARCH/hypernatt-terminal.
No install for the hosted MCP. In Claude → Settings → Connectors → Add custom connector:
Field | Value |
Name | HyperNatt Terminal |
URL |
|
Then ask:
Call get_agent_manifest and choose journeys_v1 for my task. Use get_liq_radar for liquidation terrain. For an ETH buy of 0.1 ETH, walk filmed recorded liquidity context with get_native_depth. Use swap_via_nattswap for a Li.Fi route.
More clients (Cursor / Cline / Codex / Windsurf): docs/integrations.md.
Related MCP server: crypto-quant-signal-mcp
Start with get_agent_manifest (free), then choose the tools your task needs through journeys_v1:
Understand the market: get_liq_radar provides liquidation clusters, open-interest context and observed liquidations (BTC ETH SOL BNB XRP HYPE ZEC).
Walk filmed depth: get_native_depth reports fill, remaining and four simultaneous views, fixed-price wall history and observed aggressor flow.
Find a cross-chain swap route: swap_via_nattswap requests a Li.Fi route for your source/destination chains and tokens. Your agent signs the transaction.
Radar covers seven tokens. Native depth is BTC and ETH only. Cross-chain swaps use the chains and tokens supported by Li.Fi, subject to route availability. Neither paid tool requires the other.
get_liq_radarA map of forced orders: where leveraged positions will be liquidated if price reaches them (clusters, OI build-up, observed liquidations).
This is market structure context, not a trade signal. It shows terrain so a sovereign trading agent can judge timing, sizing, and risk with more awareness than agents that only read RSI/MACD-style public feeds.
Your agent still decides. We show the terrain.
Ignore clusters with class=noise (distance < 3%). If cluster_grammar is present, wait only near class=true (low-leverage stack ~7%+). Then watch real_liquidations print — without assuming a guaranteed reversal. class=true is terrain, not an entry signal.
Cluster ~5% away vs ~0.5% away is a different risk parameter. Distance informs sizing or patience — it is not a prediction that the level will be hit.
If price swept a zone and real liquidations spiked, compare with OI change. A large OI drop can mean forced flow is partly exhausted — still context, not an auto entry.
Term | Meaning |
Cluster | Zone where leveraged positions may liquidate if mark reaches it. Not a TP. |
| If present: read this first. |
Nearest vs largest |
|
Real vs estimated |
|
| Directional density bias from OI / L-S / funding. Not a hit probability. |
The radar glossary and scenarios also ship on get_agent_manifest → agent_interpretation_rules_v1. Use journeys_v1 for native-depth and swap workflows.
get_native_depth“Where is liquidity, is it changing, and what flow is meeting it?” Supply symbol (BTC or ETH), side, quantity_base, and lookback_s (30 or 300). Read agent_readout, then liquidity_map for four simultaneous price granularities, size coverage and changes at fixed wall prices; trade_flow shows observed aggressor buying/selling. Check history coverage and freshness. Never sum overlapping views. These facts complement radar terrain without disclosing a strategy or guaranteeing a fill. Guide.
swap_via_nattswap“What route is available to swap my token on one chain for a token on another?” Supply the source/destination chains and tokens, amount and wallet addresses. Review the Li.Fi route, costs and execution readiness; your agent signs with its own wallet. This is a separate workflow from native BTC/ETH depth. Swap inputs and execution steps.
Daily MCP trial: one free call per paid tool and eligible token each UTC day: radar x 7 tokens plus 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.
Tool | Price |
| Free — call first |
| $0.001 x402 (Base EIP-3009 or Solana SVM exact) |
| Free at MCP (you sign; gas + Li.Fi fee on-chain) |
| $0.001 x402, or eligible credits |
Solana pay: rail is live (SVM exact). Do not reuse an EVM/Base x402 client. Use @x402/svm. A Base HTTP 200 is not a Solana payment. See docs/x402-pay.md.
Whitelist get_liq_radar: BTC ETH SOL BNB XRP HYPE ZEC (omit symbol = BTC). get_native_depth: BTC ETH only.
We do not claim | What we do show |
Generic Coinglass wrapper | Operator-shaped forced-order map for agents |
Predictive Fuel Score / sweep classifier | Distance, size, OI, real liqs — labeled |
Custody of keys or funds | Agent signs own txs |
Trade advice / guaranteed edge | Read-only JSON context |
More than 5 MCP tools | Exactly 5 · v2.10.0 |
Vault / | Separate HyperNatt vault product |
Independent security audit | Public code + SECURITY.md |
curl -s https://hypernatt.com/api/m2m/agent/manifest
curl -i https://hypernatt.com/api/m2m/liq-radarStep | Link |
Quickstart | |
x402 Base vs Solana | |
Integrations (5 clients + AgentKit) | |
HL terrain example (read-only) | |
Honest interpret example | |
CDP Bazaar checklist | |
Examples | |
Security | |
Buyer skill (use the MCP) | |
Tests | test/ — |
Changelog |
MCP: https://hypernatt.com/mcp/protocol
You can start with the daily MCP trials without setting up payments. For paid use, one optional wallet provider is Coinbase Agentic Wallet MCP. Follow its current setup and funding instructions; available funding methods depend on the provider and your account:
npx @coinbase/payments-mcpDocs: Agentic Wallet MCP. Then connect HyperNatt Terminal (https://hypernatt.com/mcp/protocol). The two paid tools — get_liq_radar and get_native_depth — each cost 0.001 USDC per call, or one eligible credit, after an available daily trial. An x402-capable client can handle the payment requirements and retry under your payment authorization rules. In MCP, inspect the tool response for payment requirements; do not rely only on an HTTP 402 status. See payment and credits.
Optional: eligible swap-earned credits or an Agent Pass at $5 for 15,000 credits valid for 30 days, shared across the paid tools. Call get_agent_manifest with {"detail":"full"} to read the current pass_program and quota_program; they are not included in the default compact response. Manifest and MCP swap requests remain free; on-chain swap costs are separate.
MIT — see LICENSE.
Start here (free): 5 tools, prices, daily per-tool/per-token trial status and intent-based journeys. Choose liquidation radar, native BTC/ETH depth, Li.Fi swap or the L2 archive catalog. Compact includes arguments; detail=full adds quota/pass/onboarding.
Inputs: detail, locale.
Free, read-only. USE WHEN an agent needs historical raw Hyperliquid L2 order-book data for BTC or ETH: returns the catalog of the sealed archive (coverage, files, SHA-256, free 24h sample under CC BY 4.0, offers, x402 purchase endpoints, terms). Same JSON as https://hypernatt.com/api/datasets/catalog. NOT WHEN the agent needs live market data (use get_liq_radar or get_native_depth). No arguments; no payment; nothing is bought by calling it.
Inputs: no named parameters.
Returns the liquidation map of one coin (BTC, ETH, SOL, BNB, XRP, HYPE or ZEC; default BTC). If cluster_grammar is present, read it first: class=noise (distance <3%) is high-leverage bait to ignore; class=true (~7%+) is the low-leverage stack. The liq_radar block (hypernatt_liq_radar_v2) holds modeled liquidation clusters (zones where leveraged positions may liquidate), observed real_liquidations, open interest (OI) and long/short (L/S) context, and magnet.score (directional density bias from OI, L/S and funding; not a hit probability). USE WHEN an agent needs liquidation terrain for timing or sizing. NOT WHEN it needs order-book depth for a BTC/ETH size (use get_native_depth) or a swap (use swap_via_nattswap). Read-only; terrain, not a trade signal. Price: 0.001 USDC/call via x402 (Base or Solana) or eligible credits.
Inputs: symbol, x_payment, agent_wallet.
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. Price: 0.001 USDC/call via existing x402 Base/Solana or eligible credits.
Inputs: side (required), symbol (required), quantity_base (required), x_payment, +2 more.
Cross-chain token swap powered by Li.Fi across 70+ chains incl. Hyperliquid. USE WHEN: bridge, fund gas, treasury routing, or rebalance. RETURNS: Li.Fi route + execution_readiness + swap_actions_v1. Prefer signing swap_actions_v1 in order. MCP free; on-chain swap costs gas + HyperNatt 0.25% integrator fee (Li.Fi may add its own cut — read quote.estimate.feeCosts). Side effects: MCP read-only until wallet signs.
Inputs: toChain (required), toToken (required), fromChain (required), fromToken (required), +4 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 5 tools
Each tool targets a distinct capability: manifest discovery, cross-chain swap execution, historical L2 archive catalog, live depth views, and liquidation radar. Descriptions go further with explicit 'NOT WHEN' clauses routing agents to the correct alternative (e.g. live data vs archive, depth vs swap), leaving virtually no room for misselection.
Four of five tools follow a clean get_<resource> pattern (get_agent_manifest, get_l2_archive_catalog, get_native_depth, get_liq_radar). swap_via_nattswap deviates with a verb_via_brand form, which is a minor but noticeable break in the convention.
Five tools is a tight, well-scoped set for a market-data-plus-swap terminal. Every tool covers a distinct stage of the workflow (discover, analyze liquidity, inspect depth, fetch history, execute) with no redundancy or filler.
The surface covers discovery, live analytics, historical data, and swap execution for the stated Hyperliquid domain. Minor gaps remain: no swap status/quote-only follow-up, no credits/pass balance check despite pricing referencing them, and depth is limited to BTC/ETH while radar spans more coins.
HiveCapital MCP Server — autonomous investment layer for AI agents
Self-custodial Hyperliquid perps, Polymarket, staking and yield for AI agents, with a kill switch.
Bitcoin RPC for AI agents. 7 read tools; x402 USDC on Base mainnet. Discovery is free.
Trade Hyperliquid perps, stocks, gold, oil and pre-IPO from AI agents. Hosted; keys can't withdraw.
