@dshtrading/connector-ccxt 0.6.1 → 0.6.3

package/README.md

@@ -1,34 +1,322 @@
-# @dshtrading/connector-template
+# @dshtrading/connector-ccxt
 
-**本包是脚手架源，不是可安装的连接器**：不入任何 bundle 依赖，仅在 `pnpm -r build/test`
-基线内保证可编译、冒烟测试绿。真实接入用生成器：
+加密现货连接器（crypto 市场），沿用 CCXT 的交易所词汇做**九所免密行情**
+（binance / okx / bybit / gateio / kucoin / kraken / coinbase / bitfinex / htx 九条直连分支）：
+实现 `@dshtrading/api` 的 `MarketDataService`，行情快照与 K 线都按所切换；七条需要形态变换的
+分支各有自己的 quote 资产表，K 线周期按所映射（该所不支持的周期结构化拒绝）。
+所名登记面 = 实现面：九个所名各有自己的请求符号形态、行结构与周期词汇；未登记 slug / 该所表外的
+计价币 / 该所不支持的周期都在任何请求之前结构化拒绝，不静默落 Binance 兜底。
+本包**不依赖也不打包 `ccxt` 库**，也没有合约（永续/交割）面——`-SWAP` 入参显式拒绝。
+交易面保留服务缝三态闸门与私有账户读面的失败关闭语义，**私有账户面与真实下单均未实现**。
 
