public-dot-com

📈 一站式证券账户智能管理

官方 Public.com 证券账户管理工具,支持股票/期权/加密货币的查询、报价、预演与交易执行,适合自动化投资工作流。

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

使用说明

Public.com Account Manager 综合评估

核心用法

本技能是 Public.com 官方开发的证券账户管理工具,通过 API 与用户的经纪账户交互,覆盖从信息查询到实际交易的完整投资工作流。用户需提供 PUBLIC_COM_SECRET API 密钥完成身份认证,可选配置默认账户 ID 简化后续操作。

功能矩阵:

| 类别 | 功能 | 说明 |
|------|------|------|
| 账户管理 | `get_accounts` / `set_default_account` | 查看账户列表、设置默认账户 |
| 持仓查询 | `get_portfolio` / `get_orders` / `get_history` | 实时持仓、活跃订单、交易历史(支持按类型筛选) |
| 行情数据 | `get_quotes` / `get_instruments` / `get_instrument` | 多资产实时报价、可交易标的查询、标的详情 |
| 期权工具 | `get_option_expirations` / `get_option_chain` / `get_option_greeks` | 到期日查询、期权链展示、希腊字母风险指标 |
| 交易执行 | `preflight` / `place_order` / `cancel_order` | 预演计算成本影响、下单(支持多种订单类型)、撤单 |

支持的资产类别: 股票(EQUITY)、期权(OPTION)、加密货币(CRYPTO),涵盖美股主流交易品种。

订单类型: 限价单(LIMIT)、市价单(MARKET)、止损单(STOP)、止损限价单(STOP_LIMIT),支持日间(DAY)和长期有效(GTC)指令,股票交易还可选择常规时段(CORE)或延长时段(EXTENDED)。

显著优点

1. 官方背书与合规性:由 Public.com 官方开发和维护,采用 Apache-2.0 开源协议,代码透明可查,符合美国 SEC 监管框架下的 API 接入规范。

2. 全功能交易闭环:从行情获取、风险分析(期权希腊字母)、成本预演到实际下单,形成完整的投资决策链条,特别适合量化策略和自动化交易场景。

3. 多资产统一接口:股票、期权、加密货币共享一致的命令格式和工作流,降低跨资产操作的认知成本。

4. 安全设计:API Secret 通过环境变量或安全配置存储,不硬编码于脚本;支持预演(preflight)机制,在执行真实交易前计算成本和购买力影响,避免误操作。

5. 灵活的订单表达:支持按数量(quantity)或金额(amount)下单,满足不同资金管理需求;期权交易明确区分开仓(OPEN)和平仓(CLOSE)。

潜在缺点与局限性

1. 地域与账户限制:仅支持 Public.com 账户持有者,该平台主要服务美国市场,国际用户受限。

2. 无实时行情保障:依赖 Public.com API 的数据延迟,高频交易场景可能不适用;未提及 Websocket 实时推送能力。

3. 期权复杂度门槛:期权希腊字母、OSI 符号格式(如 AAPL260116C00270000)对普通投资者学习成本较高,误操作风险较大。

4. 异步状态确认:下单和撤均为异步操作,需主动轮询查询状态,无法保证即时成交确认。

5. 无回测与模拟交易:仅提供单次预演计算,缺乏完整的策略回测和虚拟账户模拟环境。

适合人群

  • Public.com 现有用户:希望以编程方式管理账户、执行策略的散户投资者
  • 自动化交易者:需要批量下单、定时调仓、规则化再平衡的用户
  • 期权交易者:需要快速查询期权链、分析希腊字母风险的进阶投资者
  • 多资产管理者:同时持有股票、期权和加密货币,希望统一管理的用户

常规风险

| 风险类型 | 说明 | 缓解建议 |
|----------|------|----------|
| 交易执行风险 | 市价单在波动行情可能以不利价格成交 | 优先使用限价单,极端行情暂停交易 |
| API 密钥泄露 | `PUBLIC_COM_SECRET` 泄露可导致账户被恶意操作 | 使用专用环境变量,定期轮换密钥,勿提交至版本控制 |
| 误操作风险 | 脚本自动化可能放大人为错误 | 严格使用 preflight 预演,设置交易限额,启用账户级风控 |
| 流动性风险 | 小盘股、远月期权可能成交困难 | 关注成交量数据,避免大额市价单冲击 |
| 监管合规风险 | 自动化交易可能触发模式日内交易者(PDT)规则 | 了解账户类型限制,监控日内交易次数 |

> 免责声明:本技能仅供说明和信息参考,不构成投资建议或推荐。证券交易有风险,入市需谨慎。

安全解读

核心功能

Public.com Account Manager 是一款由知名互联网券商 Public.com 官方开发的 API 集成工具,允许用户通过命令行方式直接操作其证券账户。该 skill 完整覆盖了投资账户管理的核心场景:账户信息查询(get_accounts)、持仓组合查看(get_portfolio)、订单管理(get_orders/place_order/cancel_order)、行情获取(get_quotes/get_instruments)以及期权链分析(get_option_chain/get_option_greeks/get_option_expirations)。特别值得一提的是其预检计算功能(preflight),可在实际下单前估算交易成本与购买力影响,降低误操作风险。

显著优点

1. 官方 T1 级可信来源:由 Public.com 直接维护,非第三方封装,API 调用路径透明可控
2. 全资产类别覆盖:支持股票(含碎股)、期权、加密货币三类主流交易品种

3. 专业期权工具链:完整的期权到期日查询、期权链展示、希腊字母计算功能,适合期权策略交易者

4. 安全架构规范:API 密钥通过环境变量 PUBLIC_COM_SECRET 读取,符合金融级凭证管理标准;所有网络流量仅访问 api.public.com 官方端点,无第三方数据上报

5. 防御性编程实践:代码中对 API 响应字段进行 hasattr() 存在性检查,避免空指针异常

潜在局限与风险

1. 资金操作不可逆性place_order.py 直接对接真实交易账户,误操作可能导致实际资金损失
2. 依赖自动安装机制:使用 subprocess.check_call 自动安装 publicdotcom-py SDK,虽为官方包,但存在供应链攻击的理论风险

3. 无内置风控限制:代码层面对订单金额、交易频率无硬限制,完全依赖用户自律与 Public.com 账户层面的风控

4. 美国市场局限:Public.com 主要服务美国市场,非美用户可能受开户限制

适合人群

  • 需要批量查询持仓、自动化交易记录的量化爱好者
  • 希望用代码管理期权策略的进阶投资者
  • 追求操作效率、厌恶反复切换 App 的活跃交易者
  • 具备基本 Python/命令行使用经验的用户

常规风险提示

金融交易存在固有风险,本工具仅提供技术执行能力,不构成投资建议。期权交易尤其涉及高杠杆与归零风险。使用前请确保充分理解 Public.com 的费率结构、交易规则及税务影响。建议首次使用先在模拟环境或极小仓位验证流程。

public-dot-com 内容

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