@dshtrading/connector-bybit 0.5.0 → 0.6.0

package/README.md

@@ -7,7 +7,7 @@
 node scripts/new-connector.mjs --slug bybit --title Bybit --market crypto
 ```
 
-生成后按 [docs/connector-playbook.md](../../docs/connector-playbook.md) 的填写顺序
+生成后按 [docs/guides/connector-playbook.md](../../docs/guides/connector-playbook.md) 的填写顺序
 （src/rest.ts 头部清单 7 项）实现 TODO。每个 TODO 的参照段都在 connector-okx
 （packages/connector-okx/），它是本仓第一个真实 TradeService 连接器。
 

package/lib/index.d.ts

@@ -1,7 +1,7 @@
-import { AccountBalance, BybitRestClient, BybitRestOptions, INTERVAL_VOCABULARY, Interval, Kline, Order, Position, Ticker, TradingServiceError, normalizeCryptoSymbol, parseIntervalMs, toBybitInterval } from "./rest.js";
+import { AccountBalance, BybitRestClient, BybitRestOptions, INTERVAL_VOCABULARY, Interval, Kline, Order, ParsedCryptoSymbol, Position, Ticker, TradingServiceError, bybitAssetClassOf, bybitCategory, normalizeCryptoSymbol, parseCryptoSymbol, parseIntervalMs, toBybitInterval } from "./rest.js";
 import { Context, Service } from "@deepseek-ai/cordis";
 import Schema from "@deepseek-ai/schemastery";
-import { AccountBalance as AccountBalance$1, DerivativesData, DerivativesHistory, Disposable, Interval as Interval$1, Kline as Kline$1, MarketDataService, Order as Order$1, OrderRequest, Orderbook, Position as Position$1, Ticker as Ticker$1, TradeFill, TradeService, TradeTick } from "@dshtrading/api";
+import { AccountBalance as AccountBalance$1, DerivativesData, DerivativesHistory, Disposable, InstrumentRef, Interval as Interval$1, Kline as Kline$1, MarketDataService, Order as Order$1, OrderRequest, Orderbook, Position as Position$1, Ticker as Ticker$1, TradeFill, TradeService, TradeTick } from "@dshtrading/api";
 //#region src/index.d.ts
 declare const name = "dsh-trading-crypto-connector-bybit";
 interface Config {
@@ -20,6 +20,13 @@ declare class BybitMarketDataService extends Service implements MarketDataServic
   constructor(ctx: Context, options?: BybitRestOptions, serviceName?: string);
   getTicker(symbol: string): Promise<Ticker$1>;
   getKlines(symbol: string, interval?: Interval$1, limit?: number): Promise<Kline$1[]>;
+  /**
+   * 标的名册（P3）：现货 ∪ 线性永续；永续输出规范形 `BTCUSDT-SWAP`（form=perp）。
+   * assetClass 只由交易所 `symbolType` 字面量裁决（stock/ETF/xstocks→equity、
+   * commodity→commodity、innovation/adventure→crypto）；交易所没给（空串）或未登记
+   * （forex/mstocks）即留空，不本地推断（见 rest.ts bybitAssetClassOf）。
+   */
+  listInstruments(): Promise<InstrumentRef[]>;
   subscribeTicker(symbol: string, cb: (ticker: Ticker$1) => void, options?: {
     intervalMs?: number;
   }): Disposable;
@@ -43,7 +50,7 @@ declare class BybitMarketDataService extends Service implements MarketDataServic
 }
 declare class BybitTradeService extends Service implements TradeService {
   private readonly client;
-  /** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 总闸门）。 */
+  /** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 非权威镜像——实盘授权由 @dshtrading/authority 的人工签署平面裁定）。 */
   private readonly config;
   constructor(ctx: Context, options: BybitRestOptions & {
     config: Config;
@@ -61,4 +68,4 @@ declare const ROUTER_PROVIDER = "bybit";
 declare function routeAllows(ctx: Context, config: Config, market: string): boolean;
 declare function apply(ctx: Context, config: Config): void;
 //#endregion
-export { type AccountBalance, BybitMarketDataService, BybitRestClient, BybitRestOptions, BybitTradeService, Config, INTERVAL_VOCABULARY, type Interval, type Kline, type Order, type Position, ROUTER_PROVIDER, TRADING_CRYPTO_MARKET_DATA_KEY, TRADING_CRYPTO_TRADE_KEY, type Ticker, TradingServiceError, apply, name, normalizeCryptoSymbol, parseIntervalMs, routeAllows, toBybitInterval };
+export { type AccountBalance, BybitMarketDataService, BybitRestClient, BybitRestOptions, BybitTradeService, Config, INTERVAL_VOCABULARY, type Interval, type Kline, type Order, ParsedCryptoSymbol, type Position, ROUTER_PROVIDER, TRADING_CRYPTO_MARKET_DATA_KEY, TRADING_CRYPTO_TRADE_KEY, type Ticker, TradingServiceError, apply, bybitAssetClassOf, bybitCategory, name, normalizeCryptoSymbol, parseCryptoSymbol, parseIntervalMs, routeAllows, toBybitInterval };

package/lib/index.js

@@ -1,8 +1,13 @@
-import { BybitRestClient, INTERVAL_VOCABULARY, TradingServiceError, normalizeCryptoSymbol, parseIntervalMs, toBybitInterval } from "./rest.js";
+import { BybitRestClient, INTERVAL_VOCABULARY, TradingServiceError, bybitAssetClassOf, bybitCategory, normalizeCryptoSymbol, parseCryptoSymbol, parseIntervalMs, toBybitInterval } from "./rest.js";
+import { liveTradingEnabled } from "@dshtrading/authority";
 import { Service } from "@deepseek-ai/cordis";
 import { defineTool } from "@deepseek-ai/dsh-tools";
 import Schema from "@deepseek-ai/schemastery";
 //#region src/index.ts
+/**
+* @dshtrading/connector-bybit
+* Bybit 加密货币连接器插件（提供 tradingCryptoMarketData 与 crypto_* 工具）。
+*/
 const name = "dsh-trading-crypto-connector-bybit";
 const Config = Schema.object({
 	enabled: Schema.boolean().default(true).description("是否激活 Bybit 连接器"),
@@ -26,6 +31,15 @@ var BybitMarketDataService = class extends Service {
 	async getKlines(symbol, interval = "1d", limit = 100) {
 		return this.client.getKlines(symbol, interval, limit);
 	}
+	/**
+	* 标的名册（P3）：现货 ∪ 线性永续；永续输出规范形 `BTCUSDT-SWAP`（form=perp）。
+	* assetClass 只由交易所 `symbolType` 字面量裁决（stock/ETF/xstocks→equity、
+	* commodity→commodity、innovation/adventure→crypto）；交易所没给（空串）或未登记
+	* （forex/mstocks）即留空，不本地推断（见 rest.ts bybitAssetClassOf）。
+	*/
+	async listInstruments() {
+		return this.client.listInstruments();
+	}
 	subscribeTicker(symbol, cb, options) {
 		const ms = Math.max(options?.intervalMs ?? 5e3, 1e3);
 		const tick = () => {
@@ -97,7 +111,7 @@ var BybitMarketDataService = class extends Service {
 };
 var BybitTradeService = class extends Service {
 	client;
-	/** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 总闸门）。 */
+	/** 插件配置（服务缝闸门 P0：dryRun 强制模拟 / liveTrading 非权威镜像——实盘授权由 @dshtrading/authority 的人工签署平面裁定）。 */
 	config;
 	constructor(ctx, options, serviceName = TRADING_CRYPTO_TRADE_KEY) {
 		super(ctx, serviceName);
@@ -116,7 +130,7 @@ var BybitTradeService = class extends Service {
 	}
 	async placeOrder(order) {
 		const requestedDryRun = order.dryRun ?? true;
-		if (!requestedDryRun && !this.config.liveTrading) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", `Bybit TradeService.placeOrder rejected: the request asks for real execution (dryRun=${String(order.dryRun)}) but liveTrading=false — enable liveTrading explicitly or keep dryRun=true for a simulated fill.`);
+		if (!requestedDryRun && !liveTradingEnabled(this.config.liveTrading)) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", `Bybit 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.`);
 		if (requestedDryRun || this.config.dryRun) return {
 			id: `dry-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
 			symbol: order.symbol,
