/* eslint-disable @typescript-eslint/no-explicit-any */ import { APIResponseV3, APIResponseWithTime, USDCOptionsActiveOrdersRealtimeRequest, USDCOptionsActiveOrdersRequest, USDCOptionsCancelAllOrdersRequest, USDCOptionsCancelOrderRequest, USDCOptionsContractInfoRequest, USDCOptionsDeliveryHistoryRequest, USDCOptionsDeliveryPriceRequest, USDCOptionsHistoricOrdersRequest, USDCOptionsHistoricalVolatilityRequest, USDCOptionsModifyMMPRequest, USDCOptionsModifyOrderRequest, USDCOptionsOrderExecutionRequest, USDCOptionsOrderRequest, USDCOptionsPositionsInfoExpiryRequest, USDCOptionsRecentTradesRequest, USDCPositionsRequest, USDCTransactionLogRequest, } from './types'; import { REST_CLIENT_TYPE_ENUM } from './util'; import BaseRestClient from './util/BaseRestClient'; /** * REST API client for USDC Option APIs */ export class USDCOptionClient extends BaseRestClient { getClientType() { return REST_CLIENT_TYPE_ENUM.v3; } async fetchServerTime(): Promise { const res = await this.getServerTime(); return Number(res.time_now); } /** * * Market Data Endpoints * */ /** Query order book info. Each side has a depth of 25 orders. */ getOrderBook(symbol: string): Promise> { return this.get('/option/usdc/openapi/public/v1/order-book', { symbol }); } /** Fetch trading rules (such as min/max qty). Query for all if blank. */ getContractInfo( params?: USDCOptionsContractInfoRequest ): Promise> { return this.get('/option/usdc/openapi/public/v1/symbols', params); } /** Get a symbol price/statistics ticker */ getSymbolTicker(symbol: string): Promise> { return this.get('/option/usdc/openapi/public/v1/tick', { symbol }); } /** Get delivery information */ getDeliveryPrice( params?: USDCOptionsDeliveryPriceRequest ): Promise> { return this.get('/option/usdc/openapi/public/v1/delivery-price', params); } /** Returned records are Taker Buy in default. */ getLast500Trades( params: USDCOptionsRecentTradesRequest ): Promise> { return this.get( '/option/usdc/openapi/public/v1/query-trade-latest', params ); } /** * The data is in hourly. * If time field is not passed, it returns the recent 1 hour data by default. * It could be any timeframe by inputting startTime & endTime, but it must satisfy [endTime - startTime] <= 30 days. * It returns all data in 2 years when startTime & endTime are not passed. * Both startTime & endTime entered together or both are left blank */ getHistoricalVolatility( params?: USDCOptionsHistoricalVolatilityRequest ): Promise> { return this.get( '/option/usdc/openapi/public/v1/query-historical-volatility', params ); } /** * * Account Data Endpoints * */ /** -> Order API */ /** * Place an order using the USDC Derivatives Account. * The request status can be queried in real-time. * The response parameters must be queried through a query or a WebSocket response. */ submitOrder(params: USDCOptionsOrderRequest): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/place-order', params ); } /** * Each request supports a max. of four orders. The reduceOnly parameter should be separate and unique for each order in the request. */ batchSubmitOrders( orderRequest: USDCOptionsOrderRequest[] ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/batch-place-orders', { orderRequest } ); } /** For Options, at least one of the three parameters — price, quantity or implied volatility — must be input. */ modifyOrder( params: USDCOptionsModifyOrderRequest ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/replace-order', params ); } /** Each request supports a max. of four orders. The reduceOnly parameter should be separate and unique for each order in the request. */ batchModifyOrders( replaceOrderRequest: USDCOptionsModifyOrderRequest[] ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/batch-replace-orders', { replaceOrderRequest } ); } /** Cancel order */ cancelOrder( params: USDCOptionsCancelOrderRequest ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/cancel-order', params ); } /** Batch cancel orders */ batchCancelOrders( cancelRequest: USDCOptionsCancelOrderRequest[] ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/batch-cancel-orders', { cancelRequest } ); } /** This is used to cancel all active orders. The real-time response indicates whether the request is successful, depending on retCode. */ cancelActiveOrders( params?: USDCOptionsCancelAllOrdersRequest ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/cancel-all', params ); } /** Query Unfilled/Partially Filled Orders(real-time), up to last 7 days of partially filled/unfilled orders */ getActiveRealtimeOrders( params?: USDCOptionsActiveOrdersRealtimeRequest ): Promise> { return this.getPrivate( '/option/usdc/openapi/private/v1/trade/query-active-orders', params ); } /** Query Unfilled/Partially Filled Orders */ getActiveOrders( params: USDCOptionsActiveOrdersRequest ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/query-active-orders', params ); } /** Query order history. The endpoint only supports up to 30 days of queried records */ getHistoricOrders( params: USDCOptionsHistoricOrdersRequest ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/query-order-history', params ); } /** * Query trade history. * The endpoint only supports up to 30 days of queried records. * An error will be returned if startTime is more than 30 days. */ getOrderExecutionHistory( params: USDCOptionsOrderExecutionRequest ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/execution-list', params ); } /** -> Account API */ /** The endpoint only supports up to 30 days of queried records. An error will be returned if startTime is more than 30 days. */ getTransactionLog( params: USDCTransactionLogRequest ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/query-transaction-log', params ); } /** Wallet info for USDC account. */ getBalances(): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/query-wallet-balance' ); } /** Asset Info */ getAssetInfo(baseCoin?: string): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/query-asset-info', { baseCoin } ); } /** * If USDC derivatives account balance is greater than X, you can open PORTFOLIO_MARGIN, * and if it is less than Y, it will automatically close PORTFOLIO_MARGIN and change back to REGULAR_MARGIN. * X and Y will be adjusted according to operational requirements. * Rest API returns the result of checking prerequisites. You could get the real status of margin mode change by subscribing margin mode. */ setMarginMode( newMarginMode: 'REGULAR_MARGIN' | 'PORTFOLIO_MARGIN' ): Promise> { return this.postPrivate( '/option/usdc/private/asset/account/setMarginMode', { setMarginMode: newMarginMode } ); } /** Query margin mode for USDC account. */ getMarginMode(): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/query-margin-info' ); } /** -> Positions API */ /** Query my positions */ getPositions(params: USDCPositionsRequest): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/query-position', params ); } /** Query Delivery History */ getDeliveryHistory( params: USDCOptionsDeliveryHistoryRequest ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/query-delivery-list', params ); } /** Query Positions Info Upon Expiry */ getPositionsInfoUponExpiry( params?: USDCOptionsPositionsInfoExpiryRequest ): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/query-position-exp-date', params ); } /** -> Market Maker Protection */ /** modifyMMP */ modifyMMP(params: USDCOptionsModifyMMPRequest): Promise> { return this.postPrivate( '/option/usdc/openapi/private/v1/mmp-modify', params ); } /** resetMMP */ resetMMP(currency: string): Promise> { return this.postPrivate('/option/usdc/openapi/private/v1/mmp-reset', { currency, }); } /** queryMMPState */ queryMMPState(baseCoin: string): Promise> { return this.postPrivate('/option/usdc/openapi/private/v1/get-mmp-state', { baseCoin, }); } /** * * API Data Endpoints * */ getServerTime(): Promise { return this.get('/v2/public/time'); } }