@dshtrading/kit-crypto 0.4.1 → 0.6.0

package/assets/skills/crypto-instrument-analysis.md

@@ -13,6 +13,10 @@ description: 加密标的定性分析框架：趋势结构→量价→波动率
 - symbol 一律市场规范词汇（如 `BTCUSDT`），不要用交易所方言。
 - **知识库召回**：进入工具取数前先调 `knowledge_search`（按 symbol、赛道与主题标签，需要全文用 `detail: "full"`）；命中的知识卡片只作线索证据（转述≠背书，不替代工具实测数据），纳入依据清单时标注卡片 id；未命中也如实说明「知识库无相关沉淀」。主题宽泛时先 `knowledge_graph` 看主体分布，再按 `cluster` 钻取。
 
+- **形态定位（先于一切判读）**：`-SWAP` 后缀 = 永续合约（`BTCUSDT-SWAP`），无后缀 = 现货（`BTCUSDT`）；两者是同一 base 的两个不同标的，价格可以长期背离（靠资金费率锚定），取数与判读不得混用。形态由符号后缀裁决，不要各写一套判据。
+- **TradFi 合约不是股票/指数本身**：`TSLAUSDT-SWAP`、`US500-USDT-SWAP`、`XAUUSDT-SWAP` 是交易所合成合约——无股息与股东权利、可被 ADL、24/7 报价而标的现货有闭市时段；资产类别只信交易所元数据（OKX 上 `SPX-USDT-SWAP` 是迷因币 SPX6900，标普 500 叫 `US500-USDT-SWAP`），禁止按符号猜。
+- **只读边界**：本轮加密永续与 TradFi 永续只提供行情与衍生品指标；合约下单未落地，涉及交易一律按铁律 #3（dry-run 起步 + 显式开关 + 审批）。
+
 ## 第一步：趋势结构（多周期一致法）
 
 1. `crypto_get_klines` 取 1d（看方向）→ 4h（看结构）→ 1h（看时机）；根数默认 300 足够。

package/assets/skills/crypto-risk-checklist.md

@@ -12,7 +12,7 @@ description: 加密合约交易风控检查清单：开仓前逐项核对杠杆
 1. **杠杆**：名义杠杆是否在计划上限内（默认 ≤3x）；波动率放大时段（重大数据公布、周末薄流动性）是否降杠杆。
 2. **仓位**：单笔风险是否 ≤ 账户权益的既定百分比；同一标的的多笔仓位是否合并计算了净敞口。
 3. **资金费率**：当前 funding rate 与下一次结算时间；跨期/现货对冲时，费率方向是否与持仓方向一致（套利而非付费）。
-4. **强平价**：按当前杠杆计算强平价与标记价的距离，是否留出 ≥ 计划止损距离的 2 倍缓冲。
+4. **强平价**：读持仓回传的强平价（`crypto_get_positions.liquidationPrice`，交易所口径，缺席即未知），核对它与标记价的距离是否留出 ≥ 计划止损距离的 2 倍缓冲；本地不倒算强平价。
 5. **止损**：入场前是否已确定止损位与触发方式（交易所条件单优先于「心里有数」）。
 6. **流动性**：盘口深度是否足以按限价离场；小市值/新上线合约是否降低仓位上限。
 7. **对手侧情景**：价格反向运行到止损位后，是否接受该笔亏损并继续执行原计划（不允许临时放大杠杆摊平）。
@@ -21,6 +21,37 @@ description: 加密合约交易风控检查清单：开仓前逐项核对杠杆
 - 达到目标位或止损位按计划执行；移动止损只朝有利方向。
 - 资金费率在持仓期间显著反向恶化时，重新评估持有成本，而不是无视。
 
+## TradFi 合约（股票/指数/大宗永续，交易所合成产品）
+
+标的形如 `TSLAUSDT-SWAP`、`XAUUSDT-SWAP`、`US500-USDT-SWAP`（`-SWAP` = 永续，不是股票/现货本身）。
+上面 1–7 条与退出纪律同样适用，另加合约专有项：
+
+1. **合成产品与对手方风险**：这类合约由交易所合成报价与结算，持仓对手方是交易所及其清算机制，不是上市公司——没有股息、没有投票权，也不适用证券投资者保护；交易所停机、标记价格异常、自动减仓（ADL）都直接落在仓位上。
+2. **现货闭市、合约照常报价**：标的现货休市（夜间、周末、节假日）时永续仍 24/7 报价，此时盘口薄、跳价快，成交量不代表真实股票流动性；按现货收盘位（前收/开盘）设的止损在闭市段没有参照物。
+3. **隔夜与跳空**：现货闭市期间的财报、公司行动、指数期货与宏观事件会在合约上一次性反映；缺口可直接跳过止损价，条件单不保证按设定价成交。重仓隔夜前按「缺口 = 已被跳过」估算最大损失，并相应降低名义仓位。
+4. **资金费率锚定成本**：合成合约没有到期日，靠资金费率锚定现货；费率长期单向时持有成本持续侵蚀方向收益（指数与贵金属合约尤其明显），跨期对冲要确认收的是费率而不是付的。
+5. **资产类别只信交易所元数据**：符号字面不能推断归属——OKX 上 `SPX-USDT-SWAP` 是迷因币 SPX6900（`instCategory=1`），标普 500 的合约叫 `US500-USDT-SWAP`；不确定时按交易所元数据核对，禁止按符号猜。
+6. **下单接线与闸门（P7 起）**：OKX 路由下合约可下单——`crypto_place_order` 的 quantity 恒为 **base 币数**，连接器按 ctVal 折算张数并按 lotSz **向下**取整；缺省全仓（cross），逐仓（isolated）须先用 `crypto_set_leverage` 设好该标的的逐仓杠杆。**dry-run 是缺省**：只有 `dryRun=false` + 人工签署的实盘授权 + 审批放行才触达交易所（`env=demo` 打模拟盘、`env=live` 才是真钱）。Binance 路由下合约**只有行情**：`-SWAP` 下单被显式拒绝（TRADING_UNSUPPORTED_SYMBOL），不会回落成现货单。
+7. **强平与保证金口径**：强平价与维持保证金率读 `crypto_get_positions` 回传的交易所字段（`liquidationPrice` / `marginRatio` / `marginMode` / `notionalUsd`）；字段缺席即交易所未提供，**不得用本地公式倒算强平价**充数，也不得把 `0` 当读数（0 与「没有」是两回事）。
+
+## 杠杆与保证金模式（开仓前核对，OKX 词汇）
+
+1. **模式先定、再谈倍数**：全仓（cross）与逐仓（isolated）风险归属不同——逐仓亏损上限是该仓保证金，全仓会把账户余额一起拖进强平。改模式/倍数走 `crypto_set_leverage`（`marginMode` + `leverage`，双向持仓模式还要 `posSide`），它和下单同一门槛：dry-run 缺省，实盘需人工签署授权 + 审批。
+2. **上限是交易所定的**：请求倍数超过该标的规格 `lever` 会被拒绝，**不会静默截断**；不要用「先设 100x 看看」试探。
+3. **isolated 的顺序**：先 `crypto_set_leverage`（该 instId + isolated），再在 `crypto_place_order` 传 `marginMode: 'isolated'`；不先设杠杆，交易所会按参数错误拒单。
+4. **倍数与强平距离一起看**：强平价只信持仓回传值；杠杆每翻一倍，同样的价格波动对保证金的占比也翻倍——按「止损距离 × 2 倍缓冲」核对强平距离（见上节第 4 条）。
+5. **现货不适用**：现货订单传 `marginMode` 会被结构化拒绝（现货杠杆是另一个未接线产品面），不要把它当「现货也能逐仓」。
+
+## 清单归属（避免两份清单互相顶替）
+
+| 交易的是什么 | 用哪份清单 |
+|---|---|
+| 加密永续与 TradFi 永续（OKX 路由，含 `TSLAUSDT-SWAP` 这类交易所合成合约） | **本清单**（crypto-risk-checklist） |
+| 国内商品/金融期货（同花顺期货数据面 `futures` 市场，无交易面） | `futures-risk-checklist`（期货清单） |
+| 现货贵金属/外汇/海外指数（jin10 `global` 市场，纯数据） | global-risk-checklist |
+
+两条边界：OKX 的 `XAU-USDT-SWAP` 是**交易所合成永续**，与 jin10 的 `XAUUSD` 现货报价是两个产品，不互相映射；国内期货的保证金/涨跌停/移仓换月规则不适用于交易所合成永续。
+
 ## OKX 模拟盘（demo）使用法（connector-okx）
 
 OKX 连接器启用后（`enabled: true`，与 binance 行互斥），**第一默认目标是 demo 模拟盘**：

