# Alpaca IEX 实盘行情接入与公开门户验收记录

验收时间：2026-08-02 12:30（Asia/Shanghai）

## 结果

Hunter Quant 已接入 Alpaca 免费 Paper/Market Data 密钥。密钥只以 Cloudflare Worker 加密 Secret 保存；源码、Git、门户、成果档案和本文件都不包含密钥值。Cloudflare 只可见两个 Secret 名称：`ALPACA_API_KEY_ID`、`ALPACA_API_SECRET_KEY`。

公开接口与 Netlify 门户均返回：

| 字段 | 验收值 |
|---|---|
| 模型 | `market-price-8765-v1` |
| 模式 | `live-market-paper` |
| 行情提供方 | Alpaca |
| 免费行情源 | IEX（不是全美 SIP） |
| 行情时间 | 2026-07-31T20:55:00Z |
| SPY | 746.79 USD |
| QQQ | 686.13 USD |
| GLD | 371.47 USD |
| 账户权益 / 现金 | 100,000 USD / 100,000 USD |
| 持仓 / 成交 | 0 / 0 |
| 状态 | `market-closed-or-stale` |
| 可交易 | `false` |

验收当天为周末，因此“真实的最后一根 IEX 行情可见，但禁止交易”是预期行为。策略只在三个标的行情齐全、最旧行情不超过 120 秒且处于 America/New_York 09:30–16:00 常规交易时段时运行。

## 同步与故障边界

- Cloudflare Durable Object 每秒维护账户心跳。
- 门户每秒通过 HTTP 拉取公开状态；WebSocket 仅作为可用时的加速通道，不再影响“已连接”判断。
- 行情 API 每 5 秒轮询一次；策略只在新的 1 分钟柱上计算，同一分钟同一标的不重复处理。
- 无密钥、行情过期、休市、IEX/网络故障时禁止交易，不使用合成价回退。
- 所有成交都是 Hunter Quant 内部模拟撮合，不会向 Alpaca Paper 或 Live 订单接口发送订单。

公开入口：https://seekingquant.netlify.app/terminal

Cloudflare 源站：https://hunter.quant01.workers.dev/api/simulation/live

Alpaca 官方说明：https://docs.alpaca.markets/us/docs/getting-started-with-alpaca-market-data