public-dot-com

核心功能

Public.com Account Manager 是一款面向投资者的专业金融交易技能，通过与 Public.com 经纪商官方 API 深度集成，为用户提供全面的账户管理与交易能力。核心功能涵盖：账户信息查询（持仓组合、资金状况、订单历史）、实时市场行情（股票、加密货币、期权报价）、交易执行（市价/限价/止损单，支持美股正股、加密货币及期权）、期权分析工具（希腊字母计算、期权链查询、到期日管理）。

显著优点

官方直连，数据权威：由 Public.com 官方开发维护，直接对接券商核心交易系统，行情与执行无延迟，数据来源可信度极高。功能全面，覆盖多元资产：支持 EQUITY（股票）、CRYPTO（加密货币）、OPTION（期权）三大资产类别，满足多样化投资需求。专业级期权工具：内置期权希腊字母计算（Delta、Gamma、Theta、Vega、Rho）、期权链可视化、到期日筛选，适合进阶期权交易者。灵活配置：支持默认账户绑定，减少重复输入；环境变量安全存储 API 密钥。自动化依赖管理：SDK 首次运行时自动安装，降低部署门槛。

潜在局限

地域限制：Public.com 为美国持牌券商，服务主要面向美国市场用户，非美国居民可能无法开户使用。市场范围有限：仅支持 Public.com 平台可交易的标的，无法对接其他交易所或券商。无高级风控功能：缺乏自动化止损、组合保证金计算、风险价值（VaR）评估等 institutional 级风险管理工具。依赖外部 SDK：publicdotcom-py 的稳定性直接影响技能可用性，版本更新可能导致兼容性问题。

适合人群

• 美股活跃交易者：需要快速执行交易、管理多资产持仓的个人投资者
• 期权策略玩家：依赖希腊字母分析、期权链筛选进行波动率交易的用户
• 量化入门爱好者：希望通过 API 程序化获取行情、执行基础自动化交易
• 多平台整合需求者：希望在统一界面（如 AI 助手）中管理 Public.com 账户

常规风险提示

资金安全风险：API 密钥（PUBLIC_COM_SECRET）具备交易权限，泄露可能导致账户被盗用，建议严格限制密钥权限并定期轮换。交易执行风险：市价单在极端行情下可能以不利价格成交；止损单在价格跳空时可能无法按设定价触发。市场波动风险：加密货币 24 小时交易且波动剧烈，期权存在时间价值衰减及杠杆风险。合规与税务责任：用户需自行了解并承担交易相关的资本利得税、洗售规则（Wash Sale）等合规义务，技能不提供税务建议。

核心用法

Public.com Account Manager 是持牌券商 Public.com 官方开发的账户管理 Skill，通过官方 Python SDK 与 brokerage API 交互。核心功能覆盖完整投资链路：账户查询（get_accounts）、持仓组合查看（get_portfolio）、实时行情获取（get_quotes，支持股票/加密货币/期权）、可交易标的筛选（get_instruments）、期权链分析（get_option_chain/get_option_expirations/get_option_greeks），以及完整的交易生命周期管理（place_order/cancel_order/get_orders）。用户需配置 PUBLIC_COM_SECRET 环境变量进行身份认证，可选设置 PUBLIC_COM_ACCOUNT_ID 作为默认账户。

显著优点

官方背书与合规保障：由持牌金融机构 Public.com 直接开发维护，API 端点受限为官方域名，符合金融监管要求。功能深度专业：原生支持期权 Greeks（Delta/Gamma/Theta/Vega/Rho/IV）计算、OSI 标准期权符号解析、多类型订单（LIMIT/MARKET/STOP/STOP_LIMIT）及盘后交易（EXTENDED session）。凭证管理规范：强制从环境变量读取 API Secret，无硬编码密钥风险，传输采用 TLS 1.2+ 加密。体验优化设计：SDK 自动安装降低门槛，默认账户配置减少重复参数输入，丰富的命令别名覆盖自然语言查询场景。

潜在缺点与局限性

平台锁定：仅支持 Public.com 单一券商，无法跨平台管理其他经纪账户。地域限制：Public.com 主要服务美国市场，国际用户可能受开户资格限制。期权复杂度：期权 Greeks 和 OSI 符号需要专业知识，新手用户存在学习曲线。异步状态延迟：订单提交和取消均为异步操作，状态更新非实时，需主动轮询确认。subprocess 依赖安装：运行时自动安装依赖虽便利，但存在理论供应链攻击面（RISK-001，已评估为 low 风险）。

适合人群

活跃美股/加密货币交易者、期权策略投资者、需要程序化查询持仓与订单的状态监控者，以及希望在一个界面内完成行情查看→分析→下单完整流程的效率型用户。不适合需要跨券商聚合管理、或完全不具备基础金融知识的初学者。

常规风险

市场风险：Skill 本身不提供投资建议，所有交易指令直接对接真实资金账户，用户需自行承担市场波动损失。操作风险：订单参数（symbol/quantity/order-type）需人工确认，错误输入可能导致非预期交易。认证安全：API Secret 泄露将导致账户完全控制权限丢失，需严格保护环境变量访问权限。合规提示：EXTENDED 时段交易、期权等衍生品操作可能涉及额外监管风险披露要求。