之前就如入金了 但是openapi 历史行情配额数量还是不对

[fsankk]

问题描述

两月之前就入金了 但是openapi拉取历史行情 还是只能拉取100条

代码例子

    def _build_config(
        self,
        *,
        app_key: str | None,
        app_secret: str | None,
        access_token: str | None,
        region: str | None,
    ) -> Config:
        if app_key and app_secret and access_token:
            # 当前 longport Python SDK 的 Config(...) 不接受 region 参数；
            # region 主要仍通过环境变量/默认配置控制，这里避免显式传入导致 TypeError。
            return Config(app_key=app_key, app_secret=app_secret, access_token=access_token)
        return Config.from_env()


@property
    def quote_ctx(self) -> QuoteContext:
        if self._quote_ctx is None:
            self._quote_ctx = QuoteContext(self.config)
        return self._quote_ctx

 def _quote_call(self, endpoint: str, **params: Any) -> tuple[Any, LongPortRequestRecord]:
        try:
            return self._call(self.quote_ctx, endpoint, **params)
        except Exception as exc:
            if self.quote_fallback_client is None:
                raise
            log_event(
                logger,
                30,
                "longport_quote_fallback_triggered",
                endpoint=endpoint,
                error=str(exc),
            )
            return self.quote_fallback_client._call(self.quote_fallback_client.quote_ctx, endpoint, **params)
return self._quote_call("history_candlesticks_by_date", **kwargs)

错误信息或结果截图

(kind=ErrorKind.OpenApi, code=301607, trace_id=) history kline symbol count out of limit

你的环境信息

• 操作系统: [比如: macOS /]
• 开发语言: Python
• SDK 版本号： py13

[fsankk]

from longport.openapi import QuoteContext, Config, SubType, PushQuote, Period, AdjustType

config = Config.from_env()
ctx = QuoteContext(config)

# get candlesticks by offset
print("get candlesticks by offset")
print("====================")
HSTECH_CONSTITUENT_SYMBOLS_2026_03_09 = [
    "9988.HK",
    "3690.HK",
    "1211.HK",
    "1024.HK",
    "9888.HK",
    "9618.HK",
    "9868.HK",
    "9961.HK",
    "2015.HK",
    "9626.HK",
    "6690.HK",
    "300.HK",
    "780.HK",
    "9863.HK",
    "9866.HK",
    "1698.HK",
    "700.HK",
    "1810.HK",
    "981.HK",
    "9999.HK",
    "9660.HK",
    "20.HK",
    "1347.HK",
    "992.HK",
    "268.HK",
    "3888.HK",
    "285.HK",
    "6618.HK",
    "241.HK",
    "2382.HK",
]
for syb in  HSTECH_CONSTITUENT_SYMBOLS_2026_03_09:


    # get candlesticks by date
    print("get candlesticks by date")
    print("====================")
    candlesticks = ctx.history_candlesticks_by_date(syb, Period.Day, AdjustType.NoAdjust, datetime.date(2022, 5, 5), datetime.date(2026, 1, 23))
    for candlestick in candlesticks:
        `print(candlestick)``` 也不行

[fsankk]

longport.OpenApiException: OpenApiException: (kind=ErrorKind.OpenApi, code=301607, trace_id=) history kline symbol count out of limit

[fsankk]

有人能帮看下吗

[huacnlee]

NOTE: 以下内容基于 Longbridge Developers AI 分析问题并解答。我们 Longbrige Developers 网站右下角有个 AI 图标，如果后续还有其他问题，可以尝试一下。

问题原因分析

错误码 301607 说明

301607 错误表示：超过当月能够查询的标的数量上限。

Ref: 获取标的历史 K 线

这与您的情况相符：

• 开户默认额度为每月查询 100 只标的
• 您虽已入金，但额度可能未生效或未达到更高等级

---

历史 K 线权限规则

根据官方文档，历史 K 线的查询权限不是按每次拉取的 K 线根数限制，而是按每月可查询的不同标的数量限制：

权限等级表

用户类型	每月可查询的标的数量上限（只）
用户开户	100
总资产达 1 万 HKD	400
总资产达 8 万 HKD	600
总资产达 40 万 HKD 或月交易笔数 > 160 笔	1000
总资产达 400 万 HKD 或月交易笔数 > 1600 笔	2000
总资产达 600 万 HKD 或月交易笔数 > 2500 笔	3000

