金大哥 - binance-us-mcp MCP 详情

article

README

🚀 Binance.US MCP 服务器

这是一个用于与 Binance.US 加密货币交易 API 交互的模型上下文协议（MCP）服务器。它为用户提供了便捷的方式来访问 Binance.US 交易所的各种功能，包括市场数据获取、交易操作、钱包管理等。

🚀 快速开始

本 MCP 服务器允许以编程方式访问 Binance.US 交易所的功能，涵盖以下方面：

市场数据：实时价格、订单簿、交易历史
现货交易：下单、取消订单和管理订单
钱包管理：存款、取款、余额查询
账户信息：账户详情、交易历史
质押：在支持的资产上获取奖励
场外交易：场外交易功能
子账户：管理子账户
托管解决方案：适用于托管合作伙伴（需要特殊 API 密钥）
信用额度：适用于机构信用（需要特殊 API 密钥）

✨ 主要特性

Binance.US 与 Binance.com 的区别

此服务器专为 Binance.US 设计，与 Binance.com 在多个重要方面存在差异： | 特性 | Binance.US | Binance.com | |---------|------------|-------------| | 基础 URL | api.binance.us | api.binance.com | | WebSocket | stream.binance.us:9443 | stream.binance.com:9443 | | 监管 | 符合美国证券交易委员会（SEC）/金融犯罪执法网络（FinCEN）规定 | 国际监管 | | 期货交易 | ❌ 不可用 | ✅ 可用 | | 保证金交易 | ❌ 不可用 | ✅ 可用 | | 借贷 | ❌ 不可用 | ✅ 可用 | | 托管解决方案 API | ✅ 可用 | ❌ 不可用 | | 信用额度 API | ✅ 可用 | ❌ 不可用 | | 可用交易对 | ~150 对 | ~1,500+ 对 |

API 密钥类型

Binance.US 提供三种类型的 API 密钥：

1. 交易 API 密钥

适用于大多数用户的标准 API 密钥。
可访问市场数据、交易、钱包和账户端点。
创建位置：Binance.US > 个人资料 > API 管理

2. 托管解决方案 API 密钥

适用于与托管交易网络达成协议的用户。
仅可访问托管特定的端点。
需要与参与的托管合作伙伴达成协议。

3. 信用额度 API 密钥

适用于具有信用额度协议的机构用户。
仅可访问信用额度特定的端点。
需要与 Binance.US 签署信用额度协议。

📦 安装指南

# 克隆仓库
git clone https://github.com/nirholas/universal-crypto-mcp.git
cd universal-crypto-mcp/binance-us-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

配置

环境变量

创建一个 .env 文件或设置以下环境变量：

BINANCE_US_API_KEY=your_api_key_here
BINANCE_US_API_SECRET=your_api_secret_here

Claude 桌面配置

将以下内容添加到你的 Claude 桌面配置文件（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "binance-us-mcp": {
      "command": "node",
      "args": ["/path/to/binance-us-mcp-server/build/index.js"],
      "env": {
        "BINANCE_US_API_KEY": "your_api_key",
        "BINANCE_US_API_SECRET": "your_api_secret"
      }
    }
  }
}

💻 使用示例

开发环境

# 以热重载模式运行
npm run dev

# 使用 MCP 检查器进行测试
npm test

生产环境

# 构建项目
npm run build

# 启动服务器
npm start

可用工具类别

市场数据（公开）

获取行情价格
获取订单簿深度
获取近期交易
获取 K 线/烛台数据
获取 24 小时统计数据
获取交易所信息

现货交易（需要 API 密钥）

下单（限价、市价、止损限价）
取消订单
获取未成交订单
获取订单状态
获取交易历史

钱包（需要 API 密钥）

获取余额
获取存款地址
获取存款历史
获取取款历史
取款

账户（需要 API 密钥）

获取账户信息
获取交易历史
获取 API 密钥权限

质押

获取质押产品
订阅质押
赎回质押
获取质押历史

