RestClient.ts

import { AxiosRequestConfig } from 'axios';

import {
  BaseRestClient,
  REST_CLIENT_TYPE_ENUM,
  RestClientType,
} from './lib/BaseRestClient.js';
import {
  appendGateMultipartFields,
  appendGateMultipartFile,
} from './lib/multipartUtil.js';
import { RestClientOptions } from './lib/requestUtils.js';
import { CreateStpGroupReq } from './types/request/account.js';
import {
  CreateAlphaOrderReq,
  CreateAlphaQuoteReq,
  GetAlphaAccountBookReq,
  GetAlphaCurrenciesReq,
  GetAlphaOrderReq,
  GetAlphaOrdersReq,
  GetAlphaTickersReq,
} from './types/request/alpha.js';
import {
  AddAutoInvestPlanPositionReq,
  CreateAutoInvestPlanReq,
  GetAutoInvestCoinsReq,
  GetAutoInvestMinAmountReq,
  GetAutoInvestOrdersReq,
  GetAutoInvestPlanDetailReq,
  GetAutoInvestPlanRecordsReq,
  GetAutoInvestPlansReq,
  StopAutoInvestPlanReq,
  UpdateAutoInvestPlanReq,
} from './types/request/autoinvest.js';
import {
  CancelBatchCrossExOrdersReq,
  CloseCrossExPositionReq,
  CreateCrossExConvertOrderReq,
  CreateCrossExConvertQuoteReq,
  CreateCrossExOrderReq,
  CreateCrossExTransferReq,
  GetCrossExAccountBookReq,
  GetCrossExAccountsReq,
  GetCrossExAdlRankReq,
  GetCrossExCoinDiscountRateReq,
  GetCrossExHistoryMarginInterestsReq,
  GetCrossExHistoryMarginPositionsReq,
  GetCrossExHistoryOrdersReq,
  GetCrossExHistoryPositionsReq,
  GetCrossExHistoryTradesReq,
  GetCrossExInterestRateReq,
  GetCrossExMarginPositionLeverageReq,
  GetCrossExMarginPositionsReq,
  GetCrossExMarketFundingInfoReq,
  GetCrossExMarketTickersReq,
  GetCrossExOpenOrdersReq,
  GetCrossExPositionLeverageReq,
  GetCrossExPositionsReq,
  GetCrossExRiskLimitsReq,
  GetCrossExSymbolsReq,
  GetCrossExTransferCoinsReq,
  GetCrossExTransferHistoryReq,
  ModifyCrossExOrderReq,
  SetCrossExMarginPositionLeverageReq,
  SetCrossExPositionLeverageReq,
  UpdateCrossExAccountReq,
} from './types/request/crossex.js';
import {
  GetDeliveryAutoOrdersReq,
  GetDeliveryBookReq,
  GetDeliveryCandlesReq,
  GetDeliveryClosedPositionsReq,
  GetDeliveryLiquidationHistoryReq,
  GetDeliveryOrderBookReq,
  GetDeliveryOrdersReq,
  GetDeliverySettlementHistoryReq,
  GetDeliveryTradesReq,
  GetDeliveryTradingHistoryReq,
  SubmitDeliveryFuturesOrderReq,
} from './types/request/delivery.js';
import {
  CreateEarnFixedTermLendReq,
  EarnFixedTermPreRedeemReq,
  GetDualInvestmentOrdersReq,
  GetDualInvestmentPlansReq,
  GetDualOrderRefundPreviewReq,
  GetDualProjectRecommendReq,
  GetEarnFixedTermHistoryReq,
  GetEarnFixedTermLendsReq,
  GetEarnFixedTermProductsByAssetReq,
  GetEarnFixedTermProductsReq,
  PlaceDualInvestmentOrderParams,
  SubmitDualOrderRefundParams,
  UpdateDualOrderReinvestParams,
} from './types/request/earn.js';
import {
  GetLendingInterestRecordsReq,
  GetLendingOrdersReq,
  GetLendingRecordsReq,
  SubmitLendOrRedeemReq,
} from './types/request/earnuni.js';
import {
  GetFlashSwapOrdersReq,
  SubmitFlashSwapOrderPreviewReq,
  SubmitFlashSwapOrderReq,
} from './types/request/flashswap.js';
import {
  BatchAmendOrderReq,
  BatchFundingRatesReq,
  BatchTerminateTrailOrdersReq,
  CreateChaseOrderReq,
  CreateTrailOrderReq,
  DeleteAllFuturesOrdersReq,
  GetChaseOrderDetailReq,
  GetChaseOrdersReq,
  GetFundingRatesReq,
  GetFuturesAccountBookReq,
  GetFuturesAutoOrdersReq,
  GetFuturesCandlesReq,
  GetFuturesContractLeverageReq,
  GetFuturesInsuranceReq,
  GetFuturesLiquidationHistoryReq,
  GetFuturesOrderBookReq,
  GetFuturesOrdersByTimeRangeReq,
  GetFuturesOrdersReq,
  GetFuturesPositionCloseHistoryReq,
  GetFuturesPositionHistoryReq,
  GetFuturesPositionsReq,
  GetFuturesStatsReq,
  GetFuturesTradesReq,
  GetFuturesTradingHistoryByTimeRangeReq,
  GetFuturesTradingHistoryReq,
  GetLiquidationHistoryReq,
  GetRiskLimitTableReq,
  GetRiskLimitTiersReq,
  GetTrailOrderChangeLogReq,
  GetTrailOrderDetailReq,
  GetTrailOrderListReq,
  StopAllChaseOrdersReq,
  StopChaseOrderReq,
  SubmitFuturesOrderReq,
  SubmitFuturesTriggeredOrderReq,
  TerminateTrailOrderReq,
  UpdateDualModePositionLeverageReq,
  UpdateDualModePositionMarginReq,
  UpdateFuturesOrderReq,
  UpdateFuturesPriceTriggeredOrderReq,
  UpdateTrailOrderReq,
} from './types/request/futures.js';
import {
  GetCrossMarginAccountHistoryReq,
  GetCrossMarginBorrowHistoryReq,
  GetCrossMarginInterestRecordsReq,
  GetCrossMarginRepaymentsReq,
  GetMarginBalanceHistoryReq,
  SubmitCrossMarginBorrowLoanReq,
} from './types/request/margin.js';
import {
  GetMarginUNIInterestRecordsReq,
  GetMarginUNILoanRecordsReq,
  GetMarginUNILoansReq,
  GetMarginUNIMaxBorrowReq,
} from './types/request/marginuni.js';
import {
  GetMultiLoanAdjustmentRecordsReq,
  GetMultiLoanOrdersReq,
  GetMultiLoanRepayRecordsReq,
  RepayMultiLoanReq,
  SubmitMultiLoanOrderReq,
  UpdateMultiLoanReq,
} from './types/request/multicollateralLoan.js';
import {
  AmendOptionsOrderReq,
  GetOptionsAccountChangeReq,
  GetOptionsCandlesReq,
  GetOptionsMySettlementsReq,
  GetOptionsOrderBookReq,
  GetOptionsOrdersReq,
  GetOptionsPersonalHistoryReq,
  GetOptionsSettlementHistoryReq,
  GetOptionsTradesReq,
  GetOptionsUnderlyingCandlesReq,
  OptionsMMPSettingsReq,
  SubmitOptionsOrderReq,
} from './types/request/options.js';
import {
  CancelOTCOrderReq,
  CreateOTCBankReq,
  CreateOTCFiatOrderReq,
  CreateOTCQuoteReq,
  CreateOTCStablecoinOrderReq,
  GetOTCBankSupplementChecklistReq,
  GetOTCFiatOrderDetailReq,
  GetOTCFiatOrderListReq,
  GetOTCStablecoinOrderListReq,
  MarkOTCOrderAsPaidReq,
  OTCBankIdReq,
  SubmitOTCBankEnterpriseSupplementReq,
  SubmitOTCBankPersonalSupplementReq,
} from './types/request/otc.js';
import {
  P2PMerchantAdsDetailReq,
  P2PMerchantAdsUpdateStatusReq,
  P2PMerchantCancelTransactionReq,
  P2PMerchantConfirmPaymentReq,
  P2PMerchantConfirmReceiptReq,
  P2PMerchantGetAdsListReq,
  P2PMerchantGetChatsListReq,
  P2PMerchantGetCompletedTransactionListReq,
  P2PMerchantGetCounterpartyUserInfoReq,
  P2PMerchantGetMyselfPaymentReq,
  P2PMerchantGetPendingTransactionListReq,
  P2PMerchantGetTransactionDetailsReq,
  P2PMerchantMyAdsListReq,
  P2PMerchantPlaceBizPushOrderReq,
  P2PMerchantSendChatMessageReq,
  P2PMerchantSetMerchantWorkHoursReq,
  P2PMerchantUploadChatFileReq,
} from './types/request/p2pMerchant.js';
import {
  GetAgencyCommissionHistoryReq,
  GetAgencyTransactionHistoryReq,
  GetBrokerCommissionHistoryReq,
  GetBrokerTransactionHistoryReq,
  GetPartnerAgentDataAggregatedReq,
  GetPartnerSubordinateListReq,
  PartnerTransactionReq,
} from './types/request/rebate.js';
import {
  CancelSpotBatchOrdersReq,
  CancelSpotPovOrdersReq,
  CreateSpotPovOrderReq,
  DeleteSpotOrderReq,
  GetSpotAccountBookReq,
  GetSpotAutoOrdersReq,
  GetSpotCandlesReq,
  GetSpotInsuranceHistoryReq,
  GetSpotOrderBookReq,
  GetSpotOrderReq,
  GetSpotOrdersReq,
  GetSpotPovOrdersReq,
  GetSpotTradesReq,
  GetSpotTradingHistoryReq,
  SubmitSpotClosePosCrossDisabledReq,
  SubmitSpotOrderReq,
  UpdateSpotBatchOrdersReq,
  UpdateSpotOrderReq,
} from './types/request/spot.js';
import {
  CloseStockPositionReq,
  CreateStockOrderReq,
  CreateStockTransactionReq,
  GetStockOrderHistoryReq,
  GetStockOrdersReq,
  GetStockPositionsReq,
  GetStockSymbolDetailReq,
  GetStockSymbolsReq,
  GetStockTransactionsReq,
  GetStockUserAssetsReq,
  UpdateStockOrderReq,
} from './types/request/stock.js';
import {
  CreateSubAccountApiKeyReq,
  CreateSubAccountReq,
  UpdateSubAccountApiKeyReq,
} from './types/request/subaccount.js';
import {
  TradFiClosePositionReq,
  TradFiCreateOrderReq,
  TradFiCreateTransactionReq,
  TradFiGetKlinesParams,
  TradFiGetOrderHistoryParams,
  TradFiGetPositionHistoryParams,
  TradFiGetSymbolCommissionsParams,
  TradFiGetSymbolDetailParams,
  TradFiGetTransactionsParams,
  TradFiModifyOrderReq,
  TradFiModifyPositionReq,
} from './types/request/tradfi.js';
import {
  CreateQuickRepaymentReq,
  GetUnifiedHistoryLendingRateReq,
  GetUnifiedInterestRecordsReq,
  GetUnifiedLoanRecordsReq,
  GetUnifiedLoansReq,
  PortfolioMarginCalculatorReq,
  SetUnifiedAccountModeReq,
  SetUnifiedDeltaNeutralReq,
  SetUserLeverageReq,
  SubmitUnifiedBorrowOrRepayReq,
  SubmitUnifiedLoanRepayReq,
} from './types/request/unified.js';
import {
  GetMainSubTransfersReq,
  GetSavedAddressReq,
  GetSmallBalanceHistoryReq,
  GetSubAccountBalancesReq,
  GetTransferReq,
  GetWithdrawalDepositRecordsReq,
  ListPushOrdersReq,
  SubmitMainSubTransferReq,
  SubmitSubToSubTransferReq,
  SubmitTransferReq,
} from './types/request/wallet.js';
import { SubmitWithdrawalReq } from './types/request/withdrawal.js';
import {
  AccountDetail,
  AccountMainKey,
  AccountRateLimit,
  StpGroup,
  StpGroupUser,
} from './types/response/account.js';
import {
  AlphaAccount,
  AlphaAccountBook,
  AlphaCurrency,
  AlphaOrder,
  AlphaTicker,
  CreateAlphaOrderResp,
  CreateAlphaQuoteResp,
} from './types/response/alpha.js';
import {
  AutoInvestCoinItem,
  AutoInvestConfigItem,
  AutoInvestMinAmountResp,
  AutoInvestOrderItem,
  AutoInvestPlanDetail,
  AutoInvestPlanExecutionRecordsPaginated,
  AutoInvestPlansListResp,
  CreateAutoInvestPlanResp,
} from './types/response/autoinvest.js';
import {
  CancelBatchCrossExOrdersResp,
  CancelCrossExOrderResp,
  CloseCrossExPositionResp,
  CreateCrossExConvertOrderResp,
  CreateCrossExConvertQuoteResp,
  CreateCrossExOrderResp,
  CreateCrossExTransferResp,
  CrossExAccount,
  CrossExAccountBook,
  CrossExAdlRank,
  CrossExCoinDiscountRate,
  CrossExFeeRate,
  CrossExHistoryMarginInterest,
  CrossExHistoryMarginPosition,
  CrossExHistoryPosition,
  CrossExHistoryTrade,
  CrossExInterestRate,
  CrossExMarginPosition,
  CrossExMarginPositionLeverage,
  CrossExMarketFundingInfo,
  CrossExMarketTicker,
  CrossExOrder,
  CrossExPosition,
  CrossExPositionLeverage,
  CrossExRiskLimit,
  CrossExSymbol,
  CrossExTransferCoin,
  CrossExTransferHistory,
  ModifyCrossExOrderResp,
  SetCrossExMarginPositionLeverageResp,
  SetCrossExPositionLeverageResp,
  UpdateCrossExAccountResp,
} from './types/response/crossex.js';
import {
  DeliveryAccount,
  DeliveryBook,
  DeliveryCandle,
  DeliveryClosedPosition,
  DeliveryLiquidationHistoryRecord,
  DeliveryOrderBook,
  DeliverySettlementHistoryRecord,
  DeliveryTicker,
  DeliveryTrade,
  DeliveryTradingHistoryRecord,
} from './types/response/delivery.js';
import {
  CreateEarnFixedTermLendResponse,
  CreateEarnFixedTermPreRedeemResponse,
  DualInvestmentOrder,
  DualInvestmentProduct,
  DualOrderRefundPreview,
  DualProjectRecommend,
  GetEarnFixedTermHistoryResponse,
  GetEarnFixedTermLendsResponse,
  GetEarnFixedTermProductsByAssetResponse,
  GetEarnFixedTermProductsResponse,
} from './types/response/earn.js';
import {
  LendingCurrency,
  LendingInterestRecord,
  LendingOrder,
  LendingRecord,
} from './types/response/earnuni.js';
import {
  FlashSwapCurrencyPair,
  FlashSwapOrder,
  SubmitFlashSwapOrderPreviewResp,
} from './types/response/flashswap.js';
import {
  BatchAmendOrderResp,
  BatchFundingRatesResponse,
  CreateChaseOrderResp,
  DeleteFuturesBatchOrdersResp,
  FuturesAccount,
  FuturesAccountBookRecord,
  FuturesAutoDeleveragingHistoryRecord,
  FuturesCandle,
  FuturesContract,
  FuturesContractLeverageInfo,
  FuturesDeliveryContract,
  FuturesInsuranceHistory,
  FuturesLiquidationHistoryRecord,
  FuturesOrder,
  FuturesOrderBook,
  FuturesOrderTimerange,
  FuturesPosition,
  FuturesPositionHistoryRecord,
  FuturesPriceTriggeredOrder,
  FuturesStats,
  FuturesTicker,
  FuturesTrade,
  FuturesTradingHistoryRecord,
  GetChaseOrderDetailResp,
  GetChaseOrdersResp,
  IndexConstituents,
  LiquidationHistoryRecord,
  PremiumIndexKLine,
  RiskLimitTableTier,
  RiskLimitTier,
  StopAllChaseOrdersResp,
  StopChaseOrderResp,
  TrailChangeLog,
  TrailOrder,
  TriggerOrderResponse,
} from './types/response/futures.js';
import {
  CrossMarginAccount,
  CrossMarginAccountHistoryRecord,
  CrossMarginCurrency,
  CrossMarginMorrowLoanRecord,
  MarginAccount,
  MarginBalanceHistoryRecord,
  MarginUserAccount,
} from './types/response/margin.js';
import {
  LendingMarket,
  MarginUNIInterestRecord,
  MarginUNILoan,
  MarginUNILoanRecord,
  MarginUNIMaxBorrowable,
} from './types/response/marginuni.js';
import {
  MultiLoanAdjustmentRecord,
  MultiLoanCurrencyQuota,
  MultiLoanFixedRate,
  MultiLoanOrder,
  MultiLoanRatio,
  MultiLoanRepayRecord,
  MultiLoanSupportedCurrencies,
  RepayMultiLoanResp,
  UpdateMultiLoanResp,
} from './types/response/multicollateralLoan.js';
import {
  GetOptionsLiquidationResp,
  OptionsAccount,
  OptionsAccountChangeRecord,
  OptionsCandle,
  OptionsContract,
  OptionsMMPSettings,
  OptionsOrderBook,
  OptionsPositionsUnderlying,
  OptionsSettlementHistoryRecord,
  OptionsTicker,
  OptionsTrade,
  OptionsUnderlyingCandle,
  OptionsUserHistoryRecord,
  OptionsUserSettlement,
  SubmitOptionsOrderResp,
} from './types/response/options.js';
import {
  CancelOTCOrderResp,
  CreateOTCBankResp,
  CreateOTCFiatOrderResp,
  CreateOTCQuoteResp,
  CreateOTCStablecoinOrderResp,
  GetOTCBankListResp,
  GetOTCBankSupplementChecklistResp,
  GetOTCFiatOrderDetailResp,
  GetOTCFiatOrderListResp,
  GetOTCStablecoinOrderListResp,
  MarkOTCOrderAsPaidResp,
  OTCActionResp,
} from './types/response/otc.js';
import {
  P2PMerchantAdsDetail,
  P2PMerchantAdsListItem,
  P2PMerchantApiResp,
  P2PMerchantChatsListData,
  P2PMerchantCounterpartyUserInfo,
  P2PMerchantMyAdsListData,
  P2PMerchantPaymentMethod,
  P2PMerchantTransactionDetails,
  P2PMerchantTransactionListData,
  P2PMerchantUserInfo,
} from './types/response/p2pMerchant.js';
import {
  AgencyCommissionHistoryRecord,
  AgencyTransactionHistoryRecord,
  BrokerCommissionHistoryRecord,
  BrokerTransactionHistoryRecord,
  PartnerCommission,
  PartnerDataAggregatedResponse,
  PartnerSubordinate,
  PartnerTransaction,
} from './types/response/rebate.js';
import {
  DeleteSpotBatchOrdersResp,
  GetSpotOpenOrdersResp,
  SpotAccount,
  SpotAccountBook,
  SpotCandle,
  SpotCurrency,
  SpotFeeRates,
  SpotHistoricTradeRecord,
  SpotInsuranceHistory,
  SpotOrder,
  SpotOrderBook,
  SpotPovOrder,
  SpotPriceTriggeredOrder,
  SpotTicker,
  SpotTrade,
  SubmitSpotBatchOrdersResp,
} from './types/response/spot.js';
import {
  StockApiResp,
  StockClosePositionResult,
  StockCreateOrderResult,
  StockExchangeItem,
  StockFeeRateItem,
  StockListData,
  StockOrderBook,
  StockOrderHistoryItem,
  StockOrderItem,
  StockPositionItem,
  StockSymbolDetailItem,
  StockSymbolItem,
  StockTransactionItem,
  StockUpdateOrderResult,
  StockUserAssets,
} from './types/response/stock.js';
import {
  CreatedSubAccountAPIKey,
  SubAccount,
  SubAccountAPIKey,
  SubAccountMode,
} from './types/response/subaccount.js';
import {
  TradFiApiResp,
  TradFiAssets,
  TradFiCategoryItem,
  TradFiCreateOrderResult,
  TradFiCreateUserResult,
  TradFiKlineItem,
  TradFiListData,
  TradFiModifyOrderResult,
  TradFiMT5Account,
  TradFiOrderHistoryItem,
  TradFiOrderItem,
  TradFiOrderLog,
  TradFiPositionHistoryItem,
  TradFiPositionItem,
  TradFiSymbolCommissionItem,
  TradFiSymbolDetailItem,
  TradFiSymbolItem,
  TradFiTicker,
  TradFiTransactionListData,
} from './types/response/tradfi.js';
import {
  DeltaNeutralEnabled,
  LeverageFailedCurrency,
  MarginTier,
  PortfolioMarginCalculation,
  QuickEstimatedRepayment,
  QuickRepaymentResp,
  UnifiedAccountInfo,
  UnifiedCurrencyDiscountTiers,
  UnifiedHistoryLendingRate,
  UnifiedInterestRecord,
  UnifiedLoan,
  UnifiedLoanCurrency,
  UnifiedLoanRecord,
  UnifiedRiskUnitDetails,
  UserCurrencyLeverageConfig,
} from './types/response/unified.js';
import {
  AccountTransferDetail,
  CreateDepositAddressResp,
  CurrencyChain,
  DepositRecord,
  GetBalancesResp,
  PushOrder,
  SavedAddress,
  SmallBalanceHistoryRecord,
  SmallBalanceRecord,
  SubAccountBalance,
  SubAccountCrossMarginBalancesResp,
  SubAccountFuturesBalancesResp,
  SubAccountMarginBalance,
  SubAccountTransferRecord,
  TradingFees,
  WithdrawalStatus,
} from './types/response/wallet.js';
import { WithdrawalRecord } from './types/response/withdrawal.js';
import { CurrencyPair } from './types/shared.js';

/**
 * Unified REST API client for all of Gate's REST APIs
 */
export class RestClient extends BaseRestClient {
  constructor(
    restClientOptions: RestClientOptions = {},
    requestOptions: AxiosRequestConfig = {},
  ) {
    super(restClientOptions, requestOptions);
    return this;
  }

  /**
   *
   * Custom SDK functions
   *
   */

  /**
   * This method is used to get the latency and time sync between the client and the server.
   * This is not official API endpoint and is only used for internal testing purposes.
   * Use this method to check the latency and time sync between the client and the server.
   * Final values might vary slightly, but it should be within few ms difference.
   * If you have any suggestions or improvements to this measurement, please create an issue or pull request on GitHub.
   */
  async fetchLatencySummary(): Promise<any> {
    const clientTimeReqStart = Date.now();
    const serverTime = await this.getServerTime();
    const clientTimeReqEnd = Date.now();
    console.log('serverTime', serverTime);

    const serverTimeMs = serverTime.server_time;
    const roundTripTime = clientTimeReqEnd - clientTimeReqStart;
    const estimatedOneWayLatency = Math.floor(roundTripTime / 2);

    // Adjust server time by adding estimated one-way latency
    const adjustedServerTime = serverTimeMs + estimatedOneWayLatency;

    // Calculate time difference between adjusted server time and local time
    const timeDifference = adjustedServerTime - clientTimeReqEnd;

    const result = {
      localTime: clientTimeReqEnd,
      serverTime: serverTimeMs,
      roundTripTime,
      estimatedOneWayLatency,
      adjustedServerTime,
      timeDifference,
    };

    console.log('Time synchronization results:');
    console.log(result);

    console.log(
      `Your approximate latency to exchange server:
      One way: ${estimatedOneWayLatency}ms.
      Round trip: ${roundTripTime}ms.
      `,
    );

    if (timeDifference > 500) {
      console.warn(
        `WARNING! Time difference between server and client clock is greater than 500ms. It is currently ${timeDifference}ms.
        Consider adjusting your system clock to avoid unwanted clock sync errors!
        Visit https://github.com/tiagosiebler/awesome-crypto-examples/wiki/Timestamp-for-this-request-is-outside-of-the-recvWindow for more information`,
      );
    } else {
      console.log(
        `Time difference between server and client clock is within acceptable range of 500ms. It is currently ${timeDifference}ms.`,
      );
    }

    return result;
  }

  /**
   *
   * Gate.io misc endpoints
   *
   */

  getClientType(): RestClientType {
    return REST_CLIENT_TYPE_ENUM.main;
  }

  getSystemMaintenanceStatus(): Promise<any> {
    return this.get('/v1/public/system_info');
  }

  /**================================================================================================================================
   * WITHDRAW
   * ==========================================================================================================================
   */

