From fb0ae3275d85ebe797ca8eef32dd748429a21607 Mon Sep 17 00:00:00 2001 From: Endless Agent Date: Mon, 29 Jun 2026 04:25:56 +0000 Subject: [PATCH] =?UTF-8?q?feat(dev):=20=E6=A3=80=E6=9F=A5=E6=95=B4?= =?UTF-8?q?=E4=B8=AA=E9=A1=B9=E7=9B=AE=E6=9B=B4=E6=96=B0=20Pricing=20?= =?UTF-8?q?=E5=85=B3=E4=BA=8E=E8=A1=8C=E6=83=85=E6=8E=88=E6=9D=83=E7=9A=84?= =?UTF-8?q?=E8=A7=84=E5=88=99=E3=80=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 之前注册就送的是 Nasdaq Basic，而我们现在调整为注册就用 US LV1 了，我们现在不需要写 Nasdaq Basic 了。US Generated by Endless task #29. Co-authored-by: Huacnlee Li Huashun --- docs/.vitepress/theme/components/Pricing.vue | 83 +++++-------------- docs/en/docs/getting-started.md | 4 +- docs/en/docs/qa/quote.md | 2 +- docs/en/docs/quote/overview.md | 2 +- docs/en/docs/quote/stocks/candlestick.md | 2 +- .../docs/quote/stocks/history-candlestick.md | 2 +- docs/en/docs/quote/stocks/quote.md | 2 +- docs/zh-CN/docs/getting-started.md | 2 +- docs/zh-CN/docs/qa/quote.md | 2 +- docs/zh-CN/docs/quote/overview.md | 2 +- docs/zh-CN/docs/quote/stocks/candlestick.md | 2 +- .../docs/quote/stocks/history-candlestick.md | 2 +- docs/zh-CN/docs/quote/stocks/quote.md | 2 +- docs/zh-HK/docs/getting-started.md | 2 +- docs/zh-HK/docs/qa/quote.md | 2 +- docs/zh-HK/docs/quote/overview.md | 2 +- docs/zh-HK/docs/quote/stocks/candlestick.md | 2 +- .../docs/quote/stocks/history-candlestick.md | 2 +- docs/zh-HK/docs/quote/stocks/quote.md | 2 +- quote-permissions.yaml | 42 +++++----- 20 files changed, 62 insertions(+), 101 deletions(-) diff --git a/docs/.vitepress/theme/components/Pricing.vue b/docs/.vitepress/theme/components/Pricing.vue index bd7c7554..b8e34b7b 100644 --- a/docs/.vitepress/theme/components/Pricing.vue +++ b/docs/.vitepress/theme/components/Pricing.vue @@ -23,7 +23,7 @@ const LOCALE = { }, { title: 'Basic Market Data', - desc: 'Nasdaq Basic, HK Level 1, CN Level 1 — bundled with your account. View live market data to see what\'s included.', + desc: 'US LV1, HK Level 1, CN Level 1 — bundled with your account. View live market data to see what\'s included.', }, { title: 'Push & Pull Data', desc: 'WebSocket real-time push and REST API pull — unlimited.' }, ], @@ -46,14 +46,6 @@ const LOCALE = { subscribe: 'Subscribe', was: 'Was', items: [ - { - market: 'US Market', - name: 'US LV1 Real-time', - badge: '', - tagline: 'Nasdaq LV1 real-time quotes with best bid/ask, including pre / post-market.', - coverage: 'US market only', - feats: ['Nasdaq LV1 real-time quotes', 'Pre / post-market (overnight)', 'WebSocket real-time push'], - }, { market: 'HK Market', name: 'HK LV2 Advanced', @@ -76,8 +68,7 @@ const LOCALE = { eyebrow: 'FEATURE COMPARISON', title: "What's included in each plan.", plans: [ - { label: 'Nasdaq Basic', tag: 'Free', color: 'var(--lb-up)' }, - { label: 'US LV1', tag: 'Paid', color: 'var(--lb-market-us)' }, + { label: 'US LV1', tag: 'Free', color: 'var(--lb-market-us)' }, { label: 'OPRA', tag: 'Paid', color: 'var(--lb-ai-mention)' }, { label: 'HK LV1', tag: 'Free (promo)', color: 'var(--lb-up)' }, { label: 'HK LV2', tag: 'Paid', color: 'var(--lb-market-hk)' }, @@ -109,7 +100,7 @@ const LOCALE = { }, { q: 'Do I need a subscription to test the API?', - a: 'No. Trading, account, and fundamentals APIs are free. You can also use Basic Market Data tiers (Nasdaq Basic, HK LV1, CN LV1) for free.', + a: 'No. Trading, account, and fundamentals APIs are free. You can also use Basic Market Data tiers (US LV1, HK LV1, CN LV1) for free.', }, { q: 'Can I cancel anytime?', @@ -143,7 +134,7 @@ const LOCALE = { { title: '交易与账户 API', desc: '基本面、分析、资讯、资产、订单——所有核心 API 均免费。' }, { title: '基础行情数据', - desc: '纳斯达克基础行情、港股一档、A 股一档——随账户附赠。查看实时行情了解包含内容。', + desc: '美股 LV1、港股一档、A 股一档——随账户附赠。查看实时行情了解包含内容。', }, { title: '推送与拉取数据', desc: 'WebSocket 实时推送与 REST API 拉取——无限制。' }, ], @@ -166,14 +157,6 @@ const LOCALE = { subscribe: '立即订阅', was: '原价', items: [ - { - market: '美股市场', - name: 'US LV1 实时行情', - badge: '', - tagline: '纳斯达克 LV1 实时行情，含最优买卖价及盘前/盘后数据。', - coverage: '仅限美股市场', - feats: ['纳斯达克 LV1 实时行情', '盘前/盘后（隔夜）', 'WebSocket 实时推送'], - }, { market: '港股市场', name: 'HK LV2 高级行情', @@ -196,8 +179,7 @@ const LOCALE = { eyebrow: '功能对比', title: '各方案功能一览', plans: [ - { label: 'Nasdaq Basic', tag: '免费', color: 'var(--lb-up)' }, - { label: '美股 LV1', tag: '付费', color: 'var(--lb-market-us)' }, + { label: '美股 LV1', tag: '免费', color: 'var(--lb-market-us)' }, { label: 'OPRA', tag: '付费', color: 'var(--lb-ai-mention)' }, { label: '港股 LV1', tag: '推广免费', color: 'var(--lb-up)' }, { label: '港股 LV2', tag: '付费', color: 'var(--lb-market-hk)' }, @@ -229,7 +211,7 @@ const LOCALE = { }, { q: '测试 API 需要订阅吗？', - a: '不需要。交易、账户和基本面 API 均免费。您也可以免费使用基础行情（纳斯达克基础、港股 LV1、A 股 LV1）。', + a: '不需要。交易、账户和基本面 API 均免费。您也可以免费使用基础行情（美股 LV1、港股 LV1、A 股 LV1）。', }, { q: '可以随时取消吗？', a: '可以。在下一个计费周期前随时取消。行情权限在已付费周期结束前持续有效。' }, { @@ -257,7 +239,7 @@ const LOCALE = { { title: '交易與帳戶 API', desc: '基本面、分析、資訊、資產、訂單——所有核心 API 均免費。' }, { title: '基礎行情數據', - desc: '納斯達克基礎行情、港股一檔、A 股一檔——隨帳戶附贈。查看即時行情了解包含內容。', + desc: '美股 LV1、港股一檔、A 股一檔——隨帳戶附贈。查看即時行情了解包含內容。', }, { title: '推送與拉取數據', desc: 'WebSocket 即時推送與 REST API 拉取——無限制。' }, ], @@ -280,14 +262,6 @@ const LOCALE = { subscribe: '立即訂閱', was: '原價', items: [ - { - market: '美股市場', - name: 'US LV1 即時行情', - badge: '', - tagline: '納斯達克 LV1 即時行情，含最優買賣價及盤前/盤後數據。', - coverage: '僅限美股市場', - feats: ['納斯達克 LV1 即時行情', '盤前/盤後（隔夜）', 'WebSocket 即時推送'], - }, { market: '港股市場', name: 'HK LV2 高級行情', @@ -310,8 +284,7 @@ const LOCALE = { eyebrow: '功能對比', title: '各方案功能一覽。', plans: [ - { label: 'Nasdaq Basic', tag: '免費', color: 'var(--lb-up)' }, - { label: '美股 LV1', tag: '付費', color: 'var(--lb-market-us)' }, + { label: '美股 LV1', tag: '免費', color: 'var(--lb-market-us)' }, { label: 'OPRA', tag: '付費', color: 'var(--lb-ai-mention)' }, { label: '港股 LV1', tag: '推廣免費', color: 'var(--lb-up)' }, { label: '港股 LV2', tag: '付費', color: 'var(--lb-market-hk)' }, @@ -343,7 +316,7 @@ const LOCALE = { }, { q: '測試 API 需要訂閱嗎？', - a: '不需要。交易、帳戶和基本面 API 均免費。您也可以免費使用基礎行情（納斯達克基礎、港股 LV1、A 股 LV1）。', + a: '不需要。交易、帳戶和基本面 API 均免費。您也可以免費使用基礎行情（美股 LV1、港股 LV1、A 股 LV1）。', }, { q: '可以隨時取消嗎？', a: '可以。在下一個計費週期前隨時取消。行情權限在已付費週期結束前持續有效。' }, { @@ -367,18 +340,6 @@ interface PlanCycle { } const PAID_PLANS = [ - { - id: 'us-lv1', - currency: 'HK$', - color: 'var(--lb-market-us)', - hasBadge: false, - cycles: { - auto: { price: 558, discount: 22 }, - monthly: { price: 718 }, - quarterly: { price: 1748, discount: 19, approxMo: 583 }, - annual: { price: 5788, discount: 33, approxMo: 482 }, - } as Record, - }, { id: 'hk-lv2', currency: 'HK$', @@ -414,19 +375,19 @@ const FREE_ICONS = [ const BILLING_CYCLES = [{ key: 'auto' }, { key: 'monthly' }, { key: 'quarterly' }, { key: 'annual', badge: true }] const MATRIX_ROW_DATA = [ - [1, 1, 1, 1, 1, 1], - [1, 1, 1, 1, 1, 1], - [1, 1, 1, 1, 1, 1], - [1, 1, 0, 0, 0, 0], - [1, 1, 0, 0, 0, 0], - [1, 1, 0, 0, 0, 0], - [0, 0, 1, 0, 0, 0], - [0, 0, 0, 1, 1, 0], - [0, 0, 0, 1, 1, 0], - [0, 0, 0, 0, 1, 0], - [0, 0, 0, 0, 1, 0], - [0, 0, 0, 0, 1, 0], - [0, 0, 0, 0, 0, 1], + [1, 1, 1, 1, 1], + [1, 1, 1, 1, 1], + [1, 1, 1, 1, 1], + [1, 0, 0, 0, 0], + [1, 0, 0, 0, 0], + [1, 0, 0, 0, 0], + [0, 1, 0, 0, 0], + [0, 0, 1, 1, 0], + [0, 0, 1, 1, 0], + [0, 0, 0, 1, 0], + [0, 0, 0, 1, 0], + [0, 0, 0, 1, 0], + [0, 0, 0, 0, 1], ] const cycle = ref('auto') diff --git a/docs/en/docs/getting-started.md b/docs/en/docs/getting-started.md index 4622649d..28f5881a 100644 --- a/docs/en/docs/getting-started.md +++ b/docs/en/docs/getting-started.md @@ -424,7 +424,7 @@ Please pay attention to protect your **Access Token** information, anyone who ge | `LONGBRIDGE_QUOTE_WS_URL` | Quote websocket endpoint url (Default: `wss://openapi-quote.longbridge.com/v2`) | | `LONGBRIDGE_TRADE_WS_URL` | Trade websocket endpoint url (Default: `wss://openapi-trade.longbridge.com/v2`) | | `LONGBRIDGE_REGION` | Override API region; SDK auto-selects by network. Set to `cn` or `hk` if incorrect. | -| `LONGBRIDGE_ENABLE_OVERNIGHT` | Enable overnight quote, `true` or `false` (Default: `false`). Overnight quotes are included free in Nasdaq Basic. US stocks only. | +| `LONGBRIDGE_ENABLE_OVERNIGHT` | Enable overnight quote, `true` or `false` (Default: `false`). Overnight quotes are included free in US LV1. US stocks only. | | `LONGBRIDGE_PUSH_CANDLESTICK_MODE` | `realtime` or `confirmed` (Default: `realtime`) | | `LONGBRIDGE_PRINT_QUOTE_PACKAGES` | Print quote packages when connected, `true` or `false` (Default: `true`) | | `LONGBRIDGE_LOG_PATH` | Set the path of the log files (Default: no logs) | @@ -915,7 +915,7 @@ After running, the output is as follows: To subscribe to market data, please check the [Developer Center](https://open.longbridge.com/account) - "Quote authority" is correct - HK Market - BMP basic quotation is unable to subscribe with WebSocket as it has no real-time quote push. -- US Market - Nasdaq Basic (Only OpenAPI). +- US Market - US LV1 (Only OpenAPI). Before running, visit the [Developer Center](https://open.longbridge.com/dashboard) and ensure that the account has the correct quote level. diff --git a/docs/en/docs/qa/quote.md b/docs/en/docs/qa/quote.md index a8dc957c..ea585656 100644 --- a/docs/en/docs/qa/quote.md +++ b/docs/en/docs/qa/quote.md @@ -90,7 +90,7 @@ The security code uses the `ticker.region` format, `ticker` represents the code ## Q6: How to enable Overnight quote -- **Overnight quotes are included free in Nasdaq Basic.** No quote card purchase is required. +- **Overnight quotes are included free in US LV1.** No quote card purchase is required. - Overnight quotes are currently **only available for US stocks**. Hong Kong stocks do not support overnight quotes. - 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. diff --git a/docs/en/docs/quote/overview.md b/docs/en/docs/quote/overview.md index d7dbc432..1f2bf5b0 100644 --- a/docs/en/docs/quote/overview.md +++ b/docs/en/docs/quote/overview.md @@ -150,6 +150,6 @@ All Quote APIs require OpenAPI quote permissions. These are **separate from App/ | **Basic** | LV1 US/CN real-time; HK BMP (~15 min delay, no push) | Included with OpenAPI activation | | **LV1 Real-time** (HK) | HK real-time quotes + WebSocket push support | Purchase "LV1 Real-time Quotes (OpenAPI)" via Quote Store | | **LV2 Subscription** | Level 2 order book (depth), HK broker queue | Purchase LV2 subscription via Quote Store | -| **Overnight** (US) | US pre/post-market extended-hours data | Included free in Nasdaq Basic; set `LONGBRIDGE_ENABLE_OVERNIGHT=true` | +| **Overnight** (US) | US pre/post-market extended-hours data | Included free in US LV1; set `LONGBRIDGE_ENABLE_OVERNIGHT=true` | Check your current permissions at [Developer Center](https://open.longbridge.com/dashboard). Purchase quote cards via **Longbridge App → My → My Quotes → Quote Store**. diff --git a/docs/en/docs/quote/stocks/candlestick.md b/docs/en/docs/quote/stocks/candlestick.md index 7de5bdff..811c7adf 100644 --- a/docs/en/docs/quote/stocks/candlestick.md +++ b/docs/en/docs/quote/stocks/candlestick.md @@ -40,7 +40,7 @@ longbridge kline NVDA.US --period day --count 20 | period | int32 | Yes | Candlestick period, for example: `1000`, see [Period](../objects#period---candlestick-period) | | count | int32 | Yes | Count of cancdlestick, for example: `100`

