You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/en/docs/qa/general.md
+29-8Lines changed: 29 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,36 +5,57 @@ sidebar_position: 0
5
5
6
6
## Q1: Do I need to open a live account to call Longbridge Developers?
7
7
8
-
A: We provide a paper account, you can use it to complete the debugging of the OpenAPI quote and trading interfaces.
8
+
No. The platform provides a **paper account** — you can develop and debug quote and trading interfaces without opening a real securities account. The **paper account** supports real-time quotes for HK, US, and A-share markets, as well as basic trading functionality for HK and US stocks and ETFs, making it suitable for API integration and feature verification.
9
+
10
+
That said, the paper account differs from the live environment in areas such as order matching and cash rules. If you want to experience the platform's full capabilities, we recommend opening a live account as well.
9
11
10
12
## Q2: How to open a paper account for debugging?
11
13
12
-
A: Please visit [Development Center](https://open.longbridge.com/account/) to enable the paper account and obtain the corresponding App Key & Secret and Access Token.
14
+
Please visit [Development Center](https://open.longbridge.com/account/) to enable the paper account and obtain the corresponding App Key & Secret and Access Token.
13
15
14
16
## Q3: Are the trading permissions for simulation debugging the same as for real accounts?
15
17
16
-
A: Quote is the same, trading might be different.
18
+
Quote is the same, trading might be different.
17
19
18
20
Paper accounts and live accounts share the same App Key & Secret, but have different Access Tokens. Quote permissions are associated with the App Key & Secret, while trading permissions are associated with the Access Token. Therefore, under paper accounts and live accounts, quote permissions are the same, but trading permissions are associated with the securities account and may differ.
19
21
20
22
## Q4: Which markets and types of securities are supported for quote and trading in paper account debugging?
21
23
22
-
A: Market: Supports real-time market data for Hong Kong stocks, US stocks, and A-share markets. For advanced market data such as full US market data and Hong Kong Level2 data, they can be purchased through the online market store and accessed via OpenAPI.
24
+
Market: Supports real-time market data for Hong Kong stocks, US stocks, and A-share markets. For advanced market data such as full US market data and Hong Kong Level2 data, they can be purchased through the online market store and accessed via OpenAPI.
23
25
24
26
Trading: Supports trading of Hong Kong and US stocks, ETFs, and Hong Kong warrant trading. Short selling is supported for US stocks. OTC stocks, pre & post market trading, and options trading are not supported in paper accounts.
25
27
26
28
## Q5: Interface call frequency limits
27
29
28
-
A: Please visit [Rate Limit](docs/#rate-limit) for specific descriptions.
30
+
Please visit [Rate Limit](docs/#rate-limit) for specific descriptions.
29
31
30
32
## Q6: How are interface call frequency limits applied in the case of multiple accounts?
31
33
32
-
A: If a customer holds multiple securities accounts, such as intraday financing or other sub-accounts, the trading interface call frequency limits are calculated and controlled based on different securities accounts, while quote interface calls are not affected by multiple accounts and are uniformly limited.
34
+
If a customer holds multiple securities accounts, such as intraday financing or other sub-accounts, the trading interface call frequency limits are calculated and controlled based on different securities accounts, while quote interface calls are not affected by multiple accounts and are uniformly limited.
33
35
34
36
## Q7: Are there additional charges for trading operations through Longbridge Developers?
35
37
36
-
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.
38
+
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.
37
39
38
40
## Q8: How to disable the permission table output in the console after the SDK connects to the server?
39
41
40
-
A: You can set the environment variable `LONGBRIDGE_PRINT_QUOTE_PACKAGES` to `false` (or legacy `LONGPORT_PRINT_QUOTE_PACKAGES`), 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.
42
+
You can set the environment variable `LONGBRIDGE_PRINT_QUOTE_PACKAGES` to `false` (or legacy `LONGPORT_PRINT_QUOTE_PACKAGES`), 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.
43
+
44
+
## Q9: I don't know how to code. How can I access stock data from the Longbridge Developers platform?
45
+
46
+
The platform offers two ways to access stock data without writing any code:
47
+
48
+
**CLI (Command-line Tool)**
49
+
50
+
Install the [Longbridge Terminal CLI](/docs/cli) and query market data with simple commands — no programming required:
51
+
52
+
```bash
53
+
longbridge quote AAPL.US TSLA.US
54
+
longbridge static NVDA.US
55
+
```
56
+
57
+
**MCP (AI Tool Integration)**
58
+
59
+
If you use AI tools like Claude, Cursor, or ChatGPT, connect the [Longbridge MCP service](/mcp). Once configured, simply ask in plain language and the AI will query market data on your behalf.
Copy file name to clipboardExpand all lines: docs/en/docs/qa/quote.md
+7-16Lines changed: 7 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,15 +7,15 @@ sidebar_position: 1
7
7
8
8
## Q1: How to calculate the subscription quote, is it one or more subscriptions if I both subscribe depth and broker with the same security?
9
9
10
-
A: The subscription quote is only calculated according to the security dimension, only one subscription will be calculted if you subscribe muilty quote type with one security.
10
+
The subscription quote is only calculated according to the security dimension, only one subscription will be calculted if you subscribe muilty quote type with one security.
11
11
12
12
## Q2: What is the specific limit logic for request frequency limit?
13
13
14
-
A: Use the token bucket to limit request and control the request rate. No more than 10 calls in 1 second, and no more than 5 concurrent requests.
14
+
Use the token bucket to limit request and control the request rate. No more than 10 calls in 1 second, and no more than 5 concurrent requests.
15
15
16
16
## Q3: What is the available subscribing securities and corresponding symbol formats?
17
17
18
-
A: The security code uses the `ticker.region` format, `ticker` represents the code. Aavailable subscribing securities are as followes.
18
+
The security code uses the `ticker.region` format, `ticker` represents the code — for example, Tesla is `TSLA.US`. Available subscribing securities are as follows.
19
19
20
20
<table>
21
21
<tr>
@@ -74,32 +74,25 @@ A: The security code uses the `ticker.region` format, `ticker` represents the co
74
74
</tr>
75
75
</table>
76
76
77
-
You can also use Longbridge App to find the symbol of security
## Q4: What is the quote authority of OpenAPI? How to buy quote cards?
81
78
82
-
A:
83
-
84
79
- Quote Authority
85
80
In accordance with the rules of the exchange, the authority of OpenAPI are independent, and are not shared with App, PC, or Web permissions. For example, the Hong Kong stock Level 2 authority you have on the App cannot be used on the OpenAPI side. Longbridge also presents basic market rights to OpenAPI users. If you need a higher-level market, you can activate the high-level quote authority by purchasing a market card through on-line Quote Store of brokers or Longbridge.
86
81
- How to buy quote cards
87
82
Longbridge users can choose the market cards they want to buy through the "Quote Store" in the Longbridge App.
88
83
89
84
## Q5: Quote Change By Date Time
90
85
91
-
A:
92
-
93
86
- US Market: 09:20:00 EDT/EST
94
87
- HK Market: 08:50:00 CST
95
88
- CN Market: 09:00:00 CST
96
89
- SG Market: 08:20:00 CST
97
90
98
91
## Q6: How to enable Overnight quote
99
92
100
-
A:
101
-
102
-
-The night market quotation needs to be actively enabled by filling in the key `need_over_night_quote`, value `true` in the `metadata` field of the authentication interface.
93
+
-**Overnight quote data is not available by default.** You need to purchase the **"LV1 Real-time Quote (OpenAPI)"** quote card in the "Quote Store" of the Longbridge mobile app to access overnight data.
94
+
- Overnight quotes are currently **only available for US stocks**. Hong Kong stocks do not support overnight quotes.
95
+
-After obtaining the overnight quote permission, you still need to actively enable it by filling in the key `need_over_night_quote`, value `true` in the `metadata` field of the authentication interface.
103
96
104
97
```protobuf
105
98
message AuthRequest {
@@ -115,9 +108,7 @@ message ReconnectRequest {
115
108
116
109
- After turning on the night trading quotations, both the pull and push interfaces will be able to obtain the night trading quotations during the night trading period.
Copy file name to clipboardExpand all lines: docs/en/docs/qa/trade.md
+13-8Lines changed: 13 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,34 +5,39 @@ sidebar_position: 2
5
5
6
6
## Q1: What types of orders are supported?
7
7
8
-
A: Both paper and live accounts support regular Limit orders, Market orders, and Conditional orders (such as Buy if touched, Sell if touched, etc.), but do not currently support Attached orders and Grid orders.
8
+
Both paper and live accounts support regular Limit orders, Market orders, and Conditional orders (such as Buy if touched, Sell if touched, etc.), but do not currently support Attached orders and Grid orders.
9
9
10
10
## Q2: What are the trading hours for paper accounts?
11
11
12
-
A: Trading hours for paper accounts for Hong Kong stocks are the same as in the real environment. Trading pre & post market is not supported for U.S. stocks in the paper environment, only regular trading hours are supported.
12
+
Trading hours for paper accounts for Hong Kong stocks are the same as in the real environment. Trading pre & post market is not supported for U.S. stocks in the paper environment, only regular trading hours are supported.
13
13
14
14
## Q3: How can I trade overnight sessions for U.S. stocks?
15
15
16
-
A: To place orders for overnight trading, you can specify overnight trading by passing the OVERNIGHT value to the `outside_rth` parameter in the order placement API.
16
+
To place orders for overnight trading, you can specify overnight trading by passing the OVERNIGHT value to the `outside_rth` parameter in the order placement API.
17
17
18
18
## Q4: What are the trading rules for paper accounts?
19
19
20
-
A: Paper accounts currently support trading in Hong Kong and U.S. stocks, ETFs, and Hong Kong warrants. Short selling is supported for U.S. stocks. However, OTC trading, pre & post market trading, and options trading are not supported in paper accounts.
20
+
Paper accounts currently support trading in Hong Kong and U.S. stocks, ETFs, and Hong Kong warrants. Short selling is supported for U.S. stocks. However, OTC trading, pre & post market trading, and options trading are not supported in paper accounts.
21
21
22
22
Trades in the paper environment are matched based on the bid-ask spread from the real market. If the buy order price is higher than or equal to the ask price and the sell order price is lower than or equal to the bid price, a trade can be executed. Market orders are matched by default.
23
23
24
24
## Q5: How can I reset the funds in my paper account?
25
25
26
-
A: Manual resetting of demo funds is not supported at the moment. If needed, please contact your customer service or account manager for offline processing.
26
+
Manual resetting of demo funds is not supported at the moment. If needed, please contact your customer service or account manager for offline processing.
27
27
28
28
## Q6: After placing orders through the OpenAPI, how can I view them?
29
29
30
-
A: After placing orders through the OpenAPI, you can check the real-time status of orders by calling the order inquiry API. Alternatively, you can receive order update information through WebSocket push. You can also view orders and their statuses directly through the App/PC or other terminal products.
30
+
After placing orders via the OpenAPI, you can view them through any of the following:
31
+
32
+
-**Order inquiry API**: Call the API to query real-time order status
33
+
-**WebSocket push**: Subscribe to trade push events to receive order updates in real time
34
+
-**CLI**: Use the [Longbridge Terminal CLI](/docs/cli) to query from the command line, e.g. `longbridge orders`
35
+
-**App / PC**: View orders and their statuses directly in the terminal products
31
36
32
37
## Q7: How can I know if my account has sufficient funds for trading?
33
38
34
-
A: You can use the trading API `/v1/trade/estimate/buy_limit` to estimate the available cash & margin buying power, and short selling quantity in your account. Due to the complexity of risk control requirements, it's not recommended to calculate the tradable quantity manually.
39
+
You can use the trading API `/v1/trade/estimate/buy_limit` to estimate the available cash & margin buying power, and short selling quantity in your account. Due to the complexity of risk control requirements, it's not recommended to calculate the tradable quantity manually.
35
40
36
41
## Q8: What does it mean when the order placement API returns "User authentication failed"?
37
42
38
-
A: This error usually indicates that the user does not have permission for the corresponding trading operation, such as options trading or short selling U.S. stocks. You can complete the permission opening process guided by the order placement in the app. After obtaining the necessary permissions, you can continue trading or performing other operations through OpenAPI.
43
+
This error usually indicates that the user does not have permission for the corresponding trading operation, such as options trading or short selling U.S. stocks. You can complete the permission opening process guided by the order placement in the app. After obtaining the necessary permissions, you can continue trading or performing other operations through OpenAPI.
0 commit comments