Ref: 获取标的历史 K 线 - 权限说明

---

关键规则说明

1. 额度生效时间

新入金的账户，额度会在下个交易日自动生效；当账户的总资产或交易笔数增加、且达到更高等级时，额度会在下一个交易日生效。

排查要点：

• ✅ 确认入金后是否已过至少 1 个完整交易日
• ✅ 确认总资产是否真的达到了更高等级（如 1 万 HKD）

---

2. 总资产计算规则

总资产：用户的港股、美股、A 股等证券账户的总资产，按照汇率换算成港元。取用户上个自然月最后一个交易日的总资产与最近一个完整交易日的总资产的较大值。

排查要点：

• ✅ 检查上个月最后一个交易日的总资产
• ✅ 检查最近一个完整交易日的总资产
• ✅ 确认资产是否已按汇率换算成港元后满足门槛

---

3. 额度按月计算

额度按照自然月计算，每月初额度加满，上月剩余额度不累计到本月。一个自然月内重复请求同一只标的的历史 K 线，仅统计一次。

示例：

• 如果您的额度是 100 只标的/月，本月已经查询过 TSLA.US、700.HK 等 100 只不同标的，则本月无法再查询新标的
• 但可以重复查询已查询过的标的（不会再消耗额度）

---

解决方案

步骤 1：确认当前权限等级

前往 Longbridge 开发者中心，查看"行情权限"页面，确认：

• 当前每月可查询的标的数量上限
• 总资产数值（是否换算成港元）
• 月交易笔数

---

步骤 2：排查资产是否达标

如果您入金金额（换算成港元后）应该达到更高等级，但实际权限未变，可能原因：

1. 入金后未过完整交易日

   • 入金当天不会生效，需等到下一个交易日
   • 如果是周末/节假日入金，需等到下个工作日

2. 资产未达标

   • 确认入金金额按汇率换算成港元后是否达到门槛（如 1 万 HKD ≈ 1280 USD）
   • 确认资产是否在完整交易日收盘时仍在账户内

3. 系统未更新

   • 如果确认资产达标且已过交易日，但权限仍未更新，可能是系统延迟

---

步骤 3：查看已使用额度

您可以通过以下方式确认本月是否已查询过 100 只不同标的：

方法 A：通过日志统计

• 检查本月调用历史 K 线接口时使用的不同 symbol 数量
• 如果已达到 100 只，需等待下月 1 日额度重置

方法 B：联系技术支持

• 访问 open.longbridge.com 提交工单
• 请求查询当前账户的额度使用情况

---

步骤 4：临时解决方案

如果急需查询更多标的，可以：

1. 增加交易笔数

   • 如果无法短期内增加资产，可通过增加月交易笔数达到更高等级
   • 例如：完成 160 笔交易后，次日可获得 1000 只标的/月的额度

2. 等待下月重置

   • 如果本月已用完 100 只标的额度，次月 1 日自动恢复

3. 使用多个账户

   • 如果有多个证券账户，每个账户的额度独立计算

---

步骤 5：联系官方支持

如果确认以下条件均满足，但权限仍未生效：

✅ 入金金额换算成港元后达到门槛（如 ≥ 1 万 HKD）
✅ 入金后已过至少 1 个完整交易日
✅ 开发者中心显示的权限等级仍为"用户开户"（100 只/月）

建议操作：

1. 访问 open.longbridge.com
2. 提交工单，附上以下信息：
   • 入金时间与金额
   • 当前总资产截图（Longbridge App → 资产页面）
   • 开发者中心"行情权限"页面截图
   • 错误信息截图（包含 trace_id）

---

常见误区澄清

❌ 误区 1："拉取 100 条" ≠ "100 根 K 线"

很多用户误以为"只能拉取 100 条"是指每次最多获取 100 根 K 线，这是错误的。

正确理解：

• 每次拉取的 K 线根数：接口支持每次拉取最多 1000 根 K 线
• 每月查询的标的数量：开户默认每月只能查询 100 只不同的标的

示例：

# ✅ 允许：对 TSLA.US 一次性拉取 1000 根日 K 线
ctx.history_candlesticks("TSLA.US", Period.Day, count=1000)

# ✅ 允许：对同一只标的多次拉取（不会重复消耗额度）
ctx.history_candlesticks("TSLA.US", Period.Day, count=500)
ctx.history_candlesticks("TSLA.US", Period.Min_5, count=800)

