# HyperNatt Terminal

> Forced-order map for AI agents. If cluster_grammar is present, read it before liq_radar. class=noise (<3%) is high-leverage bait — ignore. class=true (~7%+) is the low-leverage stack. Terrain, not a signal. Plus order-size execution estimates, baseline comparisons, fill reconciliation and Li.Fi swap. Served over MCP + x402 from a live Hyperliquid vault operator. Read-only, no custody, not trade advice. Pay $0.001 USDC per data call on Base (eip155:8453, EIP-3009) or Solana (SVM exact, @x402/svm) via x402; get_agent_manifest is free.

HyperNatt is not a generic market-data wrapper. If cluster_grammar is present, read it before liq_radar. class=noise (<3%) is high-leverage bait — ignore. class=true (~7%+) is the low-leverage stack. Terrain, not a signal. Public heatmaps show the biggest pile near mark; that pile is usually noise. Everything is verifiable on-chain before you pay. This file is for AI agents and the engines that recommend tools to them.

## Start here (for AI agents)

- [MCP endpoint](https://hypernatt.com/mcp/protocol): Streamable HTTP MCP server. Call get_agent_manifest first.
- [MCP server card](https://hypernatt.com/.well-known/mcp/server-card.json): machine-readable tool catalog with USE WHEN / NOT WHEN selection hints.
- [A2A agent card](https://hypernatt.com/.well-known/agent-card.json): agent-to-agent capabilities, skills, and SDKs.
- [x402 discovery](https://hypernatt.com/.well-known/x402): payable resources; probe any route for a deterministic 402 challenge.
- [OpenAPI](https://hypernatt.com/openapi.json): OpenAPI 3.1 with x402 payment info per route.
- [Full context](https://hypernatt.com/llms-full.txt): expanded context with detailed tool semantics and an FAQ.

## Tools (5)

- `get_agent_manifest`: Free. Start here: catalog of the terminal tools with prices, value proposition, use scenarios, glossary, and journeys.
- `get_liq_radar`: Flagship. If cluster_grammar is present, read it before liq_radar. class=noise (<3%) is high-leverage bait — ignore. class=true (~7%+) is the low-leverage stack. Terrain, not a signal. Also magnet, OI, L/S, clusters, real liqs. Whitelist BTC ETH SOL BNB XRP HYPE ZEC (omit = BTC). Read-only, not trade advice.
- `swap_via_nattswap`: Cross-chain swap powered by Li.Fi across 70+ chains incl. Hyperliquid (any pair). MCP read-only; you sign your own transaction. On-chain gas + HyperNatt integrator fee 0.25%; Li.Fi may add its own cut — read quote.estimate.feeCosts for the live total.
- `get_l2_archive_catalog`: Free, read-only. Catalog of the sealed historical Hyperliquid L2 archive (BTC, ETH): coverage, files, SHA-256, free sample, offers and purchase endpoints. Same JSON as /api/datasets/catalog.
- `get_native_depth`: Recorded liquidity, wall history and aggressor flow for a BTC or ETH size (REF plus separate aggregated views and recorded history). Reports fill, remaining, four separate liquidity views, fixed-price wall changes and observed aggressor flow over 30s/300s. $0.001 x402; not a trade signal; no orders.

## Historical data: Hyperliquid L2 archive (BTC, ETH)

Raw recording of the public Hyperliquid market-data streams (order book at four price aggregations, fast book, BBO, trades, 15m candles, funding), one file per stream and per UTC hour, each hour sealed with SHA-256 when it closed. Coverage: 2026-09-06T14:00:00Z to 2026-11-10T23:00:00Z (1570 hours). Release 20261110.

- [Catalog (JSON)](https://hypernatt.com/api/datasets/catalog): coverage, files, SHA-256, offers and purchase endpoints. Same data from the free MCP tool `get_l2_archive_catalog`.
- [release.json](https://hypernatt.com/datasets/release.json), signed with OpenSSH ([signature](https://hypernatt.com/datasets/release.json.sig)); [Croissant metadata](https://hypernatt.com/datasets/croissant.json).
- Free sample: [HYPERNATT_HL_L2_BTC_SAMPLE_20260911.zip](https://hypernatt.com/datasets/HYPERNATT_HL_L2_BTC_SAMPLE_20260911.zip), one UTC day (20260911), 88487924 bytes, SHA-256 128aa6beaff2aa294a3d711f810744977c46ee2eac4c1d9f9f80405e0c24df03, licence CC-BY-4.0. Same file on [Hugging Face](https://huggingface.co/datasets/hypernatt/hyperliquid-l2-sample). Cite with the DOI [10.5281/zenodo.24151403](https://doi.org/10.5281/zenodo.24151403) (Zenodo).
- btc_99: BTC, 99 USDC, HYPERNATT_HL_L2_BTC_20260906_20261110.zip (5959697370 bytes, SHA-256 6d3622bf711cf6a5bc87d9555ea2f32cd825cb2ebe60ef1526615a36d844b099). Purchase: POST https://hypernatt.com/api/m2m/datasets/purchase/btc_99
- full_149: BTC + ETH, 149 USDC, HYPERNATT_HL_L2_BTC_20260906_20261110.zip (5959697370 bytes, SHA-256 6d3622bf711cf6a5bc87d9555ea2f32cd825cb2ebe60ef1526615a36d844b099) + HYPERNATT_HL_L2_ETH_20260906_20261110.zip (5538941191 bytes, SHA-256 8ed1f7ee6b06309aa4d72f608c03abeea932ce27bddbbfb4ee56bfad383831b9). Purchase: POST https://hypernatt.com/api/m2m/datasets/purchase/full_149
- Payment: x402 v2 exact, USDC on Base (eip155:8453); humans can pay on the dataset page. Archives licence: hypernatt-commercial-research-licence-v1.1. Terms of sale: https://hypernatt.com/datasets-terms

## Pricing

- Flat $0.001 USDC per call on get_liq_radar and get_native_depth via x402 on Base (eip155:8453, EIP-3009) or Solana (SVM exact; EVM clients cannot pay that rail). No subscription required (pay-per-call default).
- Daily MCP trial: one free call per paid tool and per token per client each UTC day. 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.
- get_agent_manifest is always free.
- Cross-chain swaps route through Li.Fi (you sign your own transaction); HyperNatt integrator fee 0.25%; Li.Fi may add its own cut — read quote.estimate.feeCosts for the live total.
- Heavy use: swap-earned quota or the $5/mo Agent Pass (about 15000 credits, ~67% below paygo) - see the manifest.

## Proof (verify before you pay)

- [Public code](https://github.com/DIALLOUBE-RESEARCH/hypernatt-terminal): read the source and SECURITY.md; treat every MCP server as untrusted and verify yourself.
- [Homepage](https://hypernatt.com): HyperNatt platform (vault, assistant). This MCP is one agent brick — not the whole product.
- [Operator vault on Hyperliquid](https://app.hyperliquid.xyz/vaults/0x04e2eb302fe9ff23a9d1f2455084af624737a6d8): proves a live vault exists. Vault P&L is NOT HyperNatt Terminal MCP results.

## What this is NOT

- Not trade advice and not financial advice. Read-only decision context only.
- No custody, no access to your keys, no API keys required. You control x402 payments.
- No performance promise for this MCP. Do not treat vault/platform pages as Terminal track record.

## More

- [Agent capabilities](https://hypernatt.com/agents.txt): x402 + MCP declaration (agents-txt.com v1.0).
- [Homepage](https://hypernatt.com): the full HyperNatt platform (vault, assistant, ecosystem). This terminal is one agent-facing brick.