package/assets/skills/indicator-authoring.md

@@ -1,3 +1,7 @@
+---
+name: indicator-authoring
+description: 自定义技术指标创作指南：根据用户自然语言需求生成符合契约的指标代码（TD9/SuperTrend/OBV+MA等），并通过 indicator_author 工具验证与落库。
+---
 # 指标创作指南（Indicator Authoring Guide）
 
 当用户在会话列中用自然语言提出编写或添加技术指标的需求时（例如："帮我写一个 TD9 指标"、"帮我写一个 SuperTrend 指标"、"给 OBV 加一个 34 天均线"），请遵循本指南生成符合 `@dshtrading/indicators` 契约规范的 JavaScript 纯函数代码，并调用 `indicator_author` 工具进行沙箱校验与落库。

package/assets/skills/knowledge-curation.md

@@ -41,6 +41,7 @@ description: 财经观点沉淀与知识库策展指南：基于 Content Insight
 - `title`：卡片主题（精炼概括核心逻辑，如「高股息资产在低利率环境下的防御逻辑」）；
 - `summary`：合并 2-4 条核心论点的一句话概述（图谱 hover 提示文案）；
 - `source`：`type`（bilibili / wechat / manual）、`url`、`author`、`publishedAt`；
+  - `author` **只写主体名**（B站 UP 名 / 公众号名 / 机构名），平台、角色（转播/提炼/核查）、发言人名单、备注一律写进卡片正文——同一主体的不同平台写法由 `packages/knowledge/src/authors.ts` 的别名表在入库时自动归一，命中时 `knowledge_ingest` 回报会回显「作者已归一：旧 → 规范名」。注意别名表是**精确匹配**：未登记的写法不会告警、只会安静地多出作者下拉的一行——入库前请先比对规范名册（工作区 `reports/knowledge_taxonomy.md` §作者字段规范），发现新写法时登记 `AUTHOR_ALIASES` 并补 `test/authors.test.ts` 用例，不要手改 `cards.json`；
 - `credibility`：`high` / `medium` / `low`；
 - `coreClaims`：核心论点列表（保留原作者的推理链条，避免断章取义）；
 - `factCheck`：`{ verified: [...], discrepancies: [...], unverifiable: [...] }`；

package/lib/api/lib/index.d.ts

@@ -1,14 +1,7 @@
+import "./instrument-form.js";
+import "@deepseek-ai/cordis";
 //#region ../api/lib/index.d.ts
 //#region src/index.d.ts
-/**
- * @dshtrading/api — 纯类型契约包（crypto-slice-plan §关键接口草案）。
- *
- * 零运行时、零依赖：服务契约由连接器实现（ctx 键按市场命名空间，如 ctx.tradingCrypto），
- * 消费方只依赖这里的类型。交易安全闸门（铁律 #3）在类型层面体现为
- * OrderRequest.dryRun 默认 true、错误词汇含 LIVE_TRADING_DISABLED / APPROVAL_DENIED。
- *
- * @module @dshtrading/api
- */
 /** K线周期（Binance 现货/合约 interval 词汇）。 */
 type Interval = '1m' | '3m' | '5m' | '15m' | '30m' | '1h' | '2h' | '4h' | '6h' | '8h' | '12h' | '1d' | '3d' | '1w' | '1M';
 /** 最新行情快照（公共数据，无需凭证）。 */
@@ -423,16 +416,32 @@ interface FundamentalsPackage {
   readonly dragonTiger?: DragonTigerItem;
 }
 type PositionSide = 'long' | 'short';