# ❌ 不允许：本月已查询过 100 只不同标的后，再查询第 101 只
ctx.history_candlesticks("AAPL.US", Period.Day, count=100)  # 如果本月额度已用完，会报 301607 错误

---

❌ 误区 2："入金后立即生效"

权限升级不是实时的，必须满足：

• 已过至少 1 个完整交易日
• 系统已更新账户等级（通常在交易日收盘后结算）

---

快速排查清单

请逐项核对以下内容：

检查项	状态	说明
☐ 入金时间	____年____月____日	需确认是否已过至少 1 个交易日
☐ 入金金额（换算成 HKD）	____ HKD	是否达到 1 万 HKD？
☐ 当前总资产（开发者中心显示）	____ HKD	系统识别的资产是否达标？
☐ 当前权限等级	每月 ____ 只标的	开发者中心显示的额度
☐ 本月已查询的不同标的数量	____ 只	是否已达到上限？
☐ 是否在同一自然月内	☐ 是 ☐ 否	额度在每月 1 日重置

---

参考文档

• 获取标的历史 K 线：https://open.longbridge.com/docs/quote/pull/history-candlestick
• 通用错误码：https://open.longbridge.com/docs/error-codes
• 开发者中心：https://open.longbridge.com/account

---

总结：您的问题最可能的原因是入金金额未达到更高等级门槛或权限升级尚未生效。请先确认总资产换算成港元后是否 ≥ 1 万 HKD，并确认是否已过完整交易日。如果确认无误但权限仍未更新，请联系官方技术支持并提供详细信息。

[fsankk]

开发中心什么都没显示

这里也是纯ai

在2026/2/1 就总资产过1w港币 现在还是只能拉取100个标的

[huacnlee]

301607 code 表示查询标的的累计超过了限制，而不是说 100 个，看你前面给的例子，你有可能本月累计查询了很多标的的数据，触发了我们这边的限制（注意，并没有说是 100，有可能是更多）。

以上给出的解答是基于我们业务规则的分析，你可以结合实际情况判断一下。

[fsankk]

这个有办法排查一个什么额度达到限制了吗？现在这种情况 完全不可知，不可知就不可用

[huacnlee]

Code	类型	说明
301607	接口限制	超过当月能够查询的标的数量上限

301607 错误就是查询标的的累计量超了，基于你前面的回复的例子：

HSTECH_CONSTITUENT_SYMBOLS_2026_03_09 = [
    "9988.HK",
    "3690.HK",
    "1211.HK",
    "1024.HK",
    "9888.HK",
    "9618.HK",
    "9868.HK",
    "9961.HK",
    "2015.HK",
    "9626.HK",
    "6690.HK",
    "300.HK",
    "780.HK",
    "9863.HK",
    "9866.HK",
    "1698.HK",
    "700.HK",
    "1810.HK",
    "981.HK",
    "9999.HK",
    "9660.HK",
    "20.HK",
    "1347.HK",
    "992.HK",
    "268.HK",
    "3888.HK",
    "285.HK",
    "6618.HK",
    "241.HK",
    "2382.HK",
]
for syb in  HSTECH_CONSTITUENT_SYMBOLS_2026_03_09:

估计应该还有很多次这种不同的股票查询，这个限制是按 累计股票查询量，例如上面例子就 30 个，你这里有日期，也就是说有可能这个月其他天还有很多其他的股票。

按这个情况来估计，你有可能查询过大量的 不同股票

[fsankk]

我是有其他股票查询 但是刚好的是 我一共拉到了100支标的后就不能查了 本月累计查询量 甚至历史累计查询标的量都是100

[fsankk]

我拉下来的标的都过了本地数据库做了一层本地缓存 看数据库最后的结果就是刚好一个100个标的

[huacnlee]

我向内部反馈一下，让他们查一下你账号限制触发原因，等工作日他们查询看一下，稍后回复。

你的账户编号发一下，稍后有答案我们在这里回复你

[fsankk]

H11367920

[lzfxxx]

同样的问题，账户编号H10630815 @huacnlee

[tianli052124]

一样的问题

[juffson]

你好，因为我们额度计算时间冲突导致，目前已经修复，在晚上七点后可以再试一下 @tianli052124 @lzfxxx @fsankk