hypernatt-terminal

HyperNatt Terminal

为 AI Agent 提供清算雷达（7 种代币）以及已记录的流动性、挂单墙历史和主动成交流（BTC 和 ETH），并支持 Li.Fi 跨链兑换。通过 x402 按次付费。

了解清算地形，再询问某个 BTC 或 ETH 交易规模在实测盘口上是否可行（REF 加上单独的聚合视图和已记录的历史数据）。对于跨链兑换，可请求由 Agent 签署的 Li.Fi 路由。Agent 选择任务并控制执行。

由一个人构建。代码公开。后端私有。不托管资产。非交易建议。

完整的 HyperNatt 平台（vault、助手）：https://hypernatt.com — 此仓库是面向 Agent 的一个组成部分。

公开运行环境和文档与 monorepo 同步。仓库：https://github.com/DIALLOUBE-RESEARCH/hypernatt-terminal。

快速开始（30 秒）

使用托管的 MCP 服务无需安装。在 Claude → Settings → Connectors → Add custom connector 中：

字段	值
名称	HyperNatt Terminal
URL	https://hypernatt.com/mcp/protocol

然后询问：

调用 get_agent_manifest，并为我的任务选择 journeys_v1。使用 get_liq_radar 查看清算地形。对于 0.1 ETH 的买入，通过 get_native_depth 查看实测记录的流动性背景。使用 swap_via_nattswap 获取 Li.Fi 路由。

更多客户端（Cursor / Cline / Codex / Windsurf）：docs/integrations.md。

HyperNatt Terminal 为你的 Agent 提供什么

先使用 get_agent_manifest（免费），再通过 journeys_v1 选择任务所需的工具：

• 了解市场： get_liq_radar 提供清算集群、未平仓合约背景和观测到的清算（BTC ETH SOL BNB XRP HYPE ZEC）。
• 查看实测深度： get_native_depth 报告成交量、剩余量和四种同步视图、固定价格挂单墙历史及观测到的主动成交流。
• 查找跨链兑换路由： swap_via_nattswap 根据源链／目标链及代币请求 Li.Fi 路由。交易由你的 Agent 签署。

雷达覆盖 7 种代币。原生深度仅支持 BTC 和 ETH。跨链兑换使用 Li.Fi 支持的链和代币，具体取决于路由是否可用。两种付费工具互不依赖。

清算地形 — get_liq_radar

强制平仓单地图：显示杠杆仓位在价格到达相关位置时将被清算的区域（集群、未平仓合约累积、观测到的清算）。

这是市场结构背景，不是交易信号。它展示地形，让自主交易 Agent 比只读取 RSI/MACD 类公开数据源的 Agent 更充分地评估时机、仓位规模和风险。

仍由你的 Agent 做决定。我们展示地形。

雷达场景

场景 1 — 忽略噪声；只在 class=true 附近等待

忽略 class=noise 的集群（距离 < 3%）。如果存在 cluster_grammar，则只在 class=true 附近等待（约 7%+ 的低杠杆堆积）。然后观察 real_liquidations 打印数据——不要据此假设必然反转。class=true 描述的是地形，不是入场信号。

场景 2 — 根据距离调整规模

距离约 5% 的集群与距离约 0.5% 的集群，风险参数不同。距离可用于调整仓位规模或决定是否耐心等待——它并不预测价格一定会触及该水平。

场景 3 — 真实清算后，检查 OI

如果价格扫过某个区域且真实清算激增，请对照 OI 变化。OI 大幅下降可能意味着强制平仓流部分耗尽——这仍只是背景信息，不是自动入场信号。

雷达术语表

术语	含义
Cluster	杠杆仓位可能在标记价格触及该区域时被清算的区域。不是止盈位。
cluster_grammar / class	如果存在：先读这个。noise = 距离 < 3%（忽略）；true = ~7%+（低杠杆仓位堆积）。不是交易信号。
Nearest 与 largest	nearest_* 是 largest_*（规模领先项）的旧别名，不代表距标记价格最近。
真实与估算	real_liquidations = 已观测；liq_density 簇 = 模型估算。两者均有标注。
magnet.score	来自 OI / L-S / 资金费率的方向性密度偏差。不是触及概率。

雷达术语表和场景也可通过 get_agent_manifest → agent_interpretation_rules_v1 获取。原生深度和兑换工作流请使用 journeys_v1。

原生 REF 深度 — get_native_depth

