股票交易

通过 SnapTrade 在你绑定的券商账户里下达真实股票订单。

入口：Trade Modal（可从聊天卡片、资产详情页、自选行情或通知打开），以及 /account/snap-trade 下的券商账户视图。

---

1. 前置条件

下达股票订单前，你需要先通过 SnapTrade 把券商账户绑定到 Alphio。

完整流程（选择券商 → SnapTrade Portal → 授权 → 账户导入）见绑定券商。绑定完成后，账户余额和持仓会出现在券商账户页，Trade Modal 也会对股票启用。

---

2. 下单

进入股票下单的三个入口：

• 聊天卡片。 当 Alphio AI 返回股票卡片（例如你提问某个代码）时，卡片上的 Trade 按钮会打开预填该代码的 Trade Modal。
• 资产详情页。 在任意股票 / ETF / 港股详情页，Buy / Sell 按钮会针对当前代码打开 Trade Modal。
• 直接打开 Trade Modal。 从自选行情或通知里打开，并手动输入代码。

在弹窗内选择 Buy 或 Sell，订单类型（Market / Limit / Stop / Stop-Limit）、有效期（Day / GTC）以及数量（或金额）。表单会在订单提交至券商前先做本地校验。

---

3. 订单类型

Trade Modal 支持券商通过 SnapTrade 暴露的标准订单类型：Market、Limit、Stop、Stop-Limit，以及 Day / GTC 两种有效期。

完整的订单类型对照表（每种类型如何路由）安排在 Phase 2 的订单类型参考页（Phase 2）参考页。

---

4. 订单流程

股票订单走一个严格的 check → preview → submit → confirmation 流程，避免盲发：

1. Check（校验）。 Alphio 调 check-equity-order-impact，由券商验证订单 —— 购买力、是否支持碎股、是否开盘、代码有效性等。券商返回价格、费用和影响的估算。
2. Preview（预览）。 弹窗展示预估成交价、费用，以及对余额 / 持仓的影响。你确认无误。
3. Submit（提交）。 Alphio 用第 1 步返回的 trade ID 调 place-checked-order，券商接收订单并返回状态。
4. Confirmation（确认）。 弹窗显示订单状态（Pending、Filled、Rejected 等）。订单立即出现在 24 小时订单列表里。

如果 Check 步骤失败（例如购买力不足、所选代码当前休市），弹窗会展示券商返回的错误信息，订单不会被提交。

---

5. 撤单 / 改单

对于尚未完成的订单（状态非 Filled / Rejected / Cancelled），可从以下位置撤单：

• 券商账户页上的 24 小时订单列表
• 单笔订单的详情页

撤单会调 SnapTrade 的 cancel 接口给券商。券商接受撤销后，订单变为 Cancelled 状态。如果订单已部分成交，仅撤销未成交部分。

Alphio 不支持对已存在订单做修改（改价或改量）—— 请先撤掉旧单，再以新参数下一笔新单。

---

6. 订单历史

提供两类历史视图：

• 24 小时订单 —— 过去 24 小时的近端订单，展示在券商账户页，随券商状态更新实时刷新。
• 完整订单历史 —— 每个绑定账户的分页历史，在同一券商页面进入；支持向前翻页查看更早的成交。

每条订单都可点进详情页，查看完整下单参数、券商侧的状态流转事件，以及相关费用。