Add OKX tokenized stock API reachability analysis

quant/us-stock-trading-evaluation.md

@@ -117,6 +117,11 @@ TSM, TTWO, TWLO, TZ, UNH, USAR, VRT, WDC, XLE, ZM
 
 **重要观察**：OKX 代币化股票以美股大盘蓝筹为主，**完全没有中概 ADR**（BABA/JD/BIDU/NIO/LI 均无）——应是规避中美 ADR 退市风险的主动选择。包含主要 ETF（SPY/QQQ/IWM/SMH/SOXL/TQQQ/XLE）和 meme 股（GME/RDDT/HOOD）。
 
+#### 两条产品线的可达性区别（关键）
+
+- **97 只现货代币化股票（Unified Tokenized Stocks）**：走 OKX **现货 REST API**（`/api/v5/public/instruments?instType=SPOT`），instrument `state=live`、`instType=SPOT`。已实测 `XAAPL-USDT`：ticker 返回实时价（$308.87）、bid/ask 正常、`/api/v5/market/candles` 返回 1D OHLCV。**这是 freqtrade/CCXT 唯一可能够得着的代币化股票集合**。
+- **260+ CeDeFi 代币化股票**：在 **OKX DEX**（链上，经 OKX Wallet / Web3），由 Ondo Finance 发行。**不走标准现货 REST API**，CCXT 无覆盖。完整列表仅在 `app.ondo.finance`（JS 应用）可查，curl 抓不到。**freqtrade 完全够不着这 260+ 只**——要交易需 Web3 钱包 + 链上签名，与现有框架无关。
+
 ### 4.2 Binance（已核实：2026-06-01 重启美股）
 
 ⚠️ **修正早前结论**：Binance 已重启美股业务，分两条产品线：
@@ -136,7 +141,52 @@ TSM, TTWO, TWLO, TZ, UNH, USAR, VRT, WDC, XLE, ZM
 | 结算 | USDT/BNB（代币化）/ USD（直接） | USDT/USDC |
 | 费率 | 待登录核实 | 因 provider 而异 |
 
