feat: 支持 hk 语言

Author: 石石

package.json

@@ -23,5 +23,6 @@
   },
   "peerDependencies": {
     "typescript": "^5"
-  }
+  },
+  "packageManager": "yarn@1.22.22+sha1.ac34549e6aa8e7ead463a7407e1c7390f61a6610"
 }

packages/docs/.vitepress/theme/utils/http-client.ts

@@ -90,10 +90,7 @@ async function generateSignature(
   const signStr = `HMAC-SHA256|${canonicalHashHex}`
 
   // 确保密钥是有效的字符串格式
-  const normalizedSecret = secret.trim()
-  if (!normalizedSecret) {
-    throw new Error('App Secret 不能为空')
-  }
+  const normalizedSecret = secret?.trim() || 'unknown'
 
   const secretKey = await crypto.subtle.importKey(
     'raw',

packages/docs/en/docs/changelog.md

@@ -4,6 +4,10 @@ title: Changelog
 slug: changelog
 sidebar_position: 7
 ---
+## 2025-06-17
+
+- Update the interface for Get Account Balance
+  - `GET /v1/asset/account` Add response field (frozen_transaction_fees)
 
 ## 2024-10-09
 

packages/docs/en/docs/getting-started.md

@@ -69,7 +69,7 @@ yarn install longport
 
 ```toml
 [dependencies]
-longport = "1.0.0"
+longport = "3.0.5"
 tokio = { version = "1", features = "rt-multi-thread" }
 ```
 
@@ -118,7 +118,7 @@ Please pay attention to protect your **Access Token** information, anyone who ge
 :::
 
 | 环境变量                    | 说明                                                               | 值范围          |
-| --------------------------- | ------------------------------------------------------------------ | --------------- |
+|-----------------------------|--------------------------------------------------------------------|-----------------|
 | `LONGPORT_APP_KEY`          | App Key get from developer center                                  |                 |
 | `LONGPORT_APP_SECRET`       | App Secret get from developer center                               |                 |
 | `LONGPORT_ACCESS_TOKEN`     | Access Token get from developer center                             |                 |

packages/docs/en/docs/qa/general.md

@@ -34,3 +34,7 @@ A: If a customer holds multiple securities accounts, such as intraday financing
 ## Q7: Are there additional charges for trading operations through LongPort OpenAPI?
 
 A: We do not charge additional fees for accessing market queries, trading, etc., via OpenAPI. For account-related fees such as trading commissions, platform fees, and market permissions, please refer to the information provided by the app and the official website.
+
+## Q8: How to disable the permission table output in the console after the SDK connects to the server?
+
+A: You can set the environment variable `LONGPORT_PRINT_QUOTE_PACKAGES` to `false`, or set `enable_print_quote_packages` to `false` when creating the `Config` object in the code to disable the permission table output in the console.

packages/docs/en/docs/quote/pull/candlestick.md

@@ -23,12 +23,13 @@ Note: This interface can only retrieve the last 1000 candlesticks. To obtain lon
 
 ### Parameters
 
-| Name        | Type   | Required | Description                                                                                              |
-| ----------- | ------ | -------- | -------------------------------------------------------------------------------------------------------- |
-| symbol      | string | Yes      | Security code, in `ticker.region` format, for example:`700.HK`                                           |
-| period      | int32  | Yes      | Candlestick period, for example: `1000`, see [Period](../objects#period---candlestick-period)            |
-| count       | int32  | Yes      | Count of cancdlestick, for example: `100`<br /><br />**Check rules:** <br />maximum count is `1000`      |
-| adjust_type | int32  | Yes      | Adjustment type, for example: `0`, see [AdjustType](../objects#adjusttype---candlestick-adjustment-type) |
+| Name          | Type   | Required | Description                                                                                              |
+|---------------|--------|----------|----------------------------------------------------------------------------------------------------------|
+| symbol        | string | Yes      | Security code, in `ticker.region` format, for example:`700.HK`                                           |
+| period        | int32  | Yes      | Candlestick period, for example: `1000`, see [Period](../objects#period---candlestick-period)            |
+| count         | int32  | Yes      | Count of cancdlestick, for example: `100`<br /><br />**Check rules:** <br />maximum count is `1000`      |
+| adjust_type   | int32  | Yes      | Adjustment type, for example: `0`, see [AdjustType](../objects#adjusttype---candlestick-adjustment-type) |
+| trade_session | int32  | No       | Trading session, 0: intraday, 100: All (pre, intraday, post, overnight)                                  |
 
 ### Protobuf
 
@@ -38,6 +39,7 @@ message SecurityCandlestickRequest {
   Period period = 2;
   int32 count = 3;
   AdjustType adjust_type = 4;
+  int32 trade_session = 5;
 }
 ```
 
@@ -48,30 +50,35 @@ message SecurityCandlestickRequest {
 # https://open.longportapp.com/docs/quote/pull/candlestick
 # Before running, please visit the "Developers to ensure that the account has the correct quotes authority.
 # If you do not have the quotes authority, you can enter "Me - My Quotes - Store" to purchase the authority through the "LongPort" mobile app.
-from longport.openapi import QuoteContext, Config, Period, AdjustType
+from longport.openapi import QuoteContext, Config, Period, AdjustType, TradeSessions
 
 config = Config.from_env()
 ctx = QuoteContext(config)
 
+# Get intraday candlestick data for 700.HK
 resp = ctx.candlesticks("700.HK", Period.Day, 10, AdjustType.NoAdjust)
 print(resp)
+
+# Get all candlestick data for 700.HK
+resp = ctx.candlesticks("700.HK", Period.Day, 10, AdjustType.NoAdjust, trade_session=TradeSessions.All)
 ```
 
 ## Response
 
 ### Response Properties
 
-| Name         | Type     | Description                           |
-| ------------ | -------- | ------------------------------------- |
-| symbol       | string   | Security code, for example: `AAPL.US` |
-| candlesticks | object[] | Candlestick data                      |
-| ∟ close      | string   | Close price                           |
-| ∟ open       | string   | Open price                            |
-| ∟ low        | string   | Low price                             |
-| ∟ high       | string   | High price                            |
-| ∟ volume     | int64    | Volume                                |
-| ∟ turnover   | string   | Turnover                              |
-| ∟ timestamp  | int64    | Timestamp                             |
+| Name            | Type     | Description                                                                  |
+|-----------------|----------|------------------------------------------------------------------------------|
+| symbol          | string   | Security code, for example: `AAPL.US`                                        |
+| candlesticks    | object[] | Candlestick data                                                             |
+| ∟ close         | string   | Close price                                                                  |
+| ∟ open          | string   | Open price                                                                   |
+| ∟ low           | string   | Low price                                                                    |
+| ∟ high          | string   | High price                                                                   |
+| ∟ volume        | int64    | Volume                                                                       |
+| ∟ turnover      | string   | Turnover                                                                     |
+| ∟ timestamp     | int64    | Timestamp                                                                    |
+| ∟ trade_session | int32    | Trade session, see [TradeSession](../objects#tradesession---trading-session) |
 
 ### Protobuf
 
@@ -150,7 +157,7 @@ message Candlestick {
 ## Error Code
 
 | Protocol Error Code | Business Error Code | Description                    | Troubleshooting Suggestions                                                    |
-| ------------------- | ------------------- | ------------------------------ | ------------------------------------------------------------------------------ |
+|---------------------|---------------------|--------------------------------|--------------------------------------------------------------------------------|
 | 3                   | 301600              | Invalid request                | Invalid request parameters or unpacking request failed                         |
 | 3                   | 301606              | Request rate limit             | Reduce the frequency of requests                                               |
 | 7                   | 301602              | Server error                   | Please try again or contact a technician to resolve the issue                  |