用于只读追踪 Bybit 账户,基于官方 pybit 库实现,适合账户监控、日报周报、风险告警和资金流归因,不涉及交易操作。
使用前需在 Bybit API 管理页面创建只读密钥,权限仅勾选 Wallet、Positions、Trade 的 Read-Only,不要开启提现或任何写权限;密钥仅在创建时显示一次。随后设置环境变量 BYBIT_RO_API_KEY 与 BYBIT_RO_SECRET。Bybit 对服务器 IP 有地域限制,脚本默认走内部 HK 代理(HK_PROXY),并通过 session.client.proxies.update 注入,不能作为 HTTP 构造参数传入。
运行方式为 python3 skills/bybit-account/scripts/bybit_account.py <action> [options] 与 python3 skills/bybit-account/scripts/account_scenarios.py <scenario> [options]。
动作包括:summary、wallet_balance、coin_balance、funding_balance、account_info、fee_rates、collateral_info、positions、open_orders、order_history、executions、deposits、withdrawals、internal_transfers、universal_transfers、transaction_log、borrow_history、server_time。
场景包括:portfolio_snapshot(钱包与持仓全量快照)、perp_risk(IM/MM 比率与未实现亏损监控)、cashflow(充值、提现、转账与交易日志)、trading_activity(按类别统计近期成交)。常用示例:summary、portfolio_snapshot、perp_risk --loss-threshold 5000、cashflow --limit 100、trading_activity --categories spot,linear。
重要之处:Bybit v5 的 get_wallet_balance 仅支持 accountType=UNIFIED,FUND 账户余额需用 get_coins_balance(accountType='FUND') 获取,summary 与 portfolio_snapshot 会自动合并两者;linear 持仓需按 settleCoin(USDT/USDC)分别查询,inverse 使用 BTC,summary 与 perp_risk 自动扫描三种结算币。参数支持 --account-type、--category(spot/linear/inverse/option)、--settle。linear 持仓查询需提供 settleCoin 或 symbol;高频成交建议按时间窗口分页。货币单位、具体接口限制及是否收费等资料暂未提供。