binance-account
Read-only Binance tracking: spot balances, USDM futures, PnL, funding, deposits. Use when monitoring Binance positions without trading (e.g. total PnL today, open futures positions, funding earned, recent deposits).
How do I install this agent skill?
npx skills add https://github.com/starchild-ai-agent/official-skills --skill binance-accountIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a read-only tracker for Binance spot and futures accounts. It securely handles Binance API keys via environment variables but contains hardcoded credentials for an internal proxy used to bypass regional restrictions. It also has a potential surface for indirect prompt injection from external API responses.
- Socketwarn
3 alerts: gptAnomaly
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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)
- Sign in at binance.com, top-right avatar → API Management
- Create API → System generated
- Complete 2FA verification (email + Authenticator / SMS)
- Name the key → submit
- Copy
API Key+Secret Keyimmediately (Secret is shown only once) - 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)
- ✅ Enable only
- 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:x@sc-vpn.internal: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 summaryspot_balance/futures_balance/futures_positionsspot_orders/futures_orders/spot_trades/futures_tradesdeposits/withdrawals/funding_income/account_snapshot
Scenarios
portfolio_snapshot: full account snapshotperp_risk: futures risk monitoring (margin ratio + unrealized loss)cashflow: deposits + withdrawals + funding income aggregationtrading_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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/starchild-ai-agent/official-skills/binance-account">View binance-account on skillZs</a>