“流动性在哪里、是否在变化，以及有哪些资金流与之交汇？” 提供 symbol（BTC 或 ETH）、side、quantity_base 和 lookback_s（30 或 300）。先查看 agent_readout，然后查看 liquidity_map，了解四种同步的价格粒度、规模覆盖范围，以及固定挂单墙价格处的变化；trade_flow 显示已观测到的主动买入 / 卖出。检查历史覆盖范围和数据新鲜度。切勿将重叠视图相加。这些事实可补充雷达地形信息，但不会透露策略，也不保证成交。指南。

跨链兑换 — swap_via_nattswap

“有哪些可用路线，可以将一条链上的代币兑换为另一条链上的代币？” 提供源链 / 目标链、代币、金额和钱包地址。查看 Li.Fi 路线、费用和执行就绪状态；你的 Agent 使用自己的钱包签名。这与原生 BTC/ETH 深度是独立的工作流。兑换输入和执行步骤。

试用与定价

每日 MCP 试用：每个付费工具和符合条件的代币，在每个 UTC 日可免费调用一次：雷达覆盖 7 种代币，加上原生 BTC/ETH，最多 9 次独立试用；之后每次调用收费 0.001 USDC。请在同一个 MCP 连接上读取 trial_policy_v2 和 free_tier_status_v1，以查看当前可用情况。daily_cap 为零表示独立的额度池，不属于入门试用额度。

你将获得什么

工具	价格
get_agent_manifest	免费 — 请先调用
get_liq_radar	$0.001 x402（Base EIP-3009 或 Solana SVM exact）
swap_via_nattswap	MCP 上免费（你签名；链上收取 gas + Li.Fi 费用）
get_native_depth	$0.001 x402，或使用符合条件的额度

Solana 支付：通道已上线（SVM exact）。请勿复用 EVM/Base x402 客户端。请使用 @x402/svm。Base HTTP 200 不代表 Solana 支付成功。参见 docs/x402-pay.md。

get_liq_radar 的白名单：BTC ETH SOL BNB XRP HYPE ZEC（省略 symbol = BTC）。get_native_depth：仅限 BTC ETH。

我们不声称什么

我们不声称	我们确实展示
通用 Coinglass 封装	面向 Agent、由运营者构建的强制平仓订单图
预测性 Fuel Score / 扫盘分类器	距离、规模、OI、真实清算——均有标注
托管密钥或资金	Agent 自行签署交易
交易建议 / 保证优势	只读 JSON 背景信息
超过 4 个 MCP 工具	恰好 4 个 · v2.9.1
Vault / /stats = Terminal 盈亏	独立的 HyperNatt Vault 产品
独立安全审计	公开代码 + SECURITY.md

试用

curl -s https://hypernatt.com/api/m2m/agent/manifest
curl -i https://hypernatt.com/api/m2m/liq-radar

步骤	链接
快速入门	docs/quickstart.md
x402 Base 与 Solana	docs/x402-pay.md
集成（5 个客户端 + AgentKit）	docs/integrations.md
HL 地形示例（只读）	examples/hyperliquid/read_terrain.py
诚实解读示例	examples/liq_radar_interpret.py
CDP Bazaar 检查清单	docs/cdp-bazaar-checklist.md
示例	examples/
安全	SECURITY.md
买家技能（使用 MCP）	skills/hypernatt-terminal/SKILL.md
卖家技能（x402 加固）	solana-x402-seller-security-skill
测试	test/ — npm test
更新日志	CHANGELOG.md

MCP：https://hypernatt.com/mcp/protocol

面向非加密货币用户（x402 钱包）

无需设置支付方式，即可开始使用每日 MCP 试用额度。如需付费使用，可选的一个钱包提供商是 Coinbase Agentic Wallet MCP。请按照其当前的设置和充值说明操作；可用的充值方式取决于提供商和你的账户：

npx @coinbase/payments-mcp

文档：Agentic Wallet MCP。然后连接 HyperNatt Terminal（https://hypernatt.com/mcp/protocol）。两个付费工具 — get_liq_radar 和 get_native_depth — 在可用的每日试用额度用完后，每次调用费用为 0.001 USDC，或消耗 1 个符合条件的额度。支持 x402 的客户端可根据你的支付授权规则处理支付要求并重试。在 MCP 中，请检查工具响应中的支付要求；不要只依赖 HTTP 402 状态码。请参阅支付和额度。

可选：通过符合条件的兑换获得额度，或购买 5 美元的 Agent Pass，可获得 15,000 个额度，有效期为 30 天；这些额度可在所有付费工具之间共享。调用 get_agent_manifest 并传入 {"detail":"full"}，即可读取当前的 pass_program 和 quota_program；默认的精简响应中不包含这些信息。清单和 MCP 兑换请求仍免费；链上兑换费用另计。

许可证

MIT — 参见 LICENSE。