mcpField
B
binance-account

binance-account

github.com/starchild-ai-agentその他3095 回インストール6 日前に更新
リポジトリ

binance-account について

`python-binance`を使った、読み取り専用のBinanceアカウント追跡スキルです。アカウント監視やレポート、リスク確認に向けて、残高・取引・入出金の照会とポートフォリオや無期限先物のリスク分析を行います。

主な機能

  1. 01現物・先物残高の照会
  2. 02注文・取引・ポジションの確認
  3. 03入金・出金・資金調達料の集計
  4. 04アカウントスナップショットの作成
  5. 05先物の証拠金と含み損の監視

活用シーン

  1. 01日次・週次アカウントレポートの作成
  2. 02現物・先物アカウントの状況確認
  3. 03アカウントのキャッシュフロー集計
  4. 04無期限先物のリスク監視

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/binance-accountを入力して読み込まれたか確認します。

同梱ファイルscripts/account_scenarios.pyscripts/bn_account.py

詳細

Binance アカウント (読み取り専用)

広く使われている python-binance ライブラリで構築された、読み取り専用の Binance アカウントトラッカーです。 アカウントの追跡、日次/週次のレポート、リスクアラート、キャッシュフローの帰属分析などに利用できます。

Binance API キーの取得方法 (読み取り専用)

  1. binance.com にサインインし、右上のアバター → API 管理
  2. API を作成 → システム生成
  3. 2FA 認証 (メール + Authenticator / SMS) を完了
  4. キーに名前を付ける → 送信
  5. すぐに API Key + Secret Key をコピーする (Secret は一度しか表示されません)
  6. 制限を編集:
    • ✅ Enable Reading のみを有効化
    • ❌ 取引、出金、およびすべての書き込み権限を無効化
    • IP ホワイトリストは空のままにする (IP をバインドするとクラウドからの呼び出しが拒否されます)
  7. 値をこのスキルの環境変数に設定する

参考: Binance 公式チュートリアル

前提条件

1) API キーの権限

Binance API 管理で、読み取り専用のキーを作成します。有効化するのは次のみです:

  • ✅ Enable Reading
  • ❌ 取引と出金を無効化
2) 環境変数
BINANCE_RO_API_KEY=...
BINANCE_RO_SECRET=...
3) 地域制限 (必須)

Binance はサーバー環境から 451 Restricted Location を頻繁に返します。 このスキルはデフォルトで SC 内部 HK プロキシを使用します:

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

グローバルな HTTP_PROXY を設定しないでください。他のサービスのルーティングが壊れます。

スクリプト

基本クエリスクリプト
python3 skills/binance-account/scripts/bn_account.py <action> [options]
シナリオスクリプト
python3 skills/binance-account/scripts/account_scenarios.py <scenario> [options]

アクション

  • summary: ワンショットのサマリー
  • spot_balance / futures_balance / futures_positions
  • spot_orders / futures_orders / spot_trades / futures_trades
  • deposits / withdrawals / funding_income / account_snapshot

シナリオ

  • portfolio_snapshot: アカウント全体のスナップショット
  • perp_risk: 先物リスク監視 (証拠金比率 + 未実現損失)
  • cashflow: 入金 + 出金 + 資金調達収益の集計
  • trading_activity: シンボルごとの最近の取引

よくある使い方

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

注意事項

  • クラウドでの利用では、IP ホワイトリストは空のままにするのが最適です。
  • 高頻度の取引取得には、時間枠ごとのページネーションを使用してください。

コメント

Markdown 対応