@@ -131,7 +145,7 @@ var BybitTradeService = class extends Service {
 		return this.client.placeOrder(void 0, order);
 	}
 	async cancelOrder(orderId, _symbol) {
-		if (!this.config.liveTrading || this.config.dryRun) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", "Bybit TradeService.cancelOrder rejected at the service seam: cancel is a live action and requires liveTrading=true with dryRun=false.");
+		if (!liveTradingEnabled(this.config.liveTrading) || this.config.dryRun) throw new TradingServiceError("TRADING_LIVE_TRADING_DISABLED", "Bybit 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 getOrder(symbol, id) {
@@ -184,11 +198,11 @@ function apply(ctx, config) {
 		};
 		register(defineTool({
 			name: "crypto_get_ticker",
-			description: "Get the latest trade price and quote for a crypto pair via Bybit API.",
+			description: "Get the latest trade price and quote for a crypto pair via Bybit API (spot, or perpetual with the -SWAP suffix).",
 			parameters: { symbol: {
 				type: "string",
 				required: true,
-				description: "Crypto pair symbol, e.g. BTCUSDT"
+				description: "Pair symbol: BTCUSDT for spot, BTCUSDT-SWAP for the USDT perpetual"
 			} },
 			output: {
 				schema: { type: "string" },
@@ -203,12 +217,12 @@ function apply(ctx, config) {
 		}));
 		register(defineTool({
 			name: "crypto_get_klines",
-			description: "Get recent public klines for a crypto pair via Bybit API. Supports 1m/5m/15m/30m/1h/4h/1d/1w/1M.",
+			description: "Get recent public klines for a crypto pair via Bybit API (spot, or perpetual with the -SWAP suffix). Supports 1m/5m/15m/30m/1h/4h/1d/1w/1M.",
 			parameters: {
 				symbol: {
 					type: "string",
 					required: true,
-					description: "Crypto pair symbol, e.g. BTCUSDT"
+					description: "Pair symbol: BTCUSDT for spot, BTCUSDT-SWAP for the USDT perpetual"
 				},
 				interval: {
 					type: "string",
@@ -237,4 +251,4 @@ function apply(ctx, config) {
 	});
 }
 //#endregion
-export { BybitMarketDataService, BybitRestClient, BybitTradeService, Config, INTERVAL_VOCABULARY, ROUTER_PROVIDER, TRADING_CRYPTO_MARKET_DATA_KEY, TRADING_CRYPTO_TRADE_KEY, TradingServiceError, apply, name, normalizeCryptoSymbol, parseIntervalMs, routeAllows, toBybitInterval };
+export { BybitMarketDataService, BybitRestClient, BybitTradeService, Config, INTERVAL_VOCABULARY, ROUTER_PROVIDER, TRADING_CRYPTO_MARKET_DATA_KEY, TRADING_CRYPTO_TRADE_KEY, TradingServiceError, apply, bybitAssetClassOf, bybitCategory, name, normalizeCryptoSymbol, parseCryptoSymbol, parseIntervalMs, routeAllows, toBybitInterval };

package/lib/rest.d.ts

@@ -1,4 +1,4 @@
-import { AccountBalance as AccountBalance$1, DerivativesPoint, Interval as Interval$1, Kline as Kline$1, Order as Order$1, OrderRequest, Orderbook, Position as Position$1, Ticker as Ticker$1, TradeTick, TradingErrorCode } from "@dshtrading/api";
+import { AccountBalance as AccountBalance$1, DerivativesPoint, InstrumentAssetClass, InstrumentForm, InstrumentRef, Interval as Interval$1, Kline as Kline$1, Order as Order$1, OrderRequest, Orderbook, Position as Position$1, Ticker as Ticker$1, TradeTick, TradingErrorCode } from "@dshtrading/api";
 //#region src/rest.d.ts
 declare class TradingServiceError extends Error {
   readonly code: TradingErrorCode;
@@ -7,7 +7,32 @@ declare class TradingServiceError extends Error {
 declare const INTERVAL_VOCABULARY: readonly ["1m", "5m", "15m", "30m", "1h", "4h", "1d", "1w", "1M"];
 declare function toBybitInterval(interval: Interval$1): string;
 declare function parseIntervalMs(interval: Interval$1): number;
+/** 入参符号的形态裁决结果（交易所侧符号 + 规范形）。 */
+interface ParsedCryptoSymbol {
+  /** 交易所侧符号（无 `-SWAP` 后缀）：Bybit 现货与线性永续同形，如 BTCUSDT。 */
+  readonly base: string;
+  readonly form: InstrumentForm;
+  /** 市场规范形：spot=BTCUSDT、perp=BTCUSDT-SWAP（输出纪律用）。 */
+  readonly canonical: string;
+}
+/**
+ * 解析入参符号：形态由规范后缀裁决（复用 @dshtrading/api 的 instrumentFormOf，
+ * 连接器不自写 endsWith('-SWAP')）。
+ * `-SWAP` 必须整段剥掉再做分隔符清理——否则 BTCUSDT-SWAP 会被揉成 BTCUSDTSWAP，
+ * Bybit 查无此标的（issue #54 评审 M2）。
+ */
+declare function parseCryptoSymbol(raw: string): ParsedCryptoSymbol;
+/**
+ * 交易所侧符号（无形态后缀）。
+ * 只做归一化、不表达形态：**凡可能收到 `-SWAP` 的行情路径必须改用
+ * parseCryptoSymbol 并按 form 分 category**，否则永续会被静默打到现货端点
+ * （P3 硬不变量：任何路径不得把 -SWAP 落到 spot 端点）。
+ */
 declare function normalizeCryptoSymbol(raw: string): string;
+/** Bybit v5 market 的 category：形态的唯一分岔（spot / linear），端点与响应形状一致。 */
+declare function bybitCategory(form: InstrumentForm): 'spot' | 'linear';
+/** symbolType → 资产类别；空串/未登记/缺失 = undefined（不推断）。 */
+declare function bybitAssetClassOf(symbolType: unknown): InstrumentAssetClass | undefined;
 interface BybitRestOptions {
   baseUrl?: string;
   apiKey?: string;
@@ -22,8 +47,18 @@ declare class BybitRestClient {
   private readonly fetchImpl;
   constructor(options?: BybitRestOptions);
   private requestJson;
+  /**
+   * 公共 ticker：现货 → `category=spot`，永续（`-SWAP`）→ `category=linear`。
+   * 形态只由规范后缀裁决；永续请求绝不回落现货端点。输出 symbol 为规范形。
+   */
   getTicker(symbol: string): Promise<Ticker$1>;
+  /** 公共 K 线：与 getTicker 同一条形态分岔（spot / linear）。 */
   getKlines(symbol: string, interval?: Interval$1, limit?: number): Promise<Kline$1[]>;
+  /**
+   * 标的名册：现货 ∪ 线性永续（只收 status=Trading；线性侧还要求 contractType=LinearPerpetual，
+   * instruments-info 会连已交割/预上市行一起返回）。输出规范形 + form + contract 原样透传。
+   */
+  listInstruments(): Promise<InstrumentRef[]>;
   /**
    * 线性合约行情行：GET /v5/market/tickers?category=linear —— 单端点同时携带
    * fundingRate（当前资金费率，小数）、openInterest（base 币计持仓量）、
@@ -67,4 +102,4 @@ declare class BybitRestClient {
   }>;
 }
 //#endregion
-export { type AccountBalance$1 as AccountBalance, BybitRestClient, BybitRestOptions, INTERVAL_VOCABULARY, type Interval$1 as Interval, type Kline$1 as Kline, type Order$1 as Order, type Position$1 as Position, type Ticker$1 as Ticker, TradingServiceError, normalizeCryptoSymbol, parseIntervalMs, toBybitInterval };
+export { type AccountBalance$1 as AccountBalance, BybitRestClient, BybitRestOptions, INTERVAL_VOCABULARY, type Interval$1 as Interval, type Kline$1 as Kline, type Order$1 as Order, ParsedCryptoSymbol, type Position$1 as Position, type Ticker$1 as Ticker, TradingServiceError, bybitAssetClassOf, bybitCategory, normalizeCryptoSymbol, parseCryptoSymbol, parseIntervalMs, toBybitInterval };

package/lib/rest.js

@@ -1,4 +1,9 @@
+import { SWAP_SYMBOL_SUFFIX, instrumentFormOf } from "@dshtrading/api";
 //#region src/rest.ts
+/**
+* @dshtrading/connector-bybit/rest
+* Bybit API v5 REST 客户端（支持公共行情与现货/衍生品交易）。
+*/
 var TradingServiceError = class extends Error {
 	code;
 	constructor(code, message, cause) {
@@ -45,10 +50,34 @@ function parseIntervalMs(interval) {
 		case "1M": return 2592e6;
 	}
 }
+/**
+* 解析入参符号：形态由规范后缀裁决（复用 @dshtrading/api 的 instrumentFormOf，
+* 连接器不自写 endsWith('-SWAP')）。
+* `-SWAP` 必须整段剥掉再做分隔符清理——否则 BTCUSDT-SWAP 会被揉成 BTCUSDTSWAP，
+* Bybit 查无此标的（issue #54 评审 M2）。
+*/
+function parseCryptoSymbol(raw) {
+	const form = instrumentFormOf(raw);
+	const base = raw.trim().toUpperCase().replace(/-SWAP$/, "").replace(/[-_/]/g, "");
+	if (!base) throw new TradingServiceError("TRADING_INVALID_ARGUMENT", "Symbol cannot be empty");
+	return {
+		base,
+		form,
+		canonical: form === "perp" ? `${base}${SWAP_SYMBOL_SUFFIX}` : base
+	};
+}
+/**
+* 交易所侧符号（无形态后缀）。
+* 只做归一化、不表达形态：**凡可能收到 `-SWAP` 的行情路径必须改用
+* parseCryptoSymbol 并按 form 分 category**，否则永续会被静默打到现货端点
+* （P3 硬不变量：任何路径不得把 -SWAP 落到 spot 端点）。
+*/
 function normalizeCryptoSymbol(raw) {
-	const clean = raw.trim().toUpperCase().replace(/-SWAP$/, "").replace(/[-_/]/g, "");
-	if (!clean) throw new TradingServiceError("TRADING_INVALID_ARGUMENT", "Symbol cannot be empty");
-	return clean;
+	return parseCryptoSymbol(raw).base;
+}
+/** Bybit v5 market 的 category：形态的唯一分岔（spot / linear），端点与响应形状一致。 */
+function bybitCategory(form) {
+	return form === "perp" ? "linear" : "spot";
 }
 /** 宽松转 number（字符串/数字皆收，非有限值返回 undefined）。 */
 function num(value) {
@@ -56,6 +85,78 @@ function num(value) {
 	const n = typeof value === "string" ? Number(value) : typeof value === "number" ? value : NaN;
 	return Number.isFinite(n) ? n : void 0;
 }
+function asRecord(value) {
+	return typeof value === "object" && value !== null ? value : void 0;
+}
+/** 线性永续 instruments-info 行 → contract 元数据（字段缺失一律缺省，不本地推断）。 */
+function parseContractMeta(row) {
+	const lot = asRecord(row.lotSizeFilter);
+	const price = asRecord(row.priceFilter);
+	const leverage = asRecord(row.leverageFilter);
+	const multiplier = num(row.contractSize);
+	const tickSize = num(price?.tickSize);
+	const lotSize = num(lot?.qtyStep);
+	const maxLeverage = num(leverage?.maxLeverage);
+	const settleCcy = typeof row.settleCoin === "string" && row.settleCoin !== "" ? row.settleCoin : void 0;
+	const contract = {
+		...multiplier !== void 0 ? { multiplier } : {},
+		...tickSize !== void 0 ? { tickSize } : {},
+		...lotSize !== void 0 ? { lotSize } : {},
+		...maxLeverage !== void 0 ? { maxLeverage } : {},
+		...settleCcy !== void 0 ? { settleCcy } : {}
+	};
+	return Object.keys(contract).length > 0 ? contract : void 0;
+}
+/**
+* Bybit `symbolType` 字面量 → 资产类别标签。
+*
+* `symbolType` 是 instruments-info 行上的**可选**分类字段，官方枚举页列出的取值有
+* innovation/adventure/xstocks/commodity/stock/forex/ETF/mstocks。2026-10-08 可达环境实测
+* （线性 893 行 + 现货 528 行，见 spikes/impl-crypto-perp-tradfi/EVIDENCE-reverify-2026-10-08.md）：
+* 线性侧 stock 202 / innovation 128 / ETF 54 / commodity 4 / forex 3 / 空串 502；
+* 现货侧 空串 514 / xstocks 11（NVDAXUSDT、AAPLXUSDT 等代币化股票）/ adventure 3。
+*
+* 只登记**实测过的**字面量：
+* - 空串 = 交易所没给分类（标准加密品种）⇒ **留空而不是推断成 crypto**（不变量：取不到即留空，
+*   漏标而非错标；空串不是分类值）。
+* - `forex`（EURUSD/GBPUSD/USDJPY）与 `mstocks` 未登记：枚举无外汇成员，mstocks 未在实测中出现；
+*   要不要扩枚举属契约层决定，不在本连接器内定。
+*/
+const BYBIT_SYMBOL_TYPE_ASSET_CLASS = {
+	innovation: "crypto",
+	adventure: "crypto",
+	stock: "equity",
+	ETF: "equity",
+	xstocks: "equity",
+	commodity: "commodity"
+};
+/** symbolType → 资产类别；空串/未登记/缺失 = undefined（不推断）。 */
+function bybitAssetClassOf(symbolType) {
+	if (typeof symbolType !== "string") return void 0;
+	return BYBIT_SYMBOL_TYPE_ASSET_CLASS[symbolType.trim()];
+}
+/**
+* instruments-info 行 → InstrumentRef（输出规范形）。
+* assetClass 只由交易所 `symbolType` 字面量裁决（现货与线性同一规则）；交易所没给
+* （空串/未登记）即留空，绝不按符号猜（硬不变量 #2：TradFi 归属只信交易所元数据）。
+*/
+function toInstrumentRef(row, form) {
+	const exchangeSymbol = typeof row.symbol === "string" ? row.symbol.trim().toUpperCase() : "";
+	if (exchangeSymbol === "") return void 0;
+	const assetClass = bybitAssetClassOf(row.symbolType);
+	if (form === "spot") return {
+		symbol: exchangeSymbol,
+		form,
+		...assetClass !== void 0 ? { assetClass } : {}
+	};
+	const contract = parseContractMeta(row);
+	return {
+		symbol: `${exchangeSymbol}${SWAP_SYMBOL_SUFFIX}`,
+		form,
+		...assetClass !== void 0 ? { assetClass } : {},
+		...contract !== void 0 ? { contract } : {}
+	};
+}
 var BybitRestClient = class {
 	baseUrl;
 	apiKey;
@@ -78,10 +179,14 @@ var BybitRestClient = class {
 			throw new TradingServiceError("TRADING_NETWORK", `Bybit network error: ${err instanceof Error ? err.message : String(err)}`, err);
 		}
 	}
+	/**
+	* 公共 ticker：现货 → `category=spot`，永续（`-SWAP`）→ `category=linear`。
+	* 形态只由规范后缀裁决；永续请求绝不回落现货端点。输出 symbol 为规范形。
+	*/
 	async getTicker(symbol) {
-		const sym = normalizeCryptoSymbol(symbol);
-		const data = await this.requestJson(`/v5/market/tickers?category=spot&symbol=${sym}`);
-		if (data.retCode !== 0 || !data.result?.list || data.result.list.length === 0) throw new TradingServiceError("TRADING_SYMBOL_NOT_FOUND", `Bybit ticker not found for ${sym}`);
+		const { base: sym, form, canonical } = parseCryptoSymbol(symbol);
+		const data = await this.requestJson(`/v5/market/tickers?category=${bybitCategory(form)}&symbol=${sym}`);
+		if (data.retCode !== 0 || !data.result?.list || data.result.list.length === 0) throw new TradingServiceError("TRADING_UNSUPPORTED_SYMBOL", `Bybit ticker not found for ${canonical} (category=${bybitCategory(form)})`);
 		const row = data.result.list[0];
 		const price = parseFloat(row.lastPrice);
 		const volume = parseFloat(row.volume24h);
@@ -89,7 +194,7 @@ var BybitRestClient = class {
 		const prevClose = row.prevPrice24h ? parseFloat(row.prevPrice24h) : void 0;
 		const changePercent = row.price24hPcnt ? parseFloat(row.price24hPcnt) * 100 : void 0;
 		return {
-			symbol: sym,
+			symbol: canonical,
 			price,
 			volume,
 			timestamp,
@@ -97,11 +202,12 @@ var BybitRestClient = class {
 			...changePercent !== void 0 && Number.isFinite(changePercent) ? { changePercent } : {}
 		};
 	}
+	/** 公共 K 线：与 getTicker 同一条形态分岔（spot / linear）。 */
 	async getKlines(symbol, interval = "1d", limit = 100) {
-		const sym = normalizeCryptoSymbol(symbol);
+		const { base: sym, form } = parseCryptoSymbol(symbol);
 		const bybitInt = toBybitInterval(interval);
 		const stepMs = parseIntervalMs(interval);
-		const data = await this.requestJson(`/v5/market/kline?category=spot&symbol=${sym}&interval=${bybitInt}&limit=${limit}`);
+		const data = await this.requestJson(`/v5/market/kline?category=${bybitCategory(form)}&symbol=${sym}&interval=${bybitInt}&limit=${limit}`);
 		if (data.retCode !== 0 || !data.result?.list) return [];
 		return [...data.result.list].reverse().map((r) => {
 			const openTime = parseInt(r[0], 10);
@@ -116,6 +222,49 @@ var BybitRestClient = class {
 			};
 		});
 	}
+	/** instruments-info 单页（limit=1000；游标翻页由 #collectInstrumentRows 驱动）。 */
+	async #fetchInstrumentPage(category, cursor) {
+		const query = `/v5/market/instruments-info?category=${category}&limit=1000` + (cursor !== void 0 && cursor !== "" ? `&cursor=${encodeURIComponent(cursor)}` : "");
+		const data = await this.requestJson(query);
+		if (data.retCode !== 0 || !Array.isArray(data.result?.list)) throw new TradingServiceError("TRADING_EXCHANGE_ERROR", `Bybit instruments-info (${category}): ${data.retMsg}`);
+		const next = data.result?.nextPageCursor;
+		return {
+			list: data.result.list,
+			...typeof next === "string" && next !== "" ? { next } : {}
+		};
+	}
+	async #collectInstrumentRows(category) {
+		const rows = [];
+		const seen = /* @__PURE__ */ new Set();
+		let cursor;
+		for (;;) {
+			const page = await this.#fetchInstrumentPage(category, cursor);
+			rows.push(...page.list);
+			if (page.next === void 0) return rows;
+			if (seen.has(page.next)) throw new TradingServiceError("TRADING_EXCHANGE_ERROR", `Bybit instruments-info (${category}): upstream repeated page cursor ${page.next}`);
+			seen.add(page.next);
+			cursor = page.next;
+		}
+	}
+	/**
+	* 标的名册：现货 ∪ 线性永续（只收 status=Trading；线性侧还要求 contractType=LinearPerpetual，
+	* instruments-info 会连已交割/预上市行一起返回）。输出规范形 + form + contract 原样透传。
+	*/
+	async listInstruments() {
+		const [spotRows, linearRows] = await Promise.all([this.#collectInstrumentRows("spot"), this.#collectInstrumentRows("linear")]);
+		const out = [];
+		for (const row of spotRows) {
+			if (row.status !== "Trading") continue;
+			const ref = toInstrumentRef(row, "spot");
+			if (ref !== void 0) out.push(ref);
+		}
+		for (const row of linearRows) {
+			if (row.contractType !== "LinearPerpetual" || row.status !== "Trading") continue;
+			const ref = toInstrumentRef(row, "perp");
+			if (ref !== void 0) out.push(ref);
+		}
+		return out;
+	}
 	/**
 	* 线性合约行情行：GET /v5/market/tickers?category=linear —— 单端点同时携带
 	* fundingRate（当前资金费率，小数）、openInterest（base 币计持仓量）、
@@ -211,11 +360,11 @@ var BybitRestClient = class {
 	* bids/asks 全称（2026-09-02 真实响应实证，spikes/impl-orderbook-ticks/bybit-orderbook-raw.json）。
 	*/
 	async getOrderbook(symbol) {
-		const sym = normalizeCryptoSymbol(symbol);
-		const data = await this.requestJson(`/v5/market/orderbook?category=spot&symbol=${sym}&limit=25`);
-		if (data.retCode !== 0 || !Array.isArray(data.result?.b) || !Array.isArray(data.result?.a)) throw new TradingServiceError("TRADING_EXCHANGE_ERROR", `Bybit orderbook for ${sym}: unexpected response shape`);
+		const { base: sym, form, canonical } = parseCryptoSymbol(symbol);
+		const data = await this.requestJson(`/v5/market/orderbook?category=${bybitCategory(form)}&symbol=${sym}&limit=25`);
+		if (data.retCode !== 0 || !Array.isArray(data.result?.b) || !Array.isArray(data.result?.a)) throw new TradingServiceError("TRADING_EXCHANGE_ERROR", `Bybit orderbook for ${canonical}: unexpected response shape`);
 		return {
-			symbol: sym,
+			symbol: canonical,
 			bids: data.result.b.map((row) => this.#parseBookRow(row)).filter((l) => l !== void 0),
 			asks: data.result.a.map((row) => this.#parseBookRow(row)).filter((l) => l !== void 0),
 			timestamp: num(data.result.ts) ?? Date.now()
@@ -239,12 +388,11 @@ var BybitRestClient = class {
 	}
 	/** 最近逐笔成交：GET /v5/market/recent-trade?category=spot（响应新→旧 → 反转升序）。 */
 	async getRecentTrades(symbol, limit = 50) {
-		const sym = normalizeCryptoSymbol(symbol);
+		const { base: sym, form, canonical } = parseCryptoSymbol(symbol);
 		const capped = Math.max(1, Math.min(Math.floor(limit) || 50, 60));
-		const data = await this.requestJson(`/v5/market/recent-trade?category=spot&symbol=${sym}&limit=${capped}`);
-		if (data.retCode !== 0 || !data.result?.list) throw new TradingServiceError("TRADING_EXCHANGE_ERROR", `Bybit trades for ${sym}: unexpected response shape`);
-		const symbolOut = sym;
-		return data.result.list.map((row) => this.#parseTradeRow(row, symbolOut)).reverse();
+		const data = await this.requestJson(`/v5/market/recent-trade?category=${bybitCategory(form)}&symbol=${sym}&limit=${capped}`);
+		if (data.retCode !== 0 || !data.result?.list) throw new TradingServiceError("TRADING_EXCHANGE_ERROR", `Bybit trades for ${canonical}: unexpected response shape`);
+		return data.result.list.map((row) => this.#parseTradeRow(row, canonical)).reverse();
 	}
 	async getBalance() {
 		return {
@@ -275,4 +423,4 @@ var BybitRestClient = class {
 	}
 };
 //#endregion
-export { BybitRestClient, INTERVAL_VOCABULARY, TradingServiceError, normalizeCryptoSymbol, parseIntervalMs, toBybitInterval };
+export { BybitRestClient, INTERVAL_VOCABULARY, TradingServiceError, bybitAssetClassOf, bybitCategory, normalizeCryptoSymbol, parseCryptoSymbol, parseIntervalMs, toBybitInterval };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/connector-bybit",
   "description": "【模板】交易所连接器插件脚手架：Bybit（bybit）v2 插件骨架 —— 市场数据服务 + 交易服务 + 三态闸门 + BYOK 凭证 ref。生成器：node scripts/new-connector.mjs --slug <exchange>",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -21,7 +21,8 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "dependencies": {
-    "@dshtrading/api": "^0.5.0"
+    "@dshtrading/authority": "^0.6.0",
+    "@dshtrading/api": "^0.6.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.0",