-```sh
-node scripts/new-connector.mjs --slug bybit --title Bybit --market crypto
-```
+## 状态
+
+**九所 ticker 与 binance K 线均有真实网络原始响应证据**（2026-10-15 一轮，含出口说明与可复跑探针）：
+原始响应与出口记录见 [impl-ccxt-exchange-expansion/EVIDENCE.md](../../spikes/impl-ccxt-exchange-expansion/EVIDENCE.md)。
+
+- **2026-10-15 九所取证（本轮）**：默认出口（美国节点 `216.195.208.136`）直连可达
+  gateio / kucoin / kraken / coinbase / bitfinex / htx / okx 七所（各落一份 200 原始响应，字节保真）；
+  binance / bybit 在默认出口仍是 **451 / 403**（阻断原始响应入档），改在**可达出口**取 200
+  原始响应（mihomo 规则组切 SG，出口 `188.253.121.148`，窗口结束已还原并用 `api.ipify.org` 复核）。
+  连接器级实跑（九所真实取价 + binance K 线 + 三条零请求负例）见同目录 `run-probe.ts` 与
+  `EVIDENCE.md` 的「Phase 2」一节：**退出码 0、18/18 判据通过**（`probe-summary.json` 记 HEAD sha
+  与两个源文件的内容指纹）。探针记录了一条过程事实：只读 mihomo selector 不足以证明出口已还原
+  （keep-alive 会复用窗口期连接），必须实测出口 IP。
+- **2026-10-15 quote 按所维护 + K 线按所切换（本卡）**：七条形态变换分支各有一份 quote 资产表
+  （数据来源 = 该所公开挂牌端点普查，原始响应 `census-*.json`），K 线从单分支扩到九所、周期按所映射。
+  探针扩到九所 ticker（含每所一条非 USDT 对）+ 七所 quote 普查对照 + 九所 K 线（每所两档周期，
+  请求 URL 逐字比对）+ 逐所「不支持周期」与「表外计价币」零请求负例：**退出码 0、判据 63/63 PASS**。
+  原始响应与出口说明见
+  [EVIDENCE-2026-10-15-quote-census-and-klines.md](../../spikes/impl-ccxt-exchange-expansion/EVIDENCE-2026-10-15-quote-census-and-klines.md)。
+- **2026-08-31 评审随测**（对象 commit `b80000e`，九所补齐之前的历史记录）：ccxt binance ticker
+  `BTCUSDT` 77767.66（第 8 项）、ccxt 切 bybit 所的 klines `ETHUSDT` 5m 8 根 close 2420.08（第 9 项）——
+  两项均为真实网络调用、无 stub。证据
+  [verify-connectors-suite/EVIDENCE.md](../../spikes/verify-connectors-suite/EVIDENCE.md)。
+  注意第 9 项（bybit 切所那次）走的是 **Binance 端点**：当时 `getKlines` 忽略 `exchange` 形参。
+  该假形参已在 2026-10-15 撤掉，同日又按「K 线真按所取」重开——现在 `exchange` 是**连接器自有形参**
+  （客户端方法与 `crypto_get_klines` 工具），服务契约 `MarketDataService.getKlines` 仍无该形参
+  （见「周期与契约」与「已知边界」第 2 条）。
+  该 spike 目录只提交了 EVIDENCE.md，随测脚本未入仓（`git ls-files spikes/verify-connectors-suite`
+  只有一份 EVIDENCE.md）；本节其余证据都带可复跑脚本。
+- **2026-10-08 的出口结论仍是端点级的**（[reverify 记录](../../spikes/impl-crypto-perp-tradfi/EVIDENCE-reverify-2026-10-08.md)
+  第 1/2 节）：那次没有在本包上跑；本轮已在本包上复现同样的阻断事实（见上一条与「已知边界」第 8 条）。
+- **未实现**（不是未实证）：私有账户读面的实际读实现（读方法失败关闭，见「已知边界」第 5 条）
+  与真实下单；登记面之外的 slug（如 `bitstamp`）没有直连分支。逐条见「已知边界」。
+- **九所登记面 = 实现面**（2026-10-15）：`SUPPORTED_EXCHANGES` 与 `KLINE_EXCHANGES` 都登记九条
+  直连分支（ticker 与 K 线同集、各自独立登记）。同日早先那一轮曾把登记面收窄到三所并撤掉 K 线的
+  `exchange` 形参；当日先补齐六所 ticker 分支，本卡再把 K 线按所切换并恢复连接器自有形参。
+  登记面之外的 slug 在**任何 fetch 之前**抛 `TRADING_NOT_IMPLEMENTED`（点名所名、列出实现面、
+  零网络请求），回归 `test/exchange-registry-fail-closed.test.ts`。
+
+## 配置
+
+| 字段 | 默认 | 说明 |
+|---|---|---|
+| `enabled` | `true` | 是否激活本连接器；`false` 时 `apply` 立即返回 |
+| `dryRun` | `true` | 强制模拟下单：为 `true` 时即使 `liveTrading=true` 且请求 `dryRun=false`，也只回本地模拟回执 |
+| `liveTrading` | `false` | 实盘开关的**非权威镜像**；真正授权由 `@dshtrading/authority` 的人工签署平面裁定 |
+| `defaultExchange` | `'binance'` | 首选所名（schema 是开放 `string`：任何 slug 都能填，解析期不收窄）；传给 REST 客户端作为默认 `exchange`。九所的 ticker 与 K 线都有直连分支（客户端两个方法都缺省用它；两个工具各自带 `exchange` 形参、缺省 `binance`）；未登记 slug 与「该所不支持的周期」都在请求前结构化拒绝 |
+
+依据：`src/index.ts:42-51`（schema 与默认值）、`src/index.ts:189-190`（只把 `defaultExchange`
+传给客户端）。**本包没有凭证字段**——`Config` 里没有 key/secret ref，
+`apply` 也不读任何环境变量；所有请求都是免密公共端点。
+设置页也不再挂 `CCXT_API_KEY` / `CCXT_API_SECRET` 占位（2026-10-15 撤：面板写进
+`dshtrading.credentials.ccxt` 的键无人读，见「已知边界」第 6 条）。
+
+## 接线
+
+- **数据面行**：`packages/crypto/cordis.patch.yml:36-38` → 行 id `dsh-trading-crypto-dataplane-ccxt`，
+  模块 `@dshtrading/connector-ccxt/dataplane`。该入口只把 `(crypto, ccxt)` 注册进
+  `tradingMarketDataRegistry`（`src/dataplane.ts:36`），**既不注册交易面也不注册工具**。
+- **preset 行**：`packages/crypto/assets/preset/crypto-trader/agent.cordis.yml:79-90` → isolate 组
+  id `dsh-trading-crypto-connector-ccxt-group`（isolate `tradingCryptoMarketData` 与
+  `tradingCryptoTrade`），内层行 id `dsh-trading-crypto-connector-ccxt`（第 86-87 行），
+  行内只写 `enabled: true` / `dryRun: true` / `liveTrading: false`。
+  交易服务只在 preset 主入口构造（`src/index.ts:190`），**不经 `tradingTradeRegistry`**。
+- **服务键**：`tradingCryptoMarketData`（`src/index.ts:53`）、`tradingCryptoTrade`（`src/index.ts:54`）。
+- **provider 词汇**：`packages/router/src/index.ts:66` 登记 `ccxt`。
+- **设置页显示名**：`packages/client-ui-settings/src/client/trading-settings-controller.ts:46`
+  （`PROVIDER_LABELS` 的 `ccxt` 条目：`type: 'public'`、无 `env`、无凭据字段）与
+  `packages/client-ui-settings/src/client/locales.ts` 的 `'provider.ccxt'` 条目
+  （zh `CCXT (9 所直连：Binance/OKX/Bybit/Gate/KuCoin/Kraken/Coinbase/Bitfinex/HTX)` / en
+  `CCXT (9 direct venues: Binance / OKX / Bybit / Gate / KuCoin / Kraken / Coinbase / Bitfinex / HTX)`，
+  2026-10-15 随九所补齐同步），与本包登记的实现面一致。
+- **profile overrides**：`node scripts/sync-profile-overrides.mjs --all --dsh-home ~/.dsh-trading`
+  （注意 `--dsh-home`；宿主会话继承的 `DSH_HOME` 指向别处会找错 profile 集）。
+
+用户切换：设置 → 数据源 → crypto → CCXT。
+
+## 上游端点
+
+| 用途 | 端点 | 源码行 |
+|---|---|---|
+| 快照（`exchange=binance`） | `GET https://api.binance.com/api/v3/ticker/24hr?symbol=` | `src/rest.ts:519` |
+| 快照（`exchange=okx`） | `GET https://www.okx.com/api/v5/market/ticker?instId=` | `src/rest.ts:419` |
+| 快照（`exchange=bybit`） | `GET https://api.bybit.com/v5/market/tickers?category=spot&symbol=` | `src/rest.ts:403` |
+| 快照（`exchange=gateio`） | `GET https://api.gateio.ws/api/v4/spot/tickers?currency_pair=` | `src/rest.ts:437` |
+| 快照（`exchange=kucoin`） | `GET https://api.kucoin.com/api/v1/market/stats?symbol=` | `src/rest.ts:448` |
+| 快照（`exchange=kraken`） | `GET https://api.kraken.com/0/public/Ticker?pair=` | `src/rest.ts:463` |
+| 快照（`exchange=coinbase`） | `GET https://api.exchange.coinbase.com/products/{pair}/ticker` | `src/rest.ts:476` |
+| 快照（`exchange=bitfinex`） | `GET https://api-pub.bitfinex.com/v2/ticker/{tPAIR}` | `src/rest.ts:488` |
+| 快照（`exchange=htx`） | `GET https://api.htx.com/market/detail/merged?symbol=` | `src/rest.ts:503` |
+| K 线（`exchange=binance`） | `GET https://api.binance.com/api/v3/klines?symbol=&interval=&limit=` | `src/rest.ts:553` |
+| K 线（`exchange=okx`） | `GET https://www.okx.com/api/v5/market/candles?instId=&bar=&limit=` | `src/rest.ts:576` |
+| K 线（`exchange=bybit`） | `GET https://api.bybit.com/v5/market/kline?category=spot&symbol=&interval=&limit=` | `src/rest.ts:563` |
+| K 线（`exchange=gateio`） | `GET https://api.gateio.ws/api/v4/spot/candlesticks?currency_pair=&interval=&limit=` | `src/rest.ts:589` |
+| K 线（`exchange=kucoin`） | `GET https://api.kucoin.com/api/v1/market/candles?symbol=&type=` | `src/rest.ts:602` |
+| K 线（`exchange=kraken`） | `GET https://api.kraken.com/0/public/OHLC?pair=&interval=` | `src/rest.ts:616` |
+| K 线（`exchange=coinbase`） | `GET https://api.exchange.coinbase.com/products/{pair}/candles?granularity=` | `src/rest.ts:632` |
+| K 线（`exchange=bitfinex`） | `GET https://api-pub.bitfinex.com/v2/candles/trade:{tf}:t{PAIR}/hist?limit=` | `src/rest.ts:645` |
+| K 线（`exchange=htx`） | `GET https://api.htx.com/market/history/kline?symbol=&period=&size=` | `src/rest.ts:658` |
+
+主机共九个（`api.binance.com` / `www.okx.com` / `api.bybit.com` / `api.gateio.ws` / `api.kucoin.com` /
+`api.kraken.com` / `api.exchange.coinbase.com` / `api-pub.bitfinex.com` / `api.htx.com`），
+ticker 与 K 线各打自己的同一个主机；所有请求只带 `Accept: application/json`（`src/rest.ts:365-394`），无签名头。
+`SUPPORTED_EXCHANGES`（`src/rest.ts:37`）登记九条 ticker 分支，`KLINE_EXCHANGES`（`src/rest.ts:46`）
+登记九条 K 线分支（两表当前同集、各自独立登记）；登记面之外的 slug（如 `bitstamp`）
+在入口守卫（`src/rest.ts:399`、`:541`）即抛 `TRADING_NOT_IMPLEMENTED`，**不发任何请求**
+（见「已知边界」第 1、2 条）。
 
-生成后按 [docs/guides/connector-playbook.md](../../docs/guides/connector-playbook.md) 的填写顺序
-（src/rest.ts 头部清单 7 项）实现 TODO。每个 TODO 的参照段都在 connector-okx
-（packages/connector-okx/），它是本仓第一个真实 TradeService 连接器。
+## 周期与契约
 
