public-dot-com

📈 一站式美股期权加密交易终端

官方 Public.com 券商 API 封装,支持股票/期权/加密货币交易、实时报价、希腊值分析与组合管理。T1 级信源,需注意金融交易固有风险。

收藏
9.1k
安装
2.5k
版本
1.0.3
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

核心用法

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,版本兼容性需关注

安全解读

核心功能

Public.com Account Manager 是由知名互联网券商 Public.com 官方发布的金融交易 Skill,为用户提供完整的经纪账户管理能力。支持查看投资组合、获取实时行情、查询订单历史、执行股票/期权/加密货币交易等核心功能。

显著优势

官方权威与可信来源:由 Public.com(美国持牌券商)直接开发与维护,属于 T1 级可信来源。代码经过专业安全审计,无恶意行为特征,网络通信仅与官方 API 交互。

功能全面且专业:覆盖主流投资品种——股票(含碎股)、期权(含希腊值分析、到期日查询、期权链展示)、加密货币;支持多种订单类型(限价、市价、止损、止损限价)及时间条件(日内单、长期有效单)。

安全架构严谨:API 密钥采用环境变量或专用安全文件存储,不硬编码;凭证访问遵循最小权限原则;全链路 TLS 1.2+ 加密传输;无第三方数据共享风险。

交易体验优化:提供预计算(Preflight)功能,可在正式下单前估算成本、检查购买力影响,降低误操作风险;支持默认账户设置,简化多账户用户的操作流程。

潜在局限

依赖自动安装机制:首次运行时会通过 subprocess 自动安装 publicdotcom-py SDK,虽为官方包且无代码注入风险,但部分安全敏感用户可能更倾向手动安装。

市场覆盖限制:仅支持 Public.com 平台可交易的标的,对于未上架的海外市场或小众资产无法覆盖。

实时性依赖 API:行情与账户数据完全依赖 Public.com API,极端市场情况下可能存在延迟。

适用人群

  • 活跃投资者:需要频繁查看持仓、执行交易的用户
  • 期权交易者:依赖希腊值分析、期权链筛选的专业玩家
  • 多资产配置者:同时持有股票、加密货币的多元化投资者
  • 自动化需求用户:希望通过 CLI/脚本化方式管理账户的技术型投资者

风险提示

资金安全风险:该 Skill 直接操作真实交易账户,下单、撤单指令将即时影响账户资金与持仓。请务必在确认交易参数(代码、方向、价格、数量)无误后执行

投资风险:金融市场波动可能导致投资损失,Skill 提供的行情与分析工具不构成投资建议。

技术风险:API 密钥泄露可能导致账户被恶意操作,请妥善保管 PUBLIC_COM_SECRET

public-dot-com 内容

scripts文件夹
手动下载zip · 26.5 kB
cancel_order.pytext/plain
请选择文件