**Check rules:**
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)

Note: Overnight data is included free in Nasdaq Basic, US stocks only; enable the `enable_overnight` parameter to receive it. | +| trade_session | int32 | No | Trading session, 0: intraday, 100: All (pre, intraday, post, overnight)

Note: Overnight data is included free in US LV1, US stocks only; enable the `enable_overnight` parameter to receive it. | ### Protobuf diff --git a/docs/en/docs/quote/stocks/history-candlestick.md b/docs/en/docs/quote/stocks/history-candlestick.md index a35335d6..6d3b8312 100644 --- a/docs/en/docs/quote/stocks/history-candlestick.md +++ b/docs/en/docs/quote/stocks/history-candlestick.md @@ -44,7 +44,7 @@ longbridge kline history NVDA.US --start 2025-01-01 --end 2025-12-31 | ∟ date | string | No | Query date, in `YYYYMMDD` format, for example: 20231016. Default value: latest trading day of the underlying market. | | ∟ minute | string | No | Query time, in `HHMM` format, for example: 09:35, only valid when querying minute-level data | | ∟ count | int32 | No | Count of cancdlestick, valid range:`[1,1000]`. Default value: `10` | -| trade_session | int32 | No | Trading session, 0: intraday, 100: All (pre, intraday, post, overnight)