-## 结构
+- **周期词汇与按所映射**：`1m / 5m / 15m / 30m / 1h / 4h / 1d / 1w / 1M`（`src/rest.ts:28`）是
+  工具枚举与类型层词汇；**每所有自己的映射表**（`KLINE_INTERVAL_PARAMS`，`src/rest.ts:241-265`）：
+  kraken 用分钟数（1d=1440、1w=10080、1M=21600）、coinbase 用秒（1d=86400）、bybit 用单字母（1d=`D`）、
+  okx 取 **utc 变体**（`1Dutc`/`1Wutc`/`1Mutc`，与 connector-okx 同一裁决：日界对齐 UTC，否则跨连接器错位 8 小时）、
+  htx `1day`/`1mon`、gateio 1w 用上游的 `7d`。**该所不支持的周期**（实测 coinbase 只接受
+  60/300/900/3600/21600/86400 秒，故 30m/4h/1w/1M 不支持；gateio/kucoin 无 1M；以及词汇表外取值）
+  抛 `TRADING_UNSUPPORTED_INTERVAL` 且零请求（`klineIntervalParam`，`src/rest.ts:281-291`）。
+- **所名守卫**：`getTicker` / `getKlines` 在 `normalizeSymbol` 之后、任何 fetch 之前按登记面裁决
+  （`src/rest.ts:399`、`:541`）：登记面之外的所名 → `TRADING_NOT_IMPLEMENTED`（点名所名、列出
+  实现面、零请求）。两处文案由同一个 `notImplementedError` helper 构造（`src/rest.ts:64-75`）。
+- **现货限定**：`normalizeSymbol`（`src/rest.ts:92-103`）先转大写；形态由 `@dshtrading/api` 的
+  `instrumentFormOf` 裁决，命中永续形态即抛 `TRADING_UNSUPPORTED_SYMBOL`，**不剥后缀、不发任何请求**；
+  随后删 `-`/`_` 分隔符、去掉 `/`。返回值是该所侧的裸符号（如 `BTCUSDT`），
+  也就是响应里的 `symbol` 字段。
+- **符号按所归一（quote 表按所维护）**：七条形态变换分支各有自己的 quote 资产表
+  （`QUOTE_TABLES`，`src/rest.ts:125-142`，数据来源 = 该所公开挂牌端点普查）。
+  `splitPair`（`src/rest.ts:143-161`）只按**该所**的表最长优先切 base+quote，再按所映射
+  （`requestSymbol`，`src/rest.ts:174-190`）：okx/kucoin/coinbase `BTC-USDT`、gateio `BTC_USDT`、
+  kraken `BTC`→`XBT`（`XBTUSDT`）、bitfinex 前缀 `t` 且 `USDT`→`UST`（`tBTCUST`）、htx 全小写（`btcusdt`）。
+  各所表的资产数与普查端点见
+  [本卡证据文档](../../spikes/impl-ccxt-exchange-expansion/EVIDENCE-2026-10-15-quote-census-and-klines.md)
+  （例如 kraken 记 `XBT` 不记 `BTC`、gateio 表里没有 `JPY`、okx 另有 `AED/PLN/SGD`）；
+  表由探针按同一条普查规则现场复核（表 = 普查结果，漂移即 FAIL）。变换分支的类型集合是
+  `TransformExchange`，switch 穷尽无 default——binance / bybit **不经过任何 quote 表**：它们把裸符号
+  原样发出，`ETHBNB` / `BTCFDUSD` 这类 quote 表外的合法对不受影响（回归见
+  `test/symbol-normalization.test.ts`）。表外计价币或 base 为空 → `TRADING_UNSUPPORTED_SYMBOL` 且零请求。
+- **错误映射**（`src/rest.ts:365-394`）：fetch 抛错 → `TRADING_NETWORK`；非 2xx → 先读正文
+  （**容忍非 JSON**：bybit 的 403 正文就是 CloudFront 的地域拦截片段）、压成单行 200 字符片段进 message，
+  其中 **404** 与 **400 且正文 `label` 以 `INVALID_` 开头**（gateio 实测 `INVALID_CURRENCY_PAIR`）
+  → `TRADING_SYMBOL_NOT_FOUND`，其余非 2xx → `TRADING_UPSTREAM_ERROR`。行级判空（上游 200
+  但没有可用的行）统一 `TRADING_SYMBOL_NOT_FOUND`（`src/rest.ts:78-88`）——该码已收录进
+  `@dshtrading/api` 的 `TradingErrorCode`（2026-10-15，见「已知边界」第 11 条）。
+- **K 线解析（九条分支）**：逐所解析自己的行结构（`src/rest.ts:539-668`）：binance
+  `[openTime, open, high, low, close, volume, closeTime]`（12 字段）、okx `[ts, o, h, l, c, vol, …]`、
+  bybit `[start, o, h, l, c, vol, turnover]`、gateio `[ts, 计价量, close, high, low, open, 基础量, windowClosed]`、
+  kucoin `[ts, open, close, high, low, 基础量, 计价量]`、kraken `[ts, o, h, l, c, vwap, 基础量, count]`、
+  coinbase `[ts, low, high, open, close, 基础量]`、bitfinex `[mts, open, close, high, low, 基础量]`、
+  htx `{id, open, high, low, close, amount}`。`volume` 一律取**基础币量**（与快照同口径）；
+  输出一律**升序（旧→新）**、按 openTime 去重、只保留最新 `limit` 根（`finalizeKlines`，`src/rest.ts:318-330`）——
+  九所里只有 binance / kraken 的上游本来就是升序。`closeTime` 除 binance 用上游回传值外，
+  一律 `openTime + 周期毫秒 - 1`。单请求根数按所裁剪（`KLINE_LIMIT_PARAMS`，`src/rest.ts:333-344`：
+  binance 1000 / okx 300 / bitfinex 10000 / htx 2000；kucoin/kraken/coinbase 没有根数参数，
+  上游回多少就切多少，**不翻页**）。形状不可识别的响应返回 `[]`；上游显式错误信封
+  （okx `code≠0`、kucoin `code≠200000`、bybit `retCode≠0`、htx `status≠ok`、kraken `error` 非空）
+  抛 `TRADING_SYMBOL_NOT_FOUND`。
+- **K 线按所取不经服务契约**：`exchange` 是**连接器自有形参**（`src/rest.ts:539`）；服务缝
+  `CcxtMarketDataService.getKlines(symbol, interval, limit?)`（`src/index.ts:79-84`）保持与
+  `MarketDataService` 契约同形、不吃所名，工具 `crypto_get_klines` 走公开的客户端引用
+  `CcxtMarketDataService.client`（`src/index.ts:64`）。`@dshtrading/api` 的
+  `MarketDataService.getKlines` 没有 `exchange` 形参，本卡不改它。
+- **快照字段**：只回 `symbol / price / volume / timestamp`；`price` / `volume` 一律取**基础币 24h 量**
+  （binance `volume`、okx `vol24h`、bybit `volume24h`、gateio `base_volume`、kucoin `vol`、
+  kraken `v[1]`、coinbase `volume`、bitfinex `[7]`、htx `tick.amount`）。
+  `timestamp` 分两类：**上游给服务器时间就用它**（binance `closeTime`、okx `ts`、kucoin `data.time`、
+  htx `ts`），**否则用本地观测时刻**（bybit / gateio / kraken / bitfinex / coinbase）——
+  coinbase 的 `time` 是**最后成交时间**不是服务器时间（薄标的可读到数小时前），bitfinex 数组下标 10
+  是上游坏值（实测 2019-03-11，两对都坏），两处都不用，并在代码注释里点名。
 
