SuperAPI AI 工具集

blofin-setup

智能体与模型

查看项目

更新于 10-15 20:07

技能介绍

用途:引导用户完成 BloFin MCP 服务器的安装与配置,以便在 BloFin 交易所进行交易操作。

前置条件:需安装 Node.js(v18+)与 npm,并拥有 blofin.com 账户。

安装:可全局安装 npm install -g blofin-mcp,或本地克隆仓库后执行 npm install 与 npm run build。

创建 API 密钥:登录 BloFin,进入 Account > API Management,点击 Create API Key,设置权限(READ 查看余额/订单历史/持仓,TRADE 下单与撤单,TRANSFER 账户间划转),设置 Passphrase,建议绑定 IP 白名单,保存 API Key 与 Secret Key(Secret 仅显示一次)。

配置 MCP 服务器:在代理的 MCP 配置(如 mcp.json 或 settings.json)中添加 blofin 服务器,指定 command 为 node、args 为 dist/index.js 路径,并在 env 中填入 BLOFIN_API_KEY、BLOFIN_API_SECRET、BLOFIN_PASSPHRASE,可选 BLOFIN_BROKER_ID 与 BLOFIN_BASE_URL。

Base URL:模拟盘为 https://demo-trading-openapi.blofin.com,实盘为 https://openapi.blofin.com;未设置 BLOFIN_BASE_URL 时默认使用模拟盘,建议先在模拟盘验证再切换实盘。

验证连接:使用 get_apikey_info 检查密钥权限与状态,用 get_tickers(instId 为 BTC-USDT)测试公共数据,用 get_balance 验证认证访问,并确认 readOnly 字段(0 为读写,1 为只读)。

常见问题:签名验证失败需检查 Secret 与 Passphrase 及多余空格;IP 不在白名单(152406)需添加当前 IP;密钥过期(152402)需重建或绑定 IP;限流(429)需降低频率,REST API 限制为每 IP 每分钟 500 次;连接超时需检查网络与 Base URL。

环境变量:BLOFIN_API_KEY、BLOFIN_API_SECRET、BLOFIN_PASSPHRASE 为必填,BLOFIN_BROKER_ID 与 BLOFIN_BASE_URL 为可选。

安全建议:切勿泄露 API Secret 与 Passphrase,生产环境绑定 IP,使用最小必要权限,定期轮换密钥,建议从只读权限开始。