-### 4.3 代币化股票 vs 正规美股交易
+### 4.4 现有 API 能否直接交易 OKX 代币化美股（分析）
+
+#### 结论先行
+
+**不能"直接"交易。** 当前 Vultr 上跑的 freqtrade（OKX 永续合约、`trading_mode: futures`）无法直接下单 `XAAPL-USDT` 这类代币化股票。但 97 只现货代币化股票**在 API 传输层是可达的**，经"新建一个 spot 模式实例 + 重写策略"后可交易；260+ CeDeFi 则完全够不着。
+
+#### 实测：API 传输层可达（97 只现货）
+
+用 OKX 公共 REST API 直接探测 `XAAPL-USDT`：
+
+| 探测项 | 结果 | 含义 |
+|--------|------|------|
+| instrument 详情 | `state=live`, `instType=SPOT`, `baseCcy=XAAPL`, `quoteCcy=USDT`, `lever=10`, `minSz=0.01`, `tickSz=0.01`, `instCategory=3` | 合法现货标的，最小下单 0.01 股 |
+| ticker | `last=$308.87`, bid/ask 正常, `vol24h=510` 股, `volCcy24h=$157k` | 实时行情正常，有流动性 |
+| candles | 1D OHLCV 3 根返回正常 | 历史 K 线可下载 |
+| 交易时段字段 | `contTdSwTime`/`preMktSwTime` 存在 | **跟随美股时段**，非 24/7 |
+
+即 CCXT 调 `fetch_markets`/`fetch_ticker`/`fetch_ohlcv` 对 `XAAPL/USDT` 应当能拿到数据。传输层不是障碍。
+
+#### 但当前实例直接交易有 5 个硬障碍
+
+1. **模式不匹配（最大障碍）**：现 config `trading_mode: futures`（OKX USDT-M 永续）。代币化股票是 **SPOT**。一个 freqtrade 实例不能同时跑 futures + spot。**必须新建一个 spot 模式实例**（`trading_mode` 留空/spot，独立 config、独立 sqlite、独立策略）。
+2. **杠杆语义崩塌**：当前策略靠 `trade.leverage` 联动止损（`stoploss=-0.80` 在 10x 下 = 价格 -8%）。代币化股票**不能作保证金/抵押品**（OKX FAQ 明确），spot 模式 `trade.leverage` 恒为 1，`stoploss=-0.80` 会变成"价格跌 80% 才止损"——完全失效。**策略必须按 1x spot 重写止损数学**。
+3. **交易时段**：代币化股票跟随美股盘前/正常/盘后/夜间时段（见 `contTdSwTime`），非 7×24。freqtrade bot 循环 24/7 运转，休市时段下单会被拒。非硬阻塞（订单失败、下根 K 线重试），但 OHLCV 在休市时段有缺口，信号逻辑要会处理。
+4. **账户/地区限制**：代币化股票"may not be available in all regions"。现 OKX 账户用 `www.okx.cab`（国内加速域名），暗示是国内向账户——该账户能否交易 X 前缀代币化股票**未验证**。若 API key/账户被地区限制，下单会失败。**必须先用小额实测下单**确认。
+5. **CCXT 市场识别未测**：CCXT 的 OKX 适配器 `fetch_markets` 是否把 X 前缀代币化股票标为 `active=true/spot=true`、是否被特殊 category（`instCategory=3`）过滤，**未在不跑 CCXT 的情况下确认**。需在 spot 实例里跑一次 `exchange.markets` 看是否含 `XAAPL/USDT`。
+
+#### 260+ CeDeFi 完全够不着
+
+260+ CeDeFi 代币化股票在 **OKX DEX**（链上，经 OKX Wallet / Web3 签名），由 Ondo Finance 发行。**不走标准现货 REST API**，CCXT 无覆盖，freqtrade 无 OKX DEX 适配器。要交易需 Web3 钱包 + 链上签名，与现有 freqtrade 框架无关。完整列表仅在 `app.ondo.finance`（JS 应用）可查。
+
+#### 可行路径与工作量
+
+若决定用 freqtrade 交易 97 只现货代币化股票：
+
+| 工作 | 量级 |
+|------|------|
+| 新建 spot 模式 freqtrade 实例（独立 config + db + systemd） | 小，参照 `freqtrade-deploy-guide.md` |
+| 验证 CCXT/账户能交易 `XAAPL/USDT`（小额实单） | 小，关键卡点验证 |
+| 重写 `MultiAssetChannelBreakoutV5` 为 spot 版（去杠杆、止损数学改 1x、加交易时段感知） | 中，核心策略改造 |
+| 处理休市 OHLCV 缺口 + 下单被拒重试 | 中，逻辑细节 |
+| 选品（从 97 只里挑流动性好的） | 小 |
+
+**判定**：不是"直接能交易"，而是"API 通、但要新实例 + 策略重写"。如果只想快速验证 ATR 通道突破在美股价格上的效果，阻力最小的反而是 **OKX 代币化股票 + freqtrade spot 实例**（不用换券商/框架），代价是策略要改 spot 语义 + 失去 10x 杠杆放大。
+
+### 4.5 代币化股票 vs 正规美股交易
 
 | 维度 | 代币化股票(OKX/Binance) | 正规美股(IBKR/Schwab/Alpaca) |
 |------|------------------------|------------------------------|
@@ -148,7 +198,7 @@ TSM, TTWO, TWLO, TZ, UNH, USAR, VRT, WDC, XLE, ZM
 | 信用风险 | provider/发行方风险 | 券商/清算机构风险 |
 | 量化框架 | freqtrade 可直接交易(它是加密 token) | Nautilus/Lean/backtrader |
 
-### 4.4 对当前策略的意义
+### 4.6 对当前策略的意义
 
 `MultiAssetChannelBreakoutV5` 是纯价格驱动（ATR 通道 + ADX 动量），**理论上可跑在代币化股票价格上**，且 freqtrade 能直接交易（因为代币化股票本质是加密 token）。
 但实务上有显著问题：
@@ -169,13 +219,14 @@ TSM, TTWO, TWLO, TZ, UNH, USAR, VRT, WDC, XLE, ZM
 1. **若 Alpaca 支持中国大陆开户** → **Alpaca + backtrader**（最优）。API-first、$0 佣金、免费实时数据、backtrader 原生支持。卡点是开户资格，必须先查 `alpaca.markets/international` 的国家清单。
 2. **若要正规大券商 + 免佣金** → **Schwab 嘉信**（经香港国际账户）。$25k 入金门槛 + PDT 规则 + 框架生态薄（需自己用 Schwab API 写策略循环，或找支持 Schwab 的框架）。
 3. **若优先 API 成熟度 + 全球品种** → 沿用 **IBKR + Nautilus Trader**（官方适配器，今天仍在更新）。代价：收佣金、行情付费。
