About

Imported from starchild-ai-agent/official-skills (binance-account/SKILL.md). Install upstream with npx skills add starchild-ai-agent/official-skills --skill binance-account. Copyright stays with the author.

Binance Account (Read-Only)

Name: binance-account
Author: starchild-ai-agent

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.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/starchild-ai-agent-official-skills-binance-account/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

starchild-ai-agent-official-skills-binance-account.ocm.jsonjson

{
  "ocm": "1",
  "id": "starchild-ai-agent-official-skills-binance-account",
  "kind": "skill",
  "name": "binance-account",
  "description": "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).",
  "publisher": "starchild-ai-agent",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "binance",
      "account",
      "readonly",
      "tracking",
      "futures",
      "spot",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "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)."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/starchild-ai-agent/official-skills",
      "path": "binance-account/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/starchild-ai-agent/official-skills/blob/HEAD/binance-account/SKILL.md",
      "key": "starchild-ai-agent/official-skills/binance-account/SKILL.md"
    }
  },
  "instructions": "# Binance Account (Read-Only)\n\nRead-only Binance account tracker built on the widely used `python-binance` library.\nUse it for account tracking, daily/weekly reports, risk alerts, and cashflow attribution.\n\n## How to Get a Binance API Key (Read-Only)\n\n1. Sign in at [binance.com](https://www.binance.com), top-right avatar → **API Management**\n   - Direct link: https://www.binance.com/en/my/settings/api-management\n2. **Create API** → **System generated**\n3. Complete 2FA verification (email + Authenticator / SMS)\n4. Name the key → submit\n5. **Copy** `API Key` + `Secret Key` immediately (Secret is",
  "cost": {
    "context_tokens": 709
  }
}

Fetch it by URL: GET /api/v1/registry/starchild-ai-agent-official-skills-binance-account/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.