{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_m36e9mmxvqm8","handle":"hyperliquid-mcp-python","url":"https://wellknown.network/agents/hyperliquid-mcp-python","links":{"self":"https://wellknown.network/agents/hyperliquid-mcp-python/record.json","html":"https://wellknown.network/agents/hyperliquid-mcp-python","markdown":"https://wellknown.network/agents/hyperliquid-mcp-python/record.md","api":"https://wellknown.network/api/v1/agents/hyperliquid-mcp-python","status":"https://wellknown.network/api/v1/agents/hyperliquid-mcp-python/status","claim":"https://wellknown.network/agents/hyperliquid-mcp-python/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/hyperliquid-mcp-python/claim.json","badge":"https://wellknown.network/agents/hyperliquid-mcp-python/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/hyperliquid-mcp-python/history","tools":"https://wellknown.network/api/v1/agents/hyperliquid-mcp-python/tools"},"ard":{"identifier":"urn:air::server:hyperliquid-mcp-python","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"hyperliquid-mcp-python","summary":"HyperLiquid MCP Server with FastMCP - Trading tools and account management","description":"# HyperLiquid MCP Server\n\n[![CI](https://github.com/talkincode/hyperliquid-mcp-python/actions/workflows/ci.yml/badge.svg)](https://github.com/talkincode/hyperliquid-mcp-python/actions/workflows/ci.yml)\n[![PyPI version](https://badge.fury.io/py/hyperliquid-mcp-python.svg)](https://badge.fury.io/py/hyperliquid-mcp-python)\n[![Python Versions](https://img.shields.io/pypi/pyversions/hyperliquid-mcp-python.svg)](https://pypi.org/project/hyperliquid-mcp-python/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n基于 FastMCP 的 HyperLiquid 交易 MCP 服务器。为 AI 助手提供与 HyperLiquid 永续合约和现货交易平台交互的工具。\n\n> **致谢**: 本项目 Fork 自 [GigabrainGG/hyperliquid-mcp](https://github.com/GigabrainGG/hyperliquid-mcp)，感谢原作者的出色工作！\n\n## 功能特性\n\n### 交易工具\n\n- [x] **市价订单**：使用 HyperLiquid 原生函数优化的开仓和平仓\n- [x] **限价订单**：支持 reduce-only 和自定义订单 ID 追踪\n- [x] **括号订单**：一键创建带止盈止损的新仓位（OCO 行为）\n- [x] **订单管理**：按 ID 或客户端 ID 取消订单、批量取消、修改订单\n- [x] **仓位管理**：查看仓位、平仓（全部或部分）、获取盈亏信息\n- [x] **高级止盈止损**：为现有仓位设置 OCO 止盈止损\n\n### 账户管理\n\n- [x] **余额信息**：获取账户余额和保证金详情\n- [x] **仓位跟踪**：监控所有开仓及未实现盈亏\n- [x] **交易历史**：查询成交记录和交易历史\n- [x] **杠杆控制**：为不同资产更新杠杆设置\n- [x] **资金划转**：在现货和合约账户间转移资金\n\n### 市场数据\n\n- [x] **实时价格**：获取当前市场数据，包括买卖价差\n- [x] **订单簿**：获取可配置深度的实时订单簿数据\n- [x] **资金费率**：访问历史资金费率信息\n\n### 实用工具\n\n- [x] **账户总览**：获取账户综合概览\n- [x] **美元转换**：根据当前价格计算代币数量\n- [x] **仓位管理**：专用的现有仓位管理工具\n\n## 快速开始\n\n### 方式 1：使用 uvx（推荐）🚀\n\n**最简单的方式** - 无需安装，直接运行：\n\n```bash\n# 查看帮助\nuvx --python 3.13 --from hyperliquid-mcp-python hyperliquid-mcp --help\n\n# 启动 HTTP 服务器\nuvx --python 3.13 --from hyperliquid-mcp-python hyperliquid-mcp start\n\n# 启动 stdio 服务器（用于 MCP 客户端）\nuvx --python 3.13 --from hyperliquid-mcp-python hyperliquid-mcp stdio\n```\n\n> **为什么要指定 `--python 3.13`?**\n> 依赖包 `ckzg` 目前只提供到 Python 3.13 的预编译包，Python 3.14 还不支持。指定版本可以避免编译错误。\n\n### 方式 2：本地开发安装\n\n```bash\n# 克隆仓库\ngit clone https://github.com/talkincode/hyperliquid-mcp-python.git\ncd hyperliquid-mcp-python\n\n# 安装依赖（uv 会自动处理编译）\nuv sync\n\n# 配置\ncp .env.example .env  # 然后编辑 .env 文件\n# 或设置环境变量\nexport H…","publisher":null,"homepage":"https://github.com/talkincode/hyperliquid-mcp-python#readme","repository":"https://github.com/talkincode/hyperliquid-mcp-python/issues","version":"0.1.8","license":"MIT","protocols":["mcp"],"tags":["ai","crypto","fastmcp","hyperliquid","mcp","perpetuals","trading"],"pricing":null,"endpoints":[{"url":"pypi:hyperliquid-mcp-python","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"finance.markets","name":"Markets & Trading","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":0.688,"provenance":"derived"}],"categories":["dev","finance"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"hyperliquid-mcp-python","registry":"pypi","observedAt":"2026-09-15T16:22:22.552Z","publishedAt":"2025-10-28T08:39:52.840533Z","latestVersion":"0.1.8"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"hyperliquid-mcp-python","url":"https://pypi.org/project/hyperliquid-mcp-python/","firstSeenAt":"2026-09-09T17:21:44.947Z","fetchedAt":"2026-09-15T16:21:21.717Z","normalizedAt":"2026-09-15T16:21:21.717Z"}]},"firstSeenAt":"2026-09-09T17:21:44.947Z","updatedAt":"2026-09-15T16:22:22.552Z"}