feat(v3.0.3): add new V3 endpoints

Author: JJ-Cro

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "bitget-api",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "Complete Node.js & JavaScript SDK for Bitget V1-V3 REST APIs & WebSockets, with TypeScript & end-to-end tests.",
   "scripts": {
     "test": "jest",

package.json

@@ -18,6 +18,7 @@ import {
   GetTransferableCoinsRequestV3,
   GetWithdrawRecordsRequestV3,
   RepayRequestV3,
+  SetDepositAccountRequestV3,
   SetLeverageRequestV3,
   SubAccountTransferRequestV3,
   SwitchDeductRequestV3,
@@ -93,6 +94,7 @@ import {
   SubAccountV3,
   SubTransferRecordV3,
   SubUnifiedAssetV3,
+  SwitchStatusResponseV3,
   TransferResponseV3,
   UpdateSubAccountApiKeyResponseV3,
   WithdrawRecordV3,
@@ -119,6 +121,7 @@ import {
   OpenInterestV3,
   OrderBookV3,
   PositionTierV3,
+  ProofOfReservesV3,
   PublicFillV3,
   RiskReserveV3,
   TickerV3,
@@ -142,6 +145,7 @@ import {
   OrderInfoV3,
   PlaceBatchOrdersResponseV3,
   PlaceOrderResponseV3,
+  PositionAdlRankV3,
   PositionHistoryV3,
   UnfilledOrderV3,
 } from './types/response/v3/trade.js';
@@ -278,6 +282,13 @@ export class RestClientV3 extends BaseRestClient {
     return this.get('/api/v3/market/fills', params);
   }
 
+  /**
+   * Get Proof Of Reserves
+   */
+  getProofOfReserves(): Promise<APIResponse<ProofOfReservesV3>> {
+    return this.get('/api/v3/market/proof-of-reserves');
+  }
+
   /**
    * Get Open Interest
    */
@@ -466,6 +477,18 @@ export class RestClientV3 extends BaseRestClient {
     return this.getPrivate('/api/v3/account/convert-records', params);
   }
 
+  /**
+   * Set up deposit account - Configure default recharge account for a certain symbol
+   * This configuration item remains valid for a long time. That is, once a user sets a default
+   * recharge account for a certain symbol, it will be retained permanently, and there is no need to reconfigure it.
+   * Permission: UTA mgt. (read & write)
+   */
+  setDepositAccount(
+    params: SetDepositAccountRequestV3,
+  ): Promise<APIResponse<string>> {
+    return this.postPrivate('/api/v3/account/deposit-account', params);
+  }
+
   /**
    * Switch Deduct - Set BGB deduction
    */
@@ -496,6 +519,27 @@ export class RestClientV3 extends BaseRestClient {
     return this.getPrivate('/api/v3/account/fee-rate', params);
   }
 
+  /**
+   * Switch Account - Switch to classic account mode
+   * Only supports parent accounts.
+   * This endpoint is only used for switching to classic account mode.
+   * Please note that since the account switching process takes approximately 1 minute,
+   * the successful response you receive only indicates that the request has been received,
+   * and does not mean that the account has been successfully switched to the classic account.
+   * Please use the query switching status interface to confirm whether the account switching is successful.
+   */
+  switchAccount(): Promise<APIResponse<null>> {
+    return this.postPrivate('/api/v3/account/switch');
+  }
+
+  /**
+   * Get Switch Status - Get account switching status
+   * Only supports parent accounts.
+   */
+  getSwitchStatus(): Promise<APIResponse<SwitchStatusResponseV3>> {
+    return this.getPrivate('/api/v3/account/switch-status');
+  }
+
   /**
    *
    * =====SubAccount======= endpoints
@@ -851,6 +895,13 @@ export class RestClientV3 extends BaseRestClient {
     return this.postPrivate('/api/v3/account/max-open-available', params);
   }
 
+  /**
+   * Get Position ADL Rank - Get position auto-deleveraging ranking
+   */
+  getPositionAdlRank(): Promise<APIResponse<PositionAdlRankV3[]>> {
+    return this.getPrivate('/api/v3/position/adlRank');
+  }
+
   /**
    * CountDown Cancel All
    */

src/rest-client-v3.ts

@@ -250,3 +250,8 @@ export interface GetWithdrawRecordsRequestV3 {
   limit?: string;
   cursor?: string;
 }
+
+export interface SetDepositAccountRequestV3 {
+  coin: string;
+  accountType: 'funding' | 'unified' | 'otc';
+}

src/types/request/v3/account.ts

@@ -227,3 +227,7 @@ export interface WithdrawRecordV3 {
   createdTime: string;
   updatedTime: string;
 }
+
+export interface SwitchStatusResponseV3 {
+  status: 'processProcessing' | 'successSuccess' | 'failFailed';
+}

src/types/response/v3/account.ts

@@ -72,7 +72,7 @@ export interface PositionTierV3 {
 }
 
 export interface RiskReserveRecordV3 {
-  type: 'in' | 'out';
+  balance: string;
   amount: string;
   ts: string;
 }
@@ -166,3 +166,14 @@ export interface TickerV3 {
   deliveryTime?: string;
   deliveryStatus?: string;
 }
+
+export interface ProofOfReservesV3 {
+  merkleRootHash: string;
+  totalReserveRatio: string;
+  list: {
+    coin: string;
+    userAssets: string;
+    platformAssets: string;
+    reserveRatio: string;
+  }[];
+}

src/types/response/v3/public.ts

@@ -206,3 +206,10 @@ export interface PlaceOrderResponseV3 {
   orderId: string;
   clientOid: string;
 }
+
+export interface PositionAdlRankV3 {
+  symbol: string;
+  marginCoin: string;
+  adlRank: string;
+  holdSide: 'long' | 'short';
+}