跳转到主要内容
Helius API 使用 API 密钥进行请求认证。每个 API 请求必须包含您的 API 密钥以验证您的身份和权限。
您的 API 密钥是敏感信息,可以访问您的 Helius 账户。切勿在客户端代码、公共代码库或浏览器可访问的区域中暴露它。

入门指南

1. 创建您的 API 密钥

1

注册或登录

在 Helius 控制台上创建一个账户或登录到已有账户。
2

导航到 API 密钥

转到控制台侧边栏中的 API 密钥 部分。
3

生成新密钥

点击 创建新 API 密钥 并为您的项目提供一个描述性名称(例如,“生产应用程序”,“开发环境”)。
4

复制并安全存储您的密钥

立即复制您的 API 密钥并安全存储。一旦导航离开,您将无法再次查看它。

2. 使用您的 API 密钥

在所有请求中包含您的 API 密钥作为查询参数:

入门指南(针对代理)

代理可以通过编程方式注册Helius账户、创建项目,并使用Helius CLI生成API密钥。 完整说明请参阅:https://dashboard.helius.dev/agents.md

安装 Helius CLI

生成密钥对

为生成的钱包提供资金(仅限自动支付)

如果通过托管支付链接付款,请跳过此步骤(这是默认注册模式,使用 helius signup --resume 完成注册)。自动付款(--pay)将从本地密钥对付款:向上一步中的钱包地址发送相应套餐金额的 USDC(Agent 套餐为 $10)和约 0.001 SOL。

注册并获取API密钥

每次新注册(包括 Agent 套餐)都需要 --email、--first-name 和 --last-name。该钱包仅用于付款。

安全最佳实践

Environment Variables

将 API 密钥存储在环境变量中,而不是源代码中。

IP Restrictions

在控制面板中为 API 密钥设置 IP 限制,将访问权限限定到特定 IP 地址或地址范围。

Separate Keys

为开发、预发布和生产环境使用不同的 API 密钥,以隔离使用情况并提高安全性。

Monitor Usage

定期在控制面板中检查 API 使用情况,以检测异常模式或潜在安全问题。

密钥管理

速率限制与用量

速率限制因订阅套餐而异。请在 Helius 控制面板中监控用量,确保不超出分配的限额。

了解速率限制

  • 每秒请求数:取决于你的订阅等级
  • 每月请求配额:每个计费周期允许的请求总数
  • 突发额度:允许短期超过基础速率限制的请求峰值

处理速率限制

故障排除

症状:出现 401 Unauthorized 或“API 密钥无效”错误解决方案:
  • 验证 API 密钥是否正确且未重新生成
  • 检查是否已将 API 密钥作为查询参数包含在内:?api-key=YOUR_KEY
  • 确保 API 密钥中没有多余的空格或字符
  • 确认 API 密钥未过期或被撤销
症状:出现 429 Too Many Requests 错误解决方案:
  • 在控制面板中检查当前用量
  • 在重试逻辑中实现指数退避
  • 考虑升级套餐以获得更高限额
  • 优化请求以减少不必要的调用
症状:出现 403 Forbidden 错误解决方案:
  • 验证 IP 限制是否阻止了你的请求
  • 检查你的订阅是否包含该端点的访问权限
  • 确保 API 密钥具有必要权限

后续步骤

Quickstart Guide

开始使用 Helius 发起你的第一个 API 调用

API Reference

探索所有可用的端点和方法

Rate Limits

了解速率限制和升级选项

Dashboard

监控 API 用量并管理密钥

支持

需要身份验证方面的帮助,或对 API 密钥有疑问?

Discord Community

加入我们的 Discord,获取实时帮助和社区支持

Email Support

直接联系我们的支持团队