public-dot-com

核心功能

Public.com Account Manager 是由 Public.com 官方维护的金融交易类技能，提供与 Public.com 经纪账户的完整 API 交互能力。核心功能涵盖：账户管理（查看账户列表、设置默认账户）、投资组合监控（持仓查询、资金购买力）、市场数据获取（股票/加密货币/期权实时报价、期权链查询、希腊字母计算）、交易执行（限价/市价/止损单、支持股票/加密货币/期权三类资产）、订单管理（下单前成本预估、订单取消、历史成交查询）以及期权策略自动化（内置 35+ 种期权策略库）。

显著优点

1. 官方背书与合规性：由 Public.com 官方开发并维护（Apache-2.0 协议），API 直连券商底层系统，数据来源权威可靠
2. 资产类别全覆盖：同时支持股票（含碎股）、加密货币、期权三类资产，满足多元化投资需求
3. 期权专业工具链：提供完整的期权分析工具——到期日查询、期权链展示、希腊字母（Delta/Gamma/Theta/Vega/Rho）计算，以及 35+ 种策略的自动化工作流指南
4. 风控前置机制：preflight.py 预检脚本可在实际下单前精确计算成本、资金影响及手续费，避免意外透支
5. 灵活的身份认证：支持环境变量与加密文件双模式存储 API 密钥，符合金融场景的安全合规要求

潜在局限与风险

1. 市场风险：直接交易功能意味着用户可能因市场波动遭受本金损失，技能明确标注「仅供参考，不构成投资建议」
2. API 依赖性：所有功能依赖 Public.com API 可用性，服务中断时将无法执行任何操作
3. 期权复杂性：期权交易涉及时间价值衰减、波动率风险等非线性因素，策略库虽详尽但执行仍需用户自主判断
4. 异步执行特性：下单/撤单为异步处理，用户需主动查询确认最终状态，存在状态同步延迟
5. 地域限制：Public.com 服务受美国金融监管，非美国居民可能无法开户使用

适合人群

• 已拥有 Public.com 账户的美国投资者
• 需要自动化交易工作流的量化交易者
• 期权策略研究者（尤其是希望实践 Iron Condor、Calendar Spread 等复杂结构的进阶用户）
• 希望统一管理股票、加密货币、期权持仓的多资产投资者

常规风险提醒

• 资金安全：API 密钥需严格保密，建议使用 ~/.openclaw/workspace/.secrets/ 加密存储而非环境变量
• 测试先行：官方强烈建议先在新账户或隔离环境中测试集成
• 权限管控：API 密钥默认具备交易权限，泄露可能导致未授权交易
• 合规边界：技能本身不提供投资建议，所有交易决策由用户独立承担

核心用法

Public.com Account Manager 是一款面向美股投资者的官方 CLI 工具集，通过调用 Public.com API 实现全功能账户管理。用户配置 PUBLIC_COM_SECRET 后即可执行：账户信息查询（get_accounts.py）、投资组合查看（get_portfolio.py）、多资产类型行情获取（get_quotes.py 支持股票、加密货币、期权）、历史交易记录导出（get_history.py 按 TRADE/MONEY_MOVEMENT/POSITION_ADJUSTMENT 分类）。

交易功能是核心亮点：支持限价/市价/止损/止损限价四种订单类型，覆盖股票、期权、加密货币三大资产，可通过 --amount 参数实现美元金额下单而非仅股数。期权模块尤为专业，提供到期日查询（get_option_expirations.py）、期权链获取（get_option_chain.py）、希腊字母计算（get_option_greeks.py）及 35+ 种策略指南（options-automation-library.md）。preflight.py 预检功能可在下单前模拟计算成本与购买力影响，降低误操作风险。

显著优点

1. 官方背书，可信度高：Public.com 是受 SEC/FINRA 监管的持牌券商，GitHub 官方组织维护，Apache-2.0 开源，代码透明可审计。
2. 资产覆盖全面：股票、加密货币、期权三线并行，期权支持多腿策略与希腊字母分析，满足进阶投资者需求。
3. 安全设计到位：凭证优先存储于 ~/.openclaw/workspace/.secrets/ 隔离路径，支持文件与环境变量双模式；TLS 加密传输，无第三方数据外泄。
4. 自动化友好：纯 Python CLI 设计，可无缝嵌入量化工作流或 CI/CD 自动化策略执行。

潜在缺点与局限性

1. 仅支持单一券商：绑定 Public.com 账户，无法跨券商管理资产，用户迁移成本较高。
2. 无模拟交易环境：虽有预检功能，但所有下单均连接真实账户，新手缺乏零风险演练空间。
3. 期权 OSI 符号门槛：期权合约需手动构造 AAPL260116C00270000 格式符号，对非专业用户不够直观。
4. 依赖运行时安装：首次使用可能自动触发 pip install，在严格受限环境中可能失败。

适合人群

• 活跃交易者：需快速查询持仓、执行条件单或监控订单状态
• 期权策略玩家：依赖希腊字母、期权链数据构建价差、铁鹰等复杂策略
• 量化开发者：希望将 Public.com 作为程序化交易接口，整合至自有交易系统
• 多资产投资者：同时持有美股、加密货币，需统一视图管理

常规风险

1. 资金损失风险： Skill 直接操控真实资金，API 配置错误或参数误填可能导致非预期交易；建议首次使用单独开设小额测试账户。
2. API 凭证泄露：PUBLIC_COM_SECRET 拥有交易权限，一旦泄露可被恶意下单；务必使用文件模式存储并限制文件权限（chmod 600）。
3. 市场流动性风险：preflight.py 仅计算理论成本，无法保证限价单成交，极端行情下可能面临滑点或无法成交。
4. 依赖供应链风险：publicdotcom-py SDK 若出现破坏性更新或 PyPI 投毒，可能影响功能或安全；建议锁定版本并校验哈希。