mcpField
B
binance-account

binance-account

github.com/starchild-ai-agent其他3095 次安装6 天前更新
代码仓库

关于 binance-account

这是基于 `python-binance` 的只读 Binance 账户追踪 Skill，适用于账户监控、报表和风险观察。它提供余额、交易、资金流等查询，以及组合快照和永续合约风险场景。

主要功能

  1. 01查询现货与合约余额
  2. 02查看订单、交易和持仓
  3. 03汇总充值、提现与资金费
  4. 04生成账户组合快照
  5. 05监控合约保证金与未实现亏损

适用场景

  1. 01生成每日或每周账户报告
  2. 02检查现货与合约账户状况
  3. 03汇总账户现金流
  4. 04监控永续合约风险

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/starchild-ai-agent/official-skills --skill binance-account

安装后在 Claude Code 中输入/binance-account确认已加载。

附带文件scripts/account_scenarios.pyscripts/bn_account.py

详细介绍

Binance 账户（只读）

基于广泛使用的 python-binance 库构建的只读 Binance 账户跟踪工具。 可用于账户跟踪、每日／每周报告、风险提醒和现金流归因。

如何获取 Binance API 密钥（只读）

  1. 登录 binance.com，点击右上角头像 → API 管理
  2. 创建 API → 系统生成
  3. 完成双重身份验证（电子邮件 + Authenticator／短信）
  4. 为密钥命名 → 提交
  5. 立即复制 API Key + Secret Key（Secret 仅显示一次）
  6. 编辑限制：
    • ✅ 仅启用 Enable Reading
    • ❌ 禁用交易、提现和所有写入权限
    • 将 IP 白名单留空（绑定 IP 会导致云端调用被拒绝）
  7. 将这些值设置为此技能的环境变量

参考：Binance 官方教程

前提条件

1) API 密钥权限

在 Binance API 管理中创建只读密钥。仅启用：

  • ✅ Enable Reading
  • ❌ 禁用交易和提现
2) 环境变量
BINANCE_RO_API_KEY=...
BINANCE_RO_SECRET=...
3) 地理位置限制（必需）

Binance 经常在服务器环境中返回 451 Restricted Location。 此技能默认使用 SC 内部 HK 代理：

HK_PROXY = "http://hk:[email protected]:8080"

不要设置全局 HTTP_PROXY，否则会破坏其他服务的路由。

脚本

基础查询脚本
python3 skills/binance-account/scripts/bn_account.py <action> [options]
场景脚本
python3 skills/binance-account/scripts/account_scenarios.py <scenario> [options]

操作

  • summary：一次性摘要
  • spot_balance / futures_balance / futures_positions
  • spot_orders / futures_orders / spot_trades / futures_trades
  • deposits / withdrawals / funding_income / account_snapshot

场景

  • portfolio_snapshot：完整账户快照
  • perp_risk：期货风险监控（保证金比率 + 未实现亏损）
  • cashflow：存款 + 提现 + 资金费收入汇总
  • trading_activity：按交易对查看近期交易

常见用法

python3 skills/binance-account/scripts/bn_account.py summary
python3 skills/binance-account/scripts/account_scenarios.py portfolio_snapshot
python3 skills/binance-account/scripts/account_scenarios.py perp_risk --loss-threshold 5000
python3 skills/binance-account/scripts/account_scenarios.py cashflow
python3 skills/binance-account/scripts/account_scenarios.py trading_activity --symbol BTCUSDT

备注

  • 云端使用时，最好将 IP 白名单留空。
  • 高频获取交易记录时，请使用按时间窗口分页的方式。

评论

支持 Markdown