场外交易

获取场外报价
执行场外交易

子账户

创建子账户
获取子账户列表
账户间转账

托管解决方案（特殊 API 密钥）

托管特定操作
合作伙伴集成

信用额度（特殊 API 密钥）

信用额度管理
机构功能

🔧 技术细节

安全最佳实践

切勿共享 API 密钥 - 将其视为密码一样对待。
使用 IP 限制 - 在 API 设置中仅白名单信任的 IP 地址。
限制权限 - 仅启用所需的权限。
使用单独的密钥 - 为不同的应用程序创建不同的密钥。
定期轮换密钥 - 定期生成新的密钥。
监控活动 - 检查账户是否有未经授权的访问。

速率限制

Binance.US 有以下速率限制：

请求权重：每分钟 1200
订单：每秒 10 笔，每天 100,000 笔
原始请求：每 5 分钟 5000 次

服务器会自动处理速率限制，但在进行大量请求时请留意这些限制。

错误处理

服务器返回标准化的错误响应：

{
  "success": false,
  "error": {
    "code": -1121,
    "msg": "Invalid symbol."
  }
}

常见错误代码：

-1000：未知错误
-1002：未授权
-1021：时间戳超出接收窗口
-1022：无效签名
-2010：新订单被拒绝
-2011：取消订单被拒绝

📚 详细文档

详细文档可在 docs/ 文件夹中找到：

TOOLS.md - 完整的工具参考，包含参数、示例和响应
API_CLIENT.md - API 客户端架构、类型和错误处理
QUICK_REFERENCE.md - 所有工具的快速查找指南
TRADING.md - 交易工具和订单管理（共 13 个工具）
TRADING_QUICK_REF.md - 交易工具速查表
ERROR_CODES.md - 完整的错误代码参考及解决方案

📄 许可证

本项目采用 MIT 许可证 - 详情请见 LICENSE。

资源

🌐 实时 HTTP 部署

Binance US MCP 已部署并可通过 MCP 可流式 HTTP 传输协议通过 HTTP 访问 — 无需本地安装。

端点：

https://modelcontextprotocol.name/mcp/binance-us-mcp

从任何 MCP 客户端连接

将以下内容添加到你的 MCP 客户端配置（Claude 桌面、Cursor、SperaxOS 等）：

{
  "mcpServers": {
    "binance-us-mcp": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/binance-us-mcp"
    }
  }
}

可用工具（3 个）

| 工具 | 描述 | |------|-------------| | get_ticker_price | 获取 Binance.US 上的价格 | | get_24h_stats | 24 小时统计数据 | | get_order_book | 订单簿 |

示例请求

获取 Binance.US 上的价格：

curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_ticker_price","arguments":{"symbol":"BTCUSD"}}}'

24 小时统计数据：

curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_24h_stats","arguments":{"symbol":"ETHUSD"}}}'

订单簿：

curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_order_book","arguments":{"symbol":"BTCUSD","limit":5}}}'

列出所有工具

curl -X POST https://modelcontextprotocol.name/mcp/binance-us-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

也可在以下平台使用

SperaxOS — 从 MCP 市场浏览和安装
所有 27 个 MCP 服务器 — 在 modelcontextprotocol.name 查看完整目录

由 modelcontextprotocol.name 提供支持 — 开放的 MCP HTTP 网关

星标历史

ERC - 8004 关键词与 SEO 术语

此部分包含了与 ERC - 8004 相关的大量关键词，涵盖核心协议、区块链与 Web3、AI 与代理技术、信任与声誉、验证与确认、支付与商业、发现与注册、端点与集成、SDK 与开发工具、生态系统与社区、关键人物与组织、用例与应用、技术规范、活动与会议、新闻与媒体、竞争对手与替代方案、未来与路线图等多个方面，共计 6500 + 个关键词，最后更新于 2026 年 1 月 29 日。由于内容较多，此处不再详细列出，你可在文档中查看具体内容。