Skip to main content

什么是速率限制?

速率限制控制每秒可以进行的请求数量。当超过速率限制时,您将收到一个HTTP 429响应。关于当遇到429或其他临时故障时该怎么做的指导,请参见下文的重试和错误处理。

标准速率限制

您的计划有两个标准速率限制组:一个用于 RPC 请求,另一个用于 DAS API 请求。以下是每个 Helius 计划的基本速率限制:
计划RPC 速率限制DAS 和增强 API
免费10 请求/秒2 请求/秒
开发者50 请求/秒10 请求/秒
商业200 请求/秒50 请求/秒
专业500 请求/秒100 请求/秒
企业自定义自定义

提高速率限制

专业版套餐的团队可以每月支付 100 美元,额外购买 100 RPS。 如果您需要在发布前进行自定义速率限制,请联系我们的销售团队。如果您使用的是开发者或商业层,请升级您的计划以增加速率限制。

特殊速率限制

由于计算要求,一些端点和专门的 Helius 产品有特殊的速率限制。

发送交易

端点免费开发者商业专业
Sender50/秒50/秒50/秒50/秒
sendTransaction1/秒5/秒50/秒100/秒
sendBundle——5/秒5/秒
simulateBundle10/秒50/秒200/秒500/秒
Sender 无密钥 /fast 请求在每个区域中,每个出口 IP 每秒最多 1 个请求。位于同一 NAT 后的调用方共享此限制。被拒绝的 429 请求会计入限制;/ping 不会。附加你现有的 Helius 项目 API 密钥,即可获得每个区域中每个密钥每秒 50 个请求的限制。
如果你使用的是专业版套餐,并且需要提高 sendTransaction 速率限制,请联系我们的销售团队。 专业版套餐用户还可以申请提高速率限制,并为 Sender 定制小费安排,以支持吞吐量更高的交易应用。

复杂 RPC 调用

端点免费版开发者版商业版专业版
getProgramAccounts5/秒25/秒50/秒75/秒

历史数据

批量请求历史数据方法时,适用以下限制:
方法最大批量大小
getTransaction每个请求 100 项
getTransactionsForAddress不允许批量请求
getTransfersByAddress不允许批量请求
所有其他历史数据方法每个请求 10 项
超过批量限制将导致错误响应。对于 getTransactionsForAddress 和 getTransfersByAddress,必须通过单独的请求查询每个地址。

LaserStream

资源免费版开发者版商业版专业版
网络—DevnetDevnet、MainnetDevnet、Mainnet
最大公钥数—10M10M10M
活跃连接数——10100

钱包 API

钱包 API 采用与 DAS 和增强型 API 相同的速率限制。所有端点共享以下限制:
端点免费版开发者版商业版专业版
所有钱包 API 端点2/秒10/秒50/秒100/秒
这包括身份查询、余额、历史记录、转账和资金来源端点。请在我们的钱包 API 文档中了解更多信息。

解析流

资源免费版开发者版商业版专业版
并发连接数5105050
每个连接的订阅数25252525
系统按项目统计其所有 API 密钥的连接总数。项目达到连接数上限时会收到 HTTP 429。有关每个筛选器和消息的限制,请参阅解析流限制。

LaserStream WebSocket

资源免费版开发者版商业版专业版
并发连接数51502501,000
每个连接的订阅数1,0001,0001,0001,000
WebSocket 类型标准型标准型、增强型标准型、增强型标准型、增强型

Webhook

资源免费版开发者版商业版专业版
最大 Webhook 数5505050
每个 Webhook 的地址数100k100k100k100k

ZK 压缩

服务免费版开发者版商业版专业版
Photon API2/秒10/秒50/秒100/秒
getValidityProof1/秒5/秒10/秒20/秒

重试和错误处理

当你的应用收到 429 Too Many Requests、503 Service Unavailable 或临时 5xx 响应时,请稍等片刻后再重试,不要立即重试。立即重试会导致请求堆积,使速率限制恢复变慢,而不是变快。

推荐策略

  • 首次重试前等待约 1 秒。
  • 每次重试时将等待时间翻倍,最长不超过 30 秒。
  • 为每次等待添加 ±25% 的小幅随机变化,避免多个应用在同一时刻一起重试。
  • 尝试 5 次后放弃,并将错误返回给调用方代码。

哪些错误需要重试

示例

错误响应结构

所有 Helius API 都会在发生错误时返回结构化的 JSON 正文。JSON-RPC 端点(Solana RPC、DAS、Sender、优先费、ZK 压缩)返回标准 JSON-RPC 2.0 封装:
REST 端点(钱包 API、管理 API)返回:
有关完整的错误代码列表及各代码的含义,请参阅常见错误代码。