mcpField
B
binance-account

binance-account

github.com/starchild-ai-agentOther3095 installsUpdated 1w ago
Repository

About binance-account

A read-only Binance account tracking skill built on `python-binance`, for account monitoring, reporting, and risk checks. It provides queries for balances, activity, and cash flows, along with portfolio snapshot and perpetual-futures risk scenarios.

Key features

  1. 01Query spot and futures balances
  2. 02Review orders, trades, and positions
  3. 03Aggregate deposits, withdrawals, and funding
  4. 04Create an account snapshot
  5. 05Monitor futures margin and unrealized losses

Use cases

  1. 01Prepare daily or weekly account reports
  2. 02Check spot and futures account status
  3. 03Summarize account cash flows
  4. 04Monitor perpetual-futures risk

Install

Copy the command and run it in a terminal.

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

After installing, type/binance-accountin Claude Code to confirm it loaded.

Bundled filesscripts/account_scenarios.pyscripts/bn_account.py

Details

From the project README

Binance Account (Read-Only)

Read-only Binance account tracker built on the widely used python-binance library. Use it for account tracking, daily/weekly reports, risk alerts, and cashflow attribution.

How to Get a Binance API Key (Read-Only)

  1. Sign in at binance.com, top-right avatar → API Management
  2. Create API → System generated
  3. Complete 2FA verification (email + Authenticator / SMS)
  4. Name the key → submit
  5. Copy API Key + Secret Key immediately (Secret is shown only once)
  6. Edit restrictions:
    • ✅ Enable only Enable Reading
    • ❌ Disable trading, withdrawal, and all write permissions
    • Leave the IP whitelist empty (binding an IP causes cloud calls to be rejected)
  7. Set the values into this skill's environment variables

Reference: Binance official tutorial

Prerequisites

1) API key permissions

In Binance API Management, create a read-only key. Enable only:

  • ✅ Enable Reading
  • ❌ Disable trading and withdrawal
2) Environment variables
BINANCE_RO_API_KEY=...
BINANCE_RO_SECRET=...
3) Geo restriction (required)

Binance frequently returns 451 Restricted Location from server environments. This skill defaults to the SC internal HK proxy:

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

Do not set a global HTTP_PROXY — it would break routing for other services.

Scripts

Base query script
python3 skills/binance-account/scripts/bn_account.py <action> [options]
Scenario script
python3 skills/binance-account/scripts/account_scenarios.py <scenario> [options]

Actions

  • summary: one-shot summary
  • spot_balance / futures_balance / futures_positions
  • spot_orders / futures_orders / spot_trades / futures_trades
  • deposits / withdrawals / funding_income / account_snapshot

Scenarios

  • portfolio_snapshot: full account snapshot
  • perp_risk: futures risk monitoring (margin ratio + unrealized loss)
  • cashflow: deposits + withdrawals + funding income aggregation
  • trading_activity: recent trades by symbol

Common usage

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

Notes

  • IP whitelist is best left empty for cloud usage.
  • Use time-windowed pagination for high-frequency trade pulls.

Comments

Markdown supported