How do I install the Binance Account skill?

Run npx skillmds add starchild-ai-agent/binance-account in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Binance Account safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Binance Account?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Binance Account free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Binance Account?

starchild-ai-agent (@starchild-ai-agent) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Binance Account by starchild-ai-agent

Name: Binance Account
Rating: 4.2 (5 reviews)
Author: starchild-ai-agent

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).

starchild-ai-agent 04364af 4 files · 23.1 KB Updated Sep 9, 2026

File contents

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
- Direct link: https://www.binance.com/en/my/settings/api-management
Create API → System generated
Complete 2FA verification (email + Authenticator / SMS)
Name the key → submit
Copy API Key + Secret Key immediately (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)
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 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.

---name: binance-accountdescription: 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).--- # 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](https://www.binance.com), top-right avatar → **API Management** - Direct link: https://www.binance.com/en/my/settings/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](https://www.binance.com/en/support/faq/how-to-create-api-keys-on-binance-360002502072) ## 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 ```bash 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: ```python 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 ```bash python3 skills/binance-account/scripts/bn_account.py <action> [options] ``` ### Scenario script ```bash 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 ```bash 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.

Frequently asked questions