update to v7.2.70

Author: gate

README.md

@@ -1,4 +1,4 @@
-## gate-api@7.2.67
+## gate-api@7.2.70
 
 TypeScript NodeJS client for gate-api.
 
@@ -7,7 +7,7 @@ APIv4 provides operations related to spot, margin, and contract trading, includi
 
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
-- API version: v4.106.67
+- API version: v4.106.70
 - Package version: 
 - Build package: org.openapitools.codegen.languages.TypeScriptNodeClientCodegen
 For more information, please visit [https://www.gate.com/page/contacts](https://www.gate.com/page/contacts)
@@ -107,16 +107,16 @@ Class | Method | HTTP request | Description
 *AssetswapApi* | [**listAssetSwapOrdersV1**](docs/AssetswapApi.md#listAssetSwapOrdersV1) | **GET** /asset-swap/order/list | Portfolio optimization — order list
 *AssetswapApi* | [**previewAssetSwapOrderV1**](docs/AssetswapApi.md#previewAssetSwapOrderV1) | **POST** /asset-swap/order/preview | Portfolio optimization — preview
 *AssetswapApi* | [**getAssetSwapOrderV1**](docs/AssetswapApi.md#getAssetSwapOrderV1) | **GET** /asset-swap/order/{order_id} | Portfolio optimization — query order
-*BotApi* | [**getAIHubStrategyRecommend**](docs/BotApi.md#getAIHubStrategyRecommend) | **GET** /bot/strategy/recommend | 获取 AIHub 策略推荐
-*BotApi* | [**postAIHubSpotGridCreate**](docs/BotApi.md#postAIHubSpotGridCreate) | **POST** /bot/spot-grid/create | 创建现货网格
-*BotApi* | [**postAIHubMarginGridCreate**](docs/BotApi.md#postAIHubMarginGridCreate) | **POST** /bot/margin-grid/create | 创建杠杆网格
-*BotApi* | [**postAIHubInfiniteGridCreate**](docs/BotApi.md#postAIHubInfiniteGridCreate) | **POST** /bot/infinite-grid/create | 创建无限网格
-*BotApi* | [**postAIHubFuturesGridCreate**](docs/BotApi.md#postAIHubFuturesGridCreate) | **POST** /bot/futures-grid/create | 创建合约网格
-*BotApi* | [**postAIHubSpotMartingaleCreate**](docs/BotApi.md#postAIHubSpotMartingaleCreate) | **POST** /bot/spot-martingale/create | 创建现货马丁
-*BotApi* | [**postAIHubContractMartingaleCreate**](docs/BotApi.md#postAIHubContractMartingaleCreate) | **POST** /bot/contract-martingale/create | 创建合约马丁
-*BotApi* | [**getAIHubPortfolioRunning**](docs/BotApi.md#getAIHubPortfolioRunning) | **GET** /bot/portfolio/running | 查询运行中策略列表
-*BotApi* | [**getAIHubPortfolioDetail**](docs/BotApi.md#getAIHubPortfolioDetail) | **GET** /bot/portfolio/detail | 查询单策略详情
-*BotApi* | [**postAIHubPortfolioStop**](docs/BotApi.md#postAIHubPortfolioStop) | **POST** /bot/portfolio/stop | 终止单个运行中策略
+*BotApi* | [**getAIHubStrategyRecommend**](docs/BotApi.md#getAIHubStrategyRecommend) | **GET** /bot/strategy/recommend | Get AIHub strategy recommendations
+*BotApi* | [**postAIHubSpotGridCreate**](docs/BotApi.md#postAIHubSpotGridCreate) | **POST** /bot/spot-grid/create | Create spot grid
+*BotApi* | [**postAIHubMarginGridCreate**](docs/BotApi.md#postAIHubMarginGridCreate) | **POST** /bot/margin-grid/create | Create a lever grid
+*BotApi* | [**postAIHubInfiniteGridCreate**](docs/BotApi.md#postAIHubInfiniteGridCreate) | **POST** /bot/infinite-grid/create | Create infinite grid
+*BotApi* | [**postAIHubFuturesGridCreate**](docs/BotApi.md#postAIHubFuturesGridCreate) | **POST** /bot/futures-grid/create | Create a contract grid
+*BotApi* | [**postAIHubSpotMartingaleCreate**](docs/BotApi.md#postAIHubSpotMartingaleCreate) | **POST** /bot/spot-martingale/create | Create Spot Martin
+*BotApi* | [**postAIHubContractMartingaleCreate**](docs/BotApi.md#postAIHubContractMartingaleCreate) | **POST** /bot/contract-martingale/create | Create contract martin
+*BotApi* | [**getAIHubPortfolioRunning**](docs/BotApi.md#getAIHubPortfolioRunning) | **GET** /bot/portfolio/running | Query the list of running policies
+*BotApi* | [**getAIHubPortfolioDetail**](docs/BotApi.md#getAIHubPortfolioDetail) | **GET** /bot/portfolio/detail | Query order policy details
+*BotApi* | [**postAIHubPortfolioStop**](docs/BotApi.md#postAIHubPortfolioStop) | **POST** /bot/portfolio/stop | Terminate a single running policy
 *CouponApi* | [**listUserCoupons**](docs/CouponApi.md#listUserCoupons) | **GET** /coupon/user-coupon-list | Coupon Center list
 *CouponApi* | [**getUserCouponDetail**](docs/CouponApi.md#getUserCouponDetail) | **GET** /coupon/user-coupon-detail | Coupon Center details
 *CrossExApi* | [**listCrossexRuleSymbols**](docs/CrossExApi.md#listCrossexRuleSymbols) | **GET** /crossex/rule/symbols | [Public Interface] Query Trading Pair Information
@@ -300,16 +300,16 @@ Class | Method | HTTP request | Description
 *LaunchApi* | [**redeemLaunchPool**](docs/LaunchApi.md#redeemLaunchPool) | **POST** /launch/redeem | Redeem LaunchPool staked assets
 *LaunchApi* | [**listLaunchPoolPledgeRecords**](docs/LaunchApi.md#listLaunchPoolPledgeRecords) | **GET** /launch/user-pledge-records | Query user pledge records
 *LaunchApi* | [**listLaunchPoolRewardRecords**](docs/LaunchApi.md#listLaunchPoolRewardRecords) | **GET** /launch/get-user-reward-records | Query user reward records
-*LaunchApi* | [**getHodlerAirdropProjectList**](docs/LaunchApi.md#getHodlerAirdropProjectList) | **GET** /launch/hodler-airdrop/project-list | 查询HODLer Airdrop活动列表
-*LaunchApi* | [**hodlerAirdropOrder**](docs/LaunchApi.md#hodlerAirdropOrder) | **POST** /launch/hodler-airdrop/order | 参与HODLer Airdrop活动
-*LaunchApi* | [**getHodlerAirdropUserOrderRecords**](docs/LaunchApi.md#getHodlerAirdropUserOrderRecords) | **GET** /launch/hodler-airdrop/user-order-records | 查询HODLer Airdrop参与记录
-*LaunchApi* | [**getHodlerAirdropUserAirdropRecords**](docs/LaunchApi.md#getHodlerAirdropUserAirdropRecords) | **GET** /launch/hodler-airdrop/user-airdrop-records | 查询HODLer Airdrop空投记录
-*LaunchApi* | [**getCandyDropActivityListV4**](docs/LaunchApi.md#getCandyDropActivityListV4) | **GET** /launch/candydrop/activity-list | 查询活动列表
-*LaunchApi* | [**registerCandyDropV4**](docs/LaunchApi.md#registerCandyDropV4) | **POST** /launch/candydrop/register | 报名参与活动
-*LaunchApi* | [**getCandyDropActivityRulesV4**](docs/LaunchApi.md#getCandyDropActivityRulesV4) | **GET** /launch/candydrop/activity-rules | 查询活动规则
-*LaunchApi* | [**getCandyDropTaskProgressV4**](docs/LaunchApi.md#getCandyDropTaskProgressV4) | **GET** /launch/candydrop/task-progress | 查询任务完成进度
-*LaunchApi* | [**getCandyDropParticipationRecordsV4**](docs/LaunchApi.md#getCandyDropParticipationRecordsV4) | **GET** /launch/candydrop/participation-records | 查询参与记录
-*LaunchApi* | [**getCandyDropAirdropRecordsV4**](docs/LaunchApi.md#getCandyDropAirdropRecordsV4) | **GET** /launch/candydrop/airdrop-records | 查询空投记录
+*LaunchApi* | [**getHodlerAirdropProjectList**](docs/LaunchApi.md#getHodlerAirdropProjectList) | **GET** /launch/hodler-airdrop/project-list | Check the list of HODLer Airdrop activities
+*LaunchApi* | [**hodlerAirdropOrder**](docs/LaunchApi.md#hodlerAirdropOrder) | **POST** /launch/hodler-airdrop/order | Participate in the HODLer Airdrop event
+*LaunchApi* | [**getHodlerAirdropUserOrderRecords**](docs/LaunchApi.md#getHodlerAirdropUserOrderRecords) | **GET** /launch/hodler-airdrop/user-order-records | Check HODLer Airdrop participation records
+*LaunchApi* | [**getHodlerAirdropUserAirdropRecords**](docs/LaunchApi.md#getHodlerAirdropUserAirdropRecords) | **GET** /launch/hodler-airdrop/user-airdrop-records | Query HODLer Airdrop records
+*LaunchApi* | [**getCandyDropActivityListV4**](docs/LaunchApi.md#getCandyDropActivityListV4) | **GET** /launch/candydrop/activity-list | Query activity list
+*LaunchApi* | [**registerCandyDropV4**](docs/LaunchApi.md#registerCandyDropV4) | **POST** /launch/candydrop/register | Sign up for events
+*LaunchApi* | [**getCandyDropActivityRulesV4**](docs/LaunchApi.md#getCandyDropActivityRulesV4) | **GET** /launch/candydrop/activity-rules | Query activity rules
+*LaunchApi* | [**getCandyDropTaskProgressV4**](docs/LaunchApi.md#getCandyDropTaskProgressV4) | **GET** /launch/candydrop/task-progress | Query task completion progress
+*LaunchApi* | [**getCandyDropParticipationRecordsV4**](docs/LaunchApi.md#getCandyDropParticipationRecordsV4) | **GET** /launch/candydrop/participation-records | Query participation records
+*LaunchApi* | [**getCandyDropAirdropRecordsV4**](docs/LaunchApi.md#getCandyDropAirdropRecordsV4) | **GET** /launch/candydrop/airdrop-records | Query airdrop records
 *MarginApi* | [**listMarginAccounts**](docs/MarginApi.md#listMarginAccounts) | **GET** /margin/accounts | Margin account list
 *MarginApi* | [**listMarginAccountBook**](docs/MarginApi.md#listMarginAccountBook) | **GET** /margin/account_book | Query margin account balance change history
 *MarginApi* | [**listFundingAccounts**](docs/MarginApi.md#listFundingAccounts) | **GET** /margin/funding_accounts | Funding account list
@@ -520,8 +520,8 @@ Class | Method | HTTP request | Description
 *WalletApi* | [**getLowCapExchangeList**](docs/WalletApi.md#getLowCapExchangeList) | **GET** /wallet/getLowCapExchangeList | Retrieve the list of low-liquidity or low-cap tokens
 *WelfareApi* | [**getUserIdentity**](docs/WelfareApi.md#getUserIdentity) | **GET** /rewards/getUserIdentity | Get user identity
 *WelfareApi* | [**getBeginnerTaskList**](docs/WelfareApi.md#getBeginnerTaskList) | **GET** /rewards/getBeginnerTaskList | Get beginner task list
-*WelfareApi* | [**claimTask**](docs/WelfareApi.md#claimTask) | **POST** /rewards/claimTask | 领取任务
-*WelfareApi* | [**claimReward**](docs/WelfareApi.md#claimReward) | **POST** /rewards/claimReward | 领取任务奖励
+*WelfareApi* | [**claimTask**](docs/WelfareApi.md#claimTask) | **POST** /rewards/claimTask | Get the task
+*WelfareApi* | [**claimReward**](docs/WelfareApi.md#claimReward) | **POST** /rewards/claimReward | Receive mission rewards
 *WithdrawalApi* | [**withdraw**](docs/WithdrawalApi.md#withdraw) | **POST** /withdrawals | Withdraw
 *WithdrawalApi* | [**withdrawPushOrder**](docs/WithdrawalApi.md#withdrawPushOrder) | **POST** /withdrawals/push | UID transfer
 *WithdrawalApi* | [**cancelWithdrawal**](docs/WithdrawalApi.md#cancelWithdrawal) | **DELETE** /withdrawals/{withdrawal_id} | Cancel withdrawal with specified ID

api/assetswapApi.ts

@@ -162,7 +162,7 @@ export class AssetswapApi {
     /**
      * 将账户内若干源币种按指定数量换入目标币种侧配置，**正式下单前强烈建议先调用** `POST /asset-swap/order/preview` **且 `code=0` 后再用一致的语义提交本接口**。  **请求体不含 `ratio`** - 本接口 `OrderCreateV1Req` 仅含 `from` / `to`，且数组元素均为 `CreateParam`（**仅** `asset` + `amount`）。**请勿**在下单 JSON 中传入 `ratio`；比例字段 `ratio` 只存在于预览接口 `OrderPreviewV1Req.to`（`PreviewToParam`）。  **与预览接口的关键差异（易错点）** - 本接口 `to` 数组元素为 `CreateParam`：**`asset` + `amount`（目标侧数量，十进制字符串）**。 - 预览接口 `to` 为 **`asset` + `ratio`（比例字符串）**，**二者不可混用**：不要把预览里的 `ratio` 原样填到下单的 `amount`，也不要把下单的 `amount` 当成预览的 `ratio`。  **推荐调用顺序** 1. `GET /asset-swap/asset/list`：确认币种支持。 2. `GET /asset-swap/config`：读取 `recommend` / `recommend_v2`（如 `recommend_v2.market` 下某策略的 `schemes`，将 `scheme.name` 作为目标 `asset`、`scheme.ratio` 仅用于 **preview** 的 `to[].ratio`）。 3. `GET /asset-swap/evaluate`（可选）：参考可卖数量。 4. `POST /asset-swap/order/preview`：`from` 与 `to`（比例）构造询价。 5. 预览成功后，按产品/服务端约定将预览结果映射为下单的 `from`/`to`（**均为 amount**）再调用本接口。  **字段约定** - `from`：卖出侧，每项为 `asset` + `amount`（字符串，十进制，表示该币种卖出数量）。 - `to`：买入/目标侧，每项为 `asset` + **`amount`**（字符串，十进制，表示该目标币种侧数量；语义与预览的 `ratio` 不同）。 - 本接口仅校验上述 `amount` 的精度与范围；不满足时返回非 0 `code` 及 `message`。预览侧 `to[].ratio` 的校验规则见 `POST /asset-swap/order/preview` 文档。
      * @summary Portfolio optimization — place order
-     * @param orderCreateV1Req 下单请求体（`OrderCreateV1Req`）。**无 `ratio` 字段**；`from`/`to` 每项仅 `asset` + `amount`。`to` 使用目标侧**数量** `amount`，与 preview 中 `to` 的 **ratio**（比例）语义不同，勿混用。
+     * @param orderCreateV1Req Order request body (`OrderCreateV1Req`). **No `ratio` field**; `from`/`to` items are only `asset` + `amount`. `to` uses the target side **amount** `amount`, which is different from the **ratio** (ratio) semantics of `to` in preview, do not mix them.
      */
     public async createAssetSwapOrderV1(
         orderCreateV1Req: OrderCreateV1Req,
@@ -315,7 +315,7 @@ export class AssetswapApi {
     /**
      * 根据卖出币种数量与**目标分配比例**估算成交与费用，**不写入订单**。`code=0` 时 `data` 含预估 `order` 与 `transaction_fee`。  **与下单接口的关键差异（易错点）** - 本接口 `to` 数组元素为 `PreviewToParam`：**`asset` + `ratio`（比例，十进制字符串）**，表示目标币种在组合中的权重/占比。 - 下单接口 `POST /asset-swap/order/create` 的 `to` 为 **`asset` + `amount`（绝对数量）**，**不是** `ratio`。调用方切勿把两套字段混用。  **如何构造 `to`（ratio）** - 优先从 `GET /asset-swap/config` 的 `data.recommend_v2` 取值：按分组键（如 `market`、`faith`、`conservative`）找到策略列表中的某条 `RecommendV2Strategy`（如 `name` 为 `top2`），将其 `schemes` 映射为预览请求：   - `to[].asset` ← `scheme.name`（目标币种符号）   - `to[].ratio` ← `scheme.ratio`（与配置一致的比例字符串） - 亦可使用 `recommend` 下扁平 map（币种 → 比例字符串）自行展开为多元素 `to`（每项一个 `asset` + `ratio`）。 - 多目标时各 `ratio` 建议与前端/运营配置一致；是否需加总为 1 以服务端校验为准。  **`from`（卖出侧）** - 每项为 `asset` + `amount`（字符串，十进制），表示本次参与换出的该币种数量。币种应在 `GET /asset-swap/asset/list` 支持范围内；数量级过小或市场深度不足时可能返回非 0 `code`（如无法询价）。  **与下单的衔接** - 预览成功后，将业务允许的预览结果转换为下单所需的 **`from`/`to` 全为 amount** 的请求体再调用 create（具体映射规则以产品文档或服务端约定为准）。
      * @summary Portfolio optimization — preview
-     * @param orderPreviewV1Req 预览请求体。`to` 必须为 **ratio**；与 create 的 **amount** 语义不同。
+     * @param orderPreviewV1Req Preview the request body. `to` must be **ratio**; unlike create\'s **amount** semantics.
      */
     public async previewAssetSwapOrderV1(
         orderPreviewV1Req: OrderPreviewV1Req,