Note: Overnight data is included free in Nasdaq Basic, US stocks only; enable the `enable_overnight` parameter to receive it. | +| trade_session | int32 | No | Trading session, 0: intraday, 100: All (pre, intraday, post, overnight)

Note: Overnight data is included free in US LV1, US stocks only; enable the `enable_overnight` parameter to receive it. | ### Protobuf diff --git a/docs/en/docs/quote/stocks/quote.md b/docs/en/docs/quote/stocks/quote.md index 24bd03f1..9ed459b9 100644 --- a/docs/en/docs/quote/stocks/quote.md +++ b/docs/en/docs/quote/stocks/quote.md @@ -268,7 +268,7 @@ func main() { | ∟∟ high | string | High | | ∟∟ low | string | Low | | ∟∟ prev_close | string | Close of the last trade session | -| ∟ over_night_quote | object | Quote of US overnight market

Note: Enable the `enable_overnight` parameter to receive it; returns null otherwise. (Overnight quotes are included free in Nasdaq Basic, US stocks only.) | +| ∟ over_night_quote | object | Quote of US overnight market

Note: Enable the `enable_overnight` parameter to receive it; returns null otherwise. (Overnight quotes are included free in US LV1, US stocks only.) | | ∟∟ last_done | string | Latest price | | ∟∟ timestamp | int64 | Time of latest price | | ∟∟ volume | int64 | Volume | diff --git a/docs/zh-CN/docs/getting-started.md b/docs/zh-CN/docs/getting-started.md index cff933de..484a3ef1 100644 --- a/docs/zh-CN/docs/getting-started.md +++ b/docs/zh-CN/docs/getting-started.md @@ -437,7 +437,7 @@ OAuth Token 应安全存储在应用程序中（如加密文件、安全密钥 | `LONGBRIDGE_QUOTE_WS_URL` | 行情 WebSocket 地址（默认：`wss://openapi-quote.longbridge.com/v2`） | | `LONGBRIDGE_TRADE_WS_URL` | 交易 WebSocket 地址（默认：`wss://openapi-trade.longbridge.com/v2`） | | `LONGBRIDGE_REGION` | 覆盖接入点；SDK 会按网络自动选择，若判断不正确可设置（如 `cn`、`hk`） | -| `LONGBRIDGE_ENABLE_OVERNIGHT` | 是否开启夜盘行情，`true` 或 `false`（默认：`false`）；夜盘行情已包含在 Nasdaq Basic 中免费提供，仅支持美股 | +| `LONGBRIDGE_ENABLE_OVERNIGHT` | 是否开启夜盘行情，`true` 或 `false`（默认：`false`）；夜盘行情已包含在 US LV1 中免费提供，仅支持美股 | | `LONGBRIDGE_PUSH_CANDLESTICK_MODE` | K 线推送模式，`realtime` 或 `confirmed`（默认：`realtime`） | | `LONGBRIDGE_PRINT_QUOTE_PACKAGES` | 连接时是否打印行情包，`true` 或 `false`（默认：`true`） | | `LONGBRIDGE_LOG_PATH` | 日志文件路径（默认：不写日志） | diff --git a/docs/zh-CN/docs/qa/quote.md b/docs/zh-CN/docs/qa/quote.md index 1efe60c4..b0ef2523 100644 --- a/docs/zh-CN/docs/qa/quote.md +++ b/docs/zh-CN/docs/qa/quote.md @@ -90,7 +90,7 @@ sidebar_position: 1 ## Q6：如何获取夜盘行情 -- **夜盘行情已包含在 Nasdaq Basic 中免费提供**，无需购买行情卡。 +- **夜盘行情已包含在 US LV1 中免费提供**，无需购买行情卡。 - 目前夜盘行情**仅支持美股**，港股暂不支持夜盘。 - 开通夜盘权限后，还需要主动开启，方式为在鉴权接口的 `metadata` 字段填充 key `need_over_night_quote`, value `true`。 diff --git a/docs/zh-CN/docs/quote/overview.md b/docs/zh-CN/docs/quote/overview.md index 70f2d250..d977300d 100644 --- a/docs/zh-CN/docs/quote/overview.md +++ b/docs/zh-CN/docs/quote/overview.md @@ -151,6 +151,6 @@ slug: overview | **基础行情** | 美/A 股实时报价；港股 BMP（约 15 分钟延迟，不支持推送） | 开通 OpenAPI 后自动获得 | | **LV1 实时**（港股） | 港股实时报价 + WebSocket 推送支持 | 通过行情商城购买「LV1 实时行情 (OpenAPI)」 | | **LV2 订阅** | Level 2 买卖盘（depth）、港股经纪商队列（brokers） | 通过行情商城购买 LV2 订阅卡 | -| **盘前盘后**（美股） | 美股盘前/盘后延伸时段数据 | 已包含在 Nasdaq Basic 中免费提供，设置 `LONGBRIDGE_ENABLE_OVERNIGHT=true` 即可 | +| **盘前盘后**（美股） | 美股盘前/盘后延伸时段数据 | 已包含在 US LV1 中免费提供，设置 `LONGBRIDGE_ENABLE_OVERNIGHT=true` 即可 | 查看当前权限：[开发者中心](https://open.longbridge.com/dashboard)。购买行情卡：**Longbridge App → 我的 → 我的行情 → 行情商城**。 diff --git a/docs/zh-CN/docs/quote/stocks/candlestick.md b/docs/zh-CN/docs/quote/stocks/candlestick.md index 00aa2a8d..4e22c344 100644 --- a/docs/zh-CN/docs/quote/stocks/candlestick.md +++ b/docs/zh-CN/docs/quote/stocks/candlestick.md @@ -40,7 +40,7 @@ longbridge kline NVDA.US --period day --count 20 | period | int32 | 是 | k 线周期，例如：`1000`，详见 [Period](../objects#period---k-线周期) | | count | int32 | 是 | 数据数量，例如：`100`

