速率限制与配额

每个 finlight API 密钥都绑定到一个套餐，套餐定义了您的使用限制以及可访问的功能。限制按 API 密钥实时执行。本页说明每项限制及各套餐解锁的内容；有关您套餐的确切数值，请查看 finlight 控制台或价格页面。

四项使用限制

Name
每月请求配额
Description
每个 REST 请求都会从您的每月额度中消耗一个请求。计数器在每个计费周期开始时重置。超出后将返回 429，消息为 "Exceeded token limit of N for the current period."
Name
突发速率
Description
对每 10 秒内请求数的短期限制，用于平滑流量峰值。仅在定义了该限制的套餐上执行。超出后将返回 429，消息为 "Exceeded rate limit of N requests per 10 seconds." —— 请回退约 10 秒后重试。
Name
WebSocket 连接数
Description
您密钥可建立的并发 WebSocket 连接的最大数量。超出限制的新连接将被拒绝。另有一项单独的上限限制每个周期内推送的消息总数。WebSocket 需要付费套餐。
Name
Webhook 投递配额
Description
每个计费周期内 webhook 投递的最大数量。配套的限制还会限定您可创建的 webhook 数量。当投递配额用尽时，投递将暂停，直至下一周期。

除了原始限制之外，您的套餐还控制着可用的功能。请求套餐未包含的功能将返回 403（针对 REST），或者直接省略相应数据（针对 webhook/WebSocket）。

Name
历史数据
Description
您可回溯查询的范围取决于您的套餐。Free 和 Pro Light 套餐目前大约覆盖最近一个月的文章；更高级别的套餐可解锁更深的历史覆盖范围。使用 from / to 日期过滤器在您套餐的时间窗口内查询 —— 对窗口之外日期的请求只会针对该范围返回空结果。各套餐的确切历史时间窗口请参阅价格页面。
Name
情绪分析
Description
包含文章上的 sentiment 和 confidence 字段。未授权时会从负载中移除。
Name
公司实体
Description
包含 companies 数组（由 AI 解析的股票代码、ISIN、交易所等）并启用 includeEntities。未授权时会被移除。
Name
自定义来源
Description
添加到您默认来源集中的私有或客户专属新闻来源。在更高级别 / 企业套餐中提供。

按密钥实时执行。 每个请求都会递增您的计数器；一旦越过某项限制，API 会立即返回 429。
控制台用量并非实时。 finlight 控制台中显示的用量大约每天汇总一次，反映的是截至前一天的活动 —— 它不是实时计数器。执行是实时的，因此您今天的实际剩余配额可能与控制台显示的不同。
每月计数器重置于您计费周期的开始 —— 配额 429 会自动清除。
没有速率限制标头。 finlight 目前不发送 Retry-After 或 X-RateLimit-* 标头。将突发 429 视为“等待约 10 秒”；将每月 429 视为“本周期配额已用尽”。参见错误与状态码。

套餐	典型用途
Free	评估和低流量使用。仅限 REST（无 WebSocket）。
Pro (Light / Standard / Scale)	生产工作负载，配额逐级提升，含 WebSocket、webhook 和更丰富的增强数据。
Enterprise	高流量、自定义来源和定制限制。

确切的数值限制（每月令牌数、突发速率、WebSocket 连接数、webhook 配额）以及每个套餐的功能集属于定价的一部分，可能会变化。请始终在 finlight 控制台中查看您当前套餐的限制，或在价格页面上比较各套餐。需要更高的限制或自定义来源？联系我们。

有关确切的错误正文，请参阅错误与状态码。