+/**
+ * 保证金模式（合约交易语义，P7）：`cross` = 全仓、`isolated` = 逐仓。
+ * 现货（cash）不使用该字段——缺席即「非保证金/未设置」。
+ */
+type MarginMode = 'cross' | 'isolated';
 /** 持仓快照。 */
 interface Position {
   readonly symbol: string;
   readonly side: PositionSide;
-  /** 仓位数量（正数；方向由 side 表达）。 */
+  /** 仓位数量（正数；方向由 side 表达）。合约仓位是 **base 币数**（连接器已按合约乘数 ctVal 由张换算）。 */
   readonly size: number;
   readonly entryPrice: number;
   readonly markPrice?: number;
   readonly unrealizedPnl?: number;
   readonly leverage?: number;
+  /**
+   * 强平价（交易所回传原样透传；交易所未提供或不适用时缺席，绝不本地推算强平价——
+   * 强平口径与保证金模式、账户级保证金、维持保证金率有关，本地公式会给出错误的安全感）。
+   */
+  readonly liquidationPrice?: number;
+  /** 维持保证金率（OKX `mgnRatio`；口径由交易所定义，原样透传，不在本地换算或反推）。 */
+  readonly marginRatio?: number;
+  /** 该仓位的保证金模式；现货持仓与交易所未提供时缺席。 */
+  readonly marginMode?: MarginMode;
+  /** 名义价值（USD，交易所口径；用于敞口核对，不参与本地风控公式）。 */
+  readonly notionalUsd?: number;
   readonly timestamp: number;
 }
 type OrderSide = 'buy' | 'sell';
@@ -443,10 +452,18 @@ interface OrderRequest {
   readonly symbol: string;
   readonly side: OrderSide;
   readonly type: OrderType;
+  /** **base 币数量**：合约（永续）由连接器按合约乘数换算成张，消费方恒用币数语义。 */
   readonly quantity: number;
   /** limit 单必填。 */
   readonly price?: number;
-  /** 缺省/true 时仅模拟，不触碰交易所。实盘还受插件 liveTrading 闸门与 approval 约束 [S4]。 */
+  /**
+   * 合约订单的保证金模式（缺省 `cross`）。仅对永续（`-SWAP`）有效：
+   * 现货订单只允许 cash 语义，传该字段由连接器结构化拒绝
+   * （现货逐仓/杠杆是另一个产品面，本仓未接线）。
+   * `isolated` 需先在交易所侧设好该标的的逐仓杠杆（OKX `setLeverage`）。
+   */
+  readonly marginMode?: MarginMode;
+  /** 缺省/true 时仅模拟，不触碰交易所。实盘还受 @dshtrading/authority 的人工签署授权与 approval 约束 [S4]。 */
   readonly dryRun?: boolean;
 }
 /** 订单回执/状态。 */