-4. **代币化股票**仅作短期价格投机备选（OKX + freqtrade 可直接跑，但流动性/信用风险大，不适合严肃策略）。
+4. **代币化股票（阻力最小的美股价格暴露）**：OKX 97 只现货代币化股票经现有 OKX API 即可达（已实测 `XAAPL` live + 行情 + K 线正常），但需新建 spot 模式 freqtrade 实例 + 把策略改写为 1x spot 语义（见 §4.4）。适合"只想快速验证 ATR 通道在美股价格上的效果"，代价是失去 10x 杠杆放大 + 信用/流动性风险。260+ CeDeFi 那批 freqtrade 够不着。
 
 ### 5.1 下一步行动项
 
 - [ ] 核实 Alpaca 国际支持国家清单是否含中国大陆（登录 `alpaca.markets/international` 选开户看 Country 下拉）
 - [ ] 核实 Schwab One International 当前最低入金（`schwab.com/international`）
-- [ ] 核实 Binance 是否重新上线代币化股票（登录 Binance 搜索 "stock" 分类）
+- [x] ~~核实 Binance 是否重新上线代币化股票~~ → **已核实**：2026-06-01 PR Newswire 官方，7000+ 直接美股交易 + bStocks 预览（见 §4.2）
+- [ ] 若走 OKX 代币化股票路线：①跑一次 CCXT `exchange.markets` 确认含 `XAAPL/USDT` 且 `active/spot` 标记正常 ②用现 OKX 账户小额实单测下单，确认账户无地区限制 ③下载 `XAAPL/USDT` 历史 K 线回测 ATR 通道突破
 - [ ] 选定方向后出具体接入方案：本地 IB Gateway/券商 API 怎么起、框架怎么装、策略从 freqtrade 风格迁移到目标框架风格、第一个回测怎么跑
 
 ---
@@ -184,8 +235,8 @@ TSM, TTWO, TWLO, TZ, UNH, USAR, VRT, WDC, XLE, ZM
 
 本文档核实情况（2026-08-23）：
 
-- **已联网核实**：freqtrade/CCXT 不含 Robinhood/Schwab/Alpaca（源码 grep）；Robinhood 开户需 SSN 不接受 ITN（官方支持文档）；Schwab 国际版 "$0 online equity trade commissions"（官方页面）；Alpaca 有国际支持 + 实时数据（官方页面）；Nautilus `ADAPTERS.md` 列 IBKR 为 Official；Lean.Brokerages.InteractiveBrokers 活跃；ib_insync 已 archived、ib_async 活跃；**OKX 260+ 代币化股票（okx.com 官方）+ 97 只现货代币化股票完整列表（OKX `/api/v5/public/instruments` 公共 API）**；**Binance 2026-06-01 重启美股（PR Newswire 官方新闻稿，7000+ 直接交易 + bStocks 预览）**。
+- **已联网核实**：freqtrade/CCXT 不含 Robinhood/Schwab/Alpaca（源码 grep）；Robinhood 开户需 SSN 不接受 ITN（官方支持文档）；Schwab 国际版 "$0 online equity trade commissions"（官方页面）；Alpaca 有国际支持 + 实时数据（官方页面）；Nautilus `ADAPTERS.md` 列 IBKR 为 Official；Lean.Brokerages.InteractiveBrokers 活跃；ib_insync 已 archived、ib_async 活跃；**OKX 260+ 代币化股票（okx.com 官方）+ 97 只现货代币化股票完整列表（OKX `/api/v5/public/instruments` 公共 API）+ `XAAPL-USDT` 可交易性实测（`state=live`、ticker $308.87、1D K 线正常）**；**Binance 2026-06-01 重启美股（PR Newswire 官方新闻稿，7000+ 直接交易 + bStocks 预览）**。
-- **基于知识/未完全核实**：Schwab $25k 最低入金、Alpaca 中国大陆资格、Binance 直接美股/bStocks 完整费率与标的清单（`binance.com` 被反爬挡，需登录账户核实）。这几项开户/决策前请在官网确认。
+- **基于知识/未完全核实**：Schwab $25k 最低入金、Alpaca 中国大陆资格、Binance 直接美股/bStocks 完整费率与标的清单（`binance.com` 被反爬挡，需登录账户核实）、现 OKX 账户（`okx.cab` 国内向）能否交易 X 前缀代币化股票（需小额实单验证）、CCXT 是否把 X 前缀标的标为 `active/spot`（需跑一次 `exchange.markets` 确认）。这几项开户/决策前请在官网或小额实单确认。
 
 ### 6.1 联网搜索工具失效说明