tapoooooty/hypergrad

HyperGrad 是一套 Python 工具，用于在 Hyperliquid 上按 HIP-3 搭建由部署方运营的永续合约 DEX，目标是从 pump.fun 毕业的 Solana 迷因币。它不是交易前端，也不能靠它直接开出一个市场：按 HIP-3 规则，部署方需质押 500,000 HYPE（README 估算约 4500 万美元）、自行提供市场与预言机，撮合、保证金和清算由 Hyperliquid 负责 HIP-3 规则。README 标注项目状态为 testnet。

市场设计

市场按市值分层：市值达到 $500K 的币进入 grad:GRAD 指数永续；市值保持 $500K 满 24 小时、池子流动性至少 $100K 且日成交 $500K，才获得自己的 2x 永续；超过 $5M 后杠杆上限升到 3x。完整规则见 上币政策。由于迷因币价格不到一美分，上市时会选定打包单位（例如一百万枚 WIF），以适配 Hyperliquid 的五位有效数字定价。

代码实际运行什么

四个进程承担主要流程。Manager 每 10 分钟扫描毕业币，通过 Solana RPC 检查持有人，划分层级并每日再平衡指数。Oracle 约每 3 秒对 DexScreener、Jupiter 和可选链上 PumpSwap 池取中位数，用 EMA 生成标记价，数据异常时冻结，持续冻结则停牌市场。做市进程只用 ALO 单在两侧挂阶梯，市场停牌或预言机陈旧时撤单。只读面板展示各进程状态，并暴露 /api/health 供备用预言机判断接管 工作原理。

上手路径在文档中已写明：Python 3.10+ 安装，.env 填入分离的部署、预言机和做市密钥，先用 doctor 预检，再依次运行 scan、init-dex、oracle 和 mm 快速开始。由于预言机不能休眠，仓库提供 Docker Compose 和 systemd 单元用于在 VPS 上运行 服务器部署，全部命令也可通过 python -m hip3 调用 命令列表。

决定适用性的关键条件

• 资金与授权。 500,000 HYPE 质押、testnet 资金、私有 Solana RPC、做市资金和法律意见都被列为代码无法完成的事项 运维文档。
• 罚没风险。 预言机输入出错，无论源于恶意、bug 还是私钥被盗，最多可被罚没全部 500,000 HYPE；README 建议预言机密钥单独保管、部署密钥离线保存。
• 暴跌时标记价滞后。 Hyperliquid 规定 HIP-3 标记价每次更新最多变动 1%，因此在 −90% 崩盘时持仓会停留在陈旧价格上，这也是低杠杆与逐仓保证金的原因。backtest 命令可回放某币历史，显示它当时的滞后程度。
• 数据依赖。 pump.fun API 非官方，扫描器会退化为仅用 DexScreener；README 建议主网预言机至少启用两个数据源。
• 先测试网。 README 要求在主网前于测试网演练停牌、故障切换和做市。

MIT 许可 仓库。这套代码面向打算运营永续合约场所的人，而不是散户交易工具。