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. 提交 → 立即复制并保存以下三个值：API Key / Secret Key / Passphrase（Secret 仅显示一次）
  5. 将它们设置为此技能的环境变量

参考：OKX 官方教程

前提条件

1) API 密钥

在 OKX API 管理中创建一个 Read only 密钥。OKX 要求提供三项凭据：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 天账单汇总
  • trading_activity：按 instType 查看近期成交活动

常见用法

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。
  • 对于高频成交记录，请使用按时间窗口分页的方式。

评论

支持 Markdown