  /**
   * Withdraw
   *
   * Withdrawals to Gate addresses do not incur transaction fees.
   *
   * @param params Withdrawal parameters
   * @returns Promise<Withdraw>
   */
  submitWithdrawal(params: SubmitWithdrawalReq): Promise<WithdrawalRecord> {
    return this.postPrivate('/withdrawals', { body: params });
  }

  /**
   * Transfer between spot main accounts
   *
   * Both parties cannot be sub-accounts.
   *
   * @param params Transfer parameters
   * @returns Promise<{
   *   id: number;
   * }>
   */
  submitSpotMainAccountTransfer(params: {
    receive_uid: number;
    currency: string;
    amount: string;
  }): Promise<{
    id: number;
  }> {
    return this.postPrivate('/withdrawals/push', { body: params });
  }

  /**
   * Cancel withdrawal with specified ID
   *
   * @param params Parameters containing the withdrawal ID
   * @returns Promise<WithdrawalRecord>
   */
  cancelWithdrawal(params: {
    withdrawal_id: string;
  }): Promise<WithdrawalRecord> {
    return this.deletePrivate(`/withdrawals/${params.withdrawal_id}`);
  }

  /**==========================================================================================================================
   * WALLET
   * ==========================================================================================================================
   */

  /**
   * List chains supported for specified currency
   *
   * @param params Parameters containing the currency name
   * @returns Promise<CurrencyChain[]>
   */
  getCurrencyChains(params: { currency: string }): Promise<CurrencyChain[]> {
    return this.get('/wallet/currency_chains', params);
  }

  /**
   * Generate currency deposit address
   *
   * @param params Parameters containing the currency name
   * @returns Promise<CreateDepositAddressResp>
   */
  createDepositAddress(params: {
    currency: string;
  }): Promise<CreateDepositAddressResp> {
    return this.getPrivate('/wallet/deposit_address', params);
  }

  /**
   * Retrieve withdrawal records
   *
   * Record time range cannot exceed 30 days
   *
   * @param params Parameters for filtering withdrawal records
   * @returns Promise<Withdraw[]>
   */
  getWithdrawalRecords(
    params?: GetWithdrawalDepositRecordsReq,
  ): Promise<WithdrawalRecord[]> {
    return this.getPrivate('/wallet/withdrawals', params);
  }

  /**
   * Retrieve deposit records
   *
   * Record time range cannot exceed 30 days
   *
   * @param params Parameters for filtering deposit records
   * @returns Promise<DepositRecord[]>
   */
  getDepositRecords(
    params?: GetWithdrawalDepositRecordsReq,
  ): Promise<DepositRecord[]> {
    return this.getPrivate('/wallet/deposits', params);
  }

  /**
   * Transfer between trading accounts
   *
   * Transfer between different accounts. Currently support transfers between the following:
   * - spot - margin
   * - spot - futures(perpetual)
   * - spot - delivery
   * - spot - cross margin
   * - spot - options
   *
   * @param params Transfer parameters
   * @returns Promise<TransferResponse>
   */
  submitTransfer(params: SubmitTransferReq): Promise<{ tx_id: number }> {
    return this.postPrivate('/wallet/transfers', { body: params });
  }

  /**
   * Get trading account transfer details
   *
   * Retrieve the current user's trading account transfer details by tx_id. Response includes transfer status, currency, amount, source and destination account types, and applicable settlement currency or margin currency pair.
   *
   * @param params Parameters containing the transfer transaction ID
   * @returns Promise<AccountTransferDetail>
   */
  getTransfer(params: GetTransferReq): Promise<AccountTransferDetail> {
    return this.getPrivate('/wallet/transfers', params);
  }

  /**
   * Transfer between main and sub accounts
   *
   * Support transferring with sub user's spot or futures account. Note that only main user's spot account is used no matter which sub user's account is operated.
   *
   * @param params Transfer parameters
   * @returns Promise<any>
   */
  submitMainSubTransfer(params: SubmitMainSubTransferReq): Promise<any> {
    return this.postPrivate('/wallet/sub_account_transfers', { body: params });
  }

  /**
   * Retrieve transfer records between main and sub accounts
   *
   * Record time range cannot exceed 30 days
   *
   * Note: only records after 2020-04-10 can be retrieved
   *
   * @param params Parameters for filtering transfer records
   * @returns Promise<SubAccountTransferRecordResp[]>
   */
  getMainSubTransfers(
    params?: GetMainSubTransfersReq,
  ): Promise<SubAccountTransferRecord[]> {
    return this.getPrivate('/wallet/sub_account_transfers', params);
  }

  /**
   * Sub-account transfers to sub-account
   *
   * It is possible to perform balance transfers between two sub-accounts under the same main account. You can use either the API Key of the main account or the API Key of the sub-account to initiate the transfer.
   *
   * @param params Transfer parameters
   * @returns Promise<any>
   */
  submitSubToSubTransfer(params: SubmitSubToSubTransferReq): Promise<any> {
    return this.postPrivate('/wallet/sub_account_to_sub_account', {
      body: params,
    });
  }

  /**
   * Query transfer status based on client_order_id or tx_id
   *
   * @param params Parameters for querying transfer status
   * @returns Promise<{
   *   tx_id: string;
   *   status: 'PENDING' | 'SUCCESS' | 'FAIL' | 'PARTIAL_SUCCESS';
   * }>
   */
  getTransferStatus(params: {
    client_order_id?: string;
    tx_id?: string;
  }): Promise<{
    tx_id: string;
    status: 'PENDING' | 'SUCCESS' | 'FAIL' | 'PARTIAL_SUCCESS';
  }> {
    return this.getPrivate('/wallet/order_status', params);
  }

  /**
   * Retrieve withdrawal status
   *
   * @param params Parameters for retrieving withdrawal status
   * @returns Promise<WithdrawalStatus[]>
   */
  getWithdrawalStatus(params?: {
    currency?: string;
  }): Promise<WithdrawalStatus[]> {
    return this.getPrivate('/wallet/withdraw_status', params);
  }

  /**
   * Retrieve sub account balances
   *
   * @param params Parameters for retrieving sub account balances
   * @returns Promise<SubAccountBalance[]>
   */
  getSubBalance(
    params?: GetSubAccountBalancesReq,
  ): Promise<SubAccountBalance[]> {
    return this.getPrivate('/wallet/sub_account_balances', params);
  }

  /**
   * Query sub accounts' margin balances
   *
   * @param params Parameters for querying sub accounts' margin balances
   * @returns Promise<SubAccountMarginBalancesResp[]>
   */
  getSubMarginBalances(params?: {
    sub_uid?: string;
  }): Promise<{ uid: string; available: SubAccountMarginBalance[] }> {
    return this.getPrivate('/wallet/sub_account_margin_balances', params);
  }

  /**
   * Query sub accounts' futures account balances
   *
   * @param params Parameters for querying sub accounts' futures account balances
   * @returns Promise<SubAccountFuturesBalancesResp[]>
   */
  getSubFuturesBalances(params?: {
    sub_uid?: string;
    settle?: string;
  }): Promise<SubAccountFuturesBalancesResp[]> {
    return this.getPrivate('/wallet/sub_account_futures_balances', params);
  }

  /**
   * Query subaccount's cross_margin account info
   *
   * @param params Parameters for querying subaccount's cross_margin account info
   * @returns Promise<SubAccountCrossMarginBalancesResp[]>
   */
  getSubCrossMarginBalances(params?: {
    sub_uid?: string;
  }): Promise<SubAccountCrossMarginBalancesResp[]> {
    return this.getPrivate('/wallet/sub_account_cross_margin_balances', params);
  }

  /**
   * Query saved addresses
   *
   * @param params Parameters for querying saved address
   * @returns Promise<GetSavedAddressResp[]>
   */
  getSavedAddresses(params: GetSavedAddressReq): Promise<SavedAddress[]> {
    return this.getPrivate('/wallet/saved_address', params);
  }

  /**
   * Retrieve personal trading fee
   *
   * @param params Parameters for retrieving personal trading fee
   * @returns Promise<GetTradingFeesResp>
   */
  getTradingFees(params?: {
    currency_pair?: string;
    settle?: 'BTC' | 'USDT' | 'USD';
  }): Promise<TradingFees> {
    return this.getPrivate('/wallet/fee', params);
  }

  /**
   * Retrieve user's total balances
   *
   * This endpoint returns an approximate sum of exchanged amount from all currencies to input currency for each account.
   * The exchange rate and account balance could have been cached for at most 1 minute. It is not recommended to use its result for any trading calculation.
   *
   * For trading calculation, use the corresponding account query endpoint for each account type. For example:
   * - GET /spot/accounts to query spot account balance
   * - GET /margin/accounts to query margin account balance
   * - GET /futures/{settle}/accounts to query futures account balance
   *
   * @param params Parameters for retrieving total balances
   * @returns Promise<GetBalancesResp>
   */
  getBalances(params?: { currency?: string }): Promise<GetBalancesResp> {
    return this.getPrivate('/wallet/total_balance', params);
  }

  /**
   * List small balance
   *
   * @returns Promise<GetSmallBalancesResp>
   */
  getSmallBalances(): Promise<SmallBalanceRecord> {
    return this.getPrivate('/wallet/small_balance');
  }

  /**
   * Convert small balance
   *
   * @param params Parameters for converting small balance
   * @returns Promise<any>
   */
  convertSmallBalance(params?: {
    currency?: string[];
    is_all?: boolean;
  }): Promise<any> {
    return this.postPrivate('/wallet/small_balance', { body: params });
  }

  /**
   * List small balance history
   *
   * @param params Parameters for listing small balance history
   * @returns Promise<GetSmallBalanceHistoryResp[]>
   */
  getSmallBalanceHistory(
    params?: GetSmallBalanceHistoryReq,
  ): Promise<SmallBalanceHistoryRecord[]> {
    return this.getPrivate('/wallet/small_balance_history', params);
  }

  /**
   * List push orders
   *
   * @param params Parameters for listing push orders
   * @returns Promise<PushOrder[]>
   */
  getPushOrders(params?: ListPushOrdersReq): Promise<PushOrder[]> {
    return this.getPrivate('/wallet/push', params);
  }

  /**
   * Retrieve the list of low-liquidity or low-cap tokens
   *
   * @returns Promise<string[]>
   */
  getLowCapExchangeList(): Promise<string[]> {
    return this.getPrivate('/wallet/getLowCapExchangeList');
  }

  /**==========================================================================================================================
   * SUBACCOUNT
   * ==========================================================================================================================
   */

  /**
   * Create a new sub-account
   *
   * @param params Parameters for creating a new sub-account
   * @returns Promise<CreateSubAccountResp>
   */
  createSubAccount(params: CreateSubAccountReq): Promise<SubAccount> {
    return this.postPrivate('/sub_accounts', { body: params });
  }

  /**
   * List sub-accounts
   *
   * @param params Parameters for listing sub-accounts
   * @returns Promise<GetSubAccountsResp[]>
   */

  getSubAccounts(params?: { type?: string }): Promise<SubAccount[]> {
    return this.getPrivate('/sub_accounts', params);
  }

  /**
   * Get the sub-account
   *
   * @param params Parameters containing the sub-account user ID
   * @returns Promise<SubAccountResp>
   */
  getSubAccount(params: { user_id: number }): Promise<SubAccount> {
    return this.getPrivate(`/sub_accounts/${params.user_id}`);
  }

  /**
   * Create API Key of the sub-account
   *
   * @param params Parameters for creating API Key of the sub-account
   * @returns Promise<CreateSubAccountApiKeyResp>
   */
  createSubAccountApiKey(
    params: CreateSubAccountApiKeyReq,
  ): Promise<CreatedSubAccountAPIKey> {
    const { user_id, ...body } = params;
    return this.postPrivate(`/sub_accounts/${user_id}/keys`, { body: body });
  }

  /**
   * List all API Key of the sub-account
   *
   * @param params Parameters containing the sub-account user ID
   * @returns Promise<SubAccountKey[]>
   */
  getSubAccountApiKeys(params: {
    user_id: number;
  }): Promise<SubAccountAPIKey[]> {
    return this.getPrivate(`/sub_accounts/${params.user_id}/keys`);
  }

  /**
   * Update API key of the sub-account
   *
   * Note: This interface cannot modify the mode account type attribute
   *
   * @param params Parameters for updating API key of the sub-account
   * @returns Promise<any>
   */
  updateSubAccountApiKey(params: UpdateSubAccountApiKeyReq): Promise<any> {
    const { user_id, key, ...body } = params;
    return this.putPrivate(`/sub_accounts/${user_id}/keys/${key}`, { body });
  }

  /**
   * Delete API key of the sub-account
   *
   * @param params Parameters for deleting API key of the sub-account
   * @returns Promise<any>
   */
  deleteSubAccountApiKey(params: {
    user_id: number;
    key: string;
  }): Promise<any> {
    return this.deletePrivate(
      `/sub_accounts/${params.user_id}/keys/${params.key}`,
    );
  }

  /**
   * Get the API Key of the sub-account
   *
   * @param params Parameters containing the sub-account user ID and API key
   * @returns Promise<SubAccountKey>
   */
  getSubAccountApiKey(params: {
    user_id: number;
    key: string;
  }): Promise<SubAccountAPIKey> {
    return this.getPrivate(
      `/sub_accounts/${params.user_id}/keys/${params.key}`,
    );
  }

  /**
   * Lock the sub-account
   *
   * @param params Parameters containing the sub-account user ID
   * @returns Promise<any>
   */
  lockSubAccount(params: { user_id: number }): Promise<any> {
    return this.postPrivate(`/sub_accounts/${params.user_id}/lock`);
  }

  /**
   * Unlock the sub-account
   *
   * @param params Parameters containing the sub-account user ID
   * @returns Promise<any>
   */
  unlockSubAccount(params: { user_id: number }): Promise<any> {
    return this.postPrivate(`/sub_accounts/${params.user_id}/unlock`);
  }

  /**
   * Get sub-account mode
   *
   * Unified account mode:
   * - classic: Classic account mode
   * - multi_currency: Multi-currency margin mode
   * - portfolio: Portfolio margin mode
   *
   * @returns Promise<SubAccountMode>
   */
  getSubAccountMode(): Promise<SubAccountMode> {
    return this.getPrivate('/sub_accounts/unified_mode');
  }

  /**==========================================================================================================================
   * UNIFIED
   * ==========================================================================================================================
   */

  /**
   * Get unified account information
   *
   * The assets of each currency in the account will be adjusted according to their liquidity, defined by corresponding adjustment coefficients, and then uniformly converted to USD to calculate the total asset value and position value of the account.
   *
   * For specific formulas, please refer to Margin Formula
   *
   * @param params Parameters for retrieving unified account information
   * @returns Promise<UnifiedAccountInfo>
   */
  getUnifiedAccountInfo(params?: {
    currency?: string;
    sub_uid?: string;
  }): Promise<UnifiedAccountInfo> {
    return this.getPrivate('/unified/accounts', params);
  }

  /**
   * Query about the maximum borrowing for the unified account
   *
   * @param params Parameters for querying the maximum borrowing for the unified account
   * @returns Promise<{
   *   currency: string;
   *   amount: string;
   * }>
   */
  getUnifiedMaxBorrow(params: { currency: string }): Promise<{
    currency: string;
    amount: string;
  }> {
    return this.getPrivate('/unified/borrowable', params);
  }

  /**
   * Query about the maximum transferable for the unified account
   *
   * @param params Parameters for querying the maximum transferable for the unified account
   * @returns Promise<{
   *   currency: string;
   *   amount: string;
   * }>
   */
  getUnifiedMaxTransferable(params: { currency: string }): Promise<{
    currency: string;
    amount: string;
  }> {
    return this.getPrivate('/unified/transferable', params);
  }

  /**
   * Batch query maximum transferable amounts for unified accounts
   *
   * After withdrawing currency, the transferable amount will change.
   *
   * @param params Parameters containing currencies to query (up to 100 at once)
   * @returns Promise with array of currency and maximum transferable amount
   */
  getUnifiedMaxTransferables(params: { currencies: string }): Promise<
    {
      currency: string;
      amount: string;
    }[]
  > {
    return this.getPrivate('/unified/transferables', params);
  }

  getUnifiedBatchMaxBorrowable(params: { currencies: string[] }): Promise<any> {
    return this.getPrivate('/unified/batch_borrowable', {
      currencies: params.currencies.join(','),
    });
  }

  /**
   * Borrow or repay
   *
   * When borrowing, it is essential to ensure that the borrowed amount is not below the minimum borrowing threshold for the specific cryptocurrency and does not exceed the maximum borrowing limit set by the platform and the user.
   *
   * The interest on the loan will be automatically deducted from the account at regular intervals. It is the user's responsibility to manage the repayment of the borrowed amount.
   *
   * For repayment, the option to repay the entire borrowed amount is available by setting the parameter repaid_all=true
   *
   * @param params Parameters for borrowing or repaying
   * @returns Promise<any>
   */
  submitUnifiedBorrowOrRepay(
    params: SubmitUnifiedBorrowOrRepayReq,
  ): Promise<any> {
    return this.postPrivate('/unified/loans', { body: params });
  }

  /**
   * List loans
   *
   * @param params Parameters for listing loans
   * @returns Promise<GetUnifiedLoansResp[]>
   */
  getUnifiedLoans(params?: GetUnifiedLoansReq): Promise<UnifiedLoan[]> {
    return this.getPrivate('/unified/loans', params);
  }

  /**
   * Get loan records
   *
   * @param params Parameters for getting loan records
   * @returns Promise<GetUnifiedLoanRecordsResp[]>
   */
  getUnifiedLoanRecords(
    params?: GetUnifiedLoanRecordsReq,
  ): Promise<UnifiedLoanRecord[]> {
    return this.getPrivate('/unified/loan_records', params);
  }

  /**
   * List interest records
   *
   * @param params Parameters for listing interest records
   * @returns Promise<GetUnifiedInterestRecordsResp[]>
   */
  getUnifiedInterestRecords(
    params?: GetUnifiedInterestRecordsReq,
  ): Promise<UnifiedInterestRecord[]> {
    return this.getPrivate('/unified/interest_records', params);
  }

  /**
   * Retrieve user risk unit details, only valid in portfolio margin mode
   *
   * @returns Promise<GetUnifiedRiskUnitDetailsResp>
   */
  getUnifiedRiskUnitDetails(): Promise<UnifiedRiskUnitDetails> {
    return this.getPrivate('/unified/risk_units');
  }

  /**
   * Set mode of the unified account
   *
   * Switching between different account modes requires only passing the parameters corresponding to the target account mode. It also supports opening or closing configuration switches for the corresponding account mode when switching.
   *
   * @param params Parameters for setting the mode of the unified account
   * @returns Promise<any>
   */
  setUnifiedAccountMode(params: SetUnifiedAccountModeReq): Promise<any> {
    return this.putPrivate('/unified/unified_mode', { body: params });
  }

  /**
   * Query mode of the unified account
   *
   * @returns Promise<SetUnifiedAccountModeReq>
   */
  getUnifiedAccountMode(): Promise<SetUnifiedAccountModeReq> {
    return this.getPrivate('/unified/unified_mode');
  }

  /**
   * Get unified estimate rate
   *
   * Due to fluctuations in lending depth, hourly interest rates may vary, and thus, I cannot provide exact rates. When a currency is not supported, the interest rate returned will be an empty string.
   *
   * @param params Parameters for querying estimate rates
   * @returns Promise<{ [key: string]: string }>
   */
  getUnifiedEstimateRate(params: {
    currencies: string[];
  }): Promise<{ [key: string]: string }> {
    return this.getPrivate('/unified/estimate_rate', params);
  }

  /**
   * List currency discount tiers
   *
   * @returns Promise<GetUnifiedCurrencyDiscountTiersResp[]>
   */
  getUnifiedCurrencyDiscountTiers(): Promise<UnifiedCurrencyDiscountTiers[]> {
    return this.get('/unified/currency_discount_tiers');
  }

  /**
   * List loan margin tiers
   *
   * @returns Promise<{
   *   currency: string;
   *   margin_tiers: MarginTier[];
   * }[]>
   */
  getLoanMarginTiers(): Promise<
    {
      currency: string;
      margin_tiers: MarginTier[];
    }[]
  > {
    return this.get('/unified/loan_margin_tiers');
  }

  /**
   * Portfolio margin calculator
   *
   * Portfolio Margin Calculator When inputting a simulated position portfolio, each position includes the position name and quantity held, supporting markets within the range of BTC and ETH perpetual contracts, options, and spot markets. When inputting simulated orders, each order includes the market identifier, order price, and order quantity, supporting markets within the range of BTC and ETH perpetual contracts, options, and spot markets. Market orders are not included.
   *
   * @param params Parameters for portfolio margin calculator
   * @returns Promise<PortfolioMarginCalculatorResp>
   */
  portfolioMarginCalculate(
    params: PortfolioMarginCalculatorReq,
  ): Promise<PortfolioMarginCalculation> {
    return this.post('/unified/portfolio_calculator', { body: params });
  }

  /**
   * Set leverage for all borrowed currencies
   *
   * Set leverage for all of a user's borrowed currencies. Currencies with outstanding loans cannot be changed. Values above a currency's leverage limit are capped. The response lists currencies whose updates failed together with the failure reason.
   *
   * @param params Parameters containing the leverage value
   * @returns Promise<LeverageFailedCurrency[]>
   */
  setUserLeverage(
    params: SetUserLeverageReq,
  ): Promise<LeverageFailedCurrency[]> {
    return this.postPrivate('/unified/leverage/user_setting', { body: params });
  }

  /**
   * Query user currency leverage configuration
   *
   * Get the maximum and minimum leverage multiples that users can set for a currency type
   *
   * @param params Parameters containing the currency
   * @returns Promise<UserCurrencyLeverageConfig>
   */
  getUserCurrencyLeverageConfig(params: {
    currency: string;
  }): Promise<UserCurrencyLeverageConfig> {
    return this.getPrivate('/unified/leverage/user_currency_config', params);
  }

  /**
   * Get the user's currency leverage
   *
   * If currency is not passed, query all currencies.
   *
   * @param params Optional parameters containing the currency
   * @returns Promise<UserCurrencyLeverageSetting[]>
   */
  getUserCurrencyLeverageSettings(params?: { currency?: string }): Promise<
    {
      currency: string;
      leverage: string;
    }[]
  > {
    return this.getPrivate('/unified/leverage/user_currency_setting', params);
  }

  /**
   * Set the currency leverage ratio
   *
   * @param params Parameters for setting currency leverage ratio
   * @returns Promise<any> Returns nothing on success (204 No Content)
   */
  updateUserCurrencyLeverage(params: {
    currency: string;
    leverage: string;
  }): Promise<any> {
    return this.postPrivate('/unified/leverage/user_currency_setting', {
      body: params,
    });
  }

  /**
   * List loan currencies supported by unified account
   *
   * @param params Optional parameters for filtering
   * @returns Promise with array of loan currencies
   */
  getUnifiedLoanCurrencies(params?: {
    currency?: string;
  }): Promise<UnifiedLoanCurrency[]> {
    return this.getPrivate('/unified/currencies', params);
  }

  /**
   * Get historical lending rates
   *
   * @param params Parameters for retrieving historical lending rates
   * @returns Promise<UnifiedHistoryLendingRate>
   */
  getHistoricalLendingRates(
    params: GetUnifiedHistoryLendingRateReq,
  ): Promise<UnifiedHistoryLendingRate> {
    return this.getPrivate('/unified/history_loan_rate', params);
  }

  submitUnifiedLoanRepay(params: SubmitUnifiedLoanRepayReq): Promise<any> {
    return this.postPrivate('/unified/loans/repay', { body: params });
  }

  /**
   * Get estimated quick repayment data (unified account, cross-currency or portfolio margin mode)
   */
  getEstimatedQuickRepayment(): Promise<QuickEstimatedRepayment> {
    return this.getPrivate('/unified/estimated_quick_repayment');
  }

  /**
   * Execute quick repayment
   */
  createQuickRepayment(
    params: CreateQuickRepaymentReq,
  ): Promise<QuickRepaymentResp> {
    return this.postPrivate('/unified/quick_repayment', { body: params });
  }

  /**
   * Set Delta-neutral strategy mode (v4.106.97)
   *
   * Requires VIP level >= 4 and cross-currency margin mode.
   */
  setUnifiedDeltaNeutral(
    params: SetUnifiedDeltaNeutralReq,
  ): Promise<DeltaNeutralEnabled> {
    return this.postPrivate('/unified/delta_neutral', { body: params });
  }

  /**
   * Query Delta-neutral strategy mode setting (v4.106.97)
   */
  getUnifiedDeltaNeutral(): Promise<DeltaNeutralEnabled> {
    return this.getPrivate('/unified/delta_neutral');
  }

