feat(v3.6.3): enhance order types with new fields for spot and futures, including selfTradePreventionMode and peg price options

package.json

@@ -1,6 +1,6 @@
 {
   "name": "binance",
-  "version": "3.6.2",
+  "version": "3.6.3",
   "description": "Professional Node.js & JavaScript SDK for Binance REST APIs & WebSockets, with TypeScript & end-to-end tests.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

src/types/futures.ts

@@ -447,6 +447,7 @@ export interface NewOrderResult {
   priceProtect: boolean;
   selfTradePreventionMode: SelfTradePreventionMode;
   priceMatch: PriceMatchMode;
+  goodTillDate?: number;
 }
 
 export interface NewOrderError {

src/types/shared.ts

@@ -31,7 +31,8 @@ export type OrderTimeInForce =
   | 'FOK'
   | 'GTX'
   | 'GTE_GTC'
-  | 'GTD';
+  | 'GTD'
+  | 'RPI';
 
 export type StringBoolean = 'TRUE' | 'FALSE';
 
@@ -67,12 +68,14 @@ export type OrderSide = 'BUY' | 'SELL';
 
 export type OrderStatus =
   | 'NEW'
+  | 'PENDING_NEW'
   | 'PARTIALLY_FILLED'
   | 'FILLED'
   | 'CANCELED'
   | 'PENDING_CANCEL'
   | 'REJECTED'
-  | 'EXPIRED';
+  | 'EXPIRED'
+  | 'EXPIRED_IN_MATCH';
 
 export type OrderExecutionType =
   | 'NEW'
@@ -107,7 +110,9 @@ export type SelfTradePreventionMode =
   | 'EXPIRE_TAKER'
   | 'EXPIRE_MAKER'
   | 'EXPIRE_BOTH'
-  | 'NONE';
+  | 'NONE'
+  | 'DECREMENT'
+  | 'TRANSFER';
 
 export interface BasicAssetParam {
   asset: string;

src/types/spot.ts

@@ -464,6 +464,9 @@ export interface ExchangeInfoParams {
   symbolStatus?: string;
 }
 
+type SpotPegPriceType = 'PRIMARY_PEG' | 'MARKET_PEG';
+type SpotPegOffsetType = 'PRICE_LEVEL';
+
 export interface NewSpotOrderParams<
   T extends OrderType = OrderType,
   RT extends OrderResponseType | undefined = OrderResponseType,
@@ -482,6 +485,10 @@ export interface NewSpotOrderParams<
   trailingDelta?: number;
   icebergQty?: number;
   newOrderRespType?: RT;
+  selfTradePreventionMode?: SelfTradePreventionMode;
+  pegPriceType?: SpotPegPriceType;
+  pegOffsetValue?: number;
+  pegOffsetType?: SpotPegOffsetType;
   isIsolated?: StringBoolean;
   sideEffectType?: SideEffects;
   autoRepayAtCancel?: StringBoolean;
@@ -771,7 +778,23 @@ export interface OrderResponseACK {
   transactTime: number;
 }
 
-export interface OrderResponseResult {
+/** Conditional fields on POST /api/v3/order RESULT/FULL. Only present when the matching condition is met. */
+export interface SpotNewOrderConditionalFields {
+  icebergQty?: numberInString;
+  preventedMatchId?: number;
+  preventedQuantity?: numberInString;
+  stopPrice?: numberInString;
+  strategyId?: number;
+  strategyType?: number;
+  trailingDelta?: number;
+  trailingTime?: number;
+  pegPriceType?: SpotPegPriceType;
+  pegOffsetType?: SpotPegOffsetType;
+  pegOffsetValue?: number;
+  peggedPrice?: numberInString;
+}
+
+export interface OrderResponseResult extends SpotNewOrderConditionalFields {
   symbol: string;
   orderId: number;
   orderListId: number;
@@ -780,6 +803,7 @@ export interface OrderResponseResult {
   price: numberInString;
   origQty: numberInString;
   executedQty: numberInString;
+  origQuoteOrderQty: numberInString;
   cummulativeQuoteQty: numberInString;
   status: OrderStatus;
   timeInForce: OrderTimeInForce;
@@ -796,9 +820,10 @@ export interface OrderFill {
   qty: numberInString;
   commission: numberInString;
   commissionAsset: string;
+  tradeId: number;
 }
 
-export interface OrderResponseFull {
+export interface OrderResponseFull extends SpotNewOrderConditionalFields {
   symbol: string;
   orderId: number;
   orderListId?: number;
@@ -807,6 +832,7 @@ export interface OrderResponseFull {
   price: numberInString;
   origQty: numberInString;
   executedQty: numberInString;
+  origQuoteOrderQty: numberInString;
   cummulativeQuoteQty: numberInString;
   status: OrderStatus;
   timeInForce: OrderTimeInForce;

src/types/websockets/ws-api-requests.ts

@@ -215,6 +215,8 @@ export interface WSAPIMyAllocationsRequest {
 /**
  * Trading request types
  */
+type SpotPegPriceType = 'PRIMARY_PEG' | 'MARKET_PEG';
+type SpotPegOffsetType = 'PRICE_LEVEL';
 
 export interface WSAPINewSpotOrderRequest {
   symbol: string;
@@ -231,7 +233,10 @@ export interface WSAPINewSpotOrderRequest {
   icebergQty?: numberInString;
   strategyId?: number;
   strategyType?: number;
-  selfTradePreventionMode?: string;
+  selfTradePreventionMode?: SelfTradePreventionMode;
+  pegPriceType?: SpotPegPriceType;
+  pegOffsetValue?: number;
+  pegOffsetType?: SpotPegOffsetType;
 }
 
 export interface WSAPIOrderTestRequest {
@@ -248,7 +253,10 @@ export interface WSAPIOrderTestRequest {
   icebergQty?: numberInString;
   strategyId?: number;
   strategyType?: number;
-  selfTradePreventionMode?: string;
+  selfTradePreventionMode?: SelfTradePreventionMode;
+  pegPriceType?: SpotPegPriceType;
+  pegOffsetValue?: number;
+  pegOffsetType?: SpotPegOffsetType;
   computeCommissionRates?: boolean;
   timestamp: number;
   recvWindow?: number;
@@ -291,7 +299,10 @@ export interface WSAPIOrderCancelReplaceRequest {
   icebergQty?: numberInString;
   strategyId?: number;
   strategyType?: number;
-  selfTradePreventionMode?: string;
+  selfTradePreventionMode?: SelfTradePreventionMode;
+  pegPriceType?: SpotPegPriceType;
+  pegOffsetValue?: number;
+  pegOffsetType?: SpotPegOffsetType;
   cancelRestrictions?: 'ONLY_NEW' | 'ONLY_PARTIALLY_FILLED';
   orderRateLimitExceededMode?: 'DO_NOTHING' | 'CANCEL_ONLY';
   recvWindow?: number;

src/types/websockets/ws-api-responses.ts

@@ -12,7 +12,7 @@ import {
   OrderTimeInForce,
   SelfTradePreventionMode,
 } from '../shared';
-import { OrderResponse } from '../spot';
+import { OrderResponse, SpotNewOrderConditionalFields } from '../spot';
 
 /**
  * Error response type
@@ -686,7 +686,9 @@ export interface WSAPISpotOrderACK {
   transactTime: number;
 }
 
-export interface WSAPISpotOrderRESULT extends WSAPISpotOrderACK {
+export interface WSAPISpotOrderRESULT
+  extends WSAPISpotOrderACK,
+    SpotNewOrderConditionalFields {
   price: numberInString;
   origQty: numberInString;
   executedQty: numberInString;