-- `src/rest.ts` —— 错误载体（TradingServiceError）+ 通用请求管线（超时/错误映射/
-  模拟盘头/注入 fetch）直接可用；签名与端点 TODO。
-- `src/index.ts` —— Config（enabled/env/dryRun/liveTrading + 三 ref 凭证组）、
-  闸门三态判定、凭证解析（BYOK + 环境变量回落）、MarketDataService/TradeService 骨架、
-  7 个市场前缀工具注册（duplicate-safe）、apply（enabled=false 静默退出）。
-- `test/template.test.ts` —— 结构冒烟 7 用例。
+## 能力面
 
-## Token
+服务方法（`CcxtMarketDataService` / `CcxtTradeService`）：
+
+| 方法 | 有/缺席 | 说明 |
+|---|---|---|
+| `getTicker` | 有 | 第二参数 `exchange` 生效：九所直连分支；登记面之外的所名结构化拒绝（`TRADING_NOT_IMPLEMENTED`，零请求）（`src/index.ts:75-77`） |
+| `getKlines` | 有 | 契约形参不含所名（`src/index.ts:79-84`）：裁决对象是客户端默认所名；按所取 K 线走公开的客户端引用 `CcxtMarketDataService.client`（`src/index.ts:64`） |
+| `subscribeTicker` | 有 | 快照轮询，最小 1000 ms、缺省 5000 ms（`src/index.ts:86-95`） |
+| `listInstruments` | 缺席 | 未实现，调用方按可选方法缺席处理 |
+| `getOrderbook` / `getRecentTrades` | 缺席 | 未实现 |
+| `getDerivatives` / `getDerivativesHistory` | 缺席 | 未实现 |
+| `placeOrder` | 有（模拟） | 三态闸门；模拟回执由服务层本地合成（`src/index.ts:112-139`） |
+| `cancelOrder` | 有（受限） | 未获实盘授权或 `dryRun=true` 时结构化拒绝（`src/index.ts:141-151`） |
+| `getOrder` | 有（失败关闭） | 契约必需方法，恒抛 `TRADING_NOT_IMPLEMENTED`（语义是「不可用」，不是「订单不存在」）（`src/index.ts:159-165`） |
+| `getPositions` | 有（失败关闭） | 契约必需方法，恒抛 `TRADING_NOT_IMPLEMENTED`（语义是「不可用」，不是「没有持仓」）（`src/index.ts:167-173`） |
+| `getBalance` / `getOrders` | 缺席 | 非契约方法，已删除：不再回常量 USDT 余额，也不再用恒空数组冒充「没有挂单」 |
+| `getBalances` / `listOpenOrders` / `listTradeFills` / `setLeverage` | 缺席 | 可选方法未定义 |
+
+工具（`apply` 内注册，duplicate-safe，`src/index.ts:192-232`）：
+
+| 工具 | 参数 | 说明 |
+|---|---|---|
+| `crypto_get_ticker` | `symbol`（必填）/ `exchange`（枚举 = `SUPPORTED_EXCHANGES`，即九所，缺省 `binance`） | 九条直连分支；枚举外的所名在请求前结构化拒绝（`TRADING_NOT_IMPLEMENTED`，零请求） |
+| `crypto_get_klines` | `symbol` / `interval`（枚举 = 周期词汇，缺省 `1d`）/ `limit`（缺省 100）/ `exchange`（枚举 = `KLINE_EXCHANGES`，即九所，缺省 `binance`） | 九条直连分支；周期按所映射，该所不支持的周期抛 `TRADING_UNSUPPORTED_INTERVAL`（零请求）；枚举外的所名在请求前结构化拒绝（零请求） |
+
+**本包只注册这 2 个工具**，且都是行情工具；交易面没有注册任何工具。
+
+## 已知边界
+
+1. **登记面 = 实现面（ticker 与 K 线各九所）**：`SUPPORTED_EXCHANGES`（`src/rest.ts:37`）与
+   `KLINE_EXCHANGES`（`src/rest.ts:46`）各登记九条直连分支，`getTicker` / `getKlines` 在入口守卫
+   （`src/rest.ts:399`、`:541`）就拦下登记面之外的 slug（如 `bitstamp`），抛
+   `TRADING_NOT_IMPLEMENTED` 且**不发任何请求**——此前「选 kraken 会拿到 Binance 的报价、
+   没有任何提示」的静默兜底已不存在。2026-10-15 早先那轮曾把 ticker 登记面收窄到三所、K 线
+   收成单分支，同日先补齐六条 ticker 分支、再由本卡把 K 线扩到九所；工具描述与设置页显示名同步
+   （`src/index.ts:200`、`locales.ts` 的 `'provider.ccxt'` 条目）。
+2. **K 线九所按所取，但 `exchange` 不进服务契约**：`getKlines` 现在接受
+   `(symbol, interval, limit, exchange)`（`src/rest.ts:539`）——形参只加在**连接器客户端方法**与
+   `crypto_get_klines` 工具上；`@dshtrading/api` 的 `MarketDataService.getKlines(symbol, interval, limit?)`
+   没有该形参，服务缝 `CcxtMarketDataService.getKlines`（`src/index.ts:79-84`）因此保持与契约同形
+   （裁决对象是客户端默认所名）。未登记 slug → `TRADING_NOT_IMPLEMENTED`、该所不支持的周期 →
+   `TRADING_UNSUPPORTED_INTERVAL`，两者都在 fetch 之前（零请求）。逐所周期映射与不支持集合见
+   「周期与契约」；2026-10-15 之前那条「形态上接收 `exchange`、实现上忽略它恒打 Binance」的假形参
+   与「K 线只有 binance 一条路径」都已成为历史。
+3. **不是通用 CCXT 大包**：`package.json` 的 dependencies 只有 `@dshtrading/authority` 与
+   `@dshtrading/api`，**没有 `ccxt` 依赖**；本包是自写的九条 ticker 直连分支 + 九条 K 线直连分支，
+   只沿用 CCXT 的所名词汇。
+4. **现货限定**：`-SWAP` 入参抛 `TRADING_UNSUPPORTED_SYMBOL` 且零网络请求
+   （`src/rest.ts:92-103`，回归见 `test/spot-only-form.test.ts`）；本包没有合约面，
+   需要永续报价应换 bybit / okx 连接器。
+5. **私有账户读面失败关闭**：本包没有签名私有账户读路径，两类必需读方法都显式拒绝——
+   `getOrder` 抛 `TRADING_NOT_IMPLEMENTED`（`src/index.ts:159-165`）、`getPositions` 抛
+   `TRADING_NOT_IMPLEMENTED`（`src/index.ts:167-173`），文案写明语义是「不可用」，不是
+   「订单不存在」或「没有持仓」；可选方法 `getBalances` / `listOpenOrders` /
+   `listTradeFills` 直接缺席，消费方按「可选方法缺席」处理。此前硬编码的 100000 USDT
+   余额、恒空数组的 `getPositions` 与非契约的 `getOrders` 已删除；回归
+   `test/account-read-surface.test.ts`。
+6. **凭证字段已撤（2026-10-15）**：设置页不再为 ccxt 挂 `apiKey` / `apiSecret`——本连接器既不声明
+   凭证字段、也不读设置字典（`src/index.ts:42-51`、`:189-190`；`CcxtRestOptions` 的 `apiKey`/`secret`
+   只被赋值，从不进请求），面板字段是纯承诺，故撤下；日后接签名面时随消费点一起回来。
+   撤字段的理由、逐条对照与一致性用例见[设置页凭据面收窄](../../.agents/notes/implemented/simplification/2026-10-15-settings-credential-surface-narrowed.md)。
+7. **live 下单路径是本地 sim stub**：闸门③放行后 `CcxtRestClient.placeOrder`
+   返回 `sim-ccxt-*` 回执（`src/rest.ts:671-684`），不触网。
+8. **地域限制由上游实施**：默认出口对 `api.binance.com` 451、`api.bybit.com` 403
+   （2026-10-08 记录；2026-10-15 本轮在本包上复现并落原始响应）。九所里其余七所
+   （okx / gateio / kucoin / kraken / coinbase / bitfinex / htx）默认出口直连即 200，
+   只有 binance / bybit 需要可达出口；换出口属用户侧环境选择，不是仓库配置。
+9. **类型存量债**：本包 `tsconfig.json` 原有 10 条 tsc 错误记在
+   `scripts/typecheck-baseline.json`；`TRADING_SYMBOL_NOT_FOUND` 收录进 api 词汇表、包内
+   `CcxtErrorCode` 下线后现状 **6 条**（不升），全部是基线内的存量债：`cancelOrder` 与
+   `TradeService` 的签名差、`CcxtRestOptions` 里已不参与请求的 `apiKey`/`secret` 未读、
+   `exactOptionalPropertyTypes` 下的两处赋值。
+10. **quote 表按所维护（2026-10-15 起）**：七条形态变换分支各有自己的 quote 资产表
+    （`QUOTE_TABLES`，`src/rest.ts:125-142`），数据来源 = 该所公开挂牌端点的逐所普查
+    （okx `instruments`、kucoin `symbols`、gateio `currency_pairs`、kraken `AssetPairs` 的 `wsname`、
+    coinbase `products`、bitfinex `pair`+`currency` 两个 conf 端点、htx `settings/common/symbols`；
+    原始响应 `census-*.json` 与派生规则见本卡证据文档）。各所表互不相同且**只登记上游确实挂牌的
+    quote**：kraken 记 `XBT` 不记 `BTC`（24 个）、gateio 表里没有 `JPY`（8 个）、okx 另有
+    `AED/PLN/SGD`（13 个）。表外计价币在这七条分支上是**本地 `TRADING_UNSUPPORTED_SYMBOL` 且零请求**——
+    不是回归（改动前这些所名会拿到 Binance 的报价或拼出错符号），且 binance / bybit 不经过任何
+    quote 表。表**会过期**：上游新增 quote 而表未跟进时探针 `quote-census.*` 判据 FAIL；
+    刷新方式 = 重跑普查、更新表、重跑探针。
+11. **`TRADING_SYMBOL_NOT_FOUND` 已收录进 api 词汇表（2026-10-15）**：`TradingErrorCode`
+    （`packages/api/src/index.ts:889`）现在有这个码，注释写明它已被 8 个连接器实际使用
+    （akshare / eastmoney / finnhub / fmp / longbridge / polygon / tushare / 本包）、此前只是漏进
+    词汇表（与 `TRADING_UPSTREAM_ERROR` 曾经的缺口同形）。包内 `CcxtErrorCode` 已下线，
+    `TradingServiceError.code` 恢复为 `TradingErrorCode`（`src/rest.ts:26-34`），**运行时错误码不变**。
+12. **请求符号决定拿到哪个盘**：`BTCUSDT` 在 coinbase 上归一成 `products/BTC-USDT/ticker`——
+    实测该盘 24h 量只有 28.05（同一时刻 `BTC-USD` 是 6464.21），是薄盘。要拿 USD 盘就传
+    `BTCUSD`（映射成 `BTC-USD`）；各所同理（如 bitfinex 走 `tBTCUST` 即 USDT 盘）。
+    本包不改写所名，符号怎么给就怎么映射。
+
+## 合规记录
+
+- 九个主机（`api.binance.com` / `www.okx.com` / `api.bybit.com` / `api.gateio.ws` / `api.kucoin.com` /
+  `api.kraken.com` / `api.exchange.coinbase.com` / `api-pub.bitfinex.com` / `api.htx.com`）的公共行情端点：
+  公开、免密；本包不内置密钥，不读凭证环境变量，不把任何值写进日志或回执。
+- 本包不依赖也不打包 `ccxt`：名字里的 CCXT 指沿用的交易所词汇，不代表引入该库或该库的运行时。
+- 本仓不缓存、不再分发行情数据。
+- 各所的地域限制（Binance 451 / Bybit 403 记录）是上游按出口国家实施的政策，
+  不是本包可控项；换出口属用户侧环境选择，不是仓库配置的一部分。
+- 许可：`PolyForm-Noncommercial-1.0.0`（`package.json`）。
+- 本包是数据与执行通道的技术实现，不构成投资建议。
+
+## 出网验证
+
+```sh
+pnpm --filter @dshtrading/connector-ccxt test   # 离线：现货限定/符号归一/所名登记面/错误映射/账户读面/三态闸门/dataplane
+node_modules/.bin/tsx spikes/impl-ccxt-exchange-expansion/run-probe.ts   # 出网：九所 ticker（含非 USDT 对）+ 七所 quote 普查 + 九所 K 线 + 零请求负例（失败即退出码 1）
+```
 
