mcpField
O
okx-account

okx-account

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

okx-account について

okx-accountは、公式のpython-okxライブラリを用いたOKXの読み取り専用アカウント追跡ツールです。スクリプトと定義済みシナリオで、口座概要、リスク監視、キャッシュフロー集計、取引活動レポートを提供します。

主な機能

  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 okx-account

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

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

詳細

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

公式の python-okx ライブラリで構築された読み取り専用の OKX アカウントトラッカーです。 アカウントの追跡、日次/週次レポート、リスクアラート、キャッシュフローの帰属分析に使用します。

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

  1. okx.com にサインインし、右上のアバター → API
  2. Create V5 API Key → 2FA 認証を完了します
  3. フォームに入力します:
    • API name: 任意
    • Passphrase: ⚠️ API リクエストの署名に使用するまったく新しいパスワードであり、ログインパスワードではありません。紛失すると、キーを削除して新しいものを作成するしかありません。
    • Permissions: Read のみにチェックを入れ、Trade / Withdraw はオフのままにします
    • IP whitelist: 空のままにします
  4. 送信 → 3 つの値 API Key / Secret Key / Passphrase をすぐにコピーして保存します (Secret は一度しか表示されません)
  5. これらをこのスキルの環境変数に設定します

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

前提条件

1) API キー

OKX の API 管理で Read only のキーを作成します。OKX では 3 つの認証情報が必要です: api_key / secret / passphrase (キー作成時に設定したパスワードであり、ログインパスワードではありません)。

2) 環境変数
OKX_RO_API_KEY=...
OKX_RO_SECRET=...
OKX_RO_PASSPHRASE=...
3) 地域制限 (必須)

OKX はサーバーの IP を地域ブロックします。スクリプトはデフォルトで SC 内部の HK プロキシを使用します:

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

グローバルの HTTP_PROXY は設定しないでください。

スクリプト

python3 skills/okx-account/scripts/okx_account.py <action> [options]
python3 skills/okx-account/scripts/account_scenarios.py <scenario> [options]

アクション

  • summary: ワンショットのサマリー
  • account_balance / account_config / positions / position_risk / fee_rates / bills
  • open_orders / order_history / fills_history
  • funding_balance / deposits / withdrawals / currencies / funding_rate

シナリオ

  • portfolio_snapshot: アカウント全体のスナップショット
  • perp_risk: 無期限先物のリスク監視 (証拠金率 + 未実現損失のしきい値)
  • cashflow: 入金 + 出金 + 7 日間の bills の集計
  • trading_activity: instType 別の直近の fills アクティビティ

一般的な使用方法

python3 skills/okx-account/scripts/okx_account.py summary
python3 skills/okx-account/scripts/account_scenarios.py portfolio_snapshot
python3 skills/okx-account/scripts/account_scenarios.py perp_risk --loss-threshold 5000
python3 skills/okx-account/scripts/account_scenarios.py cashflow --limit 100
python3 skills/okx-account/scripts/account_scenarios.py trading_activity --inst-types SPOT,SWAP

注意事項

  • passphrase は忘れやすいです — これはキー作成時に設定したパスワードであり、ログインパスワードではありません。
  • キー作成時に IP ホワイトリストを紐付けた場合は、無効化するか、プロキシの出口 IP を追加してください。
  • 大量の fills には時間枠指定のページネーションを使用してください。

コメント

Markdown 対応