  /**==========================================================================================================================
   * SPOT
   * ==========================================================================================================================
   */

  /**
   * List all currencies' details
   *
   * Currency has two forms:
   * - Only currency name, e.g., BTC, USDT
   * - <currency>_<chain>, e.g., HT_ETH
   *
   * The latter one occurs when one currency has multiple chains. Currency detail contains a chain field whatever the form is. To retrieve all chains of one currency, you can use all the details which have the name of the currency or name starting with <currency>_.
   *
   * @returns Promise<GetSpotCurrenciesResp[]>
   */
  getSpotCurrencies(): Promise<SpotCurrency[]> {
    return this.get('/spot/currencies');
  }

  /**
   * Get details of a specific currency
   *
   * @param params Parameters for retrieving details of a specific currency
   * @returns Promise<GetSpotCurrenciesResp>
   */
  getSpotCurrency(params: { currency: string }): Promise<SpotCurrency> {
    return this.get(`/spot/currencies/${params.currency}`);
  }

  /**
   * List all currency pairs supported
   *
   * @returns Promise<CurrencyPair[]>
   */
  getSpotCurrencyPairs(): Promise<CurrencyPair[]> {
    return this.get('/spot/currency_pairs');
  }

  /**
   * Get details of a specific currency pair
   *
   * @param params Parameters for retrieving details of a specific currency pair
   * @returns Promise<CurrencyPair>
   */
  getSpotCurrencyPair(params: {
    currency_pair: string;
  }): Promise<CurrencyPair> {
    return this.get(`/spot/currency_pairs/${params.currency_pair}`);
  }

  /**
   * Retrieve ticker information
   *
   * Return only related data if currency_pair is specified; otherwise return all of them.
   *
   * @param params Parameters for retrieving ticker information
   * @returns Promise<GetSpotTickerResp[]>
   */
  getSpotTicker(params?: {
    currency_pair?: string;
    timezone?: 'utc0' | 'utc8' | 'all';
  }): Promise<SpotTicker[]> {
    return this.get('/spot/tickers', params);
  }

  /**
   * Retrieve order book
   *
   * Order book will be sorted by price from high to low on bids; low to high on asks.
   *
   * @param params Parameters for retrieving order book
   * @returns Promise<GetSpotOrderBookResp>
   */
  getSpotOrderBook(params: GetSpotOrderBookReq): Promise<SpotOrderBook> {
    return this.get('/spot/order_book', params);
  }

  /**
   * Retrieve market trades
   *
   * You can use from and to to query by time range, or use last_id by scrolling page. The default behavior is by time range.
   * Scrolling query using last_id is not recommended any more. If last_id is specified, time range query parameters will be ignored.
   *
   * @param params Parameters for retrieving market trades
   * @returns Promise<GetSpotTradesResp[]>
   */
  getSpotTrades(params: GetSpotTradesReq): Promise<SpotTrade[]> {
    return this.get('/spot/trades', params);
  }

  /**
   * Market Candles
   *
   * Maximum of 1000 points can be returned in a query. Be sure not to exceed the limit when specifying from, to and interval.
   *
   * @param params Parameters for retrieving market Candles
   * @returns Promise<GetSpotCandlesResp>
   */
  getSpotCandles(params: GetSpotCandlesReq): Promise<SpotCandle[]> {
    return this.get('/spot/candlesticks', params);
  }

  /**
   * Query user trading fee rates
   *
   * This API is deprecated in favour of new fee retrieving API /wallet/fee.
   *
   * @param params Parameters for querying user trading fee rates
   * @returns Promise<GetSpotFeeRatesResp>
   */
  getSpotFeeRates(params?: { currency_pair?: string }): Promise<SpotFeeRates> {
    return this.getPrivate('/spot/fee', params);
  }

  /**
   * Query a batch of user trading fee rates
   *
   * @param params Parameters for querying a batch of user trading fee rates
   */
  getSpotBatchFeeRates(params: {
    currency_pairs: string;
  }): Promise<Record<string, SpotFeeRates>> {
    return this.getPrivate('/spot/batch_fee', params);
  }

  /**
   * List spot accounts
   *
   * @param params Parameters for listing spot accounts
   * @returns Promise<GetSpotAccountsResp[]>
   */
  getSpotAccounts(params?: { currency?: string }): Promise<SpotAccount[]> {
    return this.getPrivate('/spot/accounts', params);
  }

  /**
   * Query account book
   *
   * Record time range cannot exceed 30 days.
   *
   * @param params Parameters for querying account book
   * @returns Promise<GetSpotAccountBookResp[]>
   */
  getSpotAccountBook(
    params?: GetSpotAccountBookReq,
  ): Promise<SpotAccountBook[]> {
    return this.getPrivate('/spot/account_book', params);
  }

  /**
   * Create a batch of orders
   *
   * Batch orders requirements:
   * - custom order field text is required
   * - At most 4 currency pairs, maximum 10 orders each, are allowed in one request
   * - No mixture of spot orders and margin orders, i.e. account must be identical for all orders
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for creating a batch of orders
   * @returns Promise<SubmitSpotBatchOrdersResp[]>
   */
  submitSpotBatchOrders(
    body: SpotOrder[],
    params?: {
      xGateExptime?: number;
    },
  ): Promise<SubmitSpotBatchOrdersResp[]> {
    const { xGateExptime } = params || {};
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.postPrivate('/spot/batch_orders', {
      headers: headers,
      body: body,
    });
  }

  /**
   * List all open orders
   *
   * List open orders in all currency pairs.
   * Note that pagination parameters affect record number in each currency pair's open order list. No pagination is applied to the number of currency pairs returned. All currency pairs with open orders will be returned.
   * Spot, portfolio, and margin orders are returned by default. To list cross margin orders, account must be set to cross_margin.
   *
   * @param params Parameters for listing all open orders
   * @returns Promise<GetSpotOpenOrdersResp[]>
   */
  getSpotOpenOrders(params?: {
    page?: number;
    limit?: number;
    account?: 'spot' | 'margin' | 'cross_margin' | 'unified';
  }): Promise<GetSpotOpenOrdersResp[]> {
    return this.getPrivate('/spot/open_orders', params);
  }

  /**
   * Close position when cross-currency is disabled
   *
   * Currently, only cross-margin accounts are supported to close position when cross currencies are disabled. Maximum buy quantity = (unpaid principal and interest - currency balance - the amount of the currency in the order book) / 0.998
   *
   * @param params Parameters for closing position when cross-currency is disabled
   * @returns Promise<Order>
   */
  submitSpotClosePosCrossDisabled(
    params: SubmitSpotClosePosCrossDisabledReq,
  ): Promise<SpotOrder> {
    return this.postPrivate('/spot/cross_liquidate_orders', { body: params });
  }

  /**
   * Create an order
   *
   * You can place orders with spot, portfolio, margin or cross margin account through setting the account field. It defaults to spot, which means spot account is used to place orders. If the user is using unified account, it defaults to the unified account.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for creating an order
   * @returns Promise<Order>
   */
  submitSpotOrder(params: SubmitSpotOrderReq): Promise<SpotOrder> {
    const { xGateExptime, ...body } = params;
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.postPrivate('/spot/orders', { headers: headers, body: body });
  }

  /**
   * List orders
   *
   * Spot, portfolio and margin orders are returned by default. If cross margin orders are needed, account must be set to cross_margin.
   *
   * @param params Parameters for listing orders
   * @returns Promise<Order[]>
   */
  getSpotOrders(params: GetSpotOrdersReq): Promise<SpotOrder[]> {
    return this.getPrivate('/spot/orders', params);
  }

  /**
   * Cancel all open orders in specified currency pair
   *
   * If account is not set, all open orders, including spot, portfolio, margin and cross margin ones, will be cancelled.
   * You can set account to cancel only orders within the specified account.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for cancelling all open orders in specified currency pair
   * @returns Promise<Order[]>
   */
  cancelSpotOpenOrders(params: {
    currency_pair: string;
    side?: 'buy' | 'sell';
    account?: 'spot' | 'margin' | 'cross_margin' | 'unified';
    action_mode?: 'ACK' | 'RESULT' | 'FULL';
    xGateExptime?: number;
  }): Promise<SpotOrder[]> {
    const { xGateExptime, ...query } = params;
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.deletePrivate('/spot/orders', {
      headers: headers,
      query: query,
    });
  }

  /**
   * Cancel a batch of orders with an ID list
   *
   * Multiple currency pairs can be specified, but maximum 20 orders are allowed per request.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for cancelling a batch of orders
   * @returns Promise<DeleteSpotBatchOrdersResp[]>
   */
  batchCancelSpotOrders(
    body: CancelSpotBatchOrdersReq[],
    params?: {
      xGateExptime?: number;
    },
  ): Promise<DeleteSpotBatchOrdersResp[]> {
    const { xGateExptime } = params || {};
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.postPrivate('/spot/cancel_batch_orders', {
      headers: headers,
      body: body,
    });
  }

  /**
   * Get a single order
   *
   * Spot, portfolio and margin orders are queried by default. If cross margin orders are needed or portfolio margin account are used, account must be set to cross_margin.
   *
   * @param params Parameters for getting a single order
   * @returns Promise<Order>
   */
  getSpotOrder(params: GetSpotOrderReq): Promise<SpotOrder> {
    const { order_id, ...query } = params;
    return this.getPrivate(`/spot/orders/${order_id}`, query);
  }

  /**
   * Amend an order
   *
   * By default, the orders of spot, portfolio and margin account are updated. If you need to modify orders of the cross-margin account, you must specify account as cross_margin. For portfolio margin account, only cross_margin account is supported.
   *
   * Currently, only supports modification of price or amount fields.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for amending an order
   * @returns Promise<Order>
   */
  updateSpotOrder(params: UpdateSpotOrderReq): Promise<SpotOrder> {
    const { xGateExptime, order_id, currency_pair, account, ...body } = params;
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    const query = {
      currency_pair: currency_pair,
      account: account,
    };

    return this.patchPrivate(`/spot/orders/${order_id}`, {
      headers: headers,
      query: query,
      body: body,
    });
  }

  /**
   * Cancel a single order
   *
   * Spot, portfolio and margin orders are cancelled by default. If trying to cancel cross margin orders or portfolio margin account are used, account must be set to cross_margin.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for cancelling a single order
   * @returns Promise<Order>
   */
  cancelSpotOrder(params: DeleteSpotOrderReq): Promise<SpotOrder> {
    const { xGateExptime, order_id, ...query } = params;
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.deletePrivate(`/spot/orders/${order_id}`, {
      headers: headers,
      query: query,
    });
  }

  /**
   * List personal trading history
   *
   * By default query of transaction records for spot, unified account and warehouse-by-site leverage accounts.
   *
   * The history within a specified time range can be queried by specifying from or (and) to.
   *
   * If no time parameters are specified, only data for the last 7 days can be obtained.
   * If only any parameter of from or to is specified, only 7-day data from the start (or end) of the specified time is returned.
   * The range not allowed to exceed 30 days.
   * The parameters of the time range filter are processed according to the order end time.
   *
   * The maximum number of pages when searching data using limit&page paging function is 100,0, that is, limit * (page - 1) <= 100,0.
   *
   * @param params Parameters for listing personal trading history
   * @returns Promise<GetSpotTradingHistoryResp[]>
   */
  getSpotTradingHistory(
    params?: GetSpotTradingHistoryReq,
  ): Promise<SpotHistoricTradeRecord[]> {
    return this.getPrivate('/spot/my_trades', params);
  }

  /**
   * Get server current time
   *
   * @returns Promise<{
   *   server_time: number;
   * }>
   */
  getServerTime(): Promise<{
    server_time: number;
  }> {
    return this.get('/spot/time');
  }

  /**
   * Countdown cancel orders
   *
   * When the timeout set by the user is reached, if there is no cancel or set a new countdown, the related pending orders will be automatically cancelled. This endpoint can be called repeatedly to set a new countdown or cancel the countdown.
   *
   * @param params Parameters for setting countdown cancel orders
   * @returns Promise<{
   *   triggerTime: number;
   * }>
   */
  submitSpotCountdownOrders(params: {
    timeout: number;
    currency_pair?: string;
  }): Promise<{
    triggerTime: number;
  }> {
    return this.postPrivate('/spot/countdown_cancel_all', { body: params });
  }

  /**
   * Batch modification of orders
   *
   * Default modification of orders for spot, portfolio, and margin accounts. To modify orders for a cross margin account, the account parameter must be specified as cross_margin. For portfolio margin accounts, the account parameter can only be specified as cross_margin. Currently, only modifications to price or quantity (choose one) are supported.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for batch modification of orders
   * @returns Promise<Order[]>
   */
  batchUpdateSpotOrders(
    body: UpdateSpotBatchOrdersReq[],
    params?: {
      xGateExptime?: number;
    },
  ): Promise<SpotOrder[]> {
    const { xGateExptime } = params || {};
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.postPrivate('/spot/amend_batch_orders', {
      headers: headers,
      body: body,
    });
  }

  /**
   * Query spot insurance fund historical data
   *
   * @param params Parameters for querying spot insurance fund history
   * @returns Promise<{
   *   currency: string;
   *   balance: string;
   *   time: number;
   * }[]>
   */
  getSpotInsuranceHistory(
    params: GetSpotInsuranceHistoryReq,
  ): Promise<SpotInsuranceHistory[]> {
    return this.getPrivate('/spot/insurance_history', params);
  }

  /**
   * Create a price-triggered order
   *
   * @param params Parameters for creating a price-triggered order
   * @returns Promise<{
   *   id: number;
   * }>
   */
  submitSpotPriceTriggerOrder(params: SpotPriceTriggeredOrder): Promise<{
    id: number;
  }> {
    return this.postPrivate('/spot/price_orders', { body: params });
  }

  /**
   * Retrieve running auto order list
   *
   * @param params Parameters for retrieving running auto order list
   * @returns Promise<SpotPriceTriggeredOrder[]>
   */
  getSpotAutoOrders(
    params: GetSpotAutoOrdersReq,
  ): Promise<SpotPriceTriggeredOrder[]> {
    return this.getPrivate('/spot/price_orders', params);
  }

  /**
   * Cancel all open orders
   *
   * @param params Parameters for cancelling all open orders
   * @returns Promise<SpotPriceTriggeredOrder[]>
   */
  cancelAllOpenSpotOrders(params?: {
    market?: string;
    account?: 'normal' | 'margin' | 'cross_margin';
  }): Promise<SpotPriceTriggeredOrder[]> {
    return this.deletePrivate('/spot/price_orders', { query: params });
  }

  /**
   * Get a price-triggered order
   *
   * @param params Parameters for getting a price-triggered order
   * @returns Promise<SpotPriceTriggeredOrder>
   */
  getPriceTriggeredOrder(params: {
    order_id: string;
  }): Promise<SpotPriceTriggeredOrder> {
    return this.getPrivate(`/spot/price_orders/${params.order_id}`);
  }

  /**
   * Cancel a price-triggered order
   *
   * @param params Parameters for cancelling a price-triggered order
   * @returns Promise<SpotPriceTriggeredOrder>
   */
  cancelSpotTriggeredOrder(params: {
    order_id: string;
  }): Promise<SpotPriceTriggeredOrder> {
    return this.deletePrivate(`/spot/price_orders/${params.order_id}`);
  }

  /**
   * List Spot POV orders
   *
   * List percentage-of-volume strategy orders. Status defaults to open when listing active orders.
   *
   * @param params Parameters for listing Spot POV orders
   * @returns Promise<SpotPovOrder[]>
   */
  getSpotPovOrders(params: GetSpotPovOrdersReq): Promise<SpotPovOrder[]> {
    return this.getPrivate('/spot/pov_orders', params);
  }

  /**
   * Create a Spot POV order
   *
   * Create a percentage-of-volume strategy order with a target participation rate, validity period, and optional limit/trigger prices.
   *
   * @param params Parameters for creating a Spot POV order
   * @returns Promise<SpotPovOrder>
   */
  createSpotPovOrder(params: CreateSpotPovOrderReq): Promise<SpotPovOrder> {
    return this.postPrivate('/spot/pov_orders', { body: params });
  }

  /**
   * Cancel Spot POV orders
   *
   * Cancel Spot POV orders in bulk. Optionally filter by currency pair.
   *
   * @param params Optional parameters for cancelling Spot POV orders
   * @returns Promise<SpotPovOrder[]>
   */
  cancelSpotPovOrders(
    params?: CancelSpotPovOrdersReq,
  ): Promise<SpotPovOrder[]> {
    return this.postPrivate('/spot/pov_orders/cancel', { query: params });
  }

  /**
   * Query Spot POV order details
   *
   * Supports the order ID returned after creation, or the custom ID specified in the text field.
   *
   * @param params Parameters containing the order ID
   * @returns Promise<SpotPovOrder>
   */
  getSpotPovOrder(params: { order_id: string }): Promise<SpotPovOrder> {
    return this.getPrivate(`/spot/pov_orders/${params.order_id}`);
  }

  /**
   * Cancel a Spot POV order
   *
   * Supports the order ID returned after creation, or the custom ID specified in the text field.
   *
   * @param params Parameters containing the order ID
   * @returns Promise<SpotPovOrder>
   */
  cancelSpotPovOrder(params: { order_id: string }): Promise<SpotPovOrder> {
    return this.postPrivate(`/spot/pov_orders/${params.order_id}/cancel`);
  }

  /**
   * Set collateral currency
   *
   * @param params Parameters for setting collateral currency
   * @returns Promise<{
   *   is_success: boolean;
   * }>
   */
  setCollateralCurrency(params: {
    collateral_type: 0 | 1;
    enable_list?: string[];
    disable_list?: string[];
  }): Promise<{
    is_success: boolean;
  }> {
    return this.postPrivate('/unified/collateral_currencies', { body: params });
  }

  /**==========================================================================================================================
   * MARGIN
   * ==========================================================================================================================
   */

  /**
   * Margin account list
   *
   * @param params Parameters for listing margin accounts
   * @returns Promise<GetMarginAccountsResp[]>
   */
  getMarginAccounts(params?: {
    currency_pair?: string;
  }): Promise<MarginAccount[]> {
    return this.getPrivate('/margin/accounts', params);
  }

  /**
   * List margin account balance change history
   *
   * Only transferals from and to margin account are provided for now. Time range allows 30 days at most.
   *
   * @param params Parameters for listing margin account balance change history
   * @returns Promise<GetMarginBalanceHistoryResp[]>
   */
  getMarginBalanceHistory(
    params?: GetMarginBalanceHistoryReq,
  ): Promise<MarginBalanceHistoryRecord[]> {
    return this.getPrivate('/margin/account_book', params);
  }

  /**
   * Funding account list
   *
   * @param params Parameters for listing funding accounts
   * @returns Promise<{
   *   currency: string;
   *   available: string;
   *   locked: string;
   *   lent: string;
   *   total_lent: string;
   * }[]>
   */
  getFundingAccounts(params?: { currency?: string }): Promise<
    {
      currency: string;
      available: string;
      locked: string;
      lent: string;
      total_lent: string;
    }[]
  > {
    return this.getPrivate('/margin/funding_accounts', params);
  }

  /**
   * Update user's auto repayment setting
   *
   * @param params Parameters for updating auto repayment setting
   * @returns Promise<{ status: 'on' | 'off' }>
   */
  updateAutoRepaymentSetting(params: {
    status: 'on' | 'off';
  }): Promise<{ status: 'on' | 'off' }> {
    return this.postPrivate('/margin/auto_repay', { query: params });
  }

  /**
   * Retrieve user auto repayment setting
   *
   * @returns Promise<{ status: 'on' | 'off' }>
   */
  getAutoRepaymentSetting(): Promise<{ status: 'on' | 'off' }> {
    return this.getPrivate('/margin/auto_repay');
  }

  /**
   * Get the max transferable amount for a specific margin currency
   *
   * @param params Parameters for retrieving the max transferable amount
   * @returns Promise<{
   *   currency: string;
   *   currency_pair?: string;
   *   amount: string;
   * }>
   */
  getMarginTransferableAmount(params: {
    currency: string;
    currency_pair?: string;
  }): Promise<{
    currency: string;
    currency_pair?: string;
    amount: string;
  }> {
    return this.getPrivate('/margin/transferable', params);
  }

  /**
   * @deprecated  as of 2025-02-10
   * Currencies supported by cross margin
   *
   * @returns Promise<GetCrossMarginCurrenciesResp[]>
   */
  getCrossMarginCurrencies(): Promise<CrossMarginCurrency[]> {
    return this.get('/margin/cross/currencies');
  }

  /**
   * @deprecated  as of 2025-02-10
   * Retrieve detail of one single currency supported by cross margin
   *
   * @param params Parameters containing the currency name
   * @returns Promise<GetCrossMarginCurrenciesResp>
   */
  getCrossMarginCurrency(params: {
    currency: string;
  }): Promise<CrossMarginCurrency> {
    return this.get(`/margin/cross/currencies/${params.currency}`);
  }

  /**
   * @deprecated  as of 2025-02-10
   * Retrieve cross margin account
   *
   * @returns Promise<GetCrossMarginAccountResp>
   */
  getCrossMarginAccount(): Promise<CrossMarginAccount> {
    return this.getPrivate('/margin/cross/accounts');
  }

  /**
   * @deprecated  as of 2025-02-10
   * Retrieve cross margin account change history
   *
   * Record time range cannot exceed 30 days.
   *
   * @param params Parameters for retrieving cross margin account change history
   * @returns Promise<GetCrossMarginAccountHistoryResp[]>
   */
  getCrossMarginAccountHistory(
    params?: GetCrossMarginAccountHistoryReq,
  ): Promise<CrossMarginAccountHistoryRecord[]> {
    return this.getPrivate('/margin/cross/account_book', params);
  }

  /**
   *
   * @deprecated  as of 2025-02-10
   * Create a cross margin borrow loan
   *
   * Borrow amount cannot be less than currency minimum borrow amount.
   *
   * @param params Parameters for creating a cross margin borrow loan
   * @returns Promise<SubmitCrossMarginBorrowLoanResp>
   *
   */
  submitCrossMarginBorrowLoan(
    params: SubmitCrossMarginBorrowLoanReq,
  ): Promise<CrossMarginMorrowLoanRecord> {
    return this.postPrivate('/margin/cross/loans', { body: params });
  }

  /**
   *
   * List cross margin borrow history
   *
   * Sort by creation time in descending order by default. Set reverse=false to return ascending results.
   *
   * @param params Parameters for listing cross margin borrow history
   * @returns Promise<SubmitCrossMarginBorrowLoanResp[]>
   */
  getCrossMarginBorrowHistory(
    params: GetCrossMarginBorrowHistoryReq,
  ): Promise<CrossMarginMorrowLoanRecord[]> {
    return this.getPrivate('/margin/cross/loans', params);
  }

  /**
   * @deprecated  as of 2025-02-10
   * Retrieve single borrow loan detail
   *
   * @param params Parameters containing the borrow loan ID
   * @returns Promise<SubmitCrossMarginBorrowLoanResp>
   */
  getCrossMarginBorrowLoan(params: {
    loan_id: string;
  }): Promise<CrossMarginMorrowLoanRecord> {
    return this.getPrivate(`/margin/cross/loans/${params.loan_id}`);
  }

  /**
   * @deprecated  as of 2025-02-10
   * Cross margin repayments
   *
   * When the liquidity of the currency is insufficient and the transaction risk is high, the currency will be disabled, and funds cannot be transferred. When the available balance of cross-margin is insufficient, the balance of the spot account can be used for repayment. Please ensure that the balance of the spot account is sufficient, and system uses cross-margin account for repayment first.
   *
   * @param params Parameters for cross margin repayments
   * @returns Promise<SubmitCrossMarginBorrowLoanResp[]>
   */
  submitCrossMarginRepayment(params: {
    currency: string;
    amount: string;
  }): Promise<CrossMarginMorrowLoanRecord[]> {
    return this.postPrivate('/margin/cross/repayments', { body: params });
  }

  /**
   * @deprecated  as of 2025-02-10
   * Retrieve cross margin repayments
   *
   * Sort by creation time in descending order by default. Set reverse=false to return ascending results.
   *
   * @param params Parameters for retrieving cross margin repayments
   * @returns Promise<GetCrossMarginRepaymentsResp[]>
   */
  getCrossMarginRepayments(
    params?: GetCrossMarginRepaymentsReq,
  ): Promise<CrossMarginAccount[]> {
    return this.getPrivate('/margin/cross/repayments', params);
  }

  /**
   * @deprecated  as of 2025-02-10
   * Interest records for the cross margin account
   *
   * @param params Parameters for retrieving interest records
   * @returns Promise<GetCrossMarginInterestRecordsResp[]>
   */
  getCrossMarginInterestRecords(
    params?: GetCrossMarginInterestRecordsReq,
  ): Promise<GetCrossMarginInterestRecordsReq[]> {
    return this.getPrivate('/margin/cross/interest_records', params);
  }