-`ccxt`（slug）/ `CCXT`（title）/ `CCXT`（ref 前缀）/
-`crypto`（工具前缀）/ `Crypto`（服务键 infix）。token 未展开也可编译；
-生成器保证全部替换。
+- **出网脚本已入仓**（2026-10-15）：`spikes/impl-ccxt-exchange-expansion/run-probe.ts`——
+  九所 ticker 真实取价（每所再一条非 USDT 对）+ 七所 quote 表对照现场普查 + 九所 K 线（每所两档周期，
+  请求 URL 逐字比对）+ 未登记 slug（ticker/K 线）/ 逐所不支持周期 / 逐所表外计价币的零请求负例；
+  逐条判据、出口 IP 与源码指纹落在同目录 `probe-summary.json` 与
+  [本卡证据文档](../../spikes/impl-ccxt-exchange-expansion/EVIDENCE-2026-10-15-quote-census-and-klines.md)。
+  **注意出口**：binance / bybit 在默认出口是 451 / 403，走可达出口窗口时须切 mihomo 规则组
+  并在结束后还原（手法见 `spikes/impl-crypto-perp-tradfi/EVIDENCE-reverify-2026-10-08.md` 第 2 节）。
+  更早一轮 2026-08-31 的评审随测其脚本未随证据入仓（`spikes/verify-connectors-suite/` 只有 EVIDENCE.md）。
+- 离线证据：`test/spot-only-form.test.ts`（永续入参拒绝 + 零请求断言 + 现货零回归）、
+  `test/symbol-normalization.test.ts`（九所请求符号形态 + 每所一条非 USDT 对 + 按所 quote 表差异 +
+  binance/bybit 不走 quote 表 + 表外零请求拒绝）、`test/klines-per-exchange.test.ts`（九所 K 线端点与
+  行结构 + 周期映射 + 不支持周期零请求 + 根数裁剪）、`test/upstream-error-mapping.test.ts`
+  （404 / 400 `INVALID_*` / 非 JSON 正文 / 正文截断 / 网络错误）、
+  `test/exchange-registry-fail-closed.test.ts`（未登记 slug 的 ticker/K 线 fail-closed +
+  九所各自主机 + 两个工具的枚举与描述面）、
+  `test/account-read-surface.test.ts`（账户读面失败关闭：必需读方法拒绝 + 可选读方法缺席 +
+  撤单闸门回归）、`test/trade-gate.test.ts`（服务缝三态矩阵）、
+  `test/dataplane-loader.test.ts`（数据面行解析）。
+- 真实网络下的服务缝闸门验证只覆盖 okx 连接器（
+  [impl-service-seam-gate/NET-VERIFY.md](../../spikes/impl-service-seam-gate/NET-VERIFY.md)），
+  与本包无关；本包未做真实下单验证。
 