**校验规则：**
请求数量最大为 `1000` | | adjust_type | int32 | 是 | 复权类型，例如：`0`，详见 [AdjustType](../objects#adjusttype---k-线复权类型) | -| trade_session | int32 | 否 | 交易时段，0: 盘中，100: 所有（盘前，盘中，盘后，夜盘）

注意：夜盘数据已包含在 Nasdaq Basic 中免费提供，仅支持美股；开启 `enable_overnight` 参数即可获取 | +| trade_session | int32 | 否 | 交易时段，0: 盘中，100: 所有（盘前，盘中，盘后，夜盘）

注意：夜盘数据已包含在 US LV1 中免费提供，仅支持美股；开启 `enable_overnight` 参数即可获取 | ### Protobuf diff --git a/docs/zh-CN/docs/quote/stocks/history-candlestick.md b/docs/zh-CN/docs/quote/stocks/history-candlestick.md index 54ed5d3e..9c080945 100644 --- a/docs/zh-CN/docs/quote/stocks/history-candlestick.md +++ b/docs/zh-CN/docs/quote/stocks/history-candlestick.md @@ -44,7 +44,7 @@ longbridge kline history NVDA.US --start 2025-01-01 --end 2025-12-31 | ∟ date | string | 否 | 查询日期，格式为 `YYYYMMDD`，例如：20231016，为空时使用标的所在市场的最新交易日 | | ∟ minute | string | 否 | 查询时间，格式为 `HHMM`，例如：09:35，仅在查询分钟级别 K 线时有效 | | ∟ count | int32 | 否 | 查询数量，填写范围 `[1,1000]`，为空时默认查询 `10` 条 | -| trade_session | int32 | 否 | 交易时段，0: 盘中，100: 所有延长时段（盘前，盘中，盘后，夜盘）

注意：夜盘数据已包含在 Nasdaq Basic 中免费提供，仅支持美股；开启 `enable_overnight` 参数即可获取 | +| trade_session | int32 | 否 | 交易时段，0: 盘中，100: 所有延长时段（盘前，盘中，盘后，夜盘）

注意：夜盘数据已包含在 US LV1 中免费提供，仅支持美股；开启 `enable_overnight` 参数即可获取 | ### Protobuf diff --git a/docs/zh-CN/docs/quote/stocks/quote.md b/docs/zh-CN/docs/quote/stocks/quote.md index ad9388cf..2d5c804b 100644 --- a/docs/zh-CN/docs/quote/stocks/quote.md +++ b/docs/zh-CN/docs/quote/stocks/quote.md @@ -268,7 +268,7 @@ func main() { | ∟∟ high | string | 最高价 | | ∟∟ low | string | 最低价 | | ∟∟ prev_close | string | 上一个交易阶段的收盘价 | -| ∟ overnight_quote | object | 美股夜盘交易行情

注意：需开启 `enable_overnight` 参数获取，否则会返回 null（夜盘行情已包含在 Nasdaq Basic 中免费提供，仅支持美股） | +| ∟ overnight_quote | object | 美股夜盘交易行情

注意：需开启 `enable_overnight` 参数获取，否则会返回 null（夜盘行情已包含在 US LV1 中免费提供，仅支持美股） | | ∟∟ last_done | string | 最新价 | | ∟∟ timestamp | int64 | 最新成交的时间戳 | | ∟∟ volume | int64 | 成交量 | diff --git a/docs/zh-HK/docs/getting-started.md b/docs/zh-HK/docs/getting-started.md index 7fc40b76..a3339377 100644 --- a/docs/zh-HK/docs/getting-started.md +++ b/docs/zh-HK/docs/getting-started.md @@ -426,7 +426,7 @@ OAuth Token 應安全儲存在應用程式中（如加密檔案、安全金鑰 | `LONGBRIDGE_QUOTE_WS_URL` | 行情 WebSocket 位址（預設：`wss://openapi-quote.longbridge.com/v2`） | | `LONGBRIDGE_TRADE_WS_URL` | 交易 WebSocket 位址（預設：`wss://openapi-trade.longbridge.com/v2`） | | `LONGBRIDGE_REGION` | 覆寫接入點；SDK 會依網路自動選擇，若判斷不正確可設定（如 `cn`、`hk`） | -| `LONGBRIDGE_ENABLE_OVERNIGHT` | 是否開啟夜盤行情，`true` 或 `false`（預設：`false`）；夜盤行情已包含在 Nasdaq Basic 中免費提供，僅支援美股 | +| `LONGBRIDGE_ENABLE_OVERNIGHT` | 是否開啟夜盤行情，`true` 或 `false`（預設：`false`）；夜盤行情已包含在 US LV1 中免費提供，僅支援美股 | | `LONGBRIDGE_PUSH_CANDLESTICK_MODE` | K 線推送模式，`realtime` 或 `confirmed`（預設：`realtime`） | | `LONGBRIDGE_PRINT_QUOTE_PACKAGES` | 連線時是否列印行情包，`true` 或 `false`（預設：`true`） | | `LONGBRIDGE_LOG_PATH` | 日誌檔案路徑（預設：不寫日誌） | diff --git a/docs/zh-HK/docs/qa/quote.md b/docs/zh-HK/docs/qa/quote.md index fb96d377..076da0be 100644 --- a/docs/zh-HK/docs/qa/quote.md +++ b/docs/zh-HK/docs/qa/quote.md @@ -90,7 +90,7 @@ sidebar_position: 1 ## Q6：如何取得夜盤行情 -- **夜盤行情已包含在 Nasdaq Basic 中免費提供**，無需購買行情卡。 +- **夜盤行情已包含在 US LV1 中免費提供**，無需購買行情卡。 - 目前夜盤行情**僅支援美股**，港股暫不支援夜盤。 - 開通夜盤權限後，還需要主動開啟，方式為在鑑權接口的 `metadata` 欄位填入 key `need_over_night_quote`, value `true`。 diff --git a/docs/zh-HK/docs/quote/overview.md b/docs/zh-HK/docs/quote/overview.md index eb0e8e8d..7bda46c3 100644 --- a/docs/zh-HK/docs/quote/overview.md +++ b/docs/zh-HK/docs/quote/overview.md @@ -151,6 +151,6 @@ slug: overview | **基礎行情** | 美/A 股實時報價；港股 BMP（約 15 分鐘延遲，不支持推送） | 開通 OpenAPI 後自動獲得 | | **LV1 實時**（港股） | 港股實時報價 + WebSocket 推送支持 | 通過行情商城購買「LV1 實時行情 (OpenAPI)」 | | **LV2 訂閱** | Level 2 買賣盤（depth）、港股經紀商隊列（brokers） | 通過行情商城購買 LV2 訂閱卡 | -| **盤前盤後**（美股） | 美股盤前/盤後延伸時段數據 | 已包含在 Nasdaq Basic 中免費提供，設置 `LONGBRIDGE_ENABLE_OVERNIGHT=true` 即可 | +| **盤前盤後**（美股） | 美股盤前/盤後延伸時段數據 | 已包含在 US LV1 中免費提供，設置 `LONGBRIDGE_ENABLE_OVERNIGHT=true` 即可 | 查看當前權限：[開發者中心](https://open.longbridge.com/dashboard)。購買行情卡：**Longbridge App → 我的 → 我的行情 → 行情商城**。 diff --git a/docs/zh-HK/docs/quote/stocks/candlestick.md b/docs/zh-HK/docs/quote/stocks/candlestick.md index 68536694..47ed706b 100644 --- a/docs/zh-HK/docs/quote/stocks/candlestick.md +++ b/docs/zh-HK/docs/quote/stocks/candlestick.md @@ -40,7 +40,7 @@ longbridge kline NVDA.US --period day --count 20 | period | int32 | 是 | k 線週期，例如：`1000`，详见 [Period](../objects#period---k-線週期) | | count | int32 | 是 | 數據數量，例如：`100`

**校验规则：**
請求數量最大為 `1000` | | adjust_type | int32 | 是 | 復權類型，例如：`0`，详见 [AdjustType](../objects#adjusttype---k-線復權類型) | -| trade_session | int32 | 否 | 交易時段，0: 盤中，100: 所有延長時段（盤前，盤中，盤後，夜盤）

注意：夜盤數據已包含在 Nasdaq Basic 中免費提供，僅支援美股；開啟 `enable_overnight` 參數即可獲取 | +| trade_session | int32 | 否 | 交易時段，0: 盤中，100: 所有延長時段（盤前，盤中，盤後，夜盤）

注意：夜盤數據已包含在 US LV1 中免費提供，僅支援美股；開啟 `enable_overnight` 參數即可獲取 | ### Protobuf diff --git a/docs/zh-HK/docs/quote/stocks/history-candlestick.md b/docs/zh-HK/docs/quote/stocks/history-candlestick.md index bb35c492..36096d8a 100644 --- a/docs/zh-HK/docs/quote/stocks/history-candlestick.md +++ b/docs/zh-HK/docs/quote/stocks/history-candlestick.md @@ -44,7 +44,7 @@ longbridge kline history NVDA.US --start 2025-01-01 --end 2025-12-31 | ∟ date | string | 否 | 查詢日期，格式為 `YYYYMMDD`，例如：20231016，為空時使用標的所在市場的最新交易日 | | ∟ minute | string | 否 | 查詢時間，格式為 `HHMM`，例如：09:35，僅在查詢分鍾級別 k 線時有效 | | ∟ count | int32 | 否 | 查詢數量，填寫範圍 `[1,1000]`，為空時默認查詢 `10` 條 | -| trade_session | int32 | 否 | 交易時段，0: 盤中，100: 所有延長時段（盤前，盤中，盤後，夜盤）

注意：夜盤數據已包含在 Nasdaq Basic 中免費提供，僅支援美股；開啟 `enable_overnight` 參數即可獲取 | +| trade_session | int32 | 否 | 交易時段，0: 盤中，100: 所有延長時段（盤前，盤中，盤後，夜盤）

注意：夜盤數據已包含在 US LV1 中免費提供，僅支援美股；開啟 `enable_overnight` 參數即可獲取 | ### Protobuf diff --git a/docs/zh-HK/docs/quote/stocks/quote.md b/docs/zh-HK/docs/quote/stocks/quote.md index aeada4dd..327cd331 100644 --- a/docs/zh-HK/docs/quote/stocks/quote.md +++ b/docs/zh-HK/docs/quote/stocks/quote.md @@ -268,7 +268,7 @@ func main() { | ∟∟ high | string | 最高價 | | ∟∟ low | string | 最低價 | | ∟∟ prev_close | string | 上一個交易階段的收盤價 | -| ∟ over_night_quote | object | 美股夜盤交易行情

注意：需開啟 `enable_overnight` 參數獲取，否則會返回 null（夜盤行情已包含在 Nasdaq Basic 中免費提供，僅支援美股） | +| ∟ over_night_quote | object | 美股夜盤交易行情

注意：需開啟 `enable_overnight` 參數獲取，否則會返回 null（夜盤行情已包含在 US LV1 中免費提供，僅支援美股） | | ∟∟ last_done | string | 最新價 | | ∟∟ timestamp | int64 | 最新成交的時間戳 | | ∟∟ volume | int64 | 成交量 | diff --git a/quote-permissions.yaml b/quote-permissions.yaml index 15dd7b88..b9440ff5 100644 --- a/quote-permissions.yaml +++ b/quote-permissions.yaml @@ -43,9 +43,9 @@ levels: overnight: label: { en: 'Overnight', zh-CN: '盘前盘后', zh-HK: '盤前盤後' } description: - en: 'US pre/post-market and overnight data — already included in Nasdaq Basic for free. Just set the environment variable LONGBRIDGE_ENABLE_OVERNIGHT=true to enable it.' - zh-CN: '美股盘前/盘后及夜盘行情数据，已包含在 Nasdaq Basic 中免费提供，仅需设置环境变量 LONGBRIDGE_ENABLE_OVERNIGHT=true 即可开启。' - zh-HK: '美股盤前/盤後及夜盤行情數據，已包含在 Nasdaq Basic 中免費提供，僅需設置環境變量 LONGBRIDGE_ENABLE_OVERNIGHT=true 即可開啟。' + en: 'US pre/post-market and overnight data — already included in US LV1 for free. Just set the environment variable LONGBRIDGE_ENABLE_OVERNIGHT=true to enable it.' + zh-CN: '美股盘前/盘后及夜盘行情数据，已包含在 US LV1 中免费提供，仅需设置环境变量 LONGBRIDGE_ENABLE_OVERNIGHT=true 即可开启。' + zh-HK: '美股盤前/盤後及夜盤行情數據，已包含在 US LV1 中免費提供，僅需設置環境變量 LONGBRIDGE_ENABLE_OVERNIGHT=true 即可開啟。' link_text: { en: 'My Quotes', zh-CN: '我的行情权限', zh-HK: '我的行情權限' } opra: label: { en: 'OPRA', zh-CN: 'OPRA 期权', zh-HK: 'OPRA 期權' } @@ -62,15 +62,15 @@ commands: level: basic description: en: |- - US stocks: Nasdaq Basic included free by default, covering pre-market, regular, after-hours, and overnight sessions. To receive overnight data, enable it via LONGBRIDGE_ENABLE_OVERNIGHT=true (see Q6 & Q7 in the Broker FAQ). + US stocks: US LV1 included free by default, covering pre-market, regular, after-hours, and overnight sessions. To receive overnight data, enable it via LONGBRIDGE_ENABLE_OVERNIGHT=true (see Q6 & Q7 in the Broker FAQ). HK stocks: LV1 real-time quotes included by default. US options: no permission by default — purchase "OPRA US Options Quotes (OpenAPI)" in the Quote Store. zh-CN: |- - 美股：默认免费赠送 Nasdaq Basic 实时行情（含盘前、盘中、盘后、夜盘全时段）；夜盘数据需设置 LONGBRIDGE_ENABLE_OVERNIGHT=true 开启（详见 Broker FAQ Q6、Q7）。 + 美股：默认免费赠送 US LV1 实时行情（含盘前、盘中、盘后、夜盘全时段）；夜盘数据需设置 LONGBRIDGE_ENABLE_OVERNIGHT=true 开启（详见 Broker FAQ Q6、Q7）。 港股：默认赠送 LV1 实时行情。 美股期权：默认无权限，需购买「OPRA 美股期权行情 (OpenAPI)」行情卡。 zh-HK: |- - 美股：預設免費贈送 Nasdaq Basic 實時行情（含盤前、盤中、盤後、夜盤全時段）；夜盤數據需設置 LONGBRIDGE_ENABLE_OVERNIGHT=true 開啟（詳見 Broker FAQ Q6、Q7）。 + 美股：預設免費贈送 US LV1 實時行情（含盤前、盤中、盤後、夜盤全時段）；夜盤數據需設置 LONGBRIDGE_ENABLE_OVERNIGHT=true 開啟（詳見 Broker FAQ Q6、Q7）。 港股：預設贈送 LV1 實時行情。 美股期權：預設無權限，需購買「OPRA 美股期權行情 (OpenAPI)」行情卡。 store_cards: @@ -84,15 +84,15 @@ commands: level: lv1 description: en: |- - US stocks: Nasdaq Basic 1-level bid/ask included free by default (pre-market, regular, after-hours, and overnight sessions). + US stocks: US LV1 1-level bid/ask included free by default (pre-market, regular, after-hours, and overnight sessions). HK stocks: LV1 1-level bid/ask included by default; 10-level order book requires "LV2 Advanced Quotes - Plus (OpenAPI)". US options: no permission by default — purchase "OPRA US Options Quotes (OpenAPI)". zh-CN: |- - 美股：默认免费赠送 Nasdaq Basic 一档买卖盘报价（含盘前、盘中、盘后、夜盘全时段）。 + 美股：默认免费赠送 US LV1 一档买卖盘报价（含盘前、盘中、盘后、夜盘全时段）。 港股：默认赠送 LV1 一档买卖盘报价；十档买卖盘需购买「LV2 高级行情 - Plus (OpenAPI)」行情卡。 美股期权：默认无权限，需购买「OPRA 美股期权行情 (OpenAPI)」行情卡。 zh-HK: |- - 美股：預設免費贈送 Nasdaq Basic 一檔買賣盤報價（含盤前、盤中、盤後、夜盤全時段）。 + 美股：預設免費贈送 US LV1 一檔買賣盤報價（含盤前、盤中、盤後、夜盤全時段）。 港股：預設贈送 LV1 一檔買賣盤報價；十檔買賣盤需購買「LV2 高級行情 - Plus (OpenAPI)」行情卡。 美股期權：預設無權限，需購買「OPRA 美股期權行情 (OpenAPI)」行情卡。 store_cards: @@ -126,15 +126,15 @@ commands: level: basic description: en: |- - US stocks: Nasdaq Basic included free by default (last ~1,000 ticks across pre-market, regular, after-hours, and overnight sessions). + US stocks: US LV1 included free by default (last ~1,000 ticks across pre-market, regular, after-hours, and overnight sessions). HK stocks: LV1 included by default (last ~1,000 ticks). US options: no permission by default — purchase "OPRA US Options Quotes (OpenAPI)". zh-CN: |- - 美股：默认免费赠送 Nasdaq Basic 实时行情（近 1000 笔，含盘前、盘中、盘后、夜盘全时段）。 + 美股：默认免费赠送 US LV1 实时行情（近 1000 笔，含盘前、盘中、盘后、夜盘全时段）。 港股：默认赠送 LV1 实时行情（近 1000 笔）。 美股期权：默认无权限，需购买「OPRA 美股期权行情 (OpenAPI)」行情卡，最多可获取近 1000 笔。 zh-HK: |- - 美股：預設免費贈送 Nasdaq Basic 實時行情（近 1000 筆，含盤前、盤中、盤後、夜盤全時段）。 + 美股：預設免費贈送 US LV1 實時行情（近 1000 筆，含盤前、盤中、盤後、夜盤全時段）。 港股：預設贈送 LV1 實時行情（近 1000 筆）。 美股期權：預設無權限，需購買「OPRA 美股期權行情 (OpenAPI)」行情卡，最多可獲取近 1000 筆。 store_cards: @@ -148,15 +148,15 @@ commands: level: basic description: en: |- - US stocks: Nasdaq Basic included free by default (pre-market, regular, after-hours, and overnight sessions). + US stocks: US LV1 included free by default (pre-market, regular, after-hours, and overnight sessions). HK stocks: LV1 real-time quotes included by default. US options: no permission by default — purchase "OPRA US Options Quotes (OpenAPI)". zh-CN: |- - 美股：默认免费赠送 Nasdaq Basic 实时行情（含盘前、盘中、盘后、夜盘全时段）。 + 美股：默认免费赠送 US LV1 实时行情（含盘前、盘中、盘后、夜盘全时段）。 港股：默认赠送 LV1 实时行情。 美股期权：默认无权限，需购买「OPRA 美股期权行情 (OpenAPI)」行情卡。 zh-HK: |- - 美股：預設免費贈送 Nasdaq Basic 實時行情（含盤前、盤中、盤後、夜盤全時段）。 + 美股：預設免費贈送 US LV1 實時行情（含盤前、盤中、盤後、夜盤全時段）。 港股：預設贈送 LV1 實時行情。 美股期權：預設無權限，需購買「OPRA 美股期權行情 (OpenAPI)」行情卡。 store_cards: @@ -171,17 +171,17 @@ commands: description: en: |- Quota-based access: 100–3,000 unique symbols per calendar month depending on account tier (resets monthly; see quota table in the docs). - US stocks: Nasdaq Basic included free by default (pre-market, regular, after-hours, and overnight sessions). + US stocks: US LV1 included free by default (pre-market, regular, after-hours, and overnight sessions). HK stocks: LV1 included by default. US options: no permission by default — purchase "OPRA US Options Quotes (OpenAPI)". zh-CN: |- 按账户等级配额，每自然月可查询 100–3,000 个标的（每月重置，详见文档中的配额表）。 - 美股：默认免费赠送 Nasdaq Basic 行情（含盘前、盘中、盘后、夜盘全时段）。 + 美股：默认免费赠送 US LV1 行情（含盘前、盘中、盘后、夜盘全时段）。 港股：默认赠送 LV1 行情。 美股期权：默认无权限，需购买「OPRA 美股期权行情 (OpenAPI)」行情卡。 zh-HK: |- 按帳戶等級配額，每自然月可查詢 100–3,000 個標的（每月重置，詳見文檔中的配額表）。 - 美股：預設免費贈送 Nasdaq Basic 行情（含盤前、盤中、盤後、夜盤全時段）。 + 美股：預設免費贈送 US LV1 行情（含盤前、盤中、盤後、夜盤全時段）。 港股：預設贈送 LV1 行情。 美股期權：預設無權限，需購買「OPRA 美股期權行情 (OpenAPI)」行情卡。 store_cards: @@ -232,15 +232,15 @@ commands: level: basic description: en: |- - US stocks: Nasdaq Basic included free by default (pre-market, regular, after-hours, and overnight sessions). + US stocks: US LV1 included free by default (pre-market, regular, after-hours, and overnight sessions). HK stocks: LV1 real-time quotes included by default. US options: not supported. zh-CN: |- - 美股：默认免费赠送 Nasdaq Basic 实时行情（含盘前、盘中、盘后、夜盘全时段）。 + 美股：默认免费赠送 US LV1 实时行情（含盘前、盘中、盘后、夜盘全时段）。 港股：默认赠送 LV1 实时行情。 美股期权：不支持该接口。 zh-HK: |- - 美股：預設免費贈送 Nasdaq Basic 實時行情（含盤前、盤中、盤後、夜盤全時段）。 + 美股：預設免費贈送 US LV1 實時行情（含盤前、盤中、盤後、夜盤全時段）。 港股：預設贈送 LV1 實時行情。 美股期權：不支持該接口。