okx-api 3.1.2 → 3.1.4

package/dist/cjs/types/rest/response/public-data.d.ts

@@ -72,8 +72,15 @@ export interface Trade {
     ts: string;
     source?: string;
 }
+export interface InstrumentUpcomingParamChange {
+    param: 'tickSz' | 'minSz' | 'maxMktSz' | string;
+    newValue: string;
+    effTime: string;
+}
 export interface Instrument {
     instType: InstrumentType;
+    /** Series id for EVENTS, e.g. BTC-ABOVE-DAILY. */
+    seriesId?: string;
     instId: string;
     uly: string;
     instFamily: string;
@@ -95,7 +102,14 @@ export interface Instrument {
     lotSz: string;
     minSz: string;
     ctType: string;
+    /**
+     * FUTURES contract label (deprecated — prefer `expTime` for delivery time; removal planned).
+     * Includes `this_five_years` / `next_five_years` (X-Perps / 5Y-style contracts).
+     */
     alias: string;
+    /**
+     * Instrument status: live, suspend, rebase (SWAP only), preopen, test, expired, settling (EVENTS), …
+     */
     state: string;
     openType?: string;
     maxLmtSz: string;
@@ -106,15 +120,26 @@ export interface Instrument {
     maxIcebergSz: string;
     maxTriggerSz: string;
     maxStopSz: string;
+    /**
+     * e.g. `normal`, `pre_market`, `rebase_contract`, `xperp` (perpetual-style expiry futures, some FUTURES only).
+     */
     ruleType: string;
     auctionEndTime: string;
     futureSettlement?: boolean;
     tradeQuoteCcyList?: string[];
     instIdCode?: number;
+    /**
+     * Asset category of the instrument's base asset (first segment of `instId`). E.g. BTC-USDT-SWAP → category of BTC.
+     * 1: Crypto, 3: Stocks, 4: Commodities, 5: Forex, 6: Bonds, "": not available
+     */
+    instCategory?: string;
     posLmtAmt?: string;
     posLmtPct?: string;
+    longPosRemainingQuota?: string;
+    shortPosRemainingQuota?: string;
     maxPlatOILmt?: string;
     groupId?: string;
+    upcChg?: InstrumentUpcomingParamChange[];
 }
 export interface EconomicCalendarData {
     calendarId: string;
@@ -140,17 +165,50 @@ export interface UnitConvertData {
     sz: string;
     unit: 'coin' | 'usds';
 }
+/**
+ * @see GET /api/v5/public/funding-rate
+ * `instType` is `SWAP` (perp) or `FUTURES` (X-Perp) when applicable.
+ */
+export interface PublicFundingRate {
+    instType: string;
+    instId: string;
+    method: string;
+    formulaType: string;
+    fundingRate: string;
+    nextFundingRate: string;
+    fundingTime: string;
+    nextFundingTime: string;
+    minFundingRate: string;
+    maxFundingRate: string;
+    interestRate: string;
+    impactValue: string;
+    settState: string;
+    settFundingRate: string;
+    premium: string;
+    ts: string;
+}
 export interface FundingRateHistory {
+    /** Perpetual (`SWAP`) or X-Perp (`FUTURES`). */
     instType: string;
     instId: string;
     fundingRate: string;
     realizedRate: string;
     fundingTime: string;
     method: string;
+    formulaType?: string;
 }
 export interface SystemTime {
     ts: string;
 }
+/**
+ * @see GET /api/v5/public/estimated-price
+ */
+export interface EstimatedDeliveryExercisePrice {
+    instType: string;
+    instId: string;
+    settlePx: string;
+    ts: string;
+}
 export interface OptionsTradeInfo {
     instId: string;
     tradeId: string;
@@ -185,6 +243,14 @@ export interface Announcement {
     title: string;
     url: string;
 }
+/** Public borrow history record (GET /api/v5/finance/savings/lending-rate-history) */
+export interface PublicBorrowHistoryRecord {
+    ccy: string;
+    amt: string;
+    rate: string;
+    lendingRate: string;
+    ts: string;
+}
 export interface BasicInterestRate {
     ccy: string;
     rate: string;
@@ -217,4 +283,85 @@ export interface InterestRateAndLoanQuota {
     configCcyList: ConfigCcyItem[];
     config: LoanQuotaConfig[];
 }
+/**
+ * @see GET /api/v5/public/market-data-history
+ */
+export interface MarketDataHistoryFileGroup {
+    dateTs: string;
+    filename: string;
+    sizeMB: string;
+    url: string;
+}
+export interface MarketDataHistoryGroupDetail {
+    instId: string;
+    instFamily: string;
+    instType: string;
+    dateRangeStart: string;
+    dateRangeEnd: string;
+    groupSizeMB: string;
+    groupDetails: MarketDataHistoryFileGroup[];
+}
+export interface MarketDataHistoryResult {
+    dateAggrType: string;
+    details: MarketDataHistoryGroupDetail[];
+    totalSizeMB: string;
+    ts: string;
+}
+/** @see GET /api/v5/finance/staking-defi/eth/product-info */
+export interface EthStakingProductInfo {
+    fastRedemptionDailyLimit: string;
+    rate: string;
+    redemptDays: string;
+    minAmt: string;
+}
+/** @see GET /api/v5/finance/staking-defi/sol/product-info */
+export interface SolStakingProductInfo {
+    fastRedemptionAvail: string;
+    fastRedemptionDailyLimit: string;
+    rate: string;
+    redemptDays: string;
+    minAmt: string;
+}
+/**
+ * @see GET /api/v5/public/event-contract/series
+ */
+export interface EventContractSettlement {
+    method: string;
+    closeEarly: boolean;
+    srcName: string;
+    underlying: string;
+}
+export interface EventContractSeries {
+    seriesId: string;
+    freq: string;
+    title: string;
+    category: string;
+    settlement: EventContractSettlement;
+}
+/**
+ * @see GET /api/v5/public/event-contract/events
+ */
+export interface EventContractEvent {
+    seriesId: string;
+    eventId: string;
+    expTime: string;
+    state: string;
+    fixTime?: string;
+}
+/**
+ * @see GET /api/v5/public/event-contract/markets
+ */
+export interface EventContractMarket {
+    seriesId: string;
+    eventId: string;
+    instId: string;
+    listTime: string;
+    expTime: string;
+    state: string;
+    fixTime: string;
+    outcome: string;
+    floorStrike: string;
+    settleValue: string;
+    disputed: boolean;
+}
 export {};

package/dist/cjs/types/rest/shared.d.ts

@@ -9,7 +9,7 @@ export type AlgoOrderState = 'live' | 'pause' | 'partially_effective' | 'effecti
 export type AlgoPositionSide = 'long' | 'short';
 export type ContractGridDirection = 'long' | 'short' | 'neutral';
 export type GridAlgoSubOrderType = 'live' | 'filled';
-export type InstrumentType = 'SPOT' | 'MARGIN' | 'SWAP' | 'FUTURES' | 'OPTION';
+export type InstrumentType = 'SPOT' | 'MARGIN' | 'SWAP' | 'FUTURES' | 'OPTION' | 'EVENTS';
 export type MarginMode = 'cross' | 'isolated';
 export type OrderSide = 'buy' | 'sell';
 export type OrderType = 'market' | 'limit' | 'post_only' | 'fok' | 'ioc' | 'optimal_limit_ioc' | 'mmp' | 'mmp_and_post_only' | 'elp';

package/dist/cjs/types/websockets/ws-api-request.d.ts

@@ -1,6 +1,10 @@
+import type { AmendAttachedTrailingStop, AttachAlgoOrdRequest } from '../rest/request/trade.js';
 import { numberInString, OrderSide, OrderType, PositionSide, TradeMode } from '../rest/shared.js';
 export interface WSAPIPlaceOrderRequestV5 {
-    instId: string;
+    /** Instrument ID. Deprecated March 2026; use instIdCode for lower latency. */
+    instId?: string;
+    /** Instrument ID code. Takes precedence over instId if both provided. Use Get instruments to map. */
+    instIdCode?: number;
     tdMode: TradeMode;
     ccy?: string;
     clOrdId?: string;
@@ -19,9 +23,22 @@ export interface WSAPIPlaceOrderRequestV5 {
     banAmend?: boolean;
     tradeQuoteCcy?: string;
     stpMode?: 'cancel_maker' | 'cancel_taker' | 'cancel_both';
+    /** ELP taker access. true = can trade with ELP orders (speed bump applied). Default false. Only applicable to ioc orders */
+    isElpTakerAccess?: boolean;
+    /** EVENTS: `"1"` for non-`post_only` orders when required (error 54086 if missing). */
+    speedBump?: string;
+    /** EVENTS: `yes` or `no`. */
+    outcome?: string;
+    attachAlgoOrds?: AttachAlgoOrdRequest[];
 }
 export interface WSAPIAmendOrderRequestV5 {
-    instId: string;
+    /**
+     * If set, ignored  for `amend-order` / `batch-amend-orders` — use `ordId`/`clOrdId` to identify the order.
+     * Map codes via Get instruments as needed.
+     */
+    instId?: string;
+    /** Use Get instruments to map. */
+    instIdCode?: number;
     cxlOnFail?: boolean;
     ordId?: string;
     clOrdId?: string;
@@ -30,6 +47,8 @@ export interface WSAPIAmendOrderRequestV5 {
     newPx?: string;
     newPxUsd?: string;
     newPxVol?: string;
+    speedBump?: string;
+    attachAlgoOrds?: AmendAttachedTrailingStop[];
 }
 export interface WSAPIMassCancelOrdersRequestV5 {
     instType: string;

package/dist/cjs/types/websockets/ws-api-response.d.ts

@@ -26,3 +26,14 @@ export interface WSAPISpreadCancelOrderResultV5 {
     sCode: string;
     sMsg: string;
 }
+/**
+ * @see Ws public channel: estimated-price
+ */
+export type WsEstimatedPriceSettleType = 'settlement' | 'delivery' | 'exercise';
+export interface WsEstimatedPriceData {
+    instId: string;
+    instType: string;
+    settlePx: string;
+    settleType: WsEstimatedPriceSettleType;
+    ts: string;
+}

package/dist/cjs/types/websockets/ws-events.d.ts

@@ -18,6 +18,7 @@ export interface WsDataEvent<T = any> {
         uid?: string;
         instId?: string;
         instFamily?: string;
+        instType?: string;
     };
     data: T;
 }

package/dist/cjs/types/websockets/ws-request.d.ts

@@ -1,3 +1,4 @@
+import type { InstrumentType } from '../rest/shared.js';
 export interface WsAuthRequestArg {
     apiKey: string;
     passphrase: string;
@@ -10,7 +11,7 @@ export type WsPublicKlineChannel = 'candle1Y' | 'candle6M' | 'candle3M' | 'candl
 export type WsPublicMarkPriceKlineChannel = 'mark-price-candle1Y' | 'mark-price-candle6M' | 'mark-price-candle3M' | 'mark-price-candle1M' | 'mark-price-candle1W' | 'mark-price-candle1D' | 'mark-price-candle2D' | 'mark-price-candle3D' | 'mark-price-candle5D' | 'mark-price-candle12H' | 'mark-price-candle6H' | 'mark-price-candle4H' | 'mark-price-candle2H' | 'mark-price-candle1H' | 'mark-price-candle30m' | 'mark-price-candle15m' | 'mark-price-candle5m' | 'mark-price-candle3m' | 'mark-price-candle1m' | 'mark-price-candle1Yutc' | 'mark-price-candle3Mutc' | 'mark-price-candle1Mutc' | 'mark-price-candle1Wutc' | 'mark-price-candle1Dutc' | 'mark-price-candle2Dutc' | 'mark-price-candle3Dutc' | 'mark-price-candle5Dutc' | 'mark-price-candle12Hutc' | 'mark-price-candle6Hutc';
 export type WsPublicIndexKlineChannel = 'index-candle1Y' | 'index-candle6M' | 'index-candle3M' | 'index-candle1M' | 'index-candle1W' | 'index-candle1D' | 'index-candle2D' | 'index-candle3D' | 'index-candle5D' | 'index-candle12H' | 'index-candle6H' | 'index-candle4H index -candle2H' | 'index-candle1H' | 'index-candle30m' | 'index-candle15m' | 'index-candle5m' | 'index-candle3m' | 'index-candle1m' | 'index-candle1Yutc' | 'index-candle3Mutc' | 'index-candle1Mutc' | 'index-candle1Wutc' | 'index-candle1Dutc' | 'index-candle2Dutc' | 'index-candle3Dutc' | 'index-candle5Dutc' | 'index-candle12Hutc' | 'index-candle6Hutc';
 export type WsPublicOrderBooksChannel = 'books' | 'books5' | 'bbo-tbt' | 'books-l2-tbt' | 'books50-l2-tpt';
-export type WsPublicChannel = 'instruments' | 'tickers' | 'open-interest' | WsPublicKlineChannel | WsPublicMarkPriceKlineChannel | WsPublicIndexKlineChannel | 'trades' | 'estimated-price' | 'mark-price' | 'price-limit' | WsPublicOrderBooksChannel | 'opt-summary' | 'funding-rate' | 'index-tickers' | 'status' | 'liquidation-orders';
+export type WsPublicChannel = 'instruments' | 'tickers' | 'open-interest' | WsPublicKlineChannel | WsPublicMarkPriceKlineChannel | WsPublicIndexKlineChannel | 'trades' | 'estimated-price' | 'mark-price' | 'price-limit' | WsPublicOrderBooksChannel | 'opt-summary' | 'funding-rate' | 'index-tickers' | 'status' | 'liquidation-orders' | 'event-contract-markets';
 export type WsBusinessPrivateChannel = 'orders-algo' | 'algo-advance' | 'deposit-info' | 'withdrawal-info' | 'grid-orders-spot' | 'grid-orders-contract' | 'grid-orders-moon' | 'grid-positions' | 'grid-sub-orders' | 'algo-recurring-buy';
 export type WsBusinessPublicChannel = WsPublicKlineChannel | WsPublicMarkPriceKlineChannel | WsPublicIndexKlineChannel;
 export type WsBusinessChannel = WsBusinessPrivateChannel | WsBusinessPublicChannel;
@@ -37,7 +38,8 @@ export interface WsPrivateChannelArgWithCcy extends WsBaseRequestArg {
     channel: 'account' | 'account-greeks' | 'withdrawal-info';
     ccy?: string;
 }
-export type WsChannelArgInstType = 'SPOT' | 'MARGIN' | 'SWAP' | 'FUTURES' | 'OPTION' | 'ANY';
+/** `ANY` is used by some private subscription args; instruments channel uses `EVENTS` for event contracts. */
+export type WsChannelArgInstType = InstrumentType | 'ANY';
 export interface WsPrivateChannelArgWithInstFamily extends WsBaseRequestArg {
     channel: 'positions' | 'orders' | 'orders-algo' | 'liquidation-warning';
     instType: WsChannelArgInstType;
@@ -73,7 +75,7 @@ export interface WsPublicChannelArgInstId extends WsBaseRequestArg {
 }
 export type WsPublicChannelArgInstIdOrFamily = {
     channel: 'estimated-price';
-    instType: 'OPTION' | 'FUTURES';
+    instType: 'OPTION' | 'FUTURES' | 'SWAP' | 'EVENTS';
 } & ({
     instId: string;
 } | {
@@ -90,4 +92,9 @@ export interface WsPublicChannelArgLiquidationOrders extends WsBaseRequestArg {
     channel: 'liquidation-orders';
     instType: 'SWAP' | 'FUTURES';
 }
-export type WsChannelSubUnSubRequestArg = WsPrivateChannelArgTickers | WsPrivateChannelArgWithCcy | WsPrivateChannelArgWithInstFamily | WsPrivateChannelArgAlgo | WsPrivateChannelArgBalanceAndPosition | WsPrivateChannelArgGridOrders | WsPrivateChannelArgGridOther | WsPublicChannelArgInstType | WsPublicChannelArgInstId | WsPublicChannelArgInstIdOrFamily | WsPublicChannelArgOptionSummary | WsPublicChannelArgStatus | WsPublicChannelArgLiquidationOrders;
+/** Event contract market status & floor strikes. @see public WS `event-contract-markets` */
+export interface WsPublicChannelArgEventContractMarkets extends WsBaseRequestArg {
+    channel: 'event-contract-markets';
+    instType: 'EVENTS';
+}
+export type WsChannelSubUnSubRequestArg = WsPrivateChannelArgTickers | WsPrivateChannelArgWithCcy | WsPrivateChannelArgWithInstFamily | WsPrivateChannelArgAlgo | WsPrivateChannelArgBalanceAndPosition | WsPrivateChannelArgGridOrders | WsPrivateChannelArgGridOther | WsPublicChannelArgInstType | WsPublicChannelArgInstId | WsPublicChannelArgInstIdOrFamily | WsPublicChannelArgOptionSummary | WsPublicChannelArgStatus | WsPublicChannelArgLiquidationOrders | WsPublicChannelArgEventContractMarkets;

package/dist/mjs/index.d.ts

@@ -6,6 +6,7 @@ export * from './types/rest/request/account.js';
 export * from './types/rest/request/block-trading.js';
 export * from './types/rest/request/convert.js';
 export * from './types/rest/request/copy-trading.js';
+export * from './types/rest/request/dual-investment.js';
 export * from './types/rest/request/funding.js';
 export * from './types/rest/request/grid-trading.js';
 export * from './types/rest/request/public.js';
@@ -19,6 +20,7 @@ export * from './types/rest/request/trade.js';
 export * from './types/rest/response/private-account.js';
 export * from './types/rest/response/private-block-trading.js';
 export * from './types/rest/response/private-copy-trading.js';
+export * from './types/rest/response/private-dual-investment.js';
 export * from './types/rest/response/private-flexible-loan.js';
 export * from './types/rest/response/private-funding.js';
 export * from './types/rest/response/private-recurring-buy.js';

package/dist/mjs/index.js

@@ -8,6 +8,7 @@ export * from './types/rest/request/account.js';
 export * from './types/rest/request/block-trading.js';
 export * from './types/rest/request/convert.js';
 export * from './types/rest/request/copy-trading.js';
+export * from './types/rest/request/dual-investment.js';
 export * from './types/rest/request/funding.js';
 export * from './types/rest/request/grid-trading.js';
 export * from './types/rest/request/public.js';
@@ -22,6 +23,7 @@ export * from './types/rest/request/trade.js';
 export * from './types/rest/response/private-account.js';
 export * from './types/rest/response/private-block-trading.js';
 export * from './types/rest/response/private-copy-trading.js';
+export * from './types/rest/response/private-dual-investment.js';
 export * from './types/rest/response/private-flexible-loan.js';
 export * from './types/rest/response/private-funding.js';
 export * from './types/rest/response/private-recurring-buy.js';

package/dist/mjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,uBAAuB;AACvB,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,eAAe;AACf,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,gBAAgB;AAChB,cAAc,0CAA0C,CAAC;AACzD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,0CAA0C,CAAC;AACzD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iDAAiD,CAAC;AAChE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,EAAE;AACF,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,uBAAuB;AACvB,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,eAAe;AACf,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,yCAAyC,CAAC;AACxD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,wCAAwC,CAAC;AACvD,cAAc,oCAAoC,CAAC;AACnD,cAAc,+BAA+B,CAAC;AAC9C,gBAAgB;AAChB,cAAc,0CAA0C,CAAC;AACzD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,kDAAkD,CAAC;AACjE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,0CAA0C,CAAC;AACzD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,iDAAiD,CAAC;AAChE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AACvD,cAAc,sCAAsC,CAAC;AACrD,EAAE;AACF,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC"}

package/dist/mjs/rest-client.d.ts

@@ -1,11 +1,12 @@
 import { ASSET_BILL_TYPE } from './constants/funding.js';
-import { ChangePositionMarginRequest, GetBorrowRepayHistoryRequest, GetFixedLoanBorrowingOrdersListRequest, GetFixedLoanBorrowQuoteRequest, GetHistoricPositionParams, GetInstrumentsRequest, GetPositionsParams, GetQuickMarginBorrowRepayHistoryRequest, GetVIPInterestRequest, GetVIPLoanOrderDetailRequest, GetVIPLoanOrderListRequest, PositionBuilderRequest, PrecheckSetDeltaNeutralRequest, QuickMarginBorrowRepayRequest, SetFeeTypeRequest, SetLeverageRequest, SetMMPConfigRequest, SetSettleCurrencyRequest, SetTradingConfigRequest, SubmitFixedLoanBorrowingOrderRequest, UpdateFixedLoanBorrowingOrderRequest, WithdrawalHistoryRequest } from './types/rest/request/account.js';
+import { BillsHistoryArchiveRequest, ChangePositionMarginRequest, GetAccountBillSubtypesRequest, GetBorrowRepayHistoryRequest, GetFixedLoanBorrowingOrdersListRequest, GetFixedLoanBorrowQuoteRequest, GetHistoricPositionParams, GetInstrumentsRequest, GetPositionsParams, GetQuickMarginBorrowRepayHistoryRequest, GetVIPInterestRequest, GetVIPLoanOrderDetailRequest, GetVIPLoanOrderListRequest, PositionBuilderRequest, PrecheckSetDeltaNeutralRequest, QuickMarginBorrowRepayRequest, SetFeeTypeRequest, SetLeverageRequest, SetMMPConfigRequest, SetSettleCurrencyRequest, SetTradingConfigRequest, SubmitFixedLoanBorrowingOrderRequest, UpdateFixedLoanBorrowingOrderRequest, WithdrawalHistoryRequest } from './types/rest/request/account.js';
 import { CancelBlockQuoteRequest, CancelBlockRFQRequest, CancelMultipleBlockQuoteRequest, CancelMultipleBlockRFQRequest, CreateBlockQuoteRequest, CreateBlockRFQRequest, ExecuteBlockQuoteRequest, GetBlockQuoteParams, GetBlockRFQSParams, SetMmpConfigRequest, SetQuoteProductsRequest } from './types/rest/request/block-trading.js';
 import { ConvertQuoteEstimateRequest, ConvertTradeRequest } from './types/rest/request/convert.js';
 import { CloseSubpositionRequest, CopySettingsRequest, GetCopyTradersRequest, GetCTBatchLeverageInfoRequest, GetCTHistoryLeadTradersRequest, GetCTProfitDetailsRequest, GetCurrentSubpositionsRequest, GetLeadTraderPositionsRequest, GetLeadTraderRanksRequest, GetLeadTraderStatsRequest, GetPrivateLeadTraderRanksRequest, GetSubpositionsHistoryRequest, PlaceCTAlgoOrderRequest, SetCTBatchLeverageRequest } from './types/rest/request/copy-trading.js';
-import { FundingRateRequest, FundsTransferRequest, GetDepositHistoryRequest, GetDepositWithdrawStatusRequest, WithdrawRequest } from './types/rest/request/funding.js';
+import { GetDcdOrderHistoryRequest, GetDcdOrderStatusRequest, GetDcdProductsRequest, RequestDcdQuoteRequest, RequestDcdRedeemQuoteRequest, SubmitDcdRedeemRequest, SubmitDcdTradeRequest } from './types/rest/request/dual-investment.js';
+import { FundingRateRequest, FundsTransferRequest, GetDepositHistoryRequest, GetDepositWithdrawStatusRequest, GetFundingRateRequest, WithdrawRequest } from './types/rest/request/funding.js';
 import { CloseContractGridPositionRequest, GetGridAlgoOrdersRequest, GetRSIBackTestingRequest, GridAlgoOrderRequest, GridAlgoOrderType, MaxGridQuantityRequest, StopGridAlgoOrderRequest } from './types/rest/request/grid-trading.js';
-import { CandleRequest, EconomicCalendarRequest, GetContractOpenInterestHistoryRequest, GetContractTakerVolumeRequest, GetOptionTradesRequest, GetPremiumHistoryRequest, GetTopTradersContractLongShortRatioRequest, UnitConvertRequest } from './types/rest/request/public.js';
+import { CandleRequest, EconomicCalendarRequest, GetContractOpenInterestHistoryRequest, GetContractTakerVolumeRequest, GetEventContractEventsRequest, GetEventContractMarketsRequest, GetEventContractSeriesRequest, GetHistoricalMarketDataRequest, GetOptionTradesRequest, GetPremiumHistoryRequest, GetTopTradersContractLongShortRatioRequest, UnitConvertRequest } from './types/rest/request/public.js';
 import { AmendRecurringBuyOrderRequest, GetRecurringBuyOrderListRequest, PlaceRecurringBuyOrderRequest } from './types/rest/request/recurring-buy.js';
 import { PaginatedSymbolRequest } from './types/rest/request/shared.js';
 import { AdjustMarginBalanceRequest, AmendTPSLRequest, CancelSubOrderRequest, CreateSignalBotRequest, CreateSignalRequest, GetSignalBotEventHistoryRequest, GetSignalBotPositionHistoryRequest, GetSignalBotRequest, GetSignalBotSubOrdersRequest, GetSignalsRequest, PlaceSubOrderRequest, SetSignalInstrumentsRequest } from './types/rest/request/signal-bot.js';
@@ -13,17 +14,18 @@ import { GetLendingOrderListRequest, GetLendingSubOrderListRequest, LendingOrder
 import { GetActiveSpreadOrdersRequest, GetSpreadCandlesRequest, GetSpreadOrderHistoryArchiveRequest, GetSpreadOrderHistoryRequest, GetSpreadsRequest, GetSpreadTradesRequest, PlaceSpreadOrderRequest, UpdateSpreadOrderRequest } from './types/rest/request/spread-trading.js';
 import { GetManagedSubAccountTransferHistoryRequest, GetSubAccountMaxWithdrawalsRequest, SetSubAccountLoanAllocationRequest, SubAccountTransferRequest } from './types/rest/request/subaccount.js';
 import { AlgoLongHistoryRequest, AlgoOrderDetailsRequest, AlgoOrderRequest, AlgoRecentHistoryRequest, AmendAlgoOrderRequest, AmendOrderRequest, CancelAlgoOrderRequest, ClosePositionRequest, FillsHistoryRequest, OrderHistoryRequest, OrderIdRequest, OrderPrecheckRequest, OrderRequest } from './types/rest/request/trade.js';
-import { AccountBalance, AccountBill, AccountChangeMarginResult, AccountConfiguration, AccountFeeRate, AccountHistoryBill, AccountInstrument, AccountIsolatedMode, AccountLeverage, AccountLeverageResult, AccountMaxLoan, AccountMaxOrderAmount, AccountMaxTradableAmount, AccountModeResult, AccountPosition, AccountPositionModeResult, AccountPositionRisk, AccountRiskState, AdjustLeverageInfo, AutoLoanResult, BorrowRepayHistoryItem, FixedLoanBorrowingLimit, FixedLoanBorrowQuote, Greeks, HistoricAccountPosition, InterestAccrued, InterestRate, MaxWithdrawal, MMPConfig, PrecheckSetDeltaNeutralResult, QuickMarginBorrowRepayRecord, QuickMarginBorrowRepayResult, SetFeeTypeResult, SetMMPConfigResult, SetSettleCurrencyResult, SetTradingConfigResult, VIPInterest, VIPLoanOrder, VIPLoanOrderDetail } from './types/rest/response/private-account.js';
+import { AccountBalance, AccountBill, AccountBillTypeDefinition, AccountChangeMarginResult, AccountConfiguration, AccountFeeRate, AccountHistoryBill, AccountInstrument, AccountIsolatedMode, AccountLeverage, AccountLeverageResult, AccountMaxLoan, AccountMaxOrderAmount, AccountMaxTradableAmount, AccountModeResult, AccountPosition, AccountPositionModeResult, AccountPositionRisk, AccountRiskState, AdjustLeverageInfo, AutoLoanResult, BorrowRepayHistoryItem, FixedLoanBorrowingLimit, FixedLoanBorrowQuote, Greeks, HistoricAccountPosition, InterestAccrued, InterestRate, MaxWithdrawal, MMPConfig, PrecheckSetDeltaNeutralResult, QuickMarginBorrowRepayRecord, QuickMarginBorrowRepayResult, SetFeeTypeResult, SetMMPConfigResult, SetSettleCurrencyResult, SetTradingConfigResult, VIPInterest, VIPLoanOrder, VIPLoanOrderDetail } from './types/rest/response/private-account.js';
 import { BlockCounterParty, BlockMakerInstrumentSettings, BlockMMPConfig, BlockRFQResult, BlockTradeResult, CancelBlockQuoteResult, CancelBlockRFQResult, CreateBlockQuoteResult, CreateRFQResult, ExecuteBlockQuoteResult, GetBlockQuoteResult, PublicBlockTrade, SetMmpConfigResult } from './types/rest/response/private-block-trading.js';
 import { CurrentSubposition, GetAccountConfigurationResult, GetCopySettingsResult, GetCopyTradersResult, GetCopyTradingConfigResult, GetCTBatchLeverageInfoResult, GetCTHistoryLeadTradersResult, GetCTMyLeadTradersResult, GetCTProfitDetailsResult, GetCTTotalProfitResult, GetCTUnrealizedProfitResult, GetLeadTraderRanksResult, GetPrivateLeadTraderRanksResult, LeadTraderCurrentPosition, LeadTraderPnl, LeadTraderPositionHistory, LeadTraderPreference, LeadTraderStats, PlaceCTAlgoOrderResult, SetCTBatchLeverageResult, SubpositionsHistory } from './types/rest/response/private-copy-trading.js';
-import { AccruedInterestItem, AccruedInterestRequest, AdjustCollateralRequest, CollateralAssetsResponse, LoanHistoryItem, LoanHistoryRequest, LoanInfo, MaxLoanRequest, MaxLoanResponse } from './types/rest/response/private-flexible-loan.js';
+import { DcdCurrencyPair, DcdOrderHistoryItem, DcdOrderStatus, DcdProduct, DcdQuote, DcdRedeemQuote, DcdRedeemResult, DcdTradeResult } from './types/rest/response/private-dual-investment.js';
+import { AccruedInterestItem, AccruedInterestRequest, AdjustCollateralRequest, CollateralAssetsResponse, GetFlexibleLoanCollateralAssetsRequest, GetLoanInfoRequest, LoanHistoryItem, LoanHistoryRequest, LoanInfo, MaxLoanRequest, MaxLoanResponse } from './types/rest/response/private-flexible-loan.js';
 import { AccountAssetValuation, AssetBillDetails, DepositHistory, FundingBalance, FundingCurrency, FundTransferResult, FundTransferState, NonTradableAsset, WithdrawResponse } from './types/rest/response/private-funding.js';
 import { RecurringBuyOrder, RecurringBuyOrderResult, RecurringBuySubOrder } from './types/rest/response/private-recurring-buy.js';
 import { CancelSignalBotsResult, CreateSignalBotResult, CreateSignalResult, GetSignalsResult } from './types/rest/response/private-signal-bot.js';
 import { CancelSpreadOrderResponse, PlaceSpreadOrderResponse, PublicSpreadTrade, SpreadCandle, SpreadDetails, SpreadOrder, SpreadOrderBook, SpreadTicker, SpreadTrade, UpdateSpreadOrderResponse } from './types/rest/response/private-spread-trading.js';
 import { ManagedSubAccountTransfer, SubAccount, SubAccountAPIReset, SubAccountBalances, SubAccountMaxWithdrawal, SubAccountTransferResult } from './types/rest/response/private-subaccount.js';
 import { AlgoOrderDetailsResult, AlgoOrderListItem, AlgoOrderResult, AmendAlgoOrderResult, AmendedOrder, CancelAllAfterResponse, CancelledOrderResult, ClosedPositions, HistoricAlgoOrder, HistoricOrder, OrderDetails, OrderFill, OrderListItem, OrderResult } from './types/rest/response/private-trade.js';
-import { Announcement, Candle, CandleNoVolume, EconomicCalendarData, IndexTicker, Instrument, InterestRateAndLoanQuota, OptionTrade, OptionTrades, OrderBook, SystemTime, Ticker, Trade, UnitConvertData } from './types/rest/response/public-data.js';
+import { Announcement, Candle, CandleNoVolume, EconomicCalendarData, EstimatedDeliveryExercisePrice, EthStakingProductInfo, EventContractEvent, EventContractMarket, EventContractSeries, FundingRateHistory, IndexTicker, Instrument, InterestRateAndLoanQuota, MarketDataHistoryResult, OptionTrade, OptionTrades, OrderBook, PublicBorrowHistoryRecord, PublicFundingRate, SolStakingProductInfo, SystemTime, Ticker, Trade, UnitConvertData } from './types/rest/response/public-data.js';
 import { AccountLevel, APIResponse, ContractGridDirection, GridAlgoSubOrderType, InstrumentType, MarginMode, numberInString, Pagination, PositionSide, PosMode, TimestampObject } from './types/rest/shared.js';
 import BaseRestClient from './util/BaseRestClient.js';
 export declare class RestClient extends BaseRestClient {
@@ -64,26 +66,24 @@ export declare class RestClient extends BaseRestClient {
     getBills(params?: any): Promise<AccountBill[]>;
     /** Last 3 months */
     getBillsArchive(params?: any): Promise<AccountBill[]>;
+    /**
+     * Bill type ids and subTypes (unified account bill CSV columns reference `type` / `subType`).
+     * @see GET /api/v5/account/subtypes
+     */
+    getAccountBillSubtypes(params?: GetAccountBillSubtypesRequest): Promise<AccountBillTypeDefinition[]>;
     /**
      * Apply for bill data since 1 February, 2021 except for the current quarter.
-     * Check the file link from the "Get bills details (since 2021)" endpoint in 30 hours to allow for data generation.
-     * During peak demand, data generation may take longer. If the file link is still unavailable after 48 hours, reach out to customer support for assistance.
+     * Check the "Get bills details (since 2021)" endpoint in about 2 hours for the download link; in peak load it may take longer, and if still missing after 3 hours contact support.
      * It is only applicable to the data from the unified account.
      *
      * This endpoint submits a request for bill data. You can then use getRequestedBillsHistoryLink to get the link to the bill data.
      * It may take some time to generate the data.
      */
-    requestBillsHistoryDownloadLink(params: {
-        year: string;
-        quarter: 'Q1' | 'Q2' | 'Q3' | 'Q4';
-    }): Promise<AccountHistoryBill[]>;
+    requestBillsHistoryDownloadLink(params: BillsHistoryArchiveRequest): Promise<AccountHistoryBill[]>;
     /**
      * This endpoint returns the link to the bill data which you can request using requestBillsHistoryDownloadLink.
      */
-    getRequestedBillsHistoryLink(params: {
-        year: string;
-        quarter: 'Q1' | 'Q2' | 'Q3' | 'Q4';
-    }): Promise<AccountHistoryBill[]>;
+    getRequestedBillsHistoryLink(params: BillsHistoryArchiveRequest): Promise<AccountHistoryBill[]>;
     getAccountConfiguration(): Promise<AccountConfiguration[]>;
     setPositionMode(params: {
         posMode: PosMode;
@@ -99,6 +99,8 @@ export declare class RestClient extends BaseRestClient {
         px?: string;
         leverage?: string;
         unSpotOffset?: boolean;
+        /** EVENTS: `yes` / `no` (required for max size when applicable). */
+        outcome?: string;
     }): Promise<AccountMaxOrderAmount[]>;
     getMaxAvailableTradableAmount(params: {
         instId: string;
@@ -141,6 +143,7 @@ export declare class RestClient extends BaseRestClient {
         instId?: string;
         uly?: string;
         instFamily?: string;
+        groupId?: string;
         ruleType?: string;
     }): Promise<AccountFeeRate[]>;
     getInterestAccrued(params?: {
@@ -775,21 +778,38 @@ export declare class RestClient extends BaseRestClient {
      * Public data - rest endpoints
      *
      */
-    getInstruments(params: {
-        instType: InstrumentType;
-        uly?: string;
-        instFamily?: string;
-        instId?: string;
-    }): Promise<Instrument[]>;
+    getInstruments(params: GetInstrumentsRequest): Promise<Instrument[]>;
+    /**
+     * Prediction / event contract series. Auth required (read).
+     * @see GET /api/v5/public/event-contract/series
+     */
+    getEventContractSeries(params?: GetEventContractSeriesRequest): Promise<EventContractSeries[]>;
+    /**
+     * Events for a series. Auth required (read).
+     * @see GET /api/v5/public/event-contract/events
+     */
+    getEventContractEvents(params: GetEventContractEventsRequest): Promise<EventContractEvent[]>;
+    /**
+     * Markets for events. Auth required (read).
+     * @see GET /api/v5/public/event-contract/markets
+     */
+    getEventContractMarkets(params: GetEventContractMarketsRequest): Promise<EventContractMarket[]>;
     getDeliveryExerciseHistory(params: any): Promise<any[]>;
     getOpenInterest(params: any): Promise<any[]>;
-    getFundingRate(params: any): Promise<any[]>;
-    getFundingRateHistory(params: FundingRateRequest): Promise<any[]>;
+    getFundingRate(params: GetFundingRateRequest): Promise<PublicFundingRate[]>;
+    getFundingRateHistory(params: FundingRateRequest): Promise<FundingRateHistory[]>;
     getMinMaxLimitPrice(params: any): Promise<any[]>;
     getOptionMarketData(params: any): Promise<any[]>;
-    getEstimatedDeliveryExercisePrice(params: any): Promise<any[]>;
+    /**
+     * Estimated delivery or exercise price (FUTURES / OPTION / EVENTS; REST returns one row with `settlePx`).
+     * The value is only meaningful shortly before delivery/exercise. The window used for the index mean is 30 minutes (since 2026-03-18; 200ms sampling).
+     */
+    getEstimatedDeliveryExercisePrice(params: {
+        instId: string;
+    }): Promise<EstimatedDeliveryExercisePrice[]>;
     getDiscountRateAndInterestFreeQuota(params: any): Promise<any[]>;
     getSystemTime(params: any): Promise<SystemTime[]>;
+    getHistoricalMarketData(params: GetHistoricalMarketDataRequest): Promise<MarketDataHistoryResult[]>;
     getMarkPrice(params: any): Promise<any[]>;
     getPositionTiers(params: any): Promise<any[]>;
     getInterestRateAndLoanQuota(): Promise<InterestRateAndLoanQuota[]>;
@@ -960,6 +980,8 @@ export declare class RestClient extends BaseRestClient {
     getConvertCurrencyPair(params: {
         fromCcy: string;
         toCcy: string;
+        /** 0: standard convert (default), 1: large order convert for VIP */
+        convertMode?: '0' | '1';
     }): Promise<any[]>;
     estimateConvertQuote(params: ConvertQuoteEstimateRequest): Promise<any[]>;
     convertTrade(params: ConvertTradeRequest): Promise<any[]>;
@@ -1061,7 +1083,8 @@ export declare class RestClient extends BaseRestClient {
      * Financial product - ETH staking endpoints
      *
      */
-    getETHStakingProductInfo(): Promise<any[]>;
+    getETHStakingProductInfo(): Promise<EthStakingProductInfo[]>;
+    getSOLStakingProductInfo(): Promise<SolStakingProductInfo>;
     purchaseETHStaking(params: {
         amt: string;
     }): Promise<any[]>;
@@ -1106,7 +1129,7 @@ export declare class RestClient extends BaseRestClient {
     getPublicBorrowInfo(params?: {
         ccy?: string;
     }): Promise<any[]>;
-    getPublicBorrowHistory(params?: PaginatedSymbolRequest): Promise<any[]>;
+    getPublicBorrowHistory(params?: PaginatedSymbolRequest): Promise<PublicBorrowHistoryRecord[]>;
     /**
      *
      * Financial product - simple earn fixed endpoints
@@ -1136,14 +1159,26 @@ export declare class RestClient extends BaseRestClient {
     getBorrowableCurrencies(): Promise<{
         borrowCcy: string;
     }[]>;
-    getCollateralAssets(params?: {
-        ccy?: string;
-    }): Promise<CollateralAssetsResponse[]>;
+    getCollateralAssets(params?: GetFlexibleLoanCollateralAssetsRequest): Promise<CollateralAssetsResponse[]>;
     getMaxLoanAmount(params: MaxLoanRequest): Promise<MaxLoanResponse[]>;
     adjustCollateral(params: AdjustCollateralRequest): Promise<[]>;
-    getLoanInfo(): Promise<LoanInfo[]>;
+    getLoanInfo(params?: GetLoanInfoRequest): Promise<LoanInfo[]>;
     getLoanHistory(params?: LoanHistoryRequest): Promise<LoanHistoryItem[]>;
     getAccruedInterest(params?: AccruedInterestRequest): Promise<AccruedInterestItem[]>;
+    /**
+     *
+     * Financial product — dual investment (DCD) endpoints
+     * @see https://www.okx.com/docs-v5/en/ (2026-03-13 release)
+     *
+     */
+    getDcdCurrencyPairs(): Promise<DcdCurrencyPair[]>;
+    getDcdProducts(params: GetDcdProductsRequest): Promise<DcdProduct[]>;
+    requestDcdQuote(params: RequestDcdQuoteRequest): Promise<DcdQuote[]>;
+    submitDcdTrade(params: SubmitDcdTradeRequest): Promise<DcdTradeResult[]>;
+    requestDcdRedeemQuote(params: RequestDcdRedeemQuoteRequest): Promise<DcdRedeemQuote[]>;
+    submitDcdRedeem(params: SubmitDcdRedeemRequest): Promise<DcdRedeemResult[]>;
+    getDcdOrderStatus(params: GetDcdOrderStatusRequest): Promise<DcdOrderStatus[]>;
+    getDcdOrderHistory(params?: GetDcdOrderHistoryRequest): Promise<DcdOrderHistoryItem[]>;
     /**
      *
      * Affiliate endpoints