-## 注意（勿改的坑）
+## 参见
 
-- 服务类用 TS 编译期 `private`（禁 ECMAScript `#`，realm 代理会炸）。
-- 工具名 = 市场前缀 + 语义词（不带交易所名）——base 闸门正则只认市场前缀。
-- 行 id = `dsh-trading-<market>-connector-<slug>`，全仓唯一（insert-only 铁律 #1）。
-- 凭证只进 ref，绝不内置/落日志（铁律 #3/#5）。
+- Owning Note：[crypto-perp-data-plane-bybit-ccxt.md](../../.agents/notes/implemented/feature/2026-10-08-crypto-perp-data-plane-bybit-ccxt.md)
+- 九所补齐与 K 线撤形参（K 线面随后由下一张卡恢复为按所取）：[2026-10-15-ccxt-nine-exchange-ticker-branches.md](../../.agents/notes/implemented/feature/2026-10-15-ccxt-nine-exchange-ticker-branches.md)
+- 本卡（quote 表按所维护 + K 线九所 + 词汇表收敛）：[2026-10-15-ccxt-per-exchange-quote-tables-and-klines.md](../../.agents/notes/implemented/feature/2026-10-15-ccxt-per-exchange-quote-tables-and-klines.md)
+- `TRADING_SYMBOL_NOT_FOUND` 收录进 api 词汇表：[2026-10-15-trading-error-code-vocabulary-symbol-not-found.md](../../.agents/notes/implemented/architecture/2026-10-15-trading-error-code-vocabulary-symbol-not-found.md)
+- 上一轮登记面收窄（本卡承接其「另开卡」项）：[2026-10-15-declared-registration-face-equals-implementation.md](../../.agents/notes/implemented/simplification/2026-10-15-declared-registration-face-equals-implementation.md)
+- 全仓当前状态与硬停：[docs/current-state.md](../../docs/current-state.md)
+- 连接器横向对照：[connectors-guide.md](../../docs/guides/connectors-guide.md)

package/lib/dataplane.d.ts

@@ -2,6 +2,6 @@ import { Config } from "./index.js";
 import { Context } from "@deepseek-ai/cordis";
 //#region src/dataplane.d.ts
 declare const inject: string[];
-declare function apply(ctx: Context, config: Config): void;
+declare function apply(ctx: Context, config?: Config): void;
 //#endregion
-export { apply, inject };
+export { Config, apply, inject };

package/lib/dataplane.js

@@ -1,13 +1,14 @@
-import { CcxtMarketDataService, TRADING_CRYPTO_MARKET_DATA_KEY } from "./index.js";
+import { CcxtMarketDataService, Config, ROUTER_PROVIDER, TRADING_CRYPTO_MARKET_DATA_KEY } from "./index.js";
 //#region src/dataplane.ts
 const inject = [];
+/** schema 的运行时可调用形态（校验即补默认值）；手工构造 ctx 不传 config 时按 schema 默认值处理。 */
+const withDefaults = (value) => Config(value);
 function resolveMarketDataRegistry(ctx) {
 	const candidate = ctx.get?.("tradingMarketDataRegistry", false);
 	return candidate !== void 0 ? candidate : void 0;
 }
-const ROUTER_PROVIDER = "ccxt";
 const MARKET = "crypto";
