@dshtrading/api 0.6.2 → 0.7.0

package/lib/index.d.ts

@@ -1122,6 +1122,12 @@ interface PredictionOutcomeBucket {
   readonly volume24h?: number | undefined;
   /** 最小报价粒度（上游 `orderPriceMinTickSize`）。 */
   readonly tickSize?: number | undefined;
+  /**
+   * 回填取数定位键（上游 gamma market `clobTokenIds[0]`，公开数据非凭据；客户端不消费）。
+   * 历史价格按 token 扇出（CLOB `prices-history` 只认 token），客户端拿到的是
+   * 按事件窗口聚合好的序列，不需要这个键。
+   */
+  readonly clobTokenId?: string | undefined;
   /**
    * 是否仍可下单（上游 market 级 `acceptingOrders`）。**不用 `active` 判断**：
    * 实测结算后 `active` 仍为 true，只有 `closed`/`acceptingOrders` 会翻转。
@@ -1165,6 +1171,38 @@ interface PredictionFeed {
   readonly fetchedAt: string;
   readonly meetings: readonly PredictionMeeting[];
 }
+/** 一条服务端历史价格读数（CLOB prices-history 的 t/p 原样，不换算单位）。 */
+interface PredictionPricePoint {
+  /** 上游时间戳（unix 秒）。 */
+  readonly t: number;
+  /** 上游价格（midpoint 口径 0..1，与 gamma outcomePrices 等价）。 */
+  readonly p: number;
+}
+/** 单档在请求窗口内的历史序列。 */
+interface PredictionPriceSeries {
+  readonly bucketKey: string;
+  readonly points: readonly PredictionPricePoint[];
+}
+/** 一段请求窗口的历史结果（服务端解析 token 后扇出各档）。 */
+interface PredictionPriceHistory {
+  /** 取数时刻（ISO 8601 UTC）。 */
+  readonly fetchedAt: string;
+  /** 上游 event id。 */
+  readonly meetingId: string;
+  /** 请求窗口（epoch ms，原样回述以便客户端复算）。 */
+  readonly fromMs: number;
+  readonly toMs: number;
+  /** 请求粒度（分钟）。 */
+  readonly fidelityMinutes: number;
+  readonly series: readonly PredictionPriceSeries[];
+}
+/** 历史请求（窗口上限 336 小时 = 上游 startTs/endTs 实测边界）。 */
+interface PredictionPriceHistoryRequest {
+  readonly meetingId: string;
+  readonly fromMs: number;
+  readonly toMs: number;
+  readonly fidelityMinutes?: number | undefined;
+}
 /**
  * 预测市场源契约（2026-10-11 Polymarket 接入，v1 只覆盖 FOMC 决议路径）：
  * host 平面由 connector-polymarket provide `tradingPredictionFeed`，GUI 面板经桥
@@ -1178,6 +1216,13 @@ interface PredictionFeed {
 interface PredictionFeedService {
   /** 当前 FOMC 决议路径全部会议（含已结算；按 endDate 升序）。 */
   listFomcMeetings(): Promise<PredictionFeed>;
+  /**
+   * 单场会议在请求窗口内的逐档概率历史（2026-10-15 事件窗口回填）。
+   *
+   * 失败必须响亮：服务缺席/上游失败/窗口超限各自以可区分的错误抛出——**不得**
+   * 以空 series 冒充「上游没有变动」（真无变动与取数失败在客户端是两个结论）。
+   */
+  listPriceHistory(request: PredictionPriceHistoryRequest): Promise<PredictionPriceHistory>;
 }
 /** 新闻聚合器注册表契约（Issue #37，router 插件提供）。 */
 interface TradingNewsRegistry {
@@ -1186,4 +1231,4 @@ interface TradingNewsRegistry {
   markets(): string[];
 }
 //#endregion
-export { AccountBalance, ActiveBuySnapshot, AggregateNewsOptions, AggregateNewsResult, AuctionSnapshot, BuybackItem, CRON_MAX, CompanyProfile, type CordisContext, CronSchedule, CryptoFundamentals, DEFAULT_MAX_INFLIGHT_EXECUTIONS, DEFAULT_SESSION_PERMISSION, DEFAULT_TASK_AGENT_PRESET, DEFAULT_TASK_PERMISSION, DerivativesData, DerivativesHistory, DerivativesPoint, Disposable, DividendItem, DragonTigerItem, EXECUTION_HISTORY_LIMIT, ExecutionRecord, FinancialCell, FinancialIndicatorRow, FinancialReportGroup, FinancialReportMatrix, FlashFeedService, ForecastSummary, FundamentalsPackage, HolderNumSummary, IAccount, InsiderTradeItem, InstitutionalHoldingItem, InstrumentAssetClass, InstrumentContract, InstrumentForm, InstrumentRef, Interval, Kline, KlineCapability, LeverageSetting, LimitUpPoolItem, MacroCalendarEntry, MacroFeedService, MacroRateEntry, MainOperationSegment, MarginMode, MarketDataRegistration, MarketDataRegistry, MarketDataService, MarketRouterService, NewTaskInput, NewsAggregator, NewsItem, OperatingEfficiency, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Orderbook, OrderbookLevel, PIN_MAX, PROMPT_MAX, Position, PositionSide, PredictionFeed, PredictionFeedService, PredictionMeeting, PredictionOutcomeBucket, ResearchReportItem, SWAP_SYMBOL_SUFFIX, ScheduleRule, ScheduleSkipRecord, SetLeverageRequest, ShareholderItem, SouthboundHoldingHistory, SouthboundHoldingPoint, SplitItem, StockFundamentals, TASKS_ACTION_BYTES_LIMIT, TASKS_API_SUBPATH, TASKS_SCHEMA_VERSION, TASK_PERMISSIONS, TASK_SKIP_REASONS, TITLE_MAX, TaskPermission, TaskRecord, TaskSkipReason, TaskUpdatePatch, TasksAction, TasksActionEnvelope, TasksSchedulerSnapshot, TasksSnapshot, Ticker, TradeFill, TradeRegistration, TradeRegistry, TradeService, TradeTick, TradingError, TradingErrorCode, TradingNewsRegistry, countOpenExecutions, hasOpenExecution, instrumentFormOf, isTaskPermission, isTaskSkipReason, isValidCron, nextRunAtMs, parseCron, parseNewTaskInput, parseTaskUpdatePatch, parseTasksAction, parseTasksEnvelope, permissionPending, permissionRank, retainRecentExecutions };
+export { AccountBalance, ActiveBuySnapshot, AggregateNewsOptions, AggregateNewsResult, AuctionSnapshot, BuybackItem, CRON_MAX, CompanyProfile, type CordisContext, CronSchedule, CryptoFundamentals, DEFAULT_MAX_INFLIGHT_EXECUTIONS, DEFAULT_SESSION_PERMISSION, DEFAULT_TASK_AGENT_PRESET, DEFAULT_TASK_PERMISSION, DerivativesData, DerivativesHistory, DerivativesPoint, Disposable, DividendItem, DragonTigerItem, EXECUTION_HISTORY_LIMIT, ExecutionRecord, FinancialCell, FinancialIndicatorRow, FinancialReportGroup, FinancialReportMatrix, FlashFeedService, ForecastSummary, FundamentalsPackage, HolderNumSummary, IAccount, InsiderTradeItem, InstitutionalHoldingItem, InstrumentAssetClass, InstrumentContract, InstrumentForm, InstrumentRef, Interval, Kline, KlineCapability, LeverageSetting, LimitUpPoolItem, MacroCalendarEntry, MacroFeedService, MacroRateEntry, MainOperationSegment, MarginMode, MarketDataRegistration, MarketDataRegistry, MarketDataService, MarketRouterService, NewTaskInput, NewsAggregator, NewsItem, OperatingEfficiency, Order, OrderRequest, OrderSide, OrderStatus, OrderType, Orderbook, OrderbookLevel, PIN_MAX, PROMPT_MAX, Position, PositionSide, PredictionFeed, PredictionFeedService, PredictionMeeting, PredictionOutcomeBucket, PredictionPriceHistory, PredictionPriceHistoryRequest, PredictionPricePoint, PredictionPriceSeries, ResearchReportItem, SWAP_SYMBOL_SUFFIX, ScheduleRule, ScheduleSkipRecord, SetLeverageRequest, ShareholderItem, SouthboundHoldingHistory, SouthboundHoldingPoint, SplitItem, StockFundamentals, TASKS_ACTION_BYTES_LIMIT, TASKS_API_SUBPATH, TASKS_SCHEMA_VERSION, TASK_PERMISSIONS, TASK_SKIP_REASONS, TITLE_MAX, TaskPermission, TaskRecord, TaskSkipReason, TaskUpdatePatch, TasksAction, TasksActionEnvelope, TasksSchedulerSnapshot, TasksSnapshot, Ticker, TradeFill, TradeRegistration, TradeRegistry, TradeService, TradeTick, TradingError, TradingErrorCode, TradingNewsRegistry, countOpenExecutions, hasOpenExecution, instrumentFormOf, isTaskPermission, isTaskSkipReason, isValidCron, nextRunAtMs, parseCron, parseNewTaskInput, parseTaskUpdatePatch, parseTasksAction, parseTasksEnvelope, permissionPending, permissionRank, retainRecentExecutions };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dshtrading/api",
   "description": "Pure TypeScript contracts for dsh-trading: market-data/trade service interfaces, domain types, and the shared error vocabulary",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "type": "module",
   "main": "lib/index.js",
   "types": "./lib/index.d.ts",
@@ -17,7 +17,7 @@
   ],
   "license": "PolyForm-Noncommercial-1.0.0",
   "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/cordis": "^4.1.0",
     "tsdown": "^0.22.0",
     "vitest": "^3.0.0"
   },