官方 Public.com 券商 API 封装,支持股票/期权/加密货币交易、实时报价、希腊值分析与组合管理。T1 级信源,需注意金融交易固有风险。
说明:
## 核心用法
Public.com Account Manager 是 Public.com 官方提供的券商账户管理工具,通过 API 实现完整的交易生命周期管理:
**1. 账户与资产查询**
– `get_accounts` / `get_portfolio`:查看账户列表、持仓组合、购买力与资产净值
– `get_history`:获取交易记录、资金流水(支持 TRADE/MONEY_MOVEMENT/POSITION_ADJUSTMENT 类型过滤)
– `get_orders`:追踪活跃订单与挂单状态
**2. 市场数据获取**
– `get_quotes`:支持股票(EQUITY)、加密货币(CRYPTO)、期权(OPTION)实时报价,可批量查询
– `get_instruments`:筛选可交易标的,支持交易状态过滤(BUY_AND_SELL/BUY_ONLY/SELL_ONLY)
– `get_instrument`:获取单只证券的详细交易属性(碎股交易、期权交易权限等)
**3. 期权专业工具**
– `get_option_expirations`:列示标的的所有到期日
– `get_option_chain`:获取完整期权链(含买卖报价、成交量、持仓量)
– `get_option_greeks`:计算 Delta、Gamma、Theta、Vega、Rho 及隐含波动率,需使用 OSI 标准期权代码
**4. 交易执行**
– `preflight`:订单预检,估算成本、手续费与购买力影响,支持按金额或数量下单
– `place_order`:支持限价/市价/止损/止损限价单,股票可设盘后交易(EXTENDED),期权支持 OPEN/CLOSE 标记
– `cancel_order`:异步撤单,需后续查询确认状态
—
## 显著优点
| 维度 | 评估 |
|——|——|
| **信源权威性** | Public.com 为美国 SEC 注册券商,FINRA/SIPC 成员,T1 级可信来源 |
| **功能完整性** | 覆盖现货与衍生品全品类,期权希腊值计算为专业级功能 |
| **风控设计** | 强制 `preflight` 预检机制,防止误操作;GTC/DAY 时间指令灵活 |
| **用户体验** | 支持 `amount` 按金额下单(适合定投场景),自动安装 SDK 降低门槛 |
| **合规透明** | Apache-2.0 开源协议,明确免责声明,不涉及投资建议 |
—
## 潜在缺点与局限性
| 风险点 | 说明 |
|——–|——|
| **地域限制** | Public.com 仅对美国居民开放,非美国用户无法开户使用 |
| **API 依赖** | 需手动申请 API Secret,环境变量配置对新手有学习成本 |
| **实时性差距** | 行情数据可能存在延迟,高频交易场景不适用 |
| **期权复杂度** | OSI 期权代码构造门槛高(如 `AAPL260116C00270000`),易因格式错误导致失败 |
| **异步确认** | 下单/撤单均为异步处理,需主动轮询 `get_orders` 确认最终状态 |
| **无策略回测** | 仅支持实盘操作,无模拟交易或历史回测功能 |
—
## 适合人群
– ? 已持有 Public.com 账户的美国个人投资者
– ? 需要自动化监控持仓与执行定期调仓的被动投资者
– ? 期权卖方/价差交易者(依赖希腊值风控)
– ? 多资产类别配置者(股票+加密+期权统一管理)
—
## 常规风险
1. **资金安全风险**:API Secret 泄露可能导致账户被恶意操作,需妥善保管环境变量
2. **市场风险**:市价单在波动剧烈时可能产生滑点,止损单不保证成交价格
3. **操作风险**:`side`/`open-close` 参数错误可能导致反向开仓或误平仓
4. **合规风险**:期权交易风险极高,不适合无经验投资者;加密货币受监管政策影响大
5. **技术风险**:脚本依赖 `publicdotcom-py` SDK,版本兼容性需关注









