SuperAPI AI Directory
Partner中文AI newsFavorites
Skillsbinance-account

binance-account

General & other

View repository

Updated 10-16 01:10

About this skill

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