@@ -486,9 +503,49 @@ interface TradeFill {
 interface Disposable {
   dispose(): void;
 }
+/**
+ * 标的形态轴（2026-10-08 加密永续与 TradFi 永续落地）：与 `market` 正交，**不新增市场键**。
+ * 缺省 = `spot`——已存自选、localStorage 与 iOS 冻结契约因此零迁移。
+ *
+ * 形态由规范符号后缀承载（`-SWAP` = 永续），见 docs/guides/symbol-vocabulary.md；
+ * `form` 只出现在名册/检索/wire 元数据里，行情方法不新增 form 形参。
+ */
+type InstrumentForm = 'spot' | 'perp';
+/**
+ * 标的资产类别标签（仅展示与检索排序用，不承载交易语义）。
+ * **只信交易所元数据**（OKX `instCategory`、Binance `underlyingType`+`underlyingSubType`）；
+ * 取不到时留空，禁止按符号字面猜（`SPX` 在 OKX 是迷因币 SPX6900，标普 500 是 `US500`）。
+ */
+type InstrumentAssetClass = 'crypto' | 'equity' | 'commodity' | 'index';
+/** 合约专有元数据（仅 `form=perp` 有值）：交易所元数据原样透传，不本地推断。 */
+interface InstrumentContract {
+  /** 合约乘数（OKX ctVal / Binance contractSize）。 */
+  readonly multiplier?: number;
+  /** 最小价格变动。 */
+  readonly tickSize?: number;
+  /** 最小下单量/张数步长。 */
+  readonly lotSize?: number;
+  /** 交易所允许的最大杠杆。 */
+  readonly maxLeverage?: number;
+  /** 结算币种（如 USDT）。 */
+  readonly settleCcy?: string;
+}
+/**
+ * 标的检索结果的最小元数据（名册/搜索/wire 共用）。
+ * 元素形状对既有 `{ symbol, name? }` 实现向后兼容：`form`/`assetClass`/`contract` 全可选。
+ */
+interface InstrumentRef {
+  /** 市场规范词汇符号（docs/guides/symbol-vocabulary.md）。 */
+  readonly symbol: string;
+  readonly name?: string;
+  /** 缺省 = spot（老数据零迁移）。 */
+  readonly form?: InstrumentForm;
+  readonly assetClass?: InstrumentAssetClass;
+  readonly contract?: InstrumentContract;
+}
 /**
  * 行情服务契约：由市场连接器实现，注册到按市场命名空间的 ctx 键（如 ctx.tradingCrypto）。
- * 符号词汇（2026-08-31 规范，docs/symbol-vocabulary.md）：入参接受市场规范形与连接器原生形，
+ * 符号词汇（2026-08-31 规范，docs/guides/symbol-vocabulary.md）：入参接受市场规范形与连接器原生形，
  * 输出 `symbol` 一律市场规范形——消费方（GUI/Agent/工作流）与数据源方言解耦。
  */
 interface MarketDataService {
@@ -497,13 +554,12 @@ interface MarketDataService {
   subscribeTicker(symbol: string, cb: (ticker: Ticker) => void): Disposable;
   /**
    * 查询本市场/交易所支持的全部标的名册（动态全集，Issue #15）。
-   * 输出 `symbol` 一律市场规范词汇（docs/symbol-vocabulary.md）。
+   * 输出 `symbol` 一律市场规范词汇（docs/guides/symbol-vocabulary.md），形态由符号后缀承载
+   * （`-SWAP` = 永续，`instrumentFormOf` 是唯一裁决实现）；每行可带
+   * `form`/`assetClass`/`contract` 元数据（InstrumentRef），缺省 = 现货。
    * 可选方法：无公开全集端点的数据源（如 tencent/yahoo/stooq）可缺省或由桥/前端回退。
    */
-  listInstruments?(): Promise<Array<{
-    symbol: string;
-    name?: string;
-  }>>;
+  listInstruments?(): Promise<InstrumentRef[]>;
   /**
    * 标的基本面与估值快照（GUI「基本面」页签用，2026-09-02）。
    * 可选方法：仅当数据源在同一公共端点里携带基本面字段时实现
@@ -539,11 +595,41 @@ interface MarketDataService {
   getRecentTrades?(symbol: string, limit?: number): Promise<TradeTick[]>;
 }
 /**
- * 交易服务契约：placeOrder 默认 dry-run；实盘前必须过插件 liveTrading 开关与
+ * 杠杆设置请求（合约交易语义，P7；仅 `form=perp` 的标的可传）。
+ * dryRun 缺省视为 true：只回本地模拟回执，不触碰交易所（与 placeOrder 同语义）。
+ */
+interface SetLeverageRequest {
+  readonly symbol: string;
+  /** 目标杠杆倍数（> 0；上限以交易所规格 `InstrumentContract.maxLeverage` 为准，超出即结构化拒绝）。 */
+  readonly leverage: number;
+  readonly marginMode: MarginMode;
+  /** 双向持仓模式下的方向（OKX `posSide`）；净持仓模式下缺席。 */
+  readonly posSide?: 'long' | 'short';
+  /** 全仓模式下按币种设置杠杆时的保证金币（OKX `ccy`）；逐仓与净持仓模式缺席。 */
+  readonly ccy?: string;
+  /** 缺省/true 时仅模拟。实盘还受 @dshtrading/authority 的人工签署授权与 approval 约束 [S4]。 */
+  readonly dryRun?: boolean;
+}
+/** 杠杆设置回执（dryRun=true 时是本地模拟回执，不触网）。 */
+interface LeverageSetting {
+  readonly symbol: string;
+  readonly leverage: number;
+  readonly marginMode: MarginMode;
+  readonly posSide?: 'long' | 'short';
+  readonly ccy?: string;
+  /** 本次是否为模拟回执（回执必须显式回带，防 dry-run 语义丢失）。 */
+  readonly dryRun: boolean;
+  readonly timestamp: number;
+}
+/**
+ * 交易服务契约：placeOrder 默认 dry-run；实盘前必须过 @dshtrading/authority 的人工签署授权与
  * ctx.approval.request（交互形态；headless 下 ask=deny，fail-closed [S4]）。
  *
  * R3（okx 切片 2026-08-29）修订：cancelOrder 增加可选 symbol、新增 getOrder——
  * OKX 按 (instId, ordId) 双键定位订单，单参 id 形态不够；无其他实现方，扩展向后兼容。
+ *
+ * P7（合约交易 Tier 2，2026-10-08）修订：新增可选 `setLeverage`——杠杆/保证金模式变更
+ * 是实盘动作，必须与下单同门槛（服务缝三态闸门 + base 审批闸门 + 人工签署授权）。
  */
 interface TradeService {
   placeOrder(req: OrderRequest): Promise<Order>;
@@ -568,6 +654,13 @@ interface TradeService {
    * 可选方法：时间升序（旧→新），最多 limit 条（缺省 ≤50）。
    */
   listTradeFills?(symbol?: string, limit?: number): Promise<TradeFill[]>;
+  /**
+   * 设置合约杠杆与保证金模式（P7 合约交易 Tier 2；仅支持合约的交易所实现）。
+   * 可选方法：不实现的连接器缺席即可，消费方按 TRADING_NOT_IMPLEMENTED 语义处理。
+   * 这是会改变账户真实风险参数的实盘动作：dryRun 缺省 true（只回本地模拟回执），
+   * dryRun=false 必须同时具备人工签署的实盘授权，并经 base 审批闸门。
+   */
+  setLeverage?(req: SetLeverageRequest): Promise<LeverageSetting>;
 }
 /**
  * Cordis Context 服务键（能力三角色之「声明」）：市场命名空间键由契约包统一声明，
@@ -598,7 +691,7 @@ declare module '@deepseek-ai/cordis' {
      * 交易服务注册表（issue #40 GUI 交易台，@dshtrading/api 类型声明）：
      * 与 tradingMarketDataRegistry 同构的宿主平面注册面——交易连接器 host 面数据行
      * 注册，GUI 桥按路由当前值惰性解析。**注册不改变安全语义**：placeOrder 的
-     * 服务缝闸门（dryRun 缺省 true + liveTrading 显式开关）随服务实例生效；
+     * 服务缝闸门（dryRun 缺省 true + @dshtrading/authority 人工签署授权）随服务实例生效；
      * GUI 桥只放行 dry-run 下单与只读查询，实盘路径仍走 Agent 工具的 base 审批闸门。
      */
     tradingTradeRegistry: TradeRegistry;
@@ -799,4 +892,4 @@ interface TradingNewsRegistry {
   markets(): string[];
 }
 //#endregion
-export { AccountBalance, AggregateNewsOptions, AggregateNewsResult, AuctionSnapshot, BuybackItem, CompanyProfile, CryptoFundamentals, DerivativesData, DerivativesHistory, DerivativesPoint, Disposable, DividendItem, DragonTigerItem, FinancialCell, FinancialIndicatorRow, FinancialReportGroup, FinancialReportMatrix, FlashFeedService, ForecastSummary, FundamentalsPackage, HolderNumSummary, InsiderTradeItem, InstitutionalHoldingItem, Interval, Kline, LimitUpPoolItem, MacroCalendarEntry, MacroFeedService, MacroRateEntry, MainOperationSegment, MarketDataRegistration, MarketDataRegistry, MarketDataService, MarketRouterService, NewsAggregator, NewsItem, OperatingEfficiency, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Orderbook, OrderbookLevel, Position, PositionSide, ResearchReportItem, ShareholderItem, SplitItem, StockFundamentals, Ticker, TradeFill, TradeRegistration, TradeRegistry, TradeService, TradeTick, TradingNewsRegistry };
+export { AccountBalance, AggregateNewsOptions, AggregateNewsResult, AuctionSnapshot, BuybackItem, CompanyProfile, CryptoFundamentals, DerivativesData, DerivativesHistory, DerivativesPoint, Disposable, DividendItem, DragonTigerItem, FinancialCell, FinancialIndicatorRow, FinancialReportGroup, FinancialReportMatrix, FlashFeedService, ForecastSummary, FundamentalsPackage, HolderNumSummary, InsiderTradeItem, InstitutionalHoldingItem, InstrumentAssetClass, InstrumentContract, InstrumentForm, InstrumentRef, Interval, Kline, LeverageSetting, LimitUpPoolItem, MacroCalendarEntry, MacroFeedService, MacroRateEntry, MainOperationSegment, MarginMode, MarketDataRegistration, MarketDataRegistry, MarketDataService, MarketRouterService, NewsAggregator, NewsItem, OperatingEfficiency, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Orderbook, OrderbookLevel, Position, PositionSide, ResearchReportItem, SetLeverageRequest, ShareholderItem, SplitItem, StockFundamentals, Ticker, TradeFill, TradeRegistration, TradeRegistry, TradeService, TradeTick, TradingNewsRegistry };

package/lib/api/lib/instrument-form.d.ts

@@ -0,0 +1 @@
+import "./index.js";

package/lib/derivatives.d.ts

@@ -7,7 +7,11 @@ interface DerivativesFetchOptions {
 interface DerivativesResult {
   data?: DerivativesData;
   unavailable?: string[];
+  /** 注册表路径实际供数的 provider（直连回退路径缺省，不回显假 provider）。 */
+  provider?: string;
 }
+/** provider 取数失败时的降级结果（fail-soft：与直连路径同一契约，报错不抛裸异常）。 */
+declare function derivativesFailure(provider: string, error: unknown): DerivativesResult;
 /** 将输入 symbol 规范化为 Binance USDT-M 合约 symbol（如 BTCUSDT）。 */
 declare function normalizeBinanceFuturesSymbol(raw: string): string;
 /** 提取 base 资产名称（如 BTCUSDT → BTC）。 */
@@ -15,4 +19,4 @@ declare function extractBaseAsset(symbol: string): string;
 declare function fetchCryptoDerivatives(options: DerivativesFetchOptions): Promise<DerivativesResult>;
 declare function renderDerivativesData(result: DerivativesResult, requestedSymbol: string): string;
 //#endregion
-export { DerivativesFetchOptions, DerivativesResult, extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData };
+export { DerivativesFetchOptions, DerivativesResult, derivativesFailure, extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData };

package/lib/derivatives.js

@@ -1,4 +1,11 @@
 //#region src/derivatives.ts
+/** provider 取数失败时的降级结果（fail-soft：与直连路径同一契约，报错不抛裸异常）。 */
+function derivativesFailure(provider, error) {
+	return {
+		provider,
+		unavailable: [`${provider}-getDerivatives: ${typeof error?.code === "string" ? `${error.code}: ` : ""}${error instanceof Error ? error.message : String(error)}`]
+	};
+}
 const BINANCE_FAPI_BASE = "https://fapi.binance.com";
 const BINANCE_FUTURES_DATA_BASE = "https://fapi.binance.com/futures/data";
 /** 将输入 symbol 规范化为 Binance USDT-M 合约 symbol（如 BTCUSDT）。 */
@@ -92,14 +99,23 @@ async function fetchCryptoDerivatives(options) {
 	return { unavailable };
 }
 function renderDerivativesData(result, requestedSymbol) {
-	const { data, unavailable = [] } = result;
+	const { data, unavailable = [], provider } = result;
 	if (!data) return `crypto_get_derivatives ${requestedSymbol}: no derivative data available.${unavailable.length > 0 ? ` (errors: ${unavailable.join("; ")})` : ""}`;
-	const lines = [`crypto_get_derivatives ${data.symbol} (source: ${data.source}, updated: ${new Date(data.timestamp).toISOString()}):`];
+	const origin = provider === void 0 ? `source: ${data.source}` : `provider: ${provider}, source: ${data.source}`;
+	const lines = [`crypto_get_derivatives ${data.symbol} (${origin}, updated: ${new Date(data.timestamp).toISOString()}):`];
 	if (data.openInterest !== void 0) lines.push(`- Open Interest (OI): ${data.openInterest.toLocaleString()} base-coins`);
+	if (data.openInterestValue !== void 0) lines.push(`- Open Interest Value: ${data.openInterestValue.toLocaleString()} quote`);
 	if (data.fundingRate !== void 0) {
 		const pct = (data.fundingRate * 100).toFixed(4);
 		lines.push(`- Latest Funding Rate: ${data.fundingRate} (${pct}%)`);
 	}
+	if (data.nextFundingRate !== void 0) {
+		const pct = (data.nextFundingRate * 100).toFixed(4);
+		lines.push(`- Next Funding Rate: ${data.nextFundingRate} (${pct}%)`);
+	}
+	if (data.nextFundingTime !== void 0) lines.push(`- Next Funding Time: ${new Date(data.nextFundingTime).toISOString()}`);
+	if (data.markPrice !== void 0) lines.push(`- Mark Price: ${data.markPrice}`);
+	if (data.indexPrice !== void 0) lines.push(`- Index Price: ${data.indexPrice}`);
 	if (data.longShortRatio !== void 0) lines.push(`- Global Long/Short Account Ratio: ${data.longShortRatio.toFixed(2)} (Accounts)`);
 	if (data.topTraderLongShortRatio !== void 0) lines.push(`- Top Trader Position L/S Ratio: ${data.topTraderLongShortRatio.toFixed(2)} (Whale Positions)`);
 	if (data.takerBuySellRatio !== void 0) lines.push(`- Taker Buy/Sell Volume Ratio: ${data.takerBuySellRatio.toFixed(2)} (Market taker aggressiveness)`);
@@ -107,4 +123,4 @@ function renderDerivativesData(result, requestedSymbol) {
 	return lines.join("\n");
 }
 //#endregion
-export { extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData };
+export { derivativesFailure, extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData };

package/lib/index.d.ts

@@ -1,6 +1,6 @@
 import { MarketDataService } from "./api/lib/index.js";
 import { CryptoFundamentalsOptions, CryptoFundamentalsResult, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, renderCryptoFundamentals } from "./fundamentals.js";
-import { DerivativesFetchOptions, DerivativesResult, extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData } from "./derivatives.js";
+import { DerivativesFetchOptions, DerivativesResult, derivativesFailure, extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData } from "./derivatives.js";
 import { AggregateNewsOptions, AggregateNewsResult, NewsItem, NewsSource, aggregateNews, deriveSymbolTokens, parseCryptoPanic, parseRss2 } from "./news.js";
 import Schema from "@deepseek-ai/schemastery";
 import { SkillProvider } from "@deepseek-ai/dsh-skill";
@@ -16,11 +16,27 @@ interface Config {
 declare const Config: Schema<Config>;
 declare const inject: string[];
 declare const name = "dsh-trading-crypto-kit";
+/**
+ * 资金费率工具工厂（只读）。调用期用注册表之外的直连 Binance fapi 公共端点；
+ * fetch 可注入（与 `createGetDerivativesTool` 同款契约化 fake 口径，测试不出网）。
+ */
+declare function createFundingRateTool(options?: {
+  fetch?: typeof globalThis.fetch;
+}): import("@deepseek-ai/dsh-tools").ToolDefinition;
 /** 白名单视图：未知名 fail-fast 不静默缩面；白名单外的 get 拒绝分发。 */
 declare function providerForSkills(allowed?: readonly string[] | null): SkillProvider;
 declare function apply(ctx: Context, config: Config): void;
+/**
+ * 衍生品指标快照工具（只读）。registry-first：数据源是路由选中的 crypto 行情服务
+ * （与 crypto_get_derivatives_history 同源，settings 切换 provider 即刻生效）；注册表
+ * 服务缺席（老部署 / 无 router）时才回退直连 Binance USDT-M 公共端点。
+ * 路由到的 provider 未实现 getDerivatives → TRADING_NOT_IMPLEMENTED（不回退 Binance
+ * 冒充路由源，也不返回空读数）；provider 取数失败 → fail-soft 报错文本（与直连路径
+ * 同一输出契约）。
+ */
 declare function createGetDerivativesTool(options?: {
   fetch?: typeof globalThis.fetch;
+  getRegistry?: () => CryptoMarketDataRegistry | undefined;
 }): import("@deepseek-ai/dsh-tools").ToolDefinition;
 /** 行情注册表最小形状（与 @dshtrading/router 的 MarketDataRegistryLike 同构）。 */
 interface CryptoMarketDataRegistry {
@@ -30,8 +46,8 @@ interface CryptoMarketDataRegistry {
   } | undefined;
 }
 /**
- * 衍生品历史序列工具（只读）。数据源恒为路由选中的 crypto 行情服务，不直连交易所：
- * 与 crypto_get_derivatives 的硬编码 Binance 数据源不一致（审计既存项）有意不复刻。
+ * 衍生品历史序列工具（只读）。数据源恒为路由选中的 crypto 行情服务，不直连交易所；
+ * crypto_get_derivatives 自 P6（2026-10-08）起同源（registry-first），两者不再分叉。
  */
 declare function createGetDerivativesHistoryTool(options: {
   getRegistry: () => CryptoMarketDataRegistry | undefined;
@@ -44,4 +60,4 @@ declare function createGetNewsTool(toolOptions?: {
   getSources?: () => readonly string[] | undefined;
 }): import("@deepseek-ai/dsh-tools").ToolDefinition;
 //#endregion
-export { AggregateNewsOptions, AggregateNewsResult, Config, CryptoFundamentalsOptions, CryptoFundamentalsResult, DerivativesFetchOptions, DerivativesResult, NewsItem, NewsSource, aggregateNews, apply, createGetDerivativesHistoryTool, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, providerForSkills, renderCryptoFundamentals, renderDerivativesData };
+export { AggregateNewsOptions, AggregateNewsResult, Config, CryptoFundamentalsOptions, CryptoFundamentalsResult, DerivativesFetchOptions, DerivativesResult, NewsItem, NewsSource, aggregateNews, apply, createFundingRateTool, createGetDerivativesHistoryTool, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, derivativesFailure, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, providerForSkills, renderCryptoFundamentals, renderDerivativesData };

package/lib/index.js

@@ -1,5 +1,5 @@
 import { aggregateNews, deriveSymbolTokens, parseCryptoPanic, parseRss2 } from "./news.js";
-import { extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData } from "./derivatives.js";
+import { derivativesFailure, extractBaseAsset, fetchCryptoDerivatives, normalizeBinanceFuturesSymbol, renderDerivativesData } from "./derivatives.js";
 import { fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, renderCryptoFundamentals } from "./fundamentals.js";
 import { readFile } from "node:fs/promises";
 import { fileURLToPath } from "node:url";
@@ -139,11 +139,11 @@ const FUNDING_RATE_URL = "https://fapi.binance.com/fapi/v1/fundingRate";
 const SYMBOL_PATTERN = /^[A-Z0-9]{4,20}$/;
 const DEFAULT_FUNDING_LIMIT = 3;
 const MAX_FUNDING_LIMIT = 1e3;
-async function fetchFundingRates(symbol, limit) {
+async function fetchFundingRates(symbol, limit, fetchImpl) {
 	const url = new URL(FUNDING_RATE_URL);
 	url.searchParams.set("symbol", symbol);
 	url.searchParams.set("limit", String(limit));
-	const response = await fetch(url, { headers: { accept: "application/json" } });
+	const response = await fetchImpl(url, { headers: { accept: "application/json" } });
 	if (!response.ok) {
 		const body = await response.text().catch(() => "");
 		throw new Error(`Binance futures API error: HTTP ${response.status}${body ? ` — ${body.slice(0, 200)}` : ""}`);
@@ -162,31 +162,19 @@ function renderFundingRates(symbol, records) {
 	});
 	return [`crypto_funding_rate ${symbol} — last ${records.length} funding event(s):`, ...lines].join("\n");
 }
-/** 白名单视图：未知名 fail-fast 不静默缩面；白名单外的 get 拒绝分发。 */
-function providerForSkills(allowed) {
-	if (!allowed) return provider;
-	const unknown = allowed.filter((name) => !SKILL_CANDIDATES.some((c) => c.name === name));
-	if (unknown.length > 0) throw new Error(`[${PROVIDER_NAME}] unknown skills in whitelist: ${unknown.join(", ")}`);
-	const active = SKILL_CANDIDATES.filter((c) => allowed.includes(c.name));
-	return {
-		name: provider.name,
-		list: () => Promise.resolve(active),
-		async get(candidate, options) {
-			if (!active.some((c) => c.name === candidate.name)) throw new Error(`[${PROVIDER_NAME}] skill not in whitelist: ${candidate.name}`);
-			return provider.get(candidate, options);
-		}
-	};
-}
-function apply(ctx, config) {
-	ctx.skills.registerProvider(() => providerForSkills(config.skills));
-	const fundingTool = defineTool({
+/**
+* 资金费率工具工厂（只读）。调用期用注册表之外的直连 Binance fapi 公共端点；
+* fetch 可注入（与 `createGetDerivativesTool` 同款契约化 fake 口径，测试不出网）。
+*/
+function createFundingRateTool(options = {}) {
+	return defineTool({
 		name: "crypto_funding_rate",
-		description: "Get recent funding rate history for a Binance USDⓈ-M perpetual futures symbol (public endpoint, no credentials). Returns the most recent funding events with rate and mark price.",
+		description: "Get recent funding rate history for a Binance USDⓈ-M perpetual contract (public endpoint, no credentials). The symbol is market-canonical perpetual form, e.g. BTCUSDT-SWAP; the native spot-shaped BTCUSDT is accepted too. Returns the most recent funding events with rate and mark price.",
 		parameters: {
 			symbol: {
 				type: "string",
 				required: true,
-				description: "Perpetual futures symbol, e.g. BTCUSDT"
+				description: "Perpetual contract symbol, market-canonical form, e.g. BTCUSDT-SWAP"
 			},
 			limit: {
 				type: "number",
@@ -203,12 +191,32 @@ function apply(ctx, config) {
 		},
 		async execute(raw) {
 			const args = raw ?? {};
-			const symbol = typeof args.symbol === "string" ? args.symbol.trim().toUpperCase() : "";
-			if (!SYMBOL_PATTERN.test(symbol)) throw new Error(`crypto_funding_rate: invalid symbol ${JSON.stringify(args.symbol)} — expected an uppercase Binance futures symbol like BTCUSDT`);
+			const requestedSymbol = typeof args.symbol === "string" ? args.symbol.trim() : "";
+			const symbol = normalizeBinanceFuturesSymbol(requestedSymbol);
+			if (!SYMBOL_PATTERN.test(symbol)) throw new Error(`crypto_funding_rate: invalid symbol ${JSON.stringify(args.symbol)} — expected a perpetual symbol, market-canonical form e.g. BTCUSDT-SWAP (native BTCUSDT is also accepted)`);
 			const requested = typeof args.limit === "number" && Number.isFinite(args.limit) ? Math.trunc(args.limit) : DEFAULT_FUNDING_LIMIT;
-			return renderFundingRates(symbol, await fetchFundingRates(symbol, Math.min(Math.max(requested, 1), MAX_FUNDING_LIMIT)));
+			const records = await fetchFundingRates(symbol, Math.min(Math.max(requested, 1), MAX_FUNDING_LIMIT), options.fetch ?? globalThis.fetch);
+			return renderFundingRates(`${symbol}-SWAP`, records);
 		}
 	});
+}
+/** 白名单视图：未知名 fail-fast 不静默缩面；白名单外的 get 拒绝分发。 */
+function providerForSkills(allowed) {
+	if (!allowed) return provider;
+	const unknown = allowed.filter((name) => !SKILL_CANDIDATES.some((c) => c.name === name));
+	if (unknown.length > 0) throw new Error(`[${PROVIDER_NAME}] unknown skills in whitelist: ${unknown.join(", ")}`);
+	const active = SKILL_CANDIDATES.filter((c) => allowed.includes(c.name));
+	return {
+		name: provider.name,
+		list: () => Promise.resolve(active),
+		async get(candidate, options) {
+			if (!active.some((c) => c.name === candidate.name)) throw new Error(`[${PROVIDER_NAME}] skill not in whitelist: ${candidate.name}`);
+			return provider.get(candidate, options);
+		}
+	};
+}
+function apply(ctx, config) {
+	ctx.skills.registerProvider(() => providerForSkills(config.skills));
 	const tools = ctx.tools;
 	const registerOnce = (tool) => {
 		if (tools.get(tool.name) !== void 0) {
@@ -217,7 +225,7 @@ function apply(ctx, config) {
 		}
 		tools.register(tool);
 	};
-	registerOnce(fundingTool);
+	registerOnce(createFundingRateTool());
 	const router = ctx.get?.("tradingMarketRouter", false);
 	const routerCtx = ctx;
 	const readNewsSources = () => (routerCtx.get?.("tradingMarketRouter", false))?.newsSources?.("crypto");
@@ -225,7 +233,7 @@ function apply(ctx, config) {
 		cryptoPanicKey: router?.newsKey?.(),
 		getSources: readNewsSources
 	}));
-	registerOnce(createGetDerivativesTool());
+	registerOnce(createGetDerivativesTool({ getRegistry: () => resolveCryptoMarketDataRegistry(ctx) }));
 	registerOnce(createGetFundamentalsTool());
 	registerOnce(createGetDerivativesHistoryTool({ getRegistry: () => resolveCryptoMarketDataRegistry(ctx) }));
 	const lifecycle = ctx;
@@ -234,14 +242,22 @@ function apply(ctx, config) {
 		if (registry && typeof registry.register === "function") lifecycle.effect?.(() => registry.register("crypto", aggregateNews), "kit-crypto news registration");
 	});
 }
+/**
+* 衍生品指标快照工具（只读）。registry-first：数据源是路由选中的 crypto 行情服务
+* （与 crypto_get_derivatives_history 同源，settings 切换 provider 即刻生效）；注册表
+* 服务缺席（老部署 / 无 router）时才回退直连 Binance USDT-M 公共端点。
+* 路由到的 provider 未实现 getDerivatives → TRADING_NOT_IMPLEMENTED（不回退 Binance
+* 冒充路由源，也不返回空读数）；provider 取数失败 → fail-soft 报错文本（与直连路径
+* 同一输出契约）。
+*/
 function createGetDerivativesTool(options = {}) {
 	return defineTool({
 		name: "crypto_get_derivatives",
-		description: "Get real-time crypto derivatives indicators (Open Interest, Long/Short Account Ratio, Top Trader Position Ratio, Taker Buy/Sell Volume Ratio, and latest Funding Rate) for a perpetual contract via Binance Futures public REST API. Accepts market-canonical (e.g. BTCUSDT, BTCUSDT-SWAP) or native symbols. No credentials required.",
+		description: "Read-only derivatives snapshot for a crypto perpetual, symbol in market-canonical form, e.g. BTCUSDT-SWAP: open interest, long/short account ratio, top-trader position ratio, taker buy/sell volume ratio, funding rate, mark and index price. Source: the crypto provider chosen by market routing (same as crypto_get_derivatives_history). With no router service it falls back to Binance public endpoints; a routed provider without getDerivatives fails with TRADING_NOT_IMPLEMENTED.",
 		parameters: { symbol: {
 			type: "string",
 			required: true,
-			description: "Perpetual contract symbol, market-canonical vocabulary, e.g. BTCUSDT or BTCUSDT-SWAP"
+			description: "Perpetual contract symbol, market-canonical form, e.g. BTCUSDT-SWAP"
 		} },
 		output: {
 			schema: { type: "string" },
@@ -253,7 +269,24 @@ function createGetDerivativesTool(options = {}) {
 		async execute(raw) {
 			const args = raw ?? {};
 			const symbol = typeof args.symbol === "string" ? args.symbol.trim() : "";
-			if (!symbol) throw new Error("crypto_get_derivatives: symbol parameter is required (e.g. BTCUSDT or BTCUSDT-SWAP)");
+			if (!symbol) throw new Error("crypto_get_derivatives: symbol parameter is required (e.g. BTCUSDT-SWAP)");
+			const entry = options.getRegistry?.()?.active("crypto");
+			if (entry !== void 0) {
+				const getDerivatives = entry.service.getDerivatives;
+				if (typeof getDerivatives !== "function") throw new Error(`crypto_get_derivatives: TRADING_NOT_IMPLEMENTED — provider ${entry.provider} does not implement getDerivatives (this is not "no data")`);
+				let returned;
+				try {
+					returned = await getDerivatives.call(entry.service, symbol);
+				} catch (error) {
+					return renderDerivativesData(derivativesFailure(entry.provider, error), symbol);
+				}
+				const data = returned;
+				if (data === null || typeof data !== "object" || typeof data.symbol !== "string" || data.symbol === "") throw new Error(`crypto_get_derivatives: provider ${entry.provider} returned an invalid derivatives payload`);
+				return renderDerivativesData({
+					data,
+					provider: entry.provider
+				}, symbol);
+			}
 			const result = await fetchCryptoDerivatives({
 				symbol,
 				fetch: options.fetch
@@ -276,18 +309,18 @@ function parseDerivativesHistoryLimit(raw) {
 	return limit;
 }
 /**
-* 衍生品历史序列工具（只读）。数据源恒为路由选中的 crypto 行情服务，不直连交易所：
-* 与 crypto_get_derivatives 的硬编码 Binance 数据源不一致（审计既存项）有意不复刻。
+* 衍生品历史序列工具（只读）。数据源恒为路由选中的 crypto 行情服务，不直连交易所；
+* crypto_get_derivatives 自 P6（2026-10-08）起同源（registry-first），两者不再分叉。
 */
 function createGetDerivativesHistoryTool(options) {
 	return defineTool({
 		name: "crypto_get_derivatives_history",
-		description: `Read-only. Get the derivatives history series for a crypto perpetual contract — funding-rate history and open-interest history, both time-ascending (oldest first) — from the currently routed crypto market data provider (registry-first; never a hardcoded exchange). The returned symbol is the provider-canonical form. Optional limit keeps only the most recent N points per series (${DERIVATIVES_HISTORY_MIN_LIMIT}-${DERIVATIVES_HISTORY_MAX_LIMIT}) and reports truncatedTo. If the routed provider does not implement getDerivativesHistory the call fails with TRADING_NOT_IMPLEMENTED — an empty series is never substituted for "no data"; if no crypto provider is routed it fails with TRADING_NO_PROVIDER.`,
+		description: "Read-only derivatives history for a crypto perpetual: funding-rate and open-interest series, time-ascending, from the currently routed crypto provider (registry-first, never a hardcoded exchange). The returned symbol is market-canonical; optional limit keeps the most recent N points per series. An unimplemented getDerivativesHistory fails with TRADING_NOT_IMPLEMENTED (never an empty series); no crypto provider routed fails with TRADING_NO_PROVIDER.",
 		parameters: {
 			symbol: {
 				type: "string",
 				required: true,
-				description: "Perpetual contract symbol, market-canonical vocabulary, e.g. BTCUSDT or BTCUSDT-SWAP"
+				description: "Perpetual contract symbol, market-canonical form, e.g. BTCUSDT-SWAP"
 			},
 			limit: {
 				type: "number",
@@ -369,7 +402,7 @@ function renderNewsItem(item) {
 	return `[${item.source}] ${item.publishedAt}  ${item.title}\n  ${item.url}`;
 }
 function createGetNewsTool(toolOptions = {}) {
-	const description = "Get recent crypto news from public no-key sources (Binance listing/delisting/API announcements, OKX announcements, CoinDesk & The Block RSS). " + (toolOptions.cryptoPanicKey ? "CryptoPanic user key is set — the CryptoPanic free tier is queried as an additional source and degrades gracefully if it fails. " : "") + "Aggregates and sorts newest-first; each item carries source name, publish time and a link for traceability. Optionally filter by symbol (matched against item titles; note media headlines often use asset names like \"Bitcoin\" rather than tickers) and by a time window. Source failures are tolerated and reported instead of failing the whole call. No credentials required. Distinguish announcements (listing, delisting, regulatory) from opinion (media) when citing.";
+	const description = "Get recent crypto news from public no-key sources (Binance/OKX announcements, CoinDesk & The Block RSS), newest-first with source, time and link per item. " + (toolOptions.cryptoPanicKey ? "CryptoPanic key set — its free tier is queried too and degrades gracefully on failure. " : "") + "Optional symbol filter matches item titles; headlines often use asset names not tickers. Source failures are reported, not fatal. No credentials required. Cite announcements (listing, delisting, regulatory) separately from media opinion.";
 	return defineTool({
 		name: "crypto_get_news",
 		description,
@@ -416,4 +449,4 @@ function createGetNewsTool(toolOptions = {}) {
 	});
 }
 //#endregion
-export { Config, aggregateNews, apply, createGetDerivativesHistoryTool, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, providerForSkills, renderCryptoFundamentals, renderDerivativesData };
+export { Config, aggregateNews, apply, createFundingRateTool, createGetDerivativesHistoryTool, createGetDerivativesTool, createGetFundamentalsTool, createGetNewsTool, derivativesFailure, deriveSymbolTokens, extractBaseAsset, fetchCryptoDerivatives, fetchCryptoFundamentals, fetchCryptoFundamentalsPackage, inject, name, normalizeBinanceFuturesSymbol, parseCryptoPanic, parseRss2, provider, providerForSkills, renderCryptoFundamentals, renderDerivativesData };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/kit-crypto",
   "description": "Crypto toolkit plugin for dsh-trading: market-specific tools and bundled trading skills (skill provider); runs as a crypto-trader preset row (session-scoped)",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -18,19 +18,19 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/indicators": "0.4.1",
-    "@dshtrading/knowledge": "0.4.1"
+    "@dshtrading/indicators": "0.6.0",
+    "@dshtrading/knowledge": "0.6.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",
-    "@deepseek-ai/dsh-skill": ">=0.1.5-rc.1",
-    "@deepseek-ai/dsh-tools": ">=0.1.5-rc.1",
+    "@deepseek-ai/dsh-skill": ">=0.2.0-rc.2",
+    "@deepseek-ai/dsh-tools": ">=0.2.0-rc.2",
     "@deepseek-ai/schemastery": ">=3.18.0"
   },
   "devDependencies": {
     "tsdown": "^0.22.0",
     "vitest": "^3.0.0",
-    "@dshtrading/api": "0.4.1"
+    "@dshtrading/api": "0.6.0"
   },
   "scripts": {
     "build": "tsdown",