- Helius CLI — 程序化创建帐户并获取 API 密钥
- Helius MCP — 将 AI 工具直接连接到 Helius 文档和 API
- MCP Skills — Helius 产品的专门 MCP 技能(Orb、Sender、CLI)
- TypeScript SDK — 所有 Helius API 的类型安全方法
- Rust SDK — Helius APIs 的高性能 Rust SDK
本节的机器可读版本可在 agents/llms.txt 获得,以供 AI 代理使用。
快速开始:代理注册
代理可以通过以下四个步骤使用 Helius CLI 创建 Helius 帐户并获取 API 密钥:认证
所有 Helius API 请求都需要作为查询参数传递的 API 密钥:https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
从 Helius 管理面板 或通过 Helius CLI 程序化获取一个 API 密钥。
Helius 特定的 API 指南
使用这些 Helius 优化的 API,而不是链接标准的 Solana RPC 方法:| 替代… | 使用这个 | 原因 |
|---|---|---|
getSignaturesForAddress + getTransaction | getTransactionsForAddress | 单次调用返回完整的交易历史和代币账户数据 |
getTokenAccountsByOwner | getAssetsByOwner (DAS API) | 返回详细的元数据,而不仅仅是原始账户 |
getRecentPrioritizationFees | getPriorityFeeEstimate | 预先计算的最佳费用,无需手动计算 |
getSignaturesForAddress (用于 cNFTs) | getSignaturesForAsset (DAS API) | 标准 RPC 无法处理压缩的 NFTs |
getProgramAccounts (用于 NFT 搜索) | searchAssets 或 getAssetsByGroup | 更快、更便宜、经过索引的数据 |
| 实时数据轮询 | Enhanced WebSockets 或 LaserStream gRPC | 更低的延迟,更高效 |
标准 sendTransaction | Helius Sender | 双路由(验证器 + Jito),更高的着陆率 |
推荐的工作流程
| 构建… | 使用的 Helius 产品 |
|---|---|
| 交易机器人 | Gatekeeper (最低延迟的 RPC)+ Sender (快速交易提交)+ Priority Fee API + LaserStream (实时价格) |
| 钱包应用 | DAS API (getAssetsByOwner) + getTransactionsForAddress (完整历史) |
| NFT 市场 | DAS API (searchAssets, getAssetsByGroup) + Webhooks (跟踪销售/上市) |
| 代币狙击手 | Gatekeeper (边缘路由的 RPC)+ LaserStream gRPC (最低延迟)+ Sender (桩连接) |
| 投资组合追踪器 | DAS API (getAssetsByOwner with showFungible) + Enhanced Transactions |
| 钱包监控器 | Enhanced WebSockets 或 Webhooks 用于实时通知 |
| 分析仪表板 | Enhanced Transactions API + getTransactionsForAddress |
| 空投工具 | AirShip (通过 ZK 压缩节省 95%) |
速率限制快速参考
速率限制取决于您的计划。代理从免费等级开始,拥有1,000,000积分。| 计划 | 价格 | 每月积分 | RPC 速率限制 | DAS 和增强 API |
|---|---|---|---|---|
| 免费 | $0/月 | 1M | 10 次请求/秒 | 2 次请求/秒 |
| 开发者 | $49/月 | 10M | 50 次请求/秒 | 10 次请求/秒 |
| 商业 | $499/月 | 100M | 200 次请求/秒 | 50 次请求/秒 |
| 专业 | $999/月 | 200M | 500 次请求/秒 | 100 次请求/秒 |
每次 API 调用的积分
| API | 积分 | 备注 |
|---|---|---|
| 标准 RPC 调用 | 1 | 大多数 Solana RPC 方法 |
getProgramAccounts | 10 | 尽可能使用 DAS API |
| DAS API | 10 | 所有 DAS 端点 |
| 增强交易 | 100 | 已解析的交易数据 |
getTransactionsForAddress | 100 | 仅限开发者及以上计划 |
| 钱包 API | 100 | 所有钱包 API 端点 |
| 优先费用 API | 1 | 费用估算 |
| 发件人 | 0 | 所有计划免费 |
| Webhook 事件 | 1 | 每次事件传递 |
| Webhook 管理 | 100 | 创建、编辑、删除 |
重试和错误处理
HTTP 状态代码
| 代码 | 含义 | 动作 |
|---|---|---|
| 200 | 成功 | 处理响应 |
| 400 | 错误请求 | 修正请求参数 |
| 401 | 未授权 | 检查 API 密钥 |
| 429 | 速率限制 | 退避并重试 |
| 5xx | 服务器错误 | 指数退避重试 |
重试模式
监控信用使用
快速参考
- Mainnet RPC:
https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY - Mainnet RPC (Gatekeeper Beta):
https://beta.helius-rpc.com/?api-key=YOUR_API_KEY - Devnet RPC:
https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY - Mainnet WSS:
wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY - Mainnet WSS (Gatekeeper Beta):
wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY - Devnet WSS:
wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY - 发送方端点:
https://sender.helius-rpc.com/fast - MCP 服务器:
https://www.helius.dev/docs/mcp - 仪表板: dashboard.helius.dev
- 状态: helius.statuspage.io