Skip to main content
Helius 为在 Solana 上构建的 AI 代理提供一流支持。从程序化帐户创建到实时数据流,代理可以在无需人工干预的情况下访问 Helius 的全部功能。
  • Helius MCP — 包含 10 个路由工具,可用于查询区块链、发送交易、流媒体等
  • Claude Code Plugin — 第一个,也是目前唯一,一个来自加密公司的官方 Claude Code 插件。一次安装:MCP 服务器 + 技能 + 参考文件
  • Skills — Claude 的专家指令集:Build、Phantom、Jupiter、DFlow、OKX、SVM
  • TypeScript SDK — 为所有 Helius API 提供类型安全的方法
  • Rust SDK — 高性能的 Rust SDK,用于 Helius API
  • Helius CLI — 账户管理和脚本编写
本节的机器可读版本可在 agents/llms.txt 获得,以供 AI 代理使用。

MCP vs CLI

Helius MCP服务器 是AI代理与Helius交互的推荐方式。它提供了10个路由工具,为AI提供直接、结构化的Solana访问——无需shell命令、无需输出解析、无需手动API调用。
从MCP开始。 如果您的AI工具支持MCP(Claude Code, Cursor, Claude Desktop等),请使用MCP服务器或Claude Code Plugin。CLI对shell脚本和CI/CD非常有用,但对于AI驱动的工作流程,MCP提供了更无缝的体验——AI直接调用工具,而不是生成shell命令并解析输出。

快速入门:代理注册

代理可以创建一个 Helius 帐户,并使用 Helius CLI 获取一个 API 密钥:
每次新注册(包括 Agent 套餐)都需要提供电子邮件地址、名字和姓氏。钱包仅用于付款。
成功后(--resume 或 --pay),你的代理将获得一个 API 密钥、RPC 端点和 1,000,000 积分。有关详细信息,请参阅完整 CLI 指南。

身份验证

所有 Helius API 请求都需要将 API 密钥作为查询参数传递:
将其附加到任意 RPC 或 API 端点。例如:https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY 通过 Helius 控制面板获取 API 密钥,或使用 Helius CLI 以编程方式获取。
使用 Gatekeeper 降低延迟 — Gatekeeper(Beta)从关键路径中移除了 Cloudflare,将响应时间缩短数十到数百毫秒。使用相同的 API 密钥和方法,只需替换端点:
支持所有 RPC、DAS、WebSocket、ZK 压缩、优先费和增强型交易方法。有关详细信息,请参阅迁移指南。

Helius 专用 API 指南

请使用这些针对 Helius 优化的 API,而不是串联标准 Solana RPC 方法:

推荐工作流

使用 Wallet API 余额获取投资组合摘要时,请注意:该 API 仍处于 Beta 阶段;每页最多包含 100 种代币;除非使用 showNfts=true,否则不包含 NFT(且仅第一页最多包含 100 个 NFT);pricePerToken 和 usdValue 可能为 null;价格为每小时估算值,而非实时市场价格;totalUsdValue 仅涵盖当前页面,而非完整的分页投资组合;每个请求消耗 100 积分。请使用分页 DAS 获取完整的 NFT 清单和元数据,不要将 Balances 视为完整的 NFT 清单。

速率限制快速参考

速率限制取决于你的套餐。代理初始使用 Agent 层级,并拥有 1,000,000 积分。Agent 层级需要一次性支付 $10 USDC,并且每次新注册都需要提供电子邮件地址、名字和姓氏。
所有以美元显示的价格均为美国美元(USD)。
有关各 API 的详细速率限制,请参阅速率限制。

每次 API 调用消耗的积分

有关完整明细,请参阅积分。

重试和错误处理

HTTP 状态码

重试模式

监控积分使用量

快速参考

  • 主网 RPC:https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • 主网 RPC(Gatekeeper Beta):https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • 开发网 RPC:https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • 主网 WSS:wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • 主网 WSS(Gatekeeper Beta):wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
  • 开发网 WSS:wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
  • Sender 端点:https://sender.helius-rpc.com/fast
  • MCP 服务器:https://www.helius.dev/docs/mcp
  • 控制面板:dashboard.helius.dev
  • 状态:helius.statuspage.io