  /**
   * @deprecated  as of 2025-02-10
   * Get the max transferable amount for a specific cross margin currency
   *
   * @param params Parameters for retrieving the max transferable amount
   * @returns Promise<{
   *   currency: string;
   *   amount: string;
   * }>
   */
  getCrossMarginTransferableAmount(params: { currency: string }): Promise<{
    currency: string;
    amount: string;
  }> {
    return this.getPrivate('/margin/cross/transferable', params);
  }

  /**
   * @deprecated  as of 2025-02-10
   * Estimated interest rates
   *
   * Please note that the interest rates are subject to change based on the borrowing and lending demand, and therefore, the provided rates may not be entirely accurate.
   *
   * @param params Parameters for retrieving estimated interest rates
   * @returns Promise<any>
   */
  getEstimatedInterestRates(params: { currencies: string[] }): Promise<any> {
    return this.getPrivate('/margin/cross/estimate_rate', params);
  }

  /**
   * @deprecated  as of 2025-02-10
   * Get the max borrowable amount for a specific cross margin currency
   *
   * @param params Parameters for retrieving the max borrowable amount
   * @returns Promise<{
   *   currency: string;
   *   amount: string;
   * }>
   */
  getCrossMarginBorrowableAmount(params: { currency: string }): Promise<{
    currency: string;
    amount: string;
  }> {
    return this.getPrivate('/margin/cross/borrowable', params);
  }

  /**
   * Check the user's own leverage lending gradient in the current market
   *
   * @param params Parameters containing currency pair to query
   * @returns Promise with array of market gradient information
   */
  getMarginUserLoanTiers(params: { currency_pair: string }): Promise<
    {
      tier_amount: string;
      mmr: string;
      leverage: string;
    }[]
  > {
    return this.getPrivate('/margin/user/loan_margin_tiers', params);
  }

  /**
   * Query the current market leverage lending gradient
   *
   * @param params Parameters containing currency pair to query
   * @returns Promise with array of market gradient information
   */
  getMarginPublicLoanTiers(params: { currency_pair: string }): Promise<
    {
      tier_amount: string;
      mmr: string;
      leverage: string;
    }[]
  > {
    return this.get('/margin/loan_margin_tiers', params);
  }

  /**
   * Set the user market leverage multiple
   *
   * @param params Parameters containing currency pair and leverage value
   * @returns Promise<void> - Returns nothing on success (204 No Content)
   */
  setMarginUserLeverage(params: {
    currency_pair: string;
    leverage: string;
  }): Promise<any> {
    return this.postPrivate('/margin/leverage/user_market_setting', {
      body: params,
    });
  }

  /**
   * Query the user's leverage account list
   *
   * Supports querying risk rate per position account and margin rate per position account
   *
   * @param params Optional parameters for filtering by currency pair
   * @returns Promise with array of margin account details
   */
  getMarginUserAccounts(params?: {
    currency_pair?: string;
  }): Promise<MarginUserAccount[]> {
    return this.getPrivate('/margin/user/account', params);
  }

  /**==========================================================================================================================
   * MARGIN UNI
   * ==========================================================================================================================
   */
  /**
   * List lending markets
   *
   * @returns Promise<GetLendingMarketsResp[]>
   */
  getLendingMarkets(): Promise<LendingMarket[]> {
    return this.get('/margin/uni/currency_pairs');
  }

  /**
   * Get detail of lending market
   *
   * @param params Parameters containing the currency pair
   * @returns Promise<{
   *   currency_pair: string;
   *   base_min_borrow_amount: string;
   *   quote_min_borrow_amount: string;
   *   leverage: string;
   * }>
   */
  getLendingMarket(params: { currency_pair: string }): Promise<LendingMarket> {
    return this.get(`/margin/uni/currency_pairs/${params.currency_pair}`);
  }

  /**
   * Estimate interest rate
   *
   * Please note that the interest rates are subject to change based on the borrowing and lending demand, and therefore, the provided rates may not be entirely accurate.
   *
   * @param params Parameters for retrieving estimated interest rates
   * @returns Promise<any>
   */
  getEstimatedInterestRate(params: { currencies: string[] }): Promise<any> {
    return this.getPrivate('/margin/uni/estimate_rate', params);
  }

  /**
   * Borrow or repay
   *
   * @param params Parameters for borrowing or repaying
   * @returns Promise<any>
   */
  submitMarginUNIBorrowOrRepay(params: {
    currency: string;
    type: 'borrow' | 'repay';
    amount: string;
    currency_pair: string;
    repaid_all?: boolean;
  }): Promise<any> {
    return this.postPrivate('/margin/uni/loans', { body: params });
  }

  /**
   * List loans
   *
   * @param params Parameters for listing loans
   * @returns Promise<GetMarginUNILoansResp[]>
   */
  getMarginUNILoans(params?: GetMarginUNILoansReq): Promise<MarginUNILoan[]> {
    return this.getPrivate('/margin/uni/loans', params);
  }

  /**
   * Get loan records
   *
   * @param params Parameters for retrieving loan records
   * @returns Promise<GetMarginUNILoanRecordsResp[]>
   */
  getMarginUNILoanRecords(
    params?: GetMarginUNILoanRecordsReq,
  ): Promise<MarginUNILoanRecord[]> {
    return this.getPrivate('/margin/uni/loan_records', params);
  }

  /**
   * List interest records
   *
   * @param params Parameters for listing interest records
   * @returns Promise<GetMarginUNIInterestRecordsResp[]>
   */
  getMarginUNIInterestRecords(
    params?: GetMarginUNIInterestRecordsReq,
  ): Promise<MarginUNIInterestRecord[]> {
    return this.getPrivate('/margin/uni/interest_records', params);
  }

  /**
   * Get maximum borrowable
   *
   * @param params Parameters for retrieving the maximum borrowable amount
   * @returns Promise<GetMarginUNIMaxBorrowResp>
   */
  getMarginUNIMaxBorrow(
    params: GetMarginUNIMaxBorrowReq,
  ): Promise<MarginUNIMaxBorrowable> {
    return this.getPrivate('/margin/uni/borrowable', params);
  }
  /**==========================================================================================================================
   * FLASH SWAP
   * ==========================================================================================================================
   */

  /**
   * List All Supported Currency Pairs In Flash Swap
   *
   * @param params Parameters for retrieving data of the specified currency
   * @returns Promise<GetFlashSwapCurrencyPairsResp[]>
   */
  getFlashSwapCurrencyPairs(params?: {
    currency?: string;
    page?: number;
    limit?: number;
  }): Promise<FlashSwapCurrencyPair[]> {
    return this.get('/flash_swap/currency_pairs', params);
  }

  /**
   * Create a flash swap order
   *
   * Initiate a flash swap preview in advance because order creation requires a preview result.
   *
   * @param params Parameters for creating a flash swap order
   * @returns Promise<SubmitFlashSwapOrderResp>
   */
  submitFlashSwapOrder(
    params: SubmitFlashSwapOrderReq,
  ): Promise<FlashSwapOrder> {
    return this.postPrivate('/flash_swap/orders', { body: params });
  }

  /**
   * List all flash swap orders
   *
   * @param params Parameters for listing flash swap orders
   * @returns Promise<GetFlashSwapOrdersResp[]>
   */
  getFlashSwapOrders(
    params?: GetFlashSwapOrdersReq,
  ): Promise<FlashSwapOrder[]> {
    return this.getPrivate('/flash_swap/orders', params);
  }

  /**
   * Get a single flash swap order's detail
   *
   * @param params Parameters containing the flash swap order ID
   * @returns Promise<GetFlashSwapOrderResp>
   */
  getFlashSwapOrder(params: { order_id: number }): Promise<FlashSwapOrder> {
    return this.getPrivate(`/flash_swap/orders/${params.order_id}`);
  }

  /**
   * Initiate a flash swap order preview
   *
   * @param params Parameters for initiating a flash swap order preview
   * @returns Promise<SubmitFlashSwapOrderPreviewResp>
   */
  submitFlashSwapOrderPreview(
    params: SubmitFlashSwapOrderPreviewReq,
  ): Promise<SubmitFlashSwapOrderPreviewResp> {
    return this.postPrivate('/flash_swap/orders/preview', { body: params });
  }

  /**==========================================================================================================================
   * FUTURES
   * ==========================================================================================================================
   */

