用途:这是基于 Webull 官方 Python SDK 的技能,让 AI 以自然语言与 Webull 交易平台交互,进行交易与行情查询。
主要能力: 交易:对股票/ETF、期权、期货、加密货币、事件合约执行下单、预览、改单、撤单;期权另支持策略下单。 行情:实时快照、历史 K 线、逐笔、报价与订单流;期权支持 option-snapshot、option-bars、option-tick(category 为 US_OPTION,支持美/港/日)。 账户:列出账户、查余额、查持仓。 标的与筛选:查询股票、加密、期货、期权、事件合约标的,获取公司资料、分析师评级与目标价;涨跌幅榜、成交活跃榜、板块、高股息、52周高低点等筛选器;财务报表、资金流、行业对比、财报/分红日历、预测 EPS、基金/ETF 数据;自选股增删查。
使用方式:安装后命令行入口为 webull-skill,含 trading、market-data、auth 三个模块,形式为 webull-skill [--env-file PATH] [--verbose-sdk-log] <module> --action <ACTION> [options]。首次使用需运行 webull-skill auth 完成交互式 2FA,SDK 最多等待 5 分钟在 Webull 手机应用中确认,令牌会缓存并自动刷新。下单建议使用 --order-file <path> 传入 JSON 文件,避免 --order-json 内联 JSON 在 Windows bash、PowerShell 及部分 macOS 终端下引号转义问题。
配置:需设置 WEBULL_APP_KEY、WEBULL_APP_SECRET,并用 WEBULL_REGION_ID 选择区域,WEBULL_ENVIRONMENT 默认 uat 沙盒、prod 为实盘。可通过 .env 或环境变量配置;.env 查找顺序为 $WEBULL_CONFIG_DIR/.env、项目根目录 .env、当前工作目录 .env。WEBULL_CONFIG_DIR 只能作为系统环境变量设置,写在 .env 内无效。还可配置订单金额/数量上限、符号白名单、令牌目录、审计日志与日志级别。
安全规则:所有改变订单的操作(place、replace、cancel、batch-place、algo-place、option-place、option-replace、option-strategy-place、futures-place、futures-replace、crypto-place、event-place、event-replace)执行前必须向用户展示动作类型、标的、方向、订单类型、数量、价格和账户,并请求明确确认后才继续;只读操作无需确认。
限制:不同区域功能差异明显,例如期权、期货、加密、事件合约、组合单、算法单、移动止损、碎股目前主要限于美国区域;港股仅支持美股期权;日本、新加坡、泰国、马来西亚、英国、墨西哥、巴西、欧盟、南非、澳大利亚等多仅支持美股/ETF 交易。各地区有不同 API 频率限制(如美国行情 600 次/分,香港行情 60 次/60 秒等)。工具输出仅供信息参考,不构成投资建议,交易有风险。