blofin-setup

BloFin 配置

指导用户设置并配置 BloFin MCP 服务，以便在 BloFin 交易所进行交易。

先决条件

• 已安装 Node.js（v18+）和 npm
• 拥有 BloFin 账户：blofin.com

设置步骤

1. 安装 blofin-mcp

npm install -g blofin-mcp

或在本地安装：

git clone https://github.com/blofin/blofin-mcp.git
cd blofin-mcp
npm install
npm run build

2. 创建 BloFin API 密钥

引导用户前往 BloFin API 管理页面：

1. 登录 BloFin
2. 前往 账户 > API 管理
3. 点击 创建 API 密钥
4. 设置权限：
   • READ — 查看余额、订单历史记录和持仓
   • TRADE — 下单和撤单
   • TRANSFER — 在账户之间转移资金
5. 设置密码短语（请牢记）
6. （建议）绑定 IP 白名单以确保安全
7. 保存 API Key 和 Secret Key — 密钥仅会显示一次

3. 配置 MCP 服务

将 blofin MCP 服务添加到 Agent 的 MCP 配置中（例如 mcp.json 或 settings.json）：

{
  "mcpServers": {
    "blofin": {
      "command": "node",
      "args": ["/path/to/blofin-mcp/dist/index.js"],
      "env": {
        "BLOFIN_API_KEY": "your-api-key",
        "BLOFIN_API_SECRET": "your-api-secret",
        "BLOFIN_PASSPHRASE": "your-passphrase",
        "BLOFIN_BROKER_ID": "your-broker-id (optional)",
        "BLOFIN_BASE_URL": "https://openapi.blofin.com"
      }
    }
  }
}

将 /path/to/blofin-mcp 替换为实际安装路径（例如，全局 npm 路径或本地克隆目录）。

4. 配置基础 URL

环境	基础 URL	使用场景
模拟交易	https://demo-trading-openapi.blofin.com	测试、学习、模拟交易
生产环境	https://openapi.blofin.com	真实资金交易

• 如果未设置 BLOFIN_BASE_URL，则默认使用模拟交易
• 请务必先从模拟交易开始，以验证配置正常运行
• 仅在模拟交易测试成功后切换到生产环境

5. 验证连接

完成配置后，验证设置是否正常：

1. 使用 get_apikey_info 验证 API 密钥权限和状态
2. 使用 get_tickers 并设置 instId: "BTC-USDT"，测试公开数据访问
3. 使用 get_balance 验证身份验证访问
4. 检查 API 密钥是否具有预期权限（readOnly 字段：0 = 读写，1 = 只读）

6. 故障排除

问题	解决方案
签名验证失败	检查 API 密钥和密码短语是否正确；确保没有多余空格
IP 不在白名单中（152406）	在 BloFin 的 API 密钥白名单中添加当前 IP
访问密钥已过期（152402）	未绑定 IP 的密钥会在 90 天后过期；请重新创建密钥或绑定 IP
速率限制（429）	降低请求频率；REST API 的限制为每个 IP 每分钟 500 次请求
连接超时	检查网络；确认基础 URL 正确

环境变量参考

变量	必需	描述
BLOFIN_API_KEY	是	BloFin API 密钥
BLOFIN_API_SECRET	是	BloFin API Secret Key
BLOFIN_PASSPHRASE	是	创建 API 密钥时设置的密码短语
BLOFIN_BROKER_ID	否	用于订单归属的 Broker ID（由 BloFin 提供）
BLOFIN_BASE_URL	否	API 基础 URL（默认使用模拟交易端点）

安全最佳实践

• 切勿分享或泄露 API 密钥和密码短语
• 在生产环境中，务必将 API 密钥绑定到指定 IP 地址
• 根据使用场景，仅授予所需的最低权限
• 定期轮换 API 密钥
• 从仅授予 READ 权限开始，并根据需要升级