-function apply(ctx, config) {
+function apply(ctx, config = withDefaults(void 0)) {
 	if (!config.enabled) return;
 	const registry = resolveMarketDataRegistry(ctx);
 	if (registry === void 0) {
@@ -19,4 +20,4 @@ function apply(ctx, config) {
 	ctx.effect(() => registry.register(MARKET, ROUTER_PROVIDER, service));
 }
 //#endregion
-export { apply, inject };
+export { Config, apply, inject };

package/lib/index.d.ts

@@ -1,12 +1,11 @@
-import { AccountBalance, CcxtRestClient, CcxtRestOptions, INTERVAL_VOCABULARY, Interval, Kline, Order, Position, SUPPORTED_EXCHANGES, Ticker, TradingServiceError, normalizeSymbol } from "./rest.js";
+import { CcxtRestClient, CcxtRestOptions, INTERVAL_VOCABULARY, Interval, KLINE_EXCHANGES, Kline, KlineExchange, Order, Position, QUOTE_TABLES, SUPPORTED_EXCHANGES, Ticker, TradingServiceError, klineIntervalParam, klineSupportedIntervals, normalizeSymbol, requestSymbol, splitPair } from "./rest.js";
 import { Context, Service } from "@deepseek-ai/cordis";
 import Schema from "@deepseek-ai/schemastery";
-import { AccountBalance as AccountBalance$1, Disposable, Interval as Interval$1, Kline as Kline$1, MarketDataService, Order as Order$1, OrderRequest, Position as Position$1, Ticker as Ticker$1, TradeService } from "@dshtrading/api";
+import { Disposable, Interval as Interval$1, Kline as Kline$1, MarketDataService, Order as Order$1, OrderRequest, Position as Position$1, Ticker as Ticker$1, TradeService } from "@dshtrading/api";
 //#region src/index.d.ts
 declare const name = "dsh-trading-crypto-connector-ccxt";
 interface Config {
   enabled: boolean;
-  env: 'demo' | 'live';
   dryRun: boolean;
   liveTrading: boolean;
   defaultExchange: string;
@@ -15,10 +14,17 @@ declare const Config: Schema<Config>;
 declare const TRADING_CRYPTO_MARKET_DATA_KEY = "tradingCryptoMarketData";
 declare const TRADING_CRYPTO_TRADE_KEY = "tradingCryptoTrade";
 declare class CcxtMarketDataService extends Service implements MarketDataService {
-  private readonly client;
+  /**
+   * REST 客户端（**公开只读引用**，不是新的服务契约）。
+   *
+   * `crypto_get_klines` 工具要按所取 K 线，而 `@dshtrading/api` 的
+   * `MarketDataService.getKlines(symbol, interval, limit?)` 没有 `exchange` 形参——
+   * 服务缝保持与契约同形，形参只加在本客户端方法与自有工具上（见 README「周期与契约」）。
+   */
+  readonly client: CcxtRestClient;
   constructor(ctx: Context, options?: CcxtRestOptions, serviceName?: string);
   getTicker(symbol: string, exchange?: string): Promise<Ticker$1>;
-  getKlines(symbol: string, interval?: Interval$1, limit?: number, exchange?: string): Promise<Kline$1[]>;
+  getKlines(symbol: string, interval?: Interval$1, limit?: number): Promise<Kline$1[]>;
   subscribeTicker(symbol: string, cb: (ticker: Ticker$1) => void, options?: {
     intervalMs?: number;
   }): Disposable;
@@ -30,17 +36,22 @@ declare class CcxtTradeService extends Service implements TradeService {
   constructor(ctx: Context, options: CcxtRestOptions & {
     config: Config;
   }, serviceName?: string);
-  getBalance(): Promise<AccountBalance$1>;
   placeOrder(order: OrderRequest): Promise<Order$1>;
   cancelOrder(orderId: string): Promise<{
     orderId: string;
     status: 'canceled';
   }>;
+  /**
+   * 私有账户读面未实现（本包没有任何签名私有账户读路径）：必须显式拒绝。base 的账户工具
+   * 与 GUI 桥把同一注册面当「交易所账户真值」消费——返回编造订单或空数组会被读成
+   * 「订单存在」「没有持仓」，而契约语义是 TRADING_NOT_IMPLEMENTED（不可用）。可选方法
+   * getBalances/listOpenOrders/listTradeFills 直接缺席，由消费方按「可选方法缺席」处理。
+   */
+  getOrder(_symbol: string, _id: string): Promise<Order$1>;
   getPositions(): Promise<Position$1[]>;
-  getOrders(): Promise<Order$1[]>;
 }
 declare const ROUTER_PROVIDER = "ccxt";
 declare function routeAllows(ctx: Context, config: Config, market: string): boolean;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { type AccountBalance, CcxtMarketDataService, CcxtRestClient, CcxtRestOptions, CcxtTradeService, Config, INTERVAL_VOCABULARY, type Interval, type Kline, type Order, type Position, ROUTER_PROVIDER, SUPPORTED_EXCHANGES, TRADING_CRYPTO_MARKET_DATA_KEY, TRADING_CRYPTO_TRADE_KEY, type Ticker, TradingServiceError, apply, name, normalizeSymbol, routeAllows };
+export { CcxtMarketDataService, CcxtRestClient, CcxtRestOptions, CcxtTradeService, Config, INTERVAL_VOCABULARY, type Interval, KLINE_EXCHANGES, type Kline, KlineExchange, type Order, type Position, QUOTE_TABLES, ROUTER_PROVIDER, SUPPORTED_EXCHANGES, TRADING_CRYPTO_MARKET_DATA_KEY, TRADING_CRYPTO_TRADE_KEY, type Ticker, TradingServiceError, apply, klineIntervalParam, klineSupportedIntervals, name, normalizeSymbol, requestSymbol, routeAllows, splitPair };

package/lib/index.js

@@ -1,4 +1,4 @@
-import { CcxtRestClient, INTERVAL_VOCABULARY, SUPPORTED_EXCHANGES, TradingServiceError, normalizeSymbol } from "./rest.js";
+import { CcxtRestClient, INTERVAL_VOCABULARY, KLINE_EXCHANGES, QUOTE_TABLES, SUPPORTED_EXCHANGES, TradingServiceError, klineIntervalParam, klineSupportedIntervals, normalizeSymbol, requestSymbol, splitPair } from "./rest.js";
 import { liveTradingEnabled } from "@dshtrading/authority";
 import { Service } from "@deepseek-ai/cordis";
 import { defineTool } from "@deepseek-ai/dsh-tools";
@@ -11,14 +11,20 @@ import Schema from "@deepseek-ai/schemastery";
 const name = "dsh-trading-crypto-connector-ccxt";
 const Config = Schema.object({
 	enabled: Schema.boolean().default(true).description("是否激活 CCXT 连接器"),
-	env: Schema.union(["demo", "live"]).default("demo").description("运行环境"),
 	dryRun: Schema.boolean().default(true).description("默认模拟下单"),
 	liveTrading: Schema.boolean().default(false).description("是否允许实盘交易"),
-	defaultExchange: Schema.string().default("binance").description("默认首选交易所")
+	defaultExchange: Schema.string().default("binance").description("默认首选交易所：9 所的 ticker 与 K 线都有直连分支（binance/okx/bybit/gateio/kucoin/kraken/coinbase/bitfinex/htx）；登记面之外的 slug 在请求前结构化拒绝（TRADING_NOT_IMPLEMENTED，零请求），登记面内的某个周期该所不支持时同样零请求拒绝（TRADING_UNSUPPORTED_INTERVAL）")
 });
 const TRADING_CRYPTO_MARKET_DATA_KEY = "tradingCryptoMarketData";
 const TRADING_CRYPTO_TRADE_KEY = "tradingCryptoTrade";
 var CcxtMarketDataService = class extends Service {
+	/**
+	* REST 客户端（**公开只读引用**，不是新的服务契约）。
+	*
+	* `crypto_get_klines` 工具要按所取 K 线，而 `@dshtrading/api` 的
+	* `MarketDataService.getKlines(symbol, interval, limit?)` 没有 `exchange` 形参——
+	* 服务缝保持与契约同形，形参只加在本客户端方法与自有工具上（见 README「周期与契约」）。
+	*/
 	client;
 	constructor(ctx, options = {}, serviceName = TRADING_CRYPTO_MARKET_DATA_KEY) {
 		super(ctx, serviceName);
@@ -27,8 +33,8 @@ var CcxtMarketDataService = class extends Service {
 	async getTicker(symbol, exchange) {
 		return this.client.getTicker(symbol, exchange);
 	}
-	async getKlines(symbol, interval = "1d", limit = 100, exchange) {
-		return this.client.getKlines(symbol, interval, limit, exchange);
+	async getKlines(symbol, interval = "1d", limit = 100) {
+		return this.client.getKlines(symbol, interval, limit);
 	}
 	subscribeTicker(symbol, cb, options) {
 		const ms = Math.max(options?.intervalMs ?? 5e3, 1e3);
@@ -49,9 +55,6 @@ var CcxtTradeService = class extends Service {
 		this.client = new CcxtRestClient(options);
 		this.config = options.config;
 	}
-	async getBalance() {
-		return this.client.getBalance();
-	}
 	async placeOrder(order) {
 		const requestedDryRun = order.dryRun ?? true;
 		if (!requestedDryRun && !liveTradingEnabled(this.config.liveTrading)) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", `CCXT TradeService.placeOrder rejected: the request asks for real execution (dryRun=${String(order.dryRun)}) but the signed live-trading authority does not grant real execution (see @dshtrading/authority) — keep dryRun=true for a simulated fill.`);
@@ -72,11 +75,17 @@ var CcxtTradeService = class extends Service {
 		if (!liveTradingEnabled(this.config.liveTrading) || this.config.dryRun) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", "CCXT TradeService.cancelOrder rejected at the service seam: cancel is a live action and requires a signed live-trading grant (see @dshtrading/authority) with dryRun=false.");
 		return this.client.cancelOrder(void 0, orderId);
 	}
-	async getPositions() {
-		return [];
+	/**
+	* 私有账户读面未实现（本包没有任何签名私有账户读路径）：必须显式拒绝。base 的账户工具
+	* 与 GUI 桥把同一注册面当「交易所账户真值」消费——返回编造订单或空数组会被读成
+	* 「订单存在」「没有持仓」，而契约语义是 TRADING_NOT_IMPLEMENTED（不可用）。可选方法
+	* getBalances/listOpenOrders/listTradeFills 直接缺席，由消费方按「可选方法缺席」处理。
+	*/
+	async getOrder(_symbol, _id) {
+		throw new TradingServiceError("TRADING_NOT_IMPLEMENTED", "CCXT TradeService.getOrder is not implemented: this connector has no signed private-account read path. That means \"not available\", NOT \"order not found\".");
 	}
-	async getOrders() {
-		return [];
+	async getPositions() {
+		throw new TradingServiceError("TRADING_NOT_IMPLEMENTED", "CCXT TradeService.getPositions is not implemented: this connector has no signed private-account read path. That means \"not available\", NOT \"no positions\".");
 	}
 };
 const ROUTER_PROVIDER = "ccxt";
@@ -101,7 +110,7 @@ function apply(ctx, config) {
 		};
 		register(defineTool({
 			name: "crypto_get_ticker",
-			description: "Get the latest ticker quote for any crypto pair across 100+ exchanges via CCXT.",
+			description: "Get the latest spot ticker from one of the nine implemented direct branches (binance, okx, bybit, gateio, kucoin, kraken, coinbase, bitfinex, htx). Any other CCXT exchange slug is rejected with TRADING_NOT_IMPLEMENTED before any network request.",
 			parameters: {
 				symbol: {
 					type: "string",
@@ -112,7 +121,7 @@ function apply(ctx, config) {
 					type: "string",
 					enum: SUPPORTED_EXCHANGES,
 					default: "binance",
-					description: "Exchange slug"
+					description: "Exchange slug; nine slugs have implemented ticker branches (binance, okx, bybit, gateio, kucoin, kraken, coinbase, bitfinex, htx)"
 				}
 			},
 			output: {
@@ -128,7 +137,7 @@ function apply(ctx, config) {
 		}));
 		register(defineTool({
 			name: "crypto_get_klines",
-			description: "Get recent klines for any crypto pair via CCXT.",
+			description: "Get recent spot klines from one of the nine implemented direct branches (binance, okx, bybit, gateio, kucoin, kraken, coinbase, bitfinex, htx). Intervals are mapped per venue; an interval that the venue does not support is rejected with TRADING_UNSUPPORTED_INTERVAL before any network request. Any other CCXT exchange slug is rejected with TRADING_NOT_IMPLEMENTED before any network request.",
 			parameters: {
 				symbol: {
 					type: "string",
@@ -139,18 +148,18 @@ function apply(ctx, config) {
 					type: "string",
 					enum: INTERVAL_VOCABULARY,
 					default: "1d",
-					description: "Interval"
+					description: "Interval (mapped per venue; unsupported intervals are rejected locally with TRADING_UNSUPPORTED_INTERVAL)"
 				},
 				limit: {
 					type: "integer",
 					default: 100,
-					description: "Limit"
+					description: "Limit (capped to the venue single-request maximum; klines are returned oldest-first)"
 				},
 				exchange: {
 					type: "string",
-					enum: SUPPORTED_EXCHANGES,
+					enum: KLINE_EXCHANGES,
 					default: "binance",
-					description: "Exchange slug"
+					description: "Exchange slug; nine slugs have implemented kline branches (binance, okx, bybit, gateio, kucoin, kraken, coinbase, bitfinex, htx)"
 				}
 			},
 			output: {
@@ -161,11 +170,11 @@ function apply(ctx, config) {
 				}]
 			},
 			async execute(args) {
-				const klines = await marketData.getKlines(args.symbol, args.interval ?? "1d", args.limit, args.exchange);
+				const klines = await marketData.client.getKlines(args.symbol, args.interval ?? "1d", args.limit, args.exchange);
 				return JSON.stringify(klines);
 			}
 		}));
 	});
 }
 //#endregion
-export { CcxtMarketDataService, CcxtRestClient, CcxtTradeService, Config, INTERVAL_VOCABULARY, ROUTER_PROVIDER, SUPPORTED_EXCHANGES, TRADING_CRYPTO_MARKET_DATA_KEY, TRADING_CRYPTO_TRADE_KEY, TradingServiceError, apply, name, normalizeSymbol, routeAllows };
+export { CcxtMarketDataService, CcxtRestClient, CcxtTradeService, Config, INTERVAL_VOCABULARY, KLINE_EXCHANGES, QUOTE_TABLES, ROUTER_PROVIDER, SUPPORTED_EXCHANGES, TRADING_CRYPTO_MARKET_DATA_KEY, TRADING_CRYPTO_TRADE_KEY, TradingServiceError, apply, klineIntervalParam, klineSupportedIntervals, name, normalizeSymbol, requestSymbol, routeAllows, splitPair };