  /**
   * List all futures contracts
   *
   * @param params Parameters for listing futures contracts
   * @returns Promise<Contract[]>
   */
  getFuturesContracts(params: {
    settle: 'btc' | 'usdt' | 'usd';
    limit?: number;
    offset?: number;
  }): Promise<FuturesContract[]> {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/contracts`, query);
  }

  /**
   * Get a single contract
   *
   * @param params Parameters for retrieving a single contract
   * @returns Promise<Contract>
   */
  getFuturesContract(params: {
    settle: 'btc' | 'usdt' | 'usd';
    contract: string;
  }): Promise<FuturesContract> {
    return this.get(`/futures/${params.settle}/contracts/${params.contract}`);
  }

  /**
   * Futures order book
   *
   * Bids will be sorted by price from high to low, while asks sorted reversely.
   *
   * @param params Parameters for retrieving the futures order book
   * @returns Promise<GetFuturesOrderBookResp>
   */
  getFuturesOrderBook(
    params: GetFuturesOrderBookReq,
  ): Promise<FuturesOrderBook> {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/order_book`, query);
  }

  /**
   * Futures trading history
   *
   * @param params Parameters for retrieving futures trading history
   * @returns Promise<GetFuturesTradesResp[]>
   */
  getFuturesTrades(params: GetFuturesTradesReq): Promise<FuturesTrade[]> {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/trades`, query);
  }

  /**
   * Get futures Candles
   *
   * Return specified contract Candles. If prefix contract with mark_, the contract's mark price Candles are returned; if prefix with index_, index price Candles will be returned.
   *
   * Maximum of 2000 points are returned in one query. Be sure not to exceed the limit when specifying from, to and interval.
   *
   * @param params Parameters for retrieving futures Candles
   * @returns Promise<GetFuturesCandlesResp[]>
   */
  getFuturesCandles(params: GetFuturesCandlesReq): Promise<FuturesCandle[]> {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/candlesticks`, query);
  }

  /**
   * Premium Index K-Line
   *
   * Maximum of 1000 points can be returned in a query. Be sure not to exceed the limit when specifying from, to and interval.
   *
   * @param params Parameters for retrieving premium index K-Line
   * @returns Promise<GetPremiumIndexKLineResp[]>
   */
  getPremiumIndexKLines(
    params: GetFuturesCandlesReq,
  ): Promise<PremiumIndexKLine[]> {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/premium_index`, query);
  }

  /**
   * List futures tickers
   *
   * @param params Parameters for listing futures tickers
   * @returns Promise<GetFuturesTickersResp[]>
   */
  getFuturesTickers(params: {
    settle: 'btc' | 'usdt' | 'usd';
    contract?: string;
  }): Promise<FuturesTicker[]> {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/tickers`, query);
  }

  /**
   * Funding rate history
   *
   * @param params Parameters for retrieving funding rate history
   * @returns Promise<{
   *   t: number;
   *   r: string;
   * }[]>
   */
  getFundingRates(params: GetFundingRatesReq): Promise<
    {
      t: number;
      r: string;
    }[]
  > {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/funding_rate`, query);
  }

  /**
   * Batch query historical funding rate data for perpetual contracts
   *
   * @param params settle and array of contract names
   * @returns Promise<BatchFundingRatesResponse[]>
   */
  getBatchFundingRates(
    params: BatchFundingRatesReq,
  ): Promise<BatchFundingRatesResponse[]> {
    const { settle, contracts } = params;
    return this.post(`/futures/${settle}/funding_rates`, {
      body: { contracts },
    });
  }

  /**
   * Futures insurance balance history
   *
   * @param params Parameters for retrieving futures insurance balance history
   * @returns Promise<{
   *   t: number;
   *   b: string;
   * }[]>
   */
  getFuturesInsuranceBalanceHistory(params: {
    settle: 'btc' | 'usdt' | 'usd';
    limit?: number;
  }): Promise<
    {
      t: number;
      b: string;
    }[]
  > {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/insurance`, query);
  }

  /**
   * Futures stats
   *
   * @param params Parameters for retrieving futures stats
   * @returns Promise<GetFuturesStatsResp[]>
   */
  getFuturesStats(params: GetFuturesStatsReq): Promise<FuturesStats[]> {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/contract_stats`, query);
  }

  /**
   * Get index constituents
   *
   * @param params Parameters for retrieving index constituents
   * @returns Promise<GetIndexConstituentsResp>
   */
  getIndexConstituents(params: {
    settle: 'btc' | 'usdt' | 'usd';
    index: string;
  }): Promise<IndexConstituents> {
    return this.get(
      `/futures/${params.settle}/index_constituents/${params.index}`,
    );
  }

  /**
   * Retrieve liquidation history
   *
   * Interval between from and to cannot exceed 3600. Some private fields will not be returned in public endpoints. Refer to field description for detail.
   *
   * @param params Parameters for retrieving liquidation history
   * @returns Promise<GetLiquidationHistoryResp[]>
   */
  getLiquidationHistory(
    params: GetLiquidationHistoryReq,
  ): Promise<LiquidationHistoryRecord[]> {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/liq_orders`, query);
  }

  /**
   * List risk limit tiers
   *
   * When the 'contract' parameter is not passed, the default is to query the risk limits for the top 100 markets.
   * 'Limit' and 'offset' correspond to pagination queries at the market level, not to the length of the returned array.
   * This only takes effect when the 'contract' parameter is empty.
   *
   * @param params Parameters for listing risk limit tiers
   * @returns Promise<GetRiskLimitTiersResp[]>
   */
  getRiskLimitTiers(params: GetRiskLimitTiersReq): Promise<RiskLimitTier[]> {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/risk_limit_tiers`, query);
  }

  /**
   * Query futures account
   *
   * Query account information for classic future account and unified account
   *
   * @param params Parameters for querying futures account
   * @returns Promise<GetFuturesAccountResp>
   */
  getFuturesAccount(params: {
    settle: 'btc' | 'usdt' | 'usd';
  }): Promise<FuturesAccount> {
    return this.getPrivate(`/futures/${params.settle}/accounts`);
  }

  /**
   * Query account book
   *
   * If the contract field is provided, it can only filter records that include this field after 2023-10-30.
   *
   * @param params Parameters for querying account book
   * @returns Promise<GetFuturesAccountBookResp[]>
   */
  getFuturesAccountBook(
    params: GetFuturesAccountBookReq,
  ): Promise<FuturesAccountBookRecord[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/account_book`, query);
  }

  /**
   * List all positions of a user
   *
   * @param params Parameters for listing all positions of a user
   * @returns Promise<Position[]>
   */
  getFuturesPositions(
    params: GetFuturesPositionsReq,
  ): Promise<FuturesPosition[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/positions`, query);
  }

  /**
   * Get single position
   *
   * Clarifies dual-position query method when holding both long and short positions in the same contract market
   *
   * @param params Parameters for retrieving a single position
   * @returns Promise<Position>
   */
  getFuturesPosition(params: {
    settle: 'btc' | 'usdt' | 'usd';
    contract: string;
  }): Promise<FuturesPosition> {
    return this.getPrivate(
      `/futures/${params.settle}/positions/${params.contract}`,
    );
  }

  /**
   * Update position margin
   *
   * Under the new risk limit rules, the position limit is related to the leverage you set; a lower leverage will result in a higher position limit. Please use the leverage adjustment api to adjust the position limit.
   *
   * @param params Parameters for updating position margin
   * @returns Promise<Position>
   */
  updateFuturesMargin(params: {
    settle: 'btc' | 'usdt' | 'usd';
    contract: string;
    change: string;
  }): Promise<FuturesPosition> {
    const { settle, contract, ...query } = params;
    return this.postPrivate(`/futures/${settle}/positions/${contract}/margin`, {
      query: query,
    });
  }

  /**
   * Update position leverage
   *
   * Position Mode Switching Rules:
   * - leverage ≠ 0: Isolated Margin Mode (Regardless of whether cross_leverage_limit is filled, this parameter will be ignored)
   * - leverage = 0: Cross Margin Mode (Use cross_leverage_limit to set the leverage multiple)
   *
   * Examples:
   * - Set isolated margin with 10x leverage: leverage=10
   * - Set cross margin with 10x leverage: leverage=0&cross_leverage_limit=10
   * - leverage=5&cross_leverage_limit=10 → Result: Isolated margin with 5x leverage (cross_leverage_limit is ignored)
   *
   * Warning: Incorrect settings may cause unexpected position mode switching, affecting risk management.
   *
   * @param params Parameters for updating position leverage
   * @returns Promise<Position>
   */
  updateFuturesLeverage(params: {
    settle: 'btc' | 'usdt' | 'usd';
    contract: string;
    leverage: string;
    cross_leverage_limit?: string;
    pid?: number; // Product ID
  }): Promise<FuturesPosition> {
    const { settle, contract, ...query } = params;
    return this.postPrivate(
      `/futures/${settle}/positions/${contract}/leverage`,
      { query: query },
    );
  }

  /**
   * Get leverage for a contract in split / dual-side mode (requires pos_margin_mode and dual_side).
   *
   * @param params settle, contract, pos_margin_mode, dual_side
   * @returns Promise<FuturesContractLeverageInfo> — response field `Lever` is the leverage string
   */
  getFuturesContractLeverage(
    params: GetFuturesContractLeverageReq,
  ): Promise<FuturesContractLeverageInfo> {
    const { settle, contract, ...query } = params;
    return this.getPrivate(
      `/futures/${settle}/get_leverage/${contract}`,
      query,
    );
  }

  /**
   * Update position by store mode
   *
   * @param params Parameters for updating position by store mode
   * @returns Promise<FuturesPosition>
   */
  updateFuturesPositionMode(params: {
    settle: 'btc' | 'usdt';
    mode: 'ISOLATED' | 'CROSS';
    contract: string;
  }): Promise<FuturesPosition> {
    const { settle, ...body } = params;
    return this.postPrivate(`/futures/${settle}/positions/cross_mode`, {
      body: body,
    });
  }

  /**
   * Update position risk limit
   *
   * @param params Parameters for updating position risk limit
   * @returns Promise<Position>
   */
  updatePositionRiskLimit(params: {
    settle: 'btc' | 'usdt' | 'usd';
    contract: string;
    risk_limit: string;
  }): Promise<FuturesPosition> {
    const { settle, contract, ...query } = params;
    return this.postPrivate(
      `/futures/${settle}/positions/${contract}/risk_limit`,
      { query: query },
    );
  }

  /**
   * Enable or disable dual mode
   *
   * Before setting dual mode, make sure all positions are closed and no orders are open.
   *
   * @param params Parameters for enabling or disabling dual mode
   * @returns Promise<FuturesAccount>
   */
  updateFuturesDualMode(params: {
    settle: 'btc' | 'usdt' | 'usd';
    dual_mode: boolean;
  }): Promise<FuturesAccount> {
    const { settle, ...query } = params;
    return this.postPrivate(`/futures/${settle}/dual_mode`, {
      query: query,
    });
  }

  /**
   * Retrieve position detail in dual mode
   *
   * @param params Parameters for retrieving position detail in dual mode
   * @returns Promise<Position[]>
   */
  getDualModePosition(params: {
    settle: 'btc' | 'usdt' | 'usd';
    contract: string;
  }): Promise<FuturesPosition[]> {
    return this.getPrivate(
      `/futures/${params.settle}/dual_comp/positions/${params.contract}`,
    );
  }

  /**
   * Update position margin in dual mode
   *
   * @param params Parameters for updating position margin in dual mode
   * @returns Promise<Position[]>
   */
  updateDualModePositionMargin(
    params: UpdateDualModePositionMarginReq,
  ): Promise<FuturesPosition[]> {
    const { settle, contract, ...query } = params;
    return this.postPrivate(
      `/futures/${settle}/dual_comp/positions/${contract}/margin`,
      { query: query },
    );
  }

  /**
   * Update position leverage in dual mode
   *
   * @param params Parameters for updating position leverage in dual mode
   * @returns Promise<Position[]>
   */
  updateDualModePositionLeverage(
    params: UpdateDualModePositionLeverageReq,
  ): Promise<FuturesPosition[]> {
    const { settle, contract, ...query } = params;
    return this.postPrivate(
      `/futures/${settle}/dual_comp/positions/${contract}/leverage`,
      { query: query },
    );
  }

  /**
   * Update position risk limit in dual mode
   *
   * @param params Parameters for updating position risk limit in dual mode
   * @returns Promise<Position[]>
   */
  /**
   * Update position risk limit in dual mode
   *
   * See risk limit rules for more information
   *
   * @param params Parameters for updating position risk limit in dual mode
   * @returns Promise<FuturesPosition[]>
   */
  updateDualModePositionRiskLimit(params: {
    settle: 'btc' | 'usdt' | 'usd';
    contract: string;
    risk_limit: string;
  }): Promise<FuturesPosition[]> {
    const { settle, contract, ...query } = params;
    return this.postPrivate(
      `/futures/${settle}/dual_comp/positions/${contract}/risk_limit`,
      { query: query },
    );
  }

  /**
   * Create a futures order
   *
   * Creating futures orders requires size, which is the number of contracts instead of currency amount. You can use quanto_multiplier in the contract detail response to know how much currency 1 size contract represents.
   * Zero-filled order cannot be retrieved 10 minutes after order cancellation. You will get a 404 not found for such orders.
   * Set reduce_only to true to keep the position from changing side when reducing position size.
   * In single position mode, to close a position, you need to set size to 0 and close to true.
   * In dual position mode, to close one side position, you need to set auto_size side, reduce_only to true, and size to 0.
   * Set stp_act to decide the strategy of self-trade prevention. For detailed usage, refer to the stp_act parameter in the request body.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for creating a futures order
   * @returns Promise<FuturesOrder>
   */
  submitFuturesOrder(params: SubmitFuturesOrderReq): Promise<FuturesOrder> {
    const { xGateExptime, settle, ...body } = params;
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.postPrivate(`/futures/${settle}/orders`, {
      headers: headers,
      body: body,
    });
  }

  /**
   * List futures orders
   *
   * Zero-fill order cannot be retrieved for 10 minutes after cancellation.
   * Historical orders, by default, only data within the past 6 months is supported. If you need to query data for a longer period, please use GET /futures/{settle}/orders_timerange.
   *
   * @param params Parameters for listing futures orders
   * @returns Promise<FuturesOrder[]>
   */
  getFuturesOrders(params: GetFuturesOrdersReq): Promise<FuturesOrder[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/orders`, query);
  }

  /**
   * Cancel all open orders matched
   *
   * Zero-filled order cannot be retrieved 10 minutes after order cancellation.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for cancelling all open orders matched
   * @returns Promise<FuturesOrder[]>
   */
  cancelAllFuturesOrders(
    params: DeleteAllFuturesOrdersReq,
  ): Promise<FuturesOrder[]> {
    const { xGateExptime, settle, ...query } = params;
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.deletePrivate(`/futures/${settle}/orders`, {
      headers: headers,
      query: query,
    });
  }

  /**
   * List Futures Orders By Time Range
   *
   * @param params Parameters for listing futures orders by time range
   * @returns Promise<FuturesOrderTimerange[]>
   */
  getFuturesOrdersByTimeRange(
    params: GetFuturesOrdersByTimeRangeReq,
  ): Promise<FuturesOrderTimerange[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/orders_timerange`, query);
  }

  /**
   * Create a batch of futures orders
   *
   * Up to 10 orders per request.
   * If any of the order's parameters are missing or in the wrong format, all of them will not be executed, and a http status 400 error will be returned directly.
   * If the parameters are checked and passed, all are executed. Even if there is a business logic error in the middle (such as insufficient funds), it will not affect other execution orders.
   * The returned result is in array format, and the order corresponds to the orders in the request body.
   * In the returned result, the succeeded field of type bool indicates whether the execution was successful or not.
   * If the execution is successful, the normal order content is included; if the execution fails, the label field is included to indicate the cause of the error.
   * In the rate limiting, each order is counted individually.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for creating a batch of futures orders
   * @returns Promise<FuturesOrder[]>
   */
  submitFuturesBatchOrders(params: {
    xGateExptime?: number;
    settle: 'btc' | 'usdt' | 'usd';
    orders: SubmitFuturesOrderReq[];
  }): Promise<FuturesOrder[]> {
    const { xGateExptime, settle, orders } = params;
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.postPrivate(`/futures/${settle}/batch_orders`, {
      headers: headers,
      body: orders,
    });
  }

  /**
   * Get a single order
   *
   * Zero-fill order cannot be retrieved for 10 minutes after cancellation.
   * Historical orders, by default, only data within the past 6 months is supported.
   *
   * @param params.order_id Exchange order id (numeric), **or** the order's custom client id from the `text` field — same path segment as in `GET /futures/{settle}/orders/{order_id}`.
   * @returns Promise<FuturesOrder>
   */
  getFuturesOrder(params: {
    settle: 'btc' | 'usdt' | 'usd';
    order_id: string;
  }): Promise<FuturesOrder> {
    return this.getPrivate(
      `/futures/${params.settle}/orders/${params.order_id}`,
    );
  }

  /**
   * Cancel a single order
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for cancelling a single order
   * @returns Promise<FuturesOrder>
   */
  cancelFuturesOrder(params: {
    xGateExptime?: number;
    settle: 'btc' | 'usdt' | 'usd';
    order_id: string;
    action_mode?: 'ACK' | 'RESULT' | 'FULL';
  }): Promise<FuturesOrder> {
    const { xGateExptime, settle, order_id, action_mode } = params;
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.deletePrivate(`/futures/${settle}/orders/${order_id}`, {
      headers: headers,
      query: action_mode !== undefined ? { action_mode } : undefined,
    });
  }

  /**
   * Amend an order
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for amending an order
   * @returns Promise<FuturesOrder>
   */
  updateFuturesOrder(params: UpdateFuturesOrderReq): Promise<FuturesOrder> {
    const { xGateExptime, settle, order_id, ...body } = params;

    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.putPrivate(`/futures/${settle}/orders/${order_id}`, {
      body: body,
      headers: headers,
    });
  }

  /**
   * List personal trading history
   *
   * By default, only data within the past 6 months is supported. If you need to query data for a longer period, please use GET /futures/{settle}/my_trades_timerange.
   *
   * @param params Parameters for listing personal trading history
   * @returns Promise<GetFuturesTradingHistoryResp[]>
   */
  getFuturesTradingHistory(
    params: GetFuturesTradingHistoryReq,
  ): Promise<FuturesTradingHistoryRecord[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/my_trades`, query);
  }

  /**
   * List personal trading history
   *
   * This endpoint is for data longer than 6 months.
   *
   * @param params Parameters for listing personal trading history
   * @returns Promise<GetFuturesTradingHistoryResp[]>
   */
  getFuturesTradingHistoryByTimeRange(
    params: GetFuturesTradingHistoryByTimeRangeReq,
  ): Promise<FuturesTradingHistoryRecord[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/my_trades_timerange`, query);
  }

  /**
   * List position close history
   *
   * @param params Parameters for listing position close history
   * @returns Promise<GetFuturesPositionHistoryResp[]>
   */
  getFuturesPositionHistory(
    params: GetFuturesPositionHistoryReq,
  ): Promise<FuturesPositionHistoryRecord[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/position_close`, query);
  }

  /**
   * List liquidation history
   *
   * @param params Parameters for listing liquidation history
   * @returns Promise<GetFuturesLiquidationHistoryResp[]>
   */
  getFuturesLiquidationHistory(
    params: GetFuturesLiquidationHistoryReq,
  ): Promise<FuturesLiquidationHistoryRecord[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/liquidates`, query);
  }

  /**
   * List Auto-Deleveraging History
   *
   * @param params Parameters for listing auto-deleveraging history
   * @returns Promise<GetFuturesAutoDeleveragingHistoryResp[]>
   */
  getFuturesAutoDeleveragingHistory(
    params: GetFuturesLiquidationHistoryReq,
  ): Promise<FuturesAutoDeleveragingHistoryRecord[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/auto_deleverages`, query);
  }

  /**
   * Countdown cancel orders
   *
   * When the timeout set by the user is reached, if there is no cancel or set a new countdown, the related pending orders will be automatically cancelled. This endpoint can be called repeatedly to set a new countdown or cancel the countdown.
   * For example, call this endpoint at 30s intervals, each countdown timeout is set to 30s. If this endpoint is not called again within 30 seconds, all pending orders on the specified market will be automatically cancelled, if no market is specified, all market pending orders will be cancelled.
   * If the timeout is set to 0 within 30 seconds, the countdown timer will expire and the cancel function will be cancelled.
   *
   * @param params Parameters for setting countdown cancel orders
   * @returns Promise<{ triggerTime: number }>
   */
  setFuturesOrderCancelCountdown(params: {
    settle: 'btc' | 'usdt' | 'usd';
    timeout: number;
    contract?: string;
  }): Promise<{ triggerTime: number }> {
    const { settle, ...body } = params;
    return this.postPrivate(`/futures/${settle}/countdown_cancel_all`, {
      body: body,
    });
  }

  /**
   * Query user trading fee rates
   *
   * @param params Parameters for querying user trading fee rates
   * @returns Promise<any>
   */
  getFuturesUserTradingFees(params: {
    settle: 'btc' | 'usdt' | 'usd';
    contract?: string;
  }): Promise<any> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/fee`, query);
  }

  /**
   * Cancel a batch of orders with an ID list
   *
   * Multiple distinct order ID list can be specified. Each request can cancel a maximum of 20 records.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Parameters for cancelling a batch of orders with an ID list
   * @returns Promise<DeleteFuturesBatchOrdersResp[]>
   */
  batchCancelFuturesOrders(params: {
    xGateExptime?: number;
    settle: 'btc' | 'usdt' | 'usd';
    orderIds: string[];
  }): Promise<DeleteFuturesBatchOrdersResp[]> {
    const { xGateExptime, settle, orderIds } = params;
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.postPrivate(`/futures/${settle}/batch_cancel_orders`, {
      headers: headers,
      body: orderIds,
    });
  }

  /**
   * Batch modify orders with specified IDs
   *
   * You can specify multiple different order IDs. You can only modify up to 10 orders in one request.
   *
   * NOTE: The "xGateExptime" parameter will translate to the "x-gate-exptime" header.
   *
   * @param params Array of BatchAmendOrderReq objects
   * @param settle Settlement currency (e.g., 'btc', 'usdt', 'usd')
   * @returns Promise<BatchAmendOrderResp[]>
   */
  batchUpdateFuturesOrders(params: {
    xGateExptime?: number;
    settle: 'btc' | 'usdt' | 'usd';
    orders: BatchAmendOrderReq[];
  }): Promise<BatchAmendOrderResp[]> {
    const { xGateExptime, settle, orders } = params;
    const headers = xGateExptime
      ? { 'x-gate-exptime': xGateExptime }
      : undefined;

    return this.postPrivate(`/futures/${settle}/batch_amend_orders`, {
      headers: headers,
      body: orders,
    });
  }

  /**
   * Query risk limit table by table_id
   *
   * @param params Parameters for querying risk limit table
   * @returns Promise<RiskLimitTableTier[]>
   */
  getRiskLimitTable(
    params: GetRiskLimitTableReq,
  ): Promise<RiskLimitTableTier[]> {
    const { settle, ...query } = params;
    return this.get(`/futures/${settle}/risk_limit_table`, query);
  }

  /**
   * Create a price-triggered order
   *
   * @param params Parameters for creating a price-triggered order
   * @returns Promise<TriggerOrderResponse>
   */
  submitFuturesPriceTriggeredOrder(
    params: SubmitFuturesTriggeredOrderReq,
  ): Promise<TriggerOrderResponse> {
    const { settle, ...body } = params;
    return this.postPrivate(`/futures/${settle}/price_orders`, { body: body });
  }

  /**
   * List all auto orders
   *
   * @param params Parameters for listing all auto orders
   * @returns Promise<FuturesPriceTriggeredOrder[]>
   */
  getFuturesAutoOrders(
    params: GetFuturesAutoOrdersReq,
  ): Promise<FuturesPriceTriggeredOrder[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/price_orders`, query);
  }

  /**
   * Cancel all open orders
   *
   * @param params Parameters for cancelling all open orders
   * @returns Promise<FuturesPriceTriggeredOrder[]>
   */
  cancelAllOpenFuturesOrders(params: {
    settle: 'btc' | 'usdt' | 'usd';
    contract: string;
  }): Promise<FuturesPriceTriggeredOrder[]> {
    const { settle, ...query } = params;
    return this.deletePrivate(`/futures/${settle}/price_orders`, {
      query: query,
    });
  }

  /**
   * Get a price-triggered order
   *
   * @param params Parameters for retrieving a price-triggered order
   * @returns Promise<FuturesPriceTriggeredOrder>
   */
  getFuturesPriceTriggeredOrder(params: {
    settle: 'btc' | 'usdt' | 'usd';
    order_id: number;
  }): Promise<FuturesPriceTriggeredOrder> {
    return this.getPrivate(
      `/futures/${params.settle}/price_orders/${params.order_id}`,
    );
  }

  /**
   * Cancel a price-triggered order
   *
   * @param params Parameters for cancelling a price-triggered order
   * @returns Promise<FuturesPriceTriggeredOrder>
   */
  cancelFuturesPriceTriggeredOrder(params: {
    settle: 'btc' | 'usdt' | 'usd';
    order_id: number;
  }): Promise<FuturesPriceTriggeredOrder> {
    return this.deletePrivate(
      `/futures/${params.settle}/price_orders/${params.order_id}`,
    );
  }

  /**
   * Update a single price-triggered order
   *
   * @param params Parameters for updating a price-triggered order
   * @returns Promise<TriggerOrderResponse>
   */
  updateFuturesPriceTriggeredOrder(
    params: UpdateFuturesPriceTriggeredOrderReq,
  ): Promise<TriggerOrderResponse> {
    const { settle, ...body } = params;
    return this.putPrivate(`/futures/${settle}/price_orders/amend`, {
      body: body,
    });
  }

  /**
   * Create trail order
   *
   * @param params settle and trail order parameters
   * @returns Promise with code, message, data containing id and timestamp
   */
  createTrailOrder(params: CreateTrailOrderReq): Promise<{
    code?: number;
    message?: string;
    data?: { id?: string; timestamp?: number };
    timestamp?: number;
  }> {
    const { settle, ...body } = params;
    return this.postPrivate(`/futures/${settle}/autoorder/v1/trail/create`, {
      body,
    });
  }

  /**
   * Terminate trail order
   *
   * @param params settle and id or text
   * @returns Promise<TrailOrder>
   */
  terminateTrailOrder(params: TerminateTrailOrderReq): Promise<TrailOrder> {
    const { settle, ...body } = params;
    return this.postPrivate(`/futures/${settle}/autoorder/v1/trail/stop`, {
      body,
    });
  }

  /**
   * Batch terminate trail orders
   *
   * @param params settle and optional contract, related_position
   * @returns Promise<{ orders: TrailOrder[] }>
   */
  batchTerminateTrailOrders(
    params: BatchTerminateTrailOrdersReq,
  ): Promise<{ orders?: TrailOrder[] }> {
    const { settle, ...body } = params;
    return this.postPrivate(`/futures/${settle}/autoorder/v1/trail/stop_all`, {
      body,
    });
  }

  /**
   * Get trail order list
   *
   * @param params query parameters
   * @returns Promise<{ orders: TrailOrder[] }>
   */
  getTrailOrderList(
    params: GetTrailOrderListReq,
  ): Promise<{ orders?: TrailOrder[] }> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/autoorder/v1/trail/list`, query);
  }

  /**
   * Get trail order details
   *
   * @param params settle and order id
   * @returns Promise with code, message, data.order
   */
  getTrailOrderDetail(params: GetTrailOrderDetailReq): Promise<{
    code?: number;
    message?: string;
    data?: { order?: TrailOrder };
    timestamp?: number;
  }> {
    const { settle, id } = params;
    return this.getPrivate(`/futures/${settle}/autoorder/v1/trail/detail`, {
      id,
    });
  }

  /**
   * Update trail order
   *
   * @param params settle, id and fields to update
   * @returns Promise<TrailOrder>
   */
  updateTrailOrder(params: UpdateTrailOrderReq): Promise<TrailOrder> {
    const { settle, id, ...body } = params;
    return this.postPrivate(`/futures/${settle}/autoorder/v1/trail/update`, {
      body: { id, ...body },
    });
  }

  /**
   * Get trail order user modification records
   *
   * @param params settle, id and optional pagination
   * @returns Promise<{ change_log: TrailChangeLog[] }>
   */
  getTrailOrderChangeLog(
    params: GetTrailOrderChangeLogReq,
  ): Promise<{ change_log?: TrailChangeLog[] }> {
    const { settle, ...query } = params;
    return this.getPrivate(
      `/futures/${settle}/autoorder/v1/trail/change_log`,
      query,
    );
  }

  /**
   * Create a chase limit order
   */
  createChaseOrder(params: CreateChaseOrderReq): Promise<CreateChaseOrderResp> {
    const { settle, ...body } = params;
    return this.postPrivate(`/futures/${settle}/autoorder/v1/chase/create`, {
      body,
    });
  }

  /**
   * Stop a chase order
   */
  stopChaseOrder(params: StopChaseOrderReq): Promise<StopChaseOrderResp> {
    const { settle, ...body } = params;
    return this.postPrivate(`/futures/${settle}/autoorder/v1/chase/stop`, {
      body,
    });
  }

  /**
   * Stop chase orders in batch
   */
  stopAllChaseOrders(
    params: StopAllChaseOrdersReq,
  ): Promise<StopAllChaseOrdersResp> {
    const { settle, ...body } = params;
    return this.postPrivate(`/futures/${settle}/autoorder/v1/chase/stop_all`, {
      body,
    });
  }

  /**
   * List chase orders
   */
  getChaseOrders(params: GetChaseOrdersReq): Promise<GetChaseOrdersResp> {
    const { settle, ...query } = params;
    return this.getPrivate(`/futures/${settle}/autoorder/v1/chase/list`, query);
  }

  /**
   * Get chase order detail
   */
  getChaseOrderDetail(
    params: GetChaseOrderDetailReq,
  ): Promise<GetChaseOrderDetailResp> {
    const { settle, id } = params;
    return this.getPrivate(`/futures/${settle}/autoorder/v1/chase/detail`, {
      id,
    });
  }

  getFuturesPositionCloseHistory(
    params: GetFuturesPositionCloseHistoryReq,
  ): Promise<FuturesPositionHistoryRecord[]> {
    return this.getPrivate(
      `/futures/${params.settle}/position_close_history`,
      params,
    );
  }

  getFuturesInsuranceHistory(
    params: GetFuturesInsuranceReq,
  ): Promise<FuturesInsuranceHistory[]> {
    return this.getPrivate(`/futures/${params.settle}/insurance`, params);
  }

  /**==========================================================================================================================
   * DELIVERY
   * ==========================================================================================================================
   */

  /**
   * List all futures contracts
   *
   * @param params Parameters for listing all futures contracts
   * @returns Promise<DeliveryContract[]>
   */
  getAllDeliveryContracts(params: {
    settle: 'usdt';
  }): Promise<FuturesDeliveryContract[]> {
    return this.get(`/delivery/${params.settle}/contracts`);
  }

  /**
   * Get a single contract
   *
   * @param params Parameters for retrieving a single contract
   * @returns Promise<DeliveryContract>
   */
  getDeliveryContract(params: {
    settle: 'usdt';
    contract: string;
  }): Promise<FuturesDeliveryContract> {
    return this.get(`/delivery/${params.settle}/contracts/${params.contract}`);
  }

  /**
   * Futures order book
   *
   * Bids will be sorted by price from high to low, while asks sorted reversely
   *
   * @param params Parameters for retrieving the futures order book
   * @returns Promise<GetDeliveryOrderBookResp>
   */
  getDeliveryOrderBook(
    params: GetDeliveryOrderBookReq,
  ): Promise<DeliveryOrderBook> {
    const { settle, ...query } = params;
    return this.get(`/delivery/${settle}/order_book`, query);
  }

  /**
   * Futures trading history
   *
   * @param params Parameters for retrieving the futures trading history
   * @returns Promise<GetDeliveryTradesResp[]>
   */
  getDeliveryTrades(params: GetDeliveryTradesReq): Promise<DeliveryTrade[]> {
    const { settle, ...query } = params;
    return this.get(`/delivery/${settle}/trades`, query);
  }

  /**
   * Get futures Candles
   *
   * Return specified contract Candles. If prefix contract with mark_, the contract's mark price Candles are returned; if prefix with index_, index price Candles will be returned.
   * Maximum of 2000 points are returned in one query. Be sure not to exceed the limit when specifying from, to and interval.
   *
   * @param params Parameters for retrieving futures Candles
   * @returns Promise<GetDeliveryCandlesResp[]>
   */
  getDeliveryCandles(params: GetDeliveryCandlesReq): Promise<DeliveryCandle[]> {
    const { settle, ...query } = params;
    return this.get(`/delivery/${settle}/candlesticks`, query);
  }

  /**
   * List futures tickers
   *
   * @param params Parameters for listing futures tickers
   * @returns Promise<GetDeliveryTickersResp[]>
   */
  getDeliveryTickers(params: {
    settle: 'usdt';
    contract?: string;
  }): Promise<DeliveryTicker[]> {
    const { settle, ...query } = params;
    return this.get(`/delivery/${settle}/tickers`, query);
  }

  /**
   * Futures insurance balance history
   *
   * @param params Parameters for retrieving the futures insurance balance history
   * @returns Promise<{
   *   t: number;
   *   b: string;
   * }[]>
   */
  getDeliveryInsuranceBalanceHistory(params: {
    settle: 'usdt';
    limit?: number;
  }): Promise<
    {
      t: number;
      b: string;
    }[]
  > {
    const { settle, ...query } = params;
    return this.get(`/delivery/${settle}/insurance`, query);
  }

  /**
   * Query futures account
   *
   * @param params Parameters for querying futures account
   * @returns Promise<GetDeliveryAccountResp>
   */
  getDeliveryAccount(params: { settle: 'usdt' }): Promise<DeliveryAccount> {
    const { settle, ...query } = params;
    return this.getPrivate(`/delivery/${settle}/accounts`, query);
  }

  /**
   * Query account book
   *
   * @param params Parameters for querying account book
   * @returns Promise<GetDeliveryBookResp[]>
   */
  getDeliveryBook(params: GetDeliveryBookReq): Promise<DeliveryBook[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/delivery/${settle}/account_book`, query);
  }

  /**
   * List all positions of a user
   *
   * @param params Parameters for listing all positions of a user
   * @returns Promise<Position[]>
   */
  getDeliveryPositions(params: { settle: 'usdt' }): Promise<FuturesPosition[]> {
    return this.getPrivate(`/delivery/${params.settle}/positions`);
  }

  /**
   * Get single position
   *
   * @param params Parameters for retrieving a single position
   * @returns Promise<Position>
   */
  getDeliveryPosition(params: {
    settle: 'usdt';
    contract: string;
  }): Promise<FuturesPosition> {
    return this.getPrivate(
      `/delivery/${params.settle}/positions/${params.contract}`,
    );
  }

  /**
   * Update position margin
   *
   * @param params Parameters for updating position margin
   * @returns Promise<Position>
   */
  updateDeliveryMargin(params: {
    settle: 'usdt';
    contract: string;
    change: string;
  }): Promise<FuturesPosition> {
    const { settle, contract, ...query } = params;
    return this.postPrivate(
      `/delivery/${settle}/positions/${contract}/margin`,
      { query: query },
    );
  }

  /**
   * Update position leverage
   *
   * @param params Parameters for updating position leverage
   * @returns Promise<Position>
   */
  updateDeliveryLeverage(params: {
    settle: 'usdt';
    contract: string;
    leverage: string;
  }): Promise<FuturesPosition> {
    const { settle, contract, ...query } = params;
    return this.postPrivate(
      `/delivery/${settle}/positions/${contract}/leverage`,
      { query: query },
    );
  }

  /**
   * Update position risk limit
   *
   * @param params Parameters for updating position risk limit
   * @returns Promise<Position>
   */
  updateDeliveryRiskLimit(params: {
    settle: 'usdt';
    contract: string;
    risk_limit: string;
  }): Promise<FuturesPosition> {
    const { settle, contract, ...query } = params;
    return this.postPrivate(
      `/delivery/${settle}/positions/${contract}/risk_limit`,
      { query: query },
    );
  }

  /**
   * Create a futures order
   *
   * Zero-filled order cannot be retrieved 10 minutes after order cancellation
   *
   * @param params Parameters for creating a futures order
   * @returns Promise<FuturesOrder>
   */
  submitDeliveryOrder(
    params: SubmitDeliveryFuturesOrderReq,
  ): Promise<FuturesOrder> {
    const { settle, ...body } = params;
    return this.postPrivate(`/delivery/${settle}/orders`, { body: body });
  }

  /**
   * List futures orders
   *
   * Zero-fill order cannot be retrieved 10 minutes after order cancellation.
   *
   * @param params Parameters for listing futures orders
   * @returns Promise<FuturesOrder[]>
   */
  getDeliveryOrders(params: GetDeliveryOrdersReq): Promise<FuturesOrder[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/delivery/${settle}/orders`, query);
  }

  /**
   * Cancel all open orders matched
   *
   * Zero-filled order cannot be retrieved 10 minutes after order cancellation
   *
   * @param params Parameters for cancelling all open orders matched
   * @returns Promise<FuturesOrder[]>
   */
  cancelAllDeliveryOrders(params: {
    settle: 'usdt';
    contract: string;
    side?: 'ask' | 'bid';
  }): Promise<FuturesOrder[]> {
    const { settle, ...query } = params;
    return this.deletePrivate(`/delivery/${settle}/orders`, {
      query: query,
    });
  }

  /**
   * Get a single order
   *
   * Zero-filled order cannot be retrieved 10 minutes after order cancellation
   *
   * @param params Parameters for retrieving a single order
   * @returns Promise<FuturesOrder>
   */
  getDeliveryOrder(params: {
    settle: 'usdt';
    order_id: string;
  }): Promise<FuturesOrder> {
    return this.getPrivate(
      `/delivery/${params.settle}/orders/${params.order_id}`,
    );
  }

  /**
   * Cancel a single order
   *
   * @param params Parameters for cancelling a single order
   * @returns Promise<FuturesOrder>
   */
  cancelDeliveryOrder(params: {
    settle: 'usdt';
    order_id: string;
  }): Promise<FuturesOrder> {
    return this.deletePrivate(
      `/delivery/${params.settle}/orders/${params.order_id}`,
    );
  }

  /**
   * List personal trading history
   *
   * @param params Parameters for listing personal trading history
   * @returns Promise<GetDeliveryTradingHistoryResp[]>
   */
  getDeliveryTradingHistory(
    params: GetDeliveryTradingHistoryReq,
  ): Promise<DeliveryTradingHistoryRecord[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/delivery/${settle}/my_trades`, query);
  }

  /**
   * List position close history
   *
   * @param params Parameters for listing position close history
   * @returns Promise<GetDeliveryClosedPositionsResp[]>
   */
  getDeliveryClosedPositions(
    params: GetDeliveryClosedPositionsReq,
  ): Promise<DeliveryClosedPosition[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/delivery/${settle}/position_close`, query);
  }

  /**
   * List liquidation history
   *
   * @param params Parameters for listing liquidation history
   * @returns Promise<GetDeliveryLiquidationHistoryResp[]>
   */
  getDeliveryLiquidationHistory(
    params: GetDeliveryLiquidationHistoryReq,
  ): Promise<DeliveryLiquidationHistoryRecord[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/delivery/${settle}/liquidates`, query);
  }

  /**
   * List settlement history
   *
   * @param params Parameters for listing settlement history
   * @returns Promise<GetDeliverySettlementHistoryResp[]>
   */
  getDeliverySettlementHistory(
    params: GetDeliverySettlementHistoryReq,
  ): Promise<DeliverySettlementHistoryRecord[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/delivery/${settle}/settlements`, query);
  }

  /**
   * Create a price-triggered order
   *
   * @param params Parameters for creating a price-triggered order
   * @returns Promise<TriggerOrderResponse>
   */
  submitDeliveryTriggeredOrder(
    params: SubmitFuturesTriggeredOrderReq,
  ): Promise<TriggerOrderResponse> {
    const { settle, ...body } = params;
    return this.postPrivate(`/delivery/${settle}/price_orders`, {
      body: body,
    });
  }

  /**
   * List all auto orders
   *
   * @param params Parameters for listing all auto orders
   * @returns Promise<FuturesPriceTriggeredOrder[]>
   */
  getDeliveryAutoOrders(
    params: GetDeliveryAutoOrdersReq,
  ): Promise<FuturesPriceTriggeredOrder[]> {
    const { settle, ...query } = params;
    return this.getPrivate(`/delivery/${settle}/price_orders`, query);
  }

  /**
   * Cancel all open orders
   *
   * @param params Parameters for cancelling all open orders
   * @returns Promise<FuturesPriceTriggeredOrder[]>
   */
  cancelAllOpenDeliveryOrders(params: {
    settle: 'usdt';
    contract: string;
  }): Promise<FuturesPriceTriggeredOrder[]> {
    const { settle, ...query } = params;
    return this.deletePrivate(`/delivery/${settle}/price_orders`, {
      query: query,
    });
  }

  /**
   * Get a price-triggered order
   *
   * @param params Parameters for retrieving a price-triggered order
   * @returns Promise<FuturesPriceTriggeredOrder>
   */
  getDeliveryTriggeredOrder(params: {
    settle: 'usdt';
    order_id: string;
  }): Promise<FuturesPriceTriggeredOrder> {
    return this.getPrivate(
      `/delivery/${params.settle}/price_orders/${params.order_id}`,
    );
  }

  /**
   * Cancel a price-triggered order
   *
   * @param params Parameters for cancelling a price-triggered order
   * @returns Promise<FuturesPriceTriggeredOrder>
   */
  cancelTriggeredDeliveryOrder(params: {
    settle: 'usdt';
    order_id: string;
  }): Promise<FuturesPriceTriggeredOrder> {
    return this.deletePrivate(
      `/delivery/${params.settle}/price_orders/${params.order_id}`,
    );
  }

  /**==========================================================================================================================
   * OPTIONS
   * ==========================================================================================================================
   */

  /**
   * List all underlyings
   *
   * @returns Promise<{ name: string; index_price: string }[]>
   */
  getOptionsUnderlyings(): Promise<{ name: string; index_price: string }[]> {
    return this.get('/options/underlyings');
  }

  /**
   * List all expiration times
   *
   * @param params Parameters for listing expiration times
   * @returns Promise<number[]>
   */
  getOptionsExpirationTimes(params: { underlying: string }): Promise<number[]> {
    return this.get('/options/expirations', params);
  }

  /**
   * List all the contracts with specified underlying and expiration time
   *
   * @param params Parameters for listing contracts
   * @returns Promise<GetOptionsContractsResp[]>
   */
  getOptionsContracts(params: {
    underlying: string;
    expiration?: number;
  }): Promise<OptionsContract[]> {
    return this.get('/options/contracts', params);
  }

  /**
   * Query specified contract detail
   *
   * @param params Parameters for querying specified contract detail
   * @returns Promise<GetOptionsContractsResp>
   */
  getOptionsContract(params: { contract: string }): Promise<OptionsContract> {
    return this.get(`/options/contracts/${params.contract}`);
  }

  /**
   * List settlement history
   *
   * @param params Parameters for listing settlement history
   * @returns Promise<GetOptionsSettlementHistoryResp[]>
   */
  getOptionsSettlementHistory(
    params: GetOptionsSettlementHistoryReq,
  ): Promise<OptionsSettlementHistoryRecord[]> {
    return this.get('/options/settlements', params);
  }

  /**
   * Get specified contract's settlement
   *
   * @param params Parameters for retrieving specified contract's settlement
   * @returns Promise<GetOptionsSettlementHistoryResp}>
   */
  getOptionsContractSettlement(params: {
    contract: string;
    underlying: string;
    at: number;
  }): Promise<OptionsSettlementHistoryRecord> {
    const { contract, ...query } = params;
    return this.get(`/options/settlements/${contract}`, query);
  }

  /**
   * List my options settlements
   *
   * @param params Parameters for listing my options settlements
   * @returns Promise<GetOptionsMySettlementsResp[]>
   */
  getOptionsMySettlements(
    params: GetOptionsMySettlementsReq,
  ): Promise<OptionsUserSettlement[]> {
    return this.getPrivate('/options/my_settlements', params);
  }

  /**
   * Options order book
   *
   * Bids will be sorted by price from high to low, while asks sorted reversely
   *
   * @param params Parameters for retrieving options order book
   * @returns Promise<GetOptionsOrderBookResp>
   */
  getOptionsOrderBook(
    params: GetOptionsOrderBookReq,
  ): Promise<OptionsOrderBook> {
    return this.get('/options/order_book', params);
  }

  /**
   * List tickers of options contracts
   *
   * @param params Parameters for listing tickers of options contracts
   * @returns Promise<GetOptionsTickersResp[]>
   */
  getOptionsTickers(params: { underlying: string }): Promise<OptionsTicker[]> {
    return this.get('/options/tickers', params);
  }

  /**
   * Get underlying ticker
   *
   * @param params Parameters for retrieving underlying ticker
   * @returns Promise<{
   *   trade_put: number;
   *   trade_call: number;
   *   index_price: string;
   * }>
   */
  getOptionsUnderlyingTicker(params: { underlying: string }): Promise<{
    trade_put: number;
    trade_call: number;
    index_price: string;
  }> {
    return this.get(`/options/underlying/tickers/${params.underlying}`);
  }

  /**
   * Get options Candles
   *
   * @param params Parameters for retrieving options Candles
   * @returns Promise<GetOptionsCandlesResp[]>
   */
  getOptionsCandles(params: GetOptionsCandlesReq): Promise<OptionsCandle[]> {
    return this.get('/options/candlesticks', params);
  }

  /**
   * Mark price Candles of an underlying
   *
   * @param params Parameters for retrieving mark price Candles of an underlying
   * @returns Promise<GetOptionsUnderlyingCandlesResp[]>
   */
  getOptionsUnderlyingCandles(
    params: GetOptionsUnderlyingCandlesReq,
  ): Promise<OptionsUnderlyingCandle[]> {
    return this.get('/options/underlying/candlesticks', params);
  }

  /**
   * Options trade history
   *
   * @param params Parameters for retrieving options trade history
   * @returns Promise<GetOptionsTradesResp[]>
   */
  getOptionsTrades(params: GetOptionsTradesReq): Promise<OptionsTrade[]> {
    return this.get('/options/trades', params);
  }

  /**
   * List options account
   *
   * Indicates support for querying both classic options accounts and unified accounts
   *
   * @returns Promise<GetOptionsAccountResp>
   */
  getOptionsAccount(): Promise<OptionsAccount> {
    return this.getPrivate('/options/accounts');
  }

  /**
   * List account changing history
   *
   * @param params Parameters for listing account changing history
   * @returns Promise<GetOptionsAccountChangeResp[]>
   */
  getOptionsAccountChange(
    params?: GetOptionsAccountChangeReq,
  ): Promise<OptionsAccountChangeRecord[]> {
    return this.getPrivate('/options/account_book', params);
  }

  /**
   * List user's positions of specified underlying
   *
   * @param params Parameters for listing user's positions of specified underlying
   * @returns Promise<GetOptionsPositionsUnderlyingResp[]>
   */
  getOptionsPositionsUnderlying(params: {
    underlying?: string;
  }): Promise<OptionsPositionsUnderlying[]> {
    return this.getPrivate('/options/positions', params);
  }

  /**
   * Get specified contract position
   *
   * @param params Parameters for retrieving specified contract position
   * @returns Promise<GetOptionsPositionsUnderlyingResp>
   */
  getOptionsPositionContract(params: {
    contract: string;
  }): Promise<OptionsPositionsUnderlying> {
    return this.getPrivate(`/options/positions/${params.contract}`);
  }

  /**
   * List user's liquidation history of specified underlying
   *
   * @param params Parameters for listing user's liquidation history of specified underlying
   * @returns Promise<GetOptionsLiquidationResp[]>
   */
  getOptionsLiquidation(params: {
    underlying: string;
    contract?: string;
  }): Promise<GetOptionsLiquidationResp[]> {
    return this.getPrivate('/options/position_close', params);
  }

  /**
   * Create an options order
   *
   * @param params Parameters for creating an options order
   * @returns Promise<SubmitOptionsOrderResp>
   */
  submitOptionsOrder(
    params: SubmitOptionsOrderReq,
  ): Promise<SubmitOptionsOrderResp> {
    return this.postPrivate('/options/orders', { body: params });
  }

  /**
   * List options orders
   *
   * @param params Parameters for listing options orders
   * @returns Promise<SubmitOptionsOrderResp[]>
   */
  getOptionsOrders(
    params: GetOptionsOrdersReq,
  ): Promise<SubmitOptionsOrderResp[]> {
    return this.getPrivate('/options/orders', params);
  }

  /**
   * Cancel all open orders matched
   *
   * @param params Parameters for canceling all open orders matched
   * @returns Promise<SubmitOptionsOrderResp[]>
   */
  cancelAllOpenOptionsOrders(params: {
    contract?: string;
    underlying?: string;
    side?: 'ask' | 'bid';
  }): Promise<SubmitOptionsOrderResp[]> {
    return this.deletePrivate('/options/orders', { query: params });
  }

  /**
   * Get a single order
   *
   * @param params Parameters for retrieving a single order
   * @returns Promise<SubmitOptionsOrderResp>
   */
  getOptionsOrder(params: {
    order_id: number;
  }): Promise<SubmitOptionsOrderResp> {
    return this.getPrivate(`/options/orders/${params.order_id}`);
  }

  /**
   * Amend an options order (modify price and/or size). Only orders with status `open` are supported.
   *
   * @param params order_id and amendment body (`contract` is required)
   * @returns Promise<SubmitOptionsOrderResp>
   */
  amendOptionsOrder(
    params: {
      order_id: number;
    } & AmendOptionsOrderReq,
  ): Promise<SubmitOptionsOrderResp> {
    const { order_id, ...body } = params;
    return this.putPrivate(`/options/orders/${order_id}`, { body });
  }

  /**
   * Cancel a single order
   *
   * @param params Parameters for canceling a single order
   * @returns Promise<SubmitOptionsOrderResp>
   */
  cancelOptionsOrder(params: {
    order_id: number;
  }): Promise<SubmitOptionsOrderResp> {
    return this.deletePrivate(`/options/orders/${params.order_id}`);
  }

  /**
   * Countdown cancel orders for options
   *
   * Option order heartbeat detection. When the timeout set by the user is reached,
   * if there is no cancel or new countdown set, related pending orders will be
   * automatically cancelled. This endpoint can be called repeatedly to set a new
   * countdown or cancel the countdown.
   *
   * @param params Parameters for setting countdown cancel orders
   * @returns Promise<{
   *   triggerTime: number;
   * }>
   */
  submitOptionsCountdownCancel(params: {
    timeout: number;
    contract?: string;
    underlying?: string;
  }): Promise<{
    triggerTime: number;
  }> {
    return this.postPrivate('/options/countdown_cancel_all', { body: params });
  }

  /**
   * List personal trading history
   *
   * @param params Parameters for listing personal trading history
   * @returns Promise<GetOptionsPersonalHistoryResp[]>
   */
  getOptionsPersonalHistory(
    params: GetOptionsPersonalHistoryReq,
  ): Promise<OptionsUserHistoryRecord[]> {
    return this.getPrivate('/options/my_trades', params);
  }

  /**
   * Set MMP (Market Maker Protection) settings
   *
   * @param params Parameters for setting MMP settings
   * @returns Promise<OptionsMMPSetings>
   */
  setOptionsMMPSettings(
    params: OptionsMMPSettingsReq,
  ): Promise<OptionsMMPSettings> {
    return this.postPrivate('/options/mmp', { body: params });
  }

  /**
   * Query MMP (Market Maker Protection) settings
   *
   * @param params Parameters for querying MMP settings
   * @returns Promise<OptionsMMPSetings[]>
   */
  getOptionsMMPSettings(params?: {
    underlying?: string;
  }): Promise<OptionsMMPSettings[]> {
    return this.getPrivate('/options/mmp', params);
  }

  /**
   * Reset MMP (Market Maker Protection) settings
   *
   * @param params Parameters for resetting MMP settings
   * @returns Promise<OptionsMMPSettings>
   */
  resetOptionsMMPSettings(params: {
    underlying: string;
  }): Promise<OptionsMMPSettings> {
    return this.postPrivate('/options/mmp/reset', { body: params });
  }

  /**==========================================================================================================================
   * EARN UNI
   * ==========================================================================================================================
   */

  /**
   * List currencies for lending
   *
   * @returns Promise<GetLendingCurrenciesResp[]>
   */
  getLendingCurrencies(): Promise<LendingCurrency[]> {
    return this.get('/earn/uni/currencies');
  }

  /**
   * Get currency detail for lending
   *
   * @param params Parameters for retrieving currency detail for lending
   * @returns Promise<GetLendingCurrenciesResp>
   */
  getLendingCurrency(params: { currency: string }): Promise<LendingCurrency> {
    return this.get(`/earn/uni/currencies/${params.currency}`);
  }

  /**
   * Lend or redeem
   *
   * @param params Parameters for lending or redeeming
   * @returns Promise<any>
   */
  submitLendOrRedeemOrder(params: SubmitLendOrRedeemReq): Promise<any> {
    return this.postPrivate('/earn/uni/lends', { body: params });
  }

  /**
   * List user's lending orders
   *
   * @param params Parameters for listing user's lending orders
   * @returns Promise<GetLendingOrdersResp[]>
   */
  getLendingOrders(params?: GetLendingOrdersReq): Promise<LendingOrder[]> {
    return this.getPrivate('/earn/uni/lends', params);
  }

  /**
   * Amend lending order
   *
   * Currently only supports amending the minimum interest rate (hour)
   *
   * @param params Parameters for amending lending order
   * @returns Promise<any>
   */
  updateLendingOrder(params: {
    currency?: string;
    min_rate?: string;
  }): Promise<any> {
    return this.patchPrivate('/earn/uni/lends', { query: params });
  }

  /**
   * List records of lending
   *
   * @param params Parameters for listing records of lending
   * @returns Promise<GetLendingRecordsResp[]>
   */
  getLendingRecords(params?: GetLendingRecordsReq): Promise<LendingRecord[]> {
    return this.getPrivate('/earn/uni/lend_records', params);
  }

  /**
   * Get the user's total interest income of specified currency
   *
   * @param params Parameters for retrieving the user's total interest income of specified currency
   * @returns Promise<{
   *   currency: string;
   *   interest: string;
   * }>
   */
  getLendingTotalInterest(params: { currency: string }): Promise<{
    currency: string;
    interest: string;
  }> {
    return this.getPrivate(`/earn/uni/interests/${params.currency}`);
  }

  /**
   * List interest records
   *
   * @param params Parameters for listing interest records
   * @returns Promise<GetLendingInterestRecordsResp[]>
   */
  getLendingInterestRecords(
    params?: GetLendingInterestRecordsReq,
  ): Promise<LendingInterestRecord[]> {
    return this.getPrivate('/earn/uni/interest_records', params);
  }

  /**
   * Set interest reinvestment toggle
   * @deprecated as of v4.99.0, 23-06-2025
   *
   * @param params Parameters for setting interest reinvestment toggle
   * @returns Promise<any>
   */
  updateInterestReinvestment(params: {
    currency: string;
    status: boolean;
  }): Promise<any> {
    return this.putPrivate('/earn/uni/interest_reinvest', { body: params });
  }

  /**
   * Query currency interest compounding status
   *
   * @param params Parameters for querying currency interest compounding status
   * @returns Promise<{
   *   currency: string;
   *   interest_status: string;
   * }>
   */
  getLendingInterestStatus(params: { currency: string }): Promise<{
    currency: string;
    interest_status: string;
  }> {
    return this.getPrivate(`/earn/uni/interest_status/${params.currency}`);
  }

  /**
   * UniLoan currency annualized trend chart
   *
   * Get the annualized interest rate trend chart data for a specific currency
   *
   * @param params Parameters for retrieving the annualized trend chart
   * @returns Promise<{ time: number; value: string }[]>
   */
  getLendingAnnualizedTrendChart(params: {
    from: number;
    to: number;
    asset: string;
  }): Promise<{ time: number; value: string }[]> {
    return this.getPrivate('/earn/uni/chart', params);
  }

  getLendingEstimatedRates(): Promise<
    { currency: string; est_rate: string }[]
  > {
    return this.getPrivate('/earn/uni/rate');
  }

  /**==========================================================================================================================
   * MULTI COLLATERAL LOAN
   * ==========================================================================================================================
   */

  /**
   * Create Multi-Collateral Order
   *
   * @param params Parameters for creating a multi-collateral order
   * @returns Promise<{ order_id: number }>
   */
  submitMultiLoanOrder(
    params: SubmitMultiLoanOrderReq,
  ): Promise<{ order_id: number }> {
    return this.postPrivate('/loan/multi_collateral/orders', { body: params });
  }

  /**
   * List Multi-Collateral Orders
   *
   * @param params Parameters for listing multi-collateral orders
   * @returns Promise<GetMultiLoanOrdersResp[]>
   */
  getMultiLoanOrders(
    params?: GetMultiLoanOrdersReq,
  ): Promise<MultiLoanOrder[]> {
    return this.getPrivate('/loan/multi_collateral/orders', params);
  }

  /**
   * Get Multi-Collateral Order Detail
   *
   * @param params Parameters for retrieving a multi-collateral order detail
   * @returns Promise<GetMultiLoanOrdersResp>
   */
  getMultiLoanOrder(params: { order_id: string }): Promise<MultiLoanOrder> {
    return this.getPrivate(`/loan/multi_collateral/orders/${params.order_id}`);
  }

  /**
   * Repay Multi-Collateral Loan
   *
   * @param params Parameters for repaying a multi-collateral loan
   * @returns Promise<RepayMultiLoanResp>
   */
  repayMultiLoan(params: RepayMultiLoanReq): Promise<RepayMultiLoanResp> {
    return this.postPrivate('/loan/multi_collateral/repay', { body: params });
  }

  /**
   * List Multi-Collateral Repay Records
   *
   * @param params Parameters for listing multi-collateral repay records
   * @returns Promise<GetMultiLoanRepayRecordsResp[]>
   */
  getMultiLoanRepayRecords(
    params: GetMultiLoanRepayRecordsReq,
  ): Promise<MultiLoanRepayRecord[]> {
    return this.getPrivate('/loan/multi_collateral/repay', params);
  }

  /**
   * Operate Multi-Collateral
   *
   * @param params Parameters for operating multi-collateral
   * @returns Promise<UpdateMultiLoanResp>
   */
  updateMultiLoan(params: UpdateMultiLoanReq): Promise<UpdateMultiLoanResp> {
    return this.postPrivate('/loan/multi_collateral/mortgage', {
      body: params,
    });
  }

  /**
   * Query collateral adjustment records
   *
   * @param params Parameters for querying collateral adjustment records
   * @returns Promise<GetMultiLoanAdjustmentRecordsResp[]>
   */
  getMultiLoanAdjustmentRecords(
    params?: GetMultiLoanAdjustmentRecordsReq,
  ): Promise<MultiLoanAdjustmentRecord[]> {
    return this.getPrivate('/loan/multi_collateral/mortgage', params);
  }

  /**
   * List User Currency Quota
   *
   * @param params Parameters for listing user currency quota
   * @returns Promise<GetMultiLoanCurrencyQuotaResp[]>
   */
  getMultiLoanCurrencyQuota(params: {
    type: 'collateral' | 'borrow';
    currency: string;
  }): Promise<MultiLoanCurrencyQuota[]> {
    return this.getPrivate('/loan/multi_collateral/currency_quota', params);
  }

  /**
   * Query supported borrowing and collateral currencies in Multi-Collateral
   *
   * @returns Promise<GetMultiLoanSupportedCurrenciesResp>
   */
  getMultiLoanSupportedCurrencies(): Promise<MultiLoanSupportedCurrencies> {
    return this.get('/loan/multi_collateral/currencies');
  }

  /**
   * Get Multi-Collateral ratio
   *
   * @returns Promise<GetMultiLoanRatioResp>
   */
  getMultiLoanRatio(): Promise<MultiLoanRatio> {
    return this.get('/loan/multi_collateral/ltv');
  }

  /**
   * Query fixed interest rates for the currency for 7 days and 30 days
   *
   * @returns Promise<GetMultiLoanFixedRatesResp[]>
   */
  getMultiLoanFixedRates(): Promise<MultiLoanFixedRate[]> {
    return this.get('/loan/multi_collateral/fixed_rate');
  }

  /**
   * Query the current interest rate of currencies
   *
   * Query the current interest rate of currencies in the last hour.
   * The current interest rate is updated every hour.
   *
   * @param params Parameters containing currencies to query and optional VIP level
   * @returns Promise<MultiLoanCurrentRate[]>
   */
  getMultiLoanCurrentRates(params: {
    currencies: string[];
    vip_level?: string;
  }): Promise<
    {
      currency: string;
      current_rate: string;
    }[]
  > {
    return this.get('/loan/multi_collateral/current_rate', params);
  }

  /**==========================================================================================================================
   * EARN
   * ==========================================================================================================================
   */

  /**
   * Dual Investment product list
   *
   * @returns Promise<GetDualInvestmentProductsResp[]>
   */
  getDualInvestmentProducts(
    params?: GetDualInvestmentPlansReq,
  ): Promise<DualInvestmentProduct[]> {
    return this.get('/earn/dual/investment_plan', params);
  }

  /**
   * Dual Investment order list
   *
   * @returns Promise<GetDualInvestmentOrdersResp[]>
   */
  getDualInvestmentOrders(
    params?: GetDualInvestmentOrdersReq,
  ): Promise<DualInvestmentOrder[]> {
    return this.getPrivate('/earn/dual/orders', params);
  }

  /**
   * Place Dual Investment order
   *
   * @param params plan_id, amount (or copies), optional text
   * @returns Promise<DualInvestmentOrder>
   */
  submitDualInvestmentOrder(
    params: PlaceDualInvestmentOrderParams,
  ): Promise<DualInvestmentOrder> {
    return this.postPrivate('/earn/dual/orders', { body: params });
  }

  /**
   * Dual-currency early redemption preview
   */
  getDualOrderRefundPreview(
    params: GetDualOrderRefundPreviewReq,
  ): Promise<DualOrderRefundPreview> {
    return this.getPrivate('/earn/dual/order-refund-preview', params);
  }

  /**
   * Dual-currency order early redemption
   */
  submitDualOrderRefund(
    params: SubmitDualOrderRefundParams,
  ): Promise<DualInvestmentOrder> {
    return this.postPrivate('/earn/dual/order-refund', { body: params });
  }

  /**
   * Update dual-currency order reinvest settings
   */
  updateDualOrderReinvest(
    params: UpdateDualOrderReinvestParams,
  ): Promise<unknown> {
    return this.postPrivate('/earn/dual/modify-order-reinvest', {
      body: params,
    });
  }

  /**
   * Dual-currency recommended projects
   */
  getDualProjectRecommend(
    params?: GetDualProjectRecommendReq,
  ): Promise<DualProjectRecommend[]> {
    return this.getPrivate('/earn/dual/project-recommend', params);
  }

  /**
   * List fixed-term earn products (public).
   */
  getEarnFixedTermProducts(
    params: GetEarnFixedTermProductsReq,
  ): Promise<GetEarnFixedTermProductsResponse> {
    return this.get('/earn/fixed-term/product', params);
  }

  /**
   * List fixed-term earn products for one asset (public).
   */
  getEarnFixedTermProductsByAsset(
    asset: string,
    params?: GetEarnFixedTermProductsByAssetReq,
  ): Promise<GetEarnFixedTermProductsByAssetResponse> {
    return this.get(`/earn/fixed-term/product/${asset}/list`, params);
  }

  /**
   * Subscribe to a fixed-term earn product.
   */
  createEarnFixedTermLend(
    params: CreateEarnFixedTermLendReq,
  ): Promise<CreateEarnFixedTermLendResponse> {
    return this.postPrivate('/earn/fixed-term/user/lend', { body: params });
  }

  /**
   * List fixed-term earn subscriptions.
   */
  getEarnFixedTermLends(
    params: GetEarnFixedTermLendsReq,
  ): Promise<GetEarnFixedTermLendsResponse> {
    return this.getPrivate('/earn/fixed-term/user/lend', params);
  }

  /**
   * Early redeem a fixed-term earn order.
   */
  createEarnFixedTermPreRedeem(
    params: EarnFixedTermPreRedeemReq,
  ): Promise<CreateEarnFixedTermPreRedeemResponse> {
    return this.postPrivate('/earn/fixed-term/user/pre-redeem', {
      body: params,
    });
  }

  /**
   * Fixed-term earn subscription history.
   */
  getEarnFixedTermHistory(
    params: GetEarnFixedTermHistoryReq,
  ): Promise<GetEarnFixedTermHistoryResponse> {
    return this.getPrivate('/earn/fixed-term/user/history', params);
  }

  /**
   * Create auto invest plan
   */
  createAutoInvestPlan(
    params: CreateAutoInvestPlanReq,
  ): Promise<CreateAutoInvestPlanResp> {
    return this.postPrivate('/earn/autoinvest/plans/create', { body: params });
  }

  /**
   * Update auto invest plan
   */
  updateAutoInvestPlan(params: UpdateAutoInvestPlanReq): Promise<unknown> {
    return this.postPrivate('/earn/autoinvest/plans/update', { body: params });
  }

  /**
   * Stop auto invest plan
   */
  stopAutoInvestPlan(params: StopAutoInvestPlanReq): Promise<unknown> {
    return this.postPrivate('/earn/autoinvest/plans/stop', { body: params });
  }

  /**
   * Add position immediately (auto invest)
   */
  addAutoInvestPlanPosition(
    params: AddAutoInvestPlanPositionReq,
  ): Promise<unknown> {
    return this.postPrivate('/earn/autoinvest/plans/add_position', {
      body: params,
    });
  }

  /**
   * List currencies supporting auto invest
   */
  getAutoInvestCoins(
    params?: GetAutoInvestCoinsReq,
  ): Promise<AutoInvestCoinItem[]> {
    return this.getPrivate('/earn/autoinvest/coins', params);
  }

  /**
   * Get minimum investment amount for a portfolio
   */
  getAutoInvestMinAmount(
    params: GetAutoInvestMinAmountReq,
  ): Promise<AutoInvestMinAmountResp> {
    return this.postPrivate('/earn/autoinvest/min_invest_amount', {
      body: params,
    });
  }

  /**
   * List plan execution records
   */
  getAutoInvestPlanRecords(
    params: GetAutoInvestPlanRecordsReq,
  ): Promise<AutoInvestPlanExecutionRecordsPaginated> {
    return this.getPrivate('/earn/autoinvest/plans/records', params);
  }

  /**
   * List plan execution order details
   */
  getAutoInvestOrders(
    params: GetAutoInvestOrdersReq,
  ): Promise<AutoInvestOrderItem[]> {
    return this.getPrivate('/earn/autoinvest/orders', params);
  }

  /**
   * List investment currency configuration
   */
  getAutoInvestConfig(): Promise<AutoInvestConfigItem[]> {
    return this.getPrivate('/earn/autoinvest/config');
  }

  /**
   * Get auto invest plan details
   */
  getAutoInvestPlanDetail(
    params: GetAutoInvestPlanDetailReq,
  ): Promise<AutoInvestPlanDetail> {
    return this.getPrivate('/earn/autoinvest/plans/detail', params);
  }

  /**
   * List auto invest plans
   */
  getAutoInvestPlans(
    params: GetAutoInvestPlansReq,
  ): Promise<AutoInvestPlansListResp> {
    return this.getPrivate('/earn/autoinvest/plans/list_info', params);
  }

  /**
   * List staking coins
   *
   * @param params Parameters for listing staking coins
   * @returns Promise<string[]>
   */
  getStakingCoins(params?: {
    coin?: string;
    cointype?: string;
  }): Promise<string[]> {
    return this.getPrivate('/earn/staking/coins', params);
  }

  /**
   * On-chain Token Swap for Earned Coins
   *
   * @param params Parameters for staking swap
   * @returns Promise<any>
   */
  submitStakingSwap(params: {
    coin: string;
    side: '0' | '1'; // 0 - Stake, 1 - Redeem
    amount: string;
    pid?: number;
  }): Promise<any> {
    return this.postPrivate('/earn/staking/swap', { body: params });
  }

  /**==========================================================================================================================
   * ACCOUNT
   * ==========================================================================================================================
   */

  /**
   * Get account detail
   *
   * @returns Promise<GetAccountDetailResp>
   */
  getAccountDetail(): Promise<AccountDetail> {
    return this.getPrivate('/account/detail');
  }

  /**
   * Get user transaction rate limit information
   *
   * @returns Promise<AccountRateLimit[]>
   */
  getAccountRateLimit(): Promise<AccountRateLimit[]> {
    return this.getPrivate('/account/rate_limit');
  }

  /**
   * Create STP Group
   *
   * @param params Parameters for creating an STP group
   * @returns Promise<CreateStpGroupResp>
   */
  createStpGroup(params: CreateStpGroupReq): Promise<StpGroup> {
    return this.postPrivate('/account/stp_groups', { body: params });
  }

  /**
   * List STP Groups
   *
   * @param params Parameters for listing STP groups
   * @returns Promise<CreateStpGroupResp[]>
   */
  getStpGroups(params?: { name?: string }): Promise<StpGroup[]> {
    return this.getPrivate('/account/stp_groups', params);
  }

  /**
   * List users of the STP group
   *
   * @param params Parameters for listing users of the STP group
   * @returns Promise<StpResp[]>
   */
  getStpGroupUsers(params: { stp_id: number }): Promise<StpGroupUser[]> {
    return this.getPrivate(`/account/stp_groups/${params.stp_id}/users`);
  }

  /**
   * Add users to the STP group
   *
   * @param params Parameters for adding users to the STP group
   * @returns Promise<StpResp[]>
   */
  addUsersToStpGroup(params: {
    stp_id: number;
    body: number[];
  }): Promise<StpGroupUser[]> {
    const { stp_id, ...body } = params;
    return this.postPrivate(`/account/stp_groups/${stp_id}/users`, {
      body: body,
    });
  }

  /**
   * Delete the user in the STP group
   *
   * @param params Parameters for deleting users from the STP group
   * @returns Promise<StpResp[]>
   */
  deleteUserFromStpGroup(params: {
    stp_id: number;
    user_id: number;
  }): Promise<StpGroupUser[]> {
    const { stp_id, ...query } = params;
    return this.deletePrivate(`/account/stp_groups/${stp_id}/users`, {
      query: query,
    });
  }

  /**
   * Set GT deduction
   *
   * Enable or disable GT deduction for the current account.
   *
   * @param params Parameters for setting GT deduction
   * @returns Promise<void>
   */
  setGTDeduction(params: { enabled: boolean }): Promise<void> {
    return this.postPrivate('/account/debit_fee', { body: params });
  }

  /**
   * Query GT deduction configuration
   *
   * Query the current GT deduction configuration for the account.
   *
   * @returns Promise<{ enabled: boolean }>
   */
  getGTDeduction(): Promise<{ enabled: boolean }> {
    return this.getPrivate('/account/debit_fee');
  }

  /**
   * Query all main account API key information
   *
   * @returns Promise<AccountMainKey[]>
   */
  getAccountMainKeys(): Promise<AccountMainKey[]> {
    return this.getPrivate('/account/main_keys');
  }

  /**==========================================================================================================================
   * REBATES
   * ==========================================================================================================================
   */

  /**
   * The agency obtains the transaction history of the recommended user.
   * Record time range cannot exceed 30 days.
   *
   * @param params Parameters for retrieving transaction history
   * @returns Promise<GetAgencyTransactionHistoryResp>
   */
  getAgencyTransactionHistory(
    params: GetAgencyTransactionHistoryReq,
  ): Promise<{ total: number; list: AgencyTransactionHistoryRecord[] }> {
    return this.getPrivate('/rebate/agency/transaction_history', params);
  }

  /**
   * The agency obtains the commission history of the recommended user.
   * Record time range cannot exceed 30 days.
   *
   * @param params Parameters for retrieving commission history
   * @returns Promise<GetAgencyCommissionHistoryResp>
   */
  getAgencyCommissionHistory(
    params: GetAgencyCommissionHistoryReq,
  ): Promise<{ total: number; list: AgencyCommissionHistoryRecord[] }> {
    return this.getPrivate('/rebate/agency/commission_history', params);
  }

  /**
   * Partner obtains transaction records of recommended users
   *
   * Record time range cannot exceed 30 days.
   *
   * @param params Parameters for retrieving transaction records
   * @returns Promise<GetPartnerTransactionHistoryResp>
   */
  getPartnerTransactionHistory(params?: PartnerTransactionReq): Promise<{
    total: number;
    list: PartnerTransaction[];
  }> {
    return this.getPrivate('/rebate/partner/transaction_history', params);
  }

  /**
   * Partner obtains commission records of recommended users
   *
   * Record time range cannot exceed 30 days.
   *
   * @param params Parameters for retrieving commission records
   * @returns Promise<GetPartnerCommissionHistoryResp>
   */
  getPartnerCommissionHistory(params?: PartnerTransactionReq): Promise<{
    total: number;
    list: PartnerCommission[];
  }> {
    return this.getPrivate('/rebate/partner/commission_history', params);
  }

  /**
   * Partner subordinate list
   *
   * Including sub-agents, direct customers, indirect customers
   *
   * @param params Parameters for retrieving partner subordinate list
   * @returns Promise<{
   *   total: number;
   *   list: {
   *     user_id: number;
   *     user_join_time: number;
   *     type: number;
   *     desc: string;
   *   }[];
   * }>
   */
  getPartnerSubordinateList(params?: GetPartnerSubordinateListReq): Promise<{
    total: number;
    list: PartnerSubordinate[];
  }> {
    return this.getPrivate('/rebate/partner/sub_list', params);
  }

  /**
   * Aggregated partner agent statistics (rebate amount, volume, net fee, customer count; optional trading user count by business type).
   */
  getPartnerAgentDataAggregated(
    params?: GetPartnerAgentDataAggregatedReq,
  ): Promise<PartnerDataAggregatedResponse> {
    return this.getPrivate('/rebate/partner/data/aggregated', params);
  }

  /**
   * The broker obtains the user's commission rebate records.
   * Record time range cannot exceed 30 days.
   *
   * @param params Parameters for retrieving commission rebate records
   * @returns Promise<GetBrokerCommissionHistoryResp>
   */
  getBrokerCommissionHistory(
    params: GetBrokerCommissionHistoryReq,
  ): Promise<{ total: number; list: BrokerCommissionHistoryRecord[] }> {
    return this.getPrivate('/rebate/broker/commission_history', params);
  }

  /**
   * The broker obtains the user's trading history.
   * Record time range cannot exceed 30 days.
   *
   * @param params Parameters for retrieving trading history
   * @returns Promise<GetBrokerTransactionHistoryResp>
   */
  getBrokerTransactionHistory(
    params: GetBrokerTransactionHistoryReq,
  ): Promise<{ total: number; list: BrokerTransactionHistoryRecord[] }> {
    return this.getPrivate('/rebate/broker/transaction_history', params);
  }

  /**
   * User retrieves rebate information.
   */
  getUserRebateInfo(): Promise<{ invite_uid: number }> {
    return this.getPrivate('/rebate/user/info');
  }

  /**
   * Query user-subordinate relationship
   *
   * Checks whether specified users are in the system and their relationship status
   */
  getUserSubordinateRelationships(params: {
    user_id_list: string; // Comma-separated list of user IDs (max 100)
  }): Promise<{
    list: {
      uid: number;
      belong: string;
      type: number;
      ref_uid: number;
    }[];
  }> {
    return this.getPrivate('/rebate/user/sub_relation', params);
  }

  /**==========================================================================================================================
   * OTC
   * ==========================================================================================================================
   */

  /**
   * Fiat and stablecoin quote
   *
   * Create fiat and stablecoin quotes, supporting both PAY and GET directions
   *
   * @param params Quote parameters
   * @returns Promise with quote details including rate, amounts, and quote_token
   */
  createOTCQuote(params: CreateOTCQuoteReq): Promise<CreateOTCQuoteResp> {
    return this.postPrivate('/otc/quote', { body: params });
  }

  /**
   * Create fiat order
   *
   * Create a fiat order, supporting BUY for on-ramp and SELL for off-ramp
   *
   * @param params Fiat order parameters
   * @returns Promise with order creation confirmation
   */
  createOTCFiatOrder(
    params: CreateOTCFiatOrderReq,
  ): Promise<CreateOTCFiatOrderResp> {
    return this.postPrivate('/otc/order/create', { body: params });
  }

  /**
   * Create stablecoin order
   *
   * Create stablecoin order
   *
   * @param params Stablecoin order parameters
   * @returns Promise with order creation confirmation
   */
  createOTCStablecoinOrder(
    params: CreateOTCStablecoinOrderReq,
  ): Promise<CreateOTCStablecoinOrderResp> {
    return this.postPrivate('/otc/stable_coin/order/create', { body: params });
  }

  /**
   * Get user bank card list (use is_default=1 for default card)
   */
  getOTCBankList(): Promise<GetOTCBankListResp> {
    return this.getPrivate('/otc/bank/list');
  }

  /**
   * Get user bank card list (Inner-aligned alias of getOTCBankList)
   */
  getOTCBankListLegacy(): Promise<GetOTCBankListResp> {
    return this.getPrivate('/otc/bank_list');
  }

  /**
   * Create / bind a bank card (multipart/form-data)
   */
  createOTCBank(params: CreateOTCBankReq): Promise<CreateOTCBankResp> {
    const { documentation_file, ...fields } = params;
    const form = new FormData();
    appendGateMultipartFields(form, fields);
    appendGateMultipartFile(form, 'documentation_file', documentation_file);
    return this.postPrivateMultipart('/otc/bank/create', form);
  }

  /**
   * Delete a bank card
   */
  deleteOTCBank(params: OTCBankIdReq): Promise<OTCActionResp> {
    return this.postPrivate('/otc/bank/delete', { body: params });
  }

  /**
   * Set default bank card
   */
  setDefaultOTCBank(params: OTCBankIdReq): Promise<OTCActionResp> {
    return this.postPrivate('/otc/bank/set_default', { body: params });
  }

  /**
   * Bank card supplement checklist
   */
  getOTCBankSupplementChecklist(
    params: GetOTCBankSupplementChecklistReq,
  ): Promise<GetOTCBankSupplementChecklistResp> {
    return this.getPrivate('/otc/bank/bank_supplement_checklist', params);
  }

  /**
   * Submit personal bank card supplement materials (multipart/form-data)
   */
  submitOTCBankPersonalSupplement(
    params: SubmitOTCBankPersonalSupplementReq,
  ): Promise<OTCActionResp> {
    const { bank_id, id_document_front, id_document_back, address_proof } =
      params;
    const form = new FormData();
    form.append('bank_id', bank_id);
    appendGateMultipartFile(form, 'id_document_front', id_document_front);
    appendGateMultipartFile(form, 'id_document_back', id_document_back);
    appendGateMultipartFile(form, 'address_proof', address_proof);
    return this.postPrivateMultipart(
      '/otc/bank/personal/bank_supplement',
      form,
    );
  }

  /**
   * Submit enterprise bank card supplement materials (multipart/form-data)
   */
  submitOTCBankEnterpriseSupplement(
    params: SubmitOTCBankEnterpriseSupplementReq,
  ): Promise<OTCActionResp> {
    const form = new FormData();
    if (params.uid !== undefined) {
      form.append('uid', params.uid);
    }
    form.append('bank_id', params.bank_id);
    appendGateMultipartFile(form, 'certificate', params.certificate);
    appendGateMultipartFile(form, 'share_holders', params.share_holders);
    appendGateMultipartFile(form, 'passport', params.passport);
    appendGateMultipartFile(
      form,
      'share_holding_structure',
      params.share_holding_structure,
    );
    if (params.funds_statement) {
      appendGateMultipartFile(form, 'funds_statement', params.funds_statement);
    }
    if (params.additional) {
      appendGateMultipartFile(form, 'additional', params.additional);
    }
    return this.postPrivateMultipart(
      '/otc/bank/enterprise/bank_supplement',
      form,
    );
  }

  /**
   * Mark fiat order as paid
   *
   * Mark fiat order as paid
   *
   * @param params Parameters with order_id
   * @returns Promise with confirmation
   */
  markOTCOrderAsPaid(
    params: MarkOTCOrderAsPaidReq,
  ): Promise<MarkOTCOrderAsPaidResp> {
    return this.postPrivate('/otc/order/paid', { body: params });
  }

  /**
   * Fiat order cancellation
   *
   * Cancel fiat order
   *
   * @param params Parameters with order_id
   * @returns Promise with cancellation confirmation
   */
  cancelOTCOrder(params: CancelOTCOrderReq): Promise<CancelOTCOrderResp> {
    return this.postPrivate('/otc/order/cancel', { query: params });
  }

  /**
   * Fiat order list
   *
   * Query the fiat order list with filters such as type, currency, time range, and status
   *
   * @param params Filter parameters for fiat order list
   * @returns Promise with paginated fiat order list
   */
  getOTCFiatOrderList(
    params?: GetOTCFiatOrderListReq,
  ): Promise<GetOTCFiatOrderListResp> {
    return this.getPrivate('/otc/order/list', params);
  }

  /**
   * Stablecoin order list
   *
   * Query stablecoin order list with filtering by currency, time range, status, etc.
   *
   * @param params Filter parameters for stablecoin order list
   * @returns Promise with paginated stablecoin order list
   */
  getOTCStablecoinOrderList(
    params?: GetOTCStablecoinOrderListReq,
  ): Promise<GetOTCStablecoinOrderListResp> {
    return this.getPrivate('/otc/stable_coin/order/list', params);
  }

  /**
   * Fiat order details
   *
   * Query fiat order details
   *
   * @param params Parameters with order_id
   * @returns Promise with fiat order details
   */
  getOTCFiatOrderDetail(
    params: GetOTCFiatOrderDetailReq,
  ): Promise<GetOTCFiatOrderDetailResp> {
    return this.getPrivate('/otc/order/detail', params);
  }

  /**==========================================================================================================================
   * P2P MERCHANT
   * ==========================================================================================================================
   */

  /**
   * Get account information
   */
  getP2PMerchantUserInfo(): Promise<P2PMerchantApiResp<P2PMerchantUserInfo>> {
    return this.postPrivate('/p2p/merchant/account/get_user_info', {
      body: {},
    });
  }

  /**
   * Get counterparty information
   */
  getP2PMerchantCounterpartyUserInfo(
    params: P2PMerchantGetCounterpartyUserInfoReq,
  ): Promise<P2PMerchantApiResp<P2PMerchantCounterpartyUserInfo>> {
    return this.postPrivate(
      '/p2p/merchant/account/get_counterparty_user_info',
      { body: params },
    );
  }

  /**
   * Get payment method list
   */
  getP2PMerchantMyselfPayment(
    params?: P2PMerchantGetMyselfPaymentReq,
  ): Promise<P2PMerchantApiResp<P2PMerchantPaymentMethod[]>> {
    return this.postPrivate('/p2p/merchant/account/get_myself_payment', {
      body: params ?? {},
    });
  }

  /**
   * Query spot account balance for P2P merchant (v4.106.103)
   *
   * Guide entry — uses Spot API GET /spot/accounts.
   */
  getP2PMerchantSpotBalance(params?: {
    currency?: string;
  }): Promise<SpotAccount[]> {
    return this.getSpotAccounts(params);
  }

  /**
   * Set merchant working status and custom working hours (v4.106.96)
   */
  setP2PMerchantWorkHours(
    params: P2PMerchantSetMerchantWorkHoursReq,
  ): Promise<P2PMerchantApiResp<{ work_status: number }>> {
    return this.postPrivate('/p2p/merchant/account/set_merchant_work_hours', {
      body: params,
    });
  }

  /**
   * Get pending orders
   */
  getP2PMerchantPendingTransactionList(
    params: P2PMerchantGetPendingTransactionListReq,
  ): Promise<P2PMerchantApiResp<P2PMerchantTransactionListData>> {
    return this.postPrivate(
      '/p2p/merchant/transaction/get_pending_transaction_list',
      { body: params },
    );
  }

  /**
   * Get completed/historical orders
   */
  getP2PMerchantCompletedTransactionList(
    params: P2PMerchantGetCompletedTransactionListReq,
  ): Promise<P2PMerchantApiResp<P2PMerchantTransactionListData>> {
    return this.postPrivate(
      '/p2p/merchant/transaction/get_completed_transaction_list',
      { body: params },
    );
  }

  /**
   * Get order details
   */
  getP2PMerchantTransactionDetails(
    params: P2PMerchantGetTransactionDetailsReq,
  ): Promise<P2PMerchantApiResp<P2PMerchantTransactionDetails>> {
    return this.postPrivate(
      '/p2p/merchant/transaction/get_transaction_details',
      { body: params },
    );
  }

  /**
   * Confirm payment
   */
  confirmP2PMerchantPayment(
    params: P2PMerchantConfirmPaymentReq,
  ): Promise<P2PMerchantApiResp<Record<string, unknown>>> {
    return this.postPrivate('/p2p/merchant/transaction/confirm-payment', {
      body: params,
    });
  }

  /**
   * Confirm receipt
   */
  confirmP2PMerchantReceipt(
    params: P2PMerchantConfirmReceiptReq,
  ): Promise<P2PMerchantApiResp<Record<string, unknown>>> {
    return this.postPrivate('/p2p/merchant/transaction/confirm-receipt', {
      body: params,
    });
  }

  /**
   * Cancel order
   */
  cancelP2PMerchantTransaction(
    params: P2PMerchantCancelTransactionReq,
  ): Promise<P2PMerchantApiResp<Record<string, unknown>>> {
    return this.postPrivate('/p2p/merchant/transaction/cancel', {
      body: params,
    });
  }

  /**
   * Place ad order
   */
  placeP2PMerchantBizPushOrder(
    params: P2PMerchantPlaceBizPushOrderReq,
  ): Promise<P2PMerchantApiResp<Record<string, unknown>>> {
    return this.postPrivate('/p2p/merchant/books/place_biz_push_order', {
      body: params,
    });
  }

  /**
   * Update ad status
   */
  updateP2PMerchantAdsStatus(
    params: P2PMerchantAdsUpdateStatusReq,
  ): Promise<P2PMerchantApiResp<{ status: number }>> {
    const { trade_type, ...body } = params;
    return this.postPrivate('/p2p/merchant/books/ads_update_status', {
      body,
      query: trade_type ? { trade_type } : undefined,
    });
  }

  /**
   * Get ad details
   */
  getP2PMerchantAdsDetail(
    params: P2PMerchantAdsDetailReq,
  ): Promise<P2PMerchantApiResp<P2PMerchantAdsDetail>> {
    return this.postPrivate('/p2p/merchant/books/ads_detail', { body: params });
  }

  /**
   * Get my ads list
   */
  getP2PMerchantMyAdsList(
    params?: P2PMerchantMyAdsListReq,
  ): Promise<P2PMerchantApiResp<P2PMerchantMyAdsListData>> {
    return this.postPrivate('/p2p/merchant/books/my_ads_list', {
      body: params ?? {},
    });
  }

  /**
   * Get advertisement list
   */
  getP2PMerchantAdsList(
    params: P2PMerchantGetAdsListReq,
  ): Promise<P2PMerchantApiResp<P2PMerchantAdsListItem[]>> {
    return this.postPrivate('/p2p/merchant/books/ads_list', { body: params });
  }

  /**
   * Get chat history
   */
  getP2PMerchantChatsList(
    params: P2PMerchantGetChatsListReq,
  ): Promise<P2PMerchantApiResp<P2PMerchantChatsListData>> {
    return this.postPrivate('/p2p/merchant/chat/get_chats_list', {
      body: params,
    });
  }

  /**
   * Send chat message
   */
  sendP2PMerchantChatMessage(
    params: P2PMerchantSendChatMessageReq,
  ): Promise<P2PMerchantApiResp<{ SRVTM: number }>> {
    return this.postPrivate('/p2p/merchant/chat/send_chat_message', {
      body: params,
    });
  }

  /**
   * Upload chat file
   */
  uploadP2PMerchantChatFile(
    params: P2PMerchantUploadChatFileReq,
  ): Promise<P2PMerchantApiResp<{ file_key: string }>> {
    return this.postPrivate('/p2p/merchant/chat/upload_chat_file', {
      body: params,
    });
  }

  /**==========================================================================================================================
   * CROSSEX
   * ==========================================================================================================================
   */

  /**
   * Query Trading Pair Information
   *
   * Query trading pair information for cross-exchange trading
   *
   * @param params Optional parameters to filter symbols
   * @returns Promise with array of symbol information
   */
  getCrossExSymbols(params?: GetCrossExSymbolsReq): Promise<CrossExSymbol[]> {
    return this.get('/crossex/rule/symbols', params);
  }

  /**
   * Query Risk Limit Information
   *
   * Query risk limit information for futures/margin trading pairs
   *
   * @param params Parameters with required symbols
   * @returns Promise with array of risk limit information
   */
  getCrossExRiskLimits(
    params: GetCrossExRiskLimitsReq,
  ): Promise<CrossExRiskLimit[]> {
    return this.get('/crossex/rule/risk_limits', params);
  }

  /**
   * Query Supported Transfer Currencies
   *
   * Query supported transfer currencies for cross-exchange
   *
   * @param params Optional currency filter
   * @returns Promise with array of transfer coin information
   */
  getCrossExTransferCoins(
    params?: GetCrossExTransferCoinsReq,
  ): Promise<CrossExTransferCoin[]> {
    return this.get('/crossex/transfers/coin', params);
  }

  /**
   * Fund Transfer
   *
   * Transfer funds between accounts. Rate limit: 10 requests per 10 seconds
   *
   * @param params Transfer parameters
   * @returns Promise with transfer confirmation
   */
  createCrossExTransfer(
    params: CreateCrossExTransferReq,
  ): Promise<CreateCrossExTransferResp> {
    return this.postPrivate('/crossex/transfers', { body: params });
  }

  /**
   * Query Fund Transfer History
   *
   * Query fund transfer history. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of transfer history records
   */
  getCrossExTransferHistory(
    params?: GetCrossExTransferHistoryReq,
  ): Promise<CrossExTransferHistory[]> {
    return this.getPrivate('/crossex/transfers', params);
  }

  /**
   * Create an order
   *
   * Create an order for cross-exchange trading. Rate Limit: 100 requests per 10 seconds
   *
   * @param params Order parameters
   * @returns Promise with order creation response
   */
  createCrossExOrder(
    params: CreateCrossExOrderReq,
  ): Promise<CreateCrossExOrderResp> {
    return this.postPrivate('/crossex/orders', { body: params });
  }

  /**
   * Batch cancel CrossEx orders
   *
   * Cancel multiple CrossEx orders by order_id or custom text. When both are provided, order_id takes precedence. Each result reports whether the request was accepted plus any error label and message. Rate Limit: 100 requests per 10 seconds
   *
   * @param params Array of cancel requests (order_id and/or text)
   * @returns Promise with array of batch cancel results
   */
  cancelBatchCrossExOrders(
    params: CancelBatchCrossExOrdersReq[],
  ): Promise<CancelBatchCrossExOrdersResp[]> {
    return this.postPrivate('/crossex/batch_cancel_orders', { body: params });
  }

  /**
   * Cancel Order
   *
   * Cancel an order. Rate Limit: 100 requests per 10 seconds
   *
   * @param order_id Order ID or Text for Cancel Order
   * @returns Promise with cancellation confirmation
   */
  cancelCrossExOrder(order_id: string): Promise<CancelCrossExOrderResp> {
    return this.deletePrivate(`/crossex/orders/${order_id}`);
  }

  /**
   * Modify Order
   *
   * Modify an existing order. Rate Limit: 100 requests per 10 seconds
   *
   * @param order_id Order ID or Text for Modify Order
   * @param params Modification parameters
   * @returns Promise with modification confirmation
   */
  modifyCrossExOrder(
    order_id: string,
    params: ModifyCrossExOrderReq,
  ): Promise<ModifyCrossExOrderResp> {
    return this.putPrivate(`/crossex/orders/${order_id}`, { body: params });
  }

  /**
   * Query order details
   *
   * Query order details by order ID or custom text. Rate Limit: 200 requests per 10 seconds
   *
   * @param order_id Order ID or custom text
   * @returns Promise with order details
   */
  getCrossExOrder(order_id: string): Promise<CrossExOrder> {
    return this.getPrivate(`/crossex/orders/${order_id}`);
  }

  /**
   * Flash Swap Inquiry
   *
   * Create a flash swap quote. Rate Limit: 100 requests per day
   *
   * @param params Quote parameters
   * @returns Promise with quote details
   */
  createCrossExConvertQuote(
    params: CreateCrossExConvertQuoteReq,
  ): Promise<CreateCrossExConvertQuoteResp> {
    return this.postPrivate('/crossex/convert/quote', { body: params });
  }

  /**
   * Flash Swap Transaction
   *
   * Execute a flash swap transaction. Rate limit: 10 requests per 10 seconds
   *
   * @param params Parameters with quote_id
   * @returns Promise with transaction confirmation
   */
  createCrossExConvertOrder(
    params: CreateCrossExConvertOrderReq,
  ): Promise<CreateCrossExConvertOrderResp> {
    return this.postPrivate('/crossex/convert/orders', { body: params });
  }

  /**
   * Modify Account Contract Position Mode and Account Mode
   *
   * Modify account settings. Rate Limit: 100 requests per 60 seconds
   *
   * @param params Account modification parameters
   * @returns Promise with update confirmation
   */
  updateCrossExAccount(
    params: UpdateCrossExAccountReq,
  ): Promise<UpdateCrossExAccountResp> {
    return this.putPrivate('/crossex/accounts', { body: params });
  }

  /**
   * Query Account Assets
   *
   * Query account assets and balances. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional exchange_type filter
   * @returns Promise with account information
   */
  getCrossExAccounts(params?: GetCrossExAccountsReq): Promise<CrossExAccount> {
    return this.getPrivate('/crossex/accounts', params);
  }

  /**
   * Modify Contract Trading Pair Leverage Multiplier
   *
   * Modify leverage for contract trading pair. Rate Limit: 100 requests per 10 seconds
   *
   * @param params Leverage modification parameters
   * @returns Promise with leverage update confirmation
   */
  setCrossExPositionLeverage(
    params: SetCrossExPositionLeverageReq,
  ): Promise<SetCrossExPositionLeverageResp> {
    return this.postPrivate('/crossex/positions/leverage', { body: params });
  }

  /**
   * Query Contract Trading Pair Leverage Multiplier
   *
   * Query leverage for contract trading pairs. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional symbols filter
   * @returns Promise with array of leverage information
   */
  getCrossExPositionLeverage(
    params?: GetCrossExPositionLeverageReq,
  ): Promise<CrossExPositionLeverage[]> {
    return this.getPrivate('/crossex/positions/leverage', params);
  }

  /**
   * Modify Leveraged Trading Pair Leverage Multiplier
   *
   * Modify leverage for margin trading pair. Rate Limit: 100 requests per 10 seconds
   *
   * @param params Leverage modification parameters
   * @returns Promise with leverage update confirmation
   */
  setCrossExMarginPositionLeverage(
    params: SetCrossExMarginPositionLeverageReq,
  ): Promise<SetCrossExMarginPositionLeverageResp> {
    return this.postPrivate('/crossex/margin_positions/leverage', {
      body: params,
    });
  }

  /**
   * Query Leveraged Trading Pair Leverage Multiplier
   *
   * Query leverage for margin trading pairs. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional symbols filter
   * @returns Promise with array of leverage information
   */
  getCrossExMarginPositionLeverage(
    params?: GetCrossExMarginPositionLeverageReq,
  ): Promise<CrossExMarginPositionLeverage[]> {
    return this.getPrivate('/crossex/margin_positions/leverage', params);
  }

  /**
   * Full Close Position
   *
   * Fully close a position. Rate Limit: 100 requests per day
   *
   * @param params Position close parameters
   * @returns Promise with close position confirmation
   */
  closeCrossExPosition(
    params: CloseCrossExPositionReq,
  ): Promise<CloseCrossExPositionResp> {
    return this.postPrivate('/crossex/position', { body: params });
  }

  /**
   * Query margin asset interest rates
   *
   * Query interest rates for margin assets. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of interest rates
   */
  getCrossExInterestRate(
    params?: GetCrossExInterestRateReq,
  ): Promise<CrossExInterestRate[]> {
    return this.getPrivate('/crossex/interest_rate', params);
  }

  /**
   * Query User Fee Rates
   *
   * Query user fee rates. Rate Limit: 200 requests per 10 seconds
   *
   * @returns Promise with fee rates per exchange
   */
  getCrossExFeeRate(): Promise<CrossExFeeRate[]> {
    return this.getPrivate('/crossex/fee');
  }

  /**
   * Query Contract Positions
   *
   * Query contract positions. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of positions
   */
  getCrossExPositions(
    params?: GetCrossExPositionsReq,
  ): Promise<CrossExPosition[]> {
    return this.getPrivate('/crossex/positions', params);
  }

  /**
   * Query Leveraged Positions
   *
   * Query margin/leveraged positions. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of margin positions
   */
  getCrossExMarginPositions(
    params?: GetCrossExMarginPositionsReq,
  ): Promise<CrossExMarginPosition[]> {
    return this.getPrivate('/crossex/margin_positions', params);
  }

  /**
   * Query ADL Position Reduction Ranking
   *
   * Query ADL position reduction ranking. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Parameters with required symbol
   * @returns Promise with array of ADL rankings
   */
  getCrossExAdlRank(params: GetCrossExAdlRankReq): Promise<CrossExAdlRank[]> {
    return this.getPrivate('/crossex/adl_rank', params);
  }

  /**
   * Query All Current Open Orders
   *
   * Query all current open orders. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of open orders
   */
  getCrossExOpenOrders(
    params?: GetCrossExOpenOrdersReq,
  ): Promise<CrossExOrder[]> {
    return this.getPrivate('/crossex/open_orders', params);
  }

  /**
   * Query order history
   *
   * Query historical orders. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of historical orders
   */
  getCrossExHistoryOrders(
    params?: GetCrossExHistoryOrdersReq,
  ): Promise<CrossExOrder[]> {
    return this.getPrivate('/crossex/history_orders', params);
  }

  /**
   * Query Contract Position History
   *
   * Query contract position history. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of historical positions
   */
  getCrossExHistoryPositions(
    params?: GetCrossExHistoryPositionsReq,
  ): Promise<CrossExHistoryPosition[]> {
    return this.getPrivate('/crossex/history_positions', params);
  }

  /**
   * Query Leveraged Position History
   *
   * Query margin position history. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of historical margin positions
   */
  getCrossExHistoryMarginPositions(
    params?: GetCrossExHistoryMarginPositionsReq,
  ): Promise<CrossExHistoryMarginPosition[]> {
    return this.getPrivate('/crossex/history_margin_positions', params);
  }

  /**
   * Query Leveraged Interest Deduction History
   *
   * Query margin interest deduction history. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of interest deduction records
   */
  getCrossExHistoryMarginInterests(
    params?: GetCrossExHistoryMarginInterestsReq,
  ): Promise<CrossExHistoryMarginInterest[]> {
    return this.getPrivate('/crossex/history_margin_interests', params);
  }

  /**
   * Query filled history
   *
   * Query trade execution history. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of trade records
   */
  getCrossExHistoryTrades(
    params?: GetCrossExHistoryTradesReq,
  ): Promise<CrossExHistoryTrade[]> {
    return this.getPrivate('/crossex/history_trades', params);
  }

  /**
   * Query Account Asset Change History
   *
   * Query account balance change history. Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of account book records
   */
  getCrossExAccountBook(
    params?: GetCrossExAccountBookReq,
  ): Promise<CrossExAccountBook[]> {
    return this.getPrivate('/crossex/account_book', params);
  }

  /**
   * Query currency discount rate
   *
   * Query currency discount rate (for margin currency in isolated exchange mode). Rate Limit: 200 requests per 10 seconds
   *
   * @param params Optional filter parameters
   * @returns Promise with array of coin discount rates
   */
  getCrossExCoinDiscountRate(
    params?: GetCrossExCoinDiscountRateReq,
  ): Promise<CrossExCoinDiscountRate[]> {
    return this.getPrivate('/crossex/coin_discount_rate', params);
  }

  /**
   * Query CrossEx market tickers
   *
   * Query exchange market tickers, optionally filtered by a comma-separated list of symbols.
   *
   * @param params Optional parameters to filter symbols
   * @returns Promise with array of market tickers
   */
  getCrossExMarketTickers(
    params?: GetCrossExMarketTickersReq,
  ): Promise<CrossExMarketTicker[]> {
    return this.get('/crossex/market/tickers', params);
  }

  /**
   * Query CrossEx market funding info
   *
   * Query futures funding rates, funding intervals, and next funding timestamps across exchanges.
   *
   * @param params Optional parameters to filter symbols
   * @returns Promise with array of funding info records
   */
  getCrossExMarketFundingInfo(
    params?: GetCrossExMarketFundingInfoReq,
  ): Promise<CrossExMarketFundingInfo[]> {
    return this.get('/crossex/market/funding_info', params);
  }

  /**==========================================================================================================================
   * ALPHA
   * ==========================================================================================================================
   */

  /**
   * Query position assets
   *
   * Query alpha account position assets
   *
   * @returns Promise with array of account balances
   */
  getAlphaAccounts(): Promise<AlphaAccount[]> {
    return this.getPrivate('/alpha/accounts');
  }

  /**
   * Query asset transactions
   *
   * Query alpha account transaction history
   *
   * @param params Parameters with required from timestamp
   * @returns Promise with array of transaction records
   */
  getAlphaAccountBook(
    params: GetAlphaAccountBookReq,
  ): Promise<AlphaAccountBook[]> {
    return this.getPrivate('/alpha/account_book', params);
  }

  /**
   * Alpha Quote API
   *
   * Get a quote for alpha trading. Quote is valid for 1 minute. Rate-limited at 10 requests per second per user.
   *
   * @param params Quote parameters
   * @returns Promise with quote details
   */
  createAlphaQuote(params: CreateAlphaQuoteReq): Promise<CreateAlphaQuoteResp> {
    return this.postPrivate('/alpha/quote', { body: params });
  }

  /**
   * Alpha Order API
   *
   * Create an alpha order. Rate-limited at 5 requests per second per user.
   *
   * @param params Order parameters including quote_id
   * @returns Promise with order details
   */
  createAlphaOrder(params: CreateAlphaOrderReq): Promise<CreateAlphaOrderResp> {
    return this.postPrivate('/alpha/orders', { body: params });
  }

  /**
   * Alpha Order List API
   *
   * Query alpha order list with filters
   *
   * @param params Filter parameters
   * @returns Promise with array of orders
   */
  getAlphaOrders(params?: GetAlphaOrdersReq): Promise<AlphaOrder[]> {
    return this.getPrivate('/alpha/orders', params);
  }

  /**
   * Alpha Single Order Query API
   *
   * Query a single alpha order by order ID
   *
   * @param params Parameters with order_id
   * @returns Promise with order details
   */
  getAlphaOrder(params: GetAlphaOrderReq): Promise<AlphaOrder> {
    return this.getPrivate('/alpha/order', params);
  }

  /**
   * Query currency information
   *
   * Query alpha currency information. When currency is provided, returns specific currency info; otherwise returns paginated list.
   *
   * @param params Optional filter parameters
   * @returns Promise with array of currency information
   */
  getAlphaCurrencies(params?: GetAlphaCurrenciesReq): Promise<AlphaCurrency[]> {
    return this.get('/alpha/currencies', params);
  }

  /**
   * Query currency ticker
   *
   * Query alpha currency ticker. When currency is provided, returns specific ticker; otherwise returns paginated list.
   *
   * @param params Optional filter parameters
   * @returns Promise with array of ticker information
   */
  getAlphaTickers(params?: GetAlphaTickersReq): Promise<AlphaTicker[]> {
    return this.get('/alpha/tickers', params);
  }

  // ============ TradFi ============

  getTradFiMT5Account(): Promise<TradFiApiResp<TradFiMT5Account>> {
    return this.getPrivate('/tradfi/users/mt5-account');
  }

  getTradFiSymbolCategories(): Promise<
    TradFiApiResp<TradFiListData<TradFiCategoryItem>>
  > {
    return this.get('/tradfi/symbols/categories');
  }

  getTradFiSymbols(): Promise<TradFiApiResp<TradFiListData<TradFiSymbolItem>>> {
    return this.get('/tradfi/symbols');
  }

  /**
   * Query CFD symbol commission rates
   *
   * At least one of symbols or category_code is required. When both are provided, symbols are filtered by category.
   *
   * @param params Optional filters for symbols and/or category codes
   * @returns Promise with list of symbol commission rates
   */
  getTradFiSymbolCommissions(
    params?: TradFiGetSymbolCommissionsParams,
  ): Promise<TradFiApiResp<TradFiListData<TradFiSymbolCommissionItem>>> {
    return this.get('/tradfi/symbols/commissions', params);
  }

  getTradFiSymbolDetail(
    params: TradFiGetSymbolDetailParams,
  ): Promise<TradFiApiResp<TradFiListData<TradFiSymbolDetailItem>>> {
    return this.getPrivate('/tradfi/symbols/detail', params);
  }

  getTradFiKlines(
    symbol: string,
    params: TradFiGetKlinesParams,
  ): Promise<TradFiApiResp<TradFiListData<TradFiKlineItem>>> {
    return this.get(`/tradfi/symbols/${symbol}/klines`, params);
  }

  getTradFiTicker(symbol: string): Promise<TradFiApiResp<TradFiTicker>> {
    return this.get(`/tradfi/symbols/${symbol}/tickers`);
  }

  createTradFiUser(): Promise<TradFiApiResp<TradFiCreateUserResult>> {
    return this.postPrivate('/tradfi/users');
  }

  getTradFiAssets(): Promise<TradFiApiResp<TradFiAssets>> {
    return this.getPrivate('/tradfi/users/assets');
  }

  createTradFiTransaction(
    params: TradFiCreateTransactionReq,
  ): Promise<TradFiApiResp<Record<string, never>>> {
    return this.postPrivate('/tradfi/transactions', { body: params });
  }

  getTradFiTransactions(
    params?: TradFiGetTransactionsParams,
  ): Promise<TradFiApiResp<TradFiTransactionListData>> {
    return this.getPrivate('/tradfi/transactions', params);
  }

  createTradFiOrder(
    params: TradFiCreateOrderReq,
  ): Promise<TradFiApiResp<TradFiCreateOrderResult>> {
    return this.postPrivate('/tradfi/orders', { body: params });
  }

  getTradFiOrders(): Promise<TradFiApiResp<TradFiListData<TradFiOrderItem>>> {
    return this.getPrivate('/tradfi/orders');
  }

  modifyTradFiOrder(
    orderId: number,
    params: TradFiModifyOrderReq,
  ): Promise<TradFiApiResp<TradFiModifyOrderResult>> {
    return this.putPrivate(`/tradfi/orders/${orderId}`, { body: params });
  }

  cancelTradFiOrder(orderId: number): Promise<Record<string, never>> {
    return this.deletePrivate(`/tradfi/orders/${orderId}`);
  }

  getTradFiOrderHistory(
    params?: TradFiGetOrderHistoryParams,
  ): Promise<TradFiApiResp<TradFiListData<TradFiOrderHistoryItem>>> {
    return this.getPrivate('/tradfi/orders/history', params);
  }

  getTradFiPositions(): Promise<
    TradFiApiResp<TradFiListData<TradFiPositionItem>>
  > {
    return this.getPrivate('/tradfi/positions');
  }

  modifyTradFiPosition(
    positionId: number,
    params: TradFiModifyPositionReq,
  ): Promise<TradFiApiResp<Record<string, never>>> {
    return this.putPrivate(`/tradfi/positions/${positionId}`, {
      body: params,
    });
  }

  closeTradFiPosition(
    positionId: number,
    params: TradFiClosePositionReq,
  ): Promise<TradFiApiResp<Record<string, never>>> {
    return this.postPrivate(`/tradfi/positions/${positionId}/close`, {
      body: params,
    });
  }

  getTradFiPositionHistory(
    params?: TradFiGetPositionHistoryParams,
  ): Promise<TradFiApiResp<TradFiListData<TradFiPositionHistoryItem>>> {
    return this.getPrivate('/tradfi/positions/history', params);
  }

  /**
   * Query order details by log_id from order placement (v4.106.94)
   */
  getTradFiOrderLog(params: {
    log_id: number | string;
  }): Promise<TradFiApiResp<TradFiOrderLog>> {
    return this.getPrivate(`/tradfi/orders/log/${params.log_id}`);
  }

  // ============ Stock ============

  /**
   * Query user stock assets
   *
   * @param params Optional PnL calculation parameters
   * @returns Promise with user asset details
   */
  getStockUserAssets(
    params?: GetStockUserAssetsReq,
  ): Promise<StockApiResp<StockUserAssets>> {
    return this.getPrivate('/stock/users/assets', params);
  }

  /**
   * Query stock symbol list
   *
   * @param params Optional filters for symbols, exchange, and pagination
   * @returns Promise with paginated symbol list
   */
  getStockSymbols(
    params?: GetStockSymbolsReq,
  ): Promise<StockApiResp<StockListData<StockSymbolItem>>> {
    return this.get('/stock/symbols', params);
  }

  /**
   * Query stock symbol details
   *
   * @param params Optional filters for symbols, exchange, and pagination
   * @returns Promise with paginated symbol detail list
   */
  getStockSymbolDetail(
    params?: GetStockSymbolDetailReq,
  ): Promise<StockApiResp<StockListData<StockSymbolDetailItem>>> {
    return this.getPrivate('/stock/symbols/detail', params);
  }

  /**
   * Query stock market order book
   *
   * @param symbol Symbol
   * @returns Promise with order book data
   */
  getStockOrderBook(symbol: string): Promise<StockApiResp<StockOrderBook>> {
    return this.get(`/stock/market/${symbol}/orderbook`);
  }

  /**
   * Query open stock orders
   *
   * @param params Optional symbol filter
   * @returns Promise with open order list
   */
  getStockOrders(
    params?: GetStockOrdersReq,
  ): Promise<StockApiResp<StockListData<StockOrderItem>>> {
    return this.getPrivate('/stock/orders', params);
  }

  /**
   * Create a stock order
   *
   * Limit orders support only the all trading session; market orders support only regular. time_in_force supports day only.
   *
   * @param params Order parameters
   * @returns Promise with created order ID
   */
  createStockOrder(
    params: CreateStockOrderReq,
  ): Promise<StockApiResp<StockCreateOrderResult>> {
    return this.postPrivate('/stock/orders', { body: params });
  }

  /**
   * Cancel all open stock orders
   *
   * @returns Promise with empty data on success
   */
  cancelAllStockOrders(): Promise<StockApiResp<Record<string, never>>> {
    return this.deletePrivate('/stock/orders');
  }

  /**
   * Query stock order history
   *
   * @param params Optional filters for symbol, order IDs, time range, side, and pagination
   * @returns Promise with paginated historical order list
   */
  getStockOrderHistory(
    params?: GetStockOrderHistoryReq,
  ): Promise<StockApiResp<StockListData<StockOrderHistoryItem>>> {
    return this.getPrivate('/stock/orders/history', params);
  }

  /**
   * Modify a stock order
   *
   * @param orderId Order ID
   * @param params Modified volume and price
   * @returns Promise with updated order ID
   */
  updateStockOrder(
    orderId: number,
    params: UpdateStockOrderReq,
  ): Promise<StockApiResp<StockUpdateOrderResult>> {
    return this.putPrivate(`/stock/orders/${orderId}`, { body: params });
  }

  /**
   * Cancel a stock order
   *
   * @param orderId Order ID
   * @returns Promise with empty data on success
   */
  cancelStockOrder(
    orderId: number,
  ): Promise<StockApiResp<Record<string, never>>> {
    return this.deletePrivate(`/stock/orders/${orderId}`);
  }

  /**
   * Query current stock positions
   *
   * @param params Optional filters for PnL calc, symbol, and exchange
   * @returns Promise with position list
   */
  getStockPositions(
    params?: GetStockPositionsReq,
  ): Promise<StockApiResp<StockListData<StockPositionItem>>> {
    return this.getPrivate('/stock/positions', params);
  }

  /**
   * Close a stock position
   *
   * @param params Close parameters (partial or full)
   * @returns Promise with close order ID
   */
  closeStockPosition(
    params: CloseStockPositionReq,
  ): Promise<StockApiResp<StockClosePositionResult>> {
    return this.postPrivate('/stock/positions/close', { body: params });
  }

  /**
   * Query stock transaction records
   *
   * @param params Optional filters for time range, ref_id, type, and pagination
   * @returns Promise with paginated transaction list
   */
  getStockTransactions(
    params?: GetStockTransactionsReq,
  ): Promise<StockApiResp<StockListData<StockTransactionItem>>> {
    return this.getPrivate('/stock/transactions', params);
  }

  /**
   * Fund transfer for stock account
   *
   * Transfer funds in or out of the stock account (USDT only).
   *
   * @param params Transfer parameters including ref_id for idempotency
   * @returns Promise with empty data on success
   */
  createStockTransaction(
    params: CreateStockTransactionReq,
  ): Promise<StockApiResp<Record<string, never>>> {
    return this.postPrivate('/stock/transactions', { body: params });
  }

  /**
   * Query supported stock exchanges
   *
   * @returns Promise with exchange list
   */
  getStockExchanges(): Promise<StockApiResp<StockListData<StockExchangeItem>>> {
    return this.get('/stock/exchanges');
  }

  /**
   * Query stock fee rates
   *
   * Maker/taker fee fields apply to Japanese and Korean stocks.
   *
   * @returns Promise with fee rate list by VIP level
   */
  getStockFeeRate(): Promise<StockApiResp<StockListData<StockFeeRateItem>>> {
    return this.get('/stock/fee-rate');
  }
}