跳转到主要内容
Helius 为在 Solana 上构建的 AI 代理提供一流支持。从程序化帐户创建到实时数据流,代理可以在无需人工干预的情况下访问 Helius 的全部功能。
  • 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 密钥:
npm install -g helius-cli    # Install CLI
helius keygen                 # Generate keypair
# Fund wallet with 1 USDC + ~0.001 SOL
helius signup --json          # Get API key (JSON output)
成功后,您的代理将收到 API 密钥、RPC 端点和 1,000,000 积分。有关详细信息,请参阅完整 CLI 指南

认证

所有 Helius API 请求都需要作为查询参数传递的 API 密钥:
?api-key=YOUR_API_KEY
将此添加到任何 RPC 或 API 端点。例如:https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY Helius 管理面板 或通过 Helius CLI 程序化获取一个 API 密钥。
使用 Gatekeeper 以降低延迟Gatekeeper (Beta) 从关键路径中移除 Cloudflare,减少响应时间数十到数百毫秒。相同的 API 密钥,相同的方法 — 只需更换端点:
https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY
支持所有 RPC、DAS、WebSocket、ZK 压缩、优先费和增强交易方法。详情请参阅迁移指南

Helius 特定的 API 指南

使用这些 Helius 优化的 API,而不是链接标准的 Solana RPC 方法:
替代…使用这个原因
getSignaturesForAddress + getTransactiongetTransactionsForAddress单次调用返回完整的交易历史和代币账户数据
getTokenAccountsByOwnergetAssetsByOwner (DAS API)返回详细的元数据,而不仅仅是原始账户
getRecentPrioritizationFeesgetPriorityFeeEstimate预先计算的最佳费用,无需手动计算
getSignaturesForAddress (用于 cNFTs)getSignaturesForAsset (DAS API)标准 RPC 无法处理压缩的 NFTs
getProgramAccounts (用于 NFT 搜索)searchAssetsgetAssetsByGroup更快、更便宜、经过索引的数据
实时数据轮询Enhanced WebSocketsLaserStream gRPC更低的延迟,更高效
标准 sendTransactionHelius 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 WebSocketsWebhooks 用于实时通知
分析仪表板Enhanced Transactions API + getTransactionsForAddress
空投工具AirShip (通过 ZK 压缩节省 95%)

速率限制快速参考

速率限制取决于您的计划。代理从免费等级开始,拥有1,000,000积分。
计划价格每月积分RPC 速率限制DAS 和增强 API
免费$0/月1M10 次请求/秒2 次请求/秒
开发者$49/月10M50 次请求/秒10 次请求/秒
商业$499/月100M200 次请求/秒50 次请求/秒
专业$999/月200M500 次请求/秒100 次请求/秒
有关每个 API 的详细速率限制,请参阅速率限制

每次 API 调用的积分

API积分备注
标准 RPC 调用1大多数 Solana RPC 方法
getProgramAccounts10尽可能使用 DAS API
DAS API10所有 DAS 端点
增强交易100已解析的交易数据
getTransactionsForAddress100仅限开发者及以上计划
钱包 API100所有钱包 API 端点
优先费用 API1费用估算
发件人0所有计划免费
Webhook 事件1每次事件传递
Webhook 管理100创建、编辑、删除
有关完整细分,请参阅积分

重试和错误处理

HTTP 状态代码

代码含义动作
200成功处理响应
400错误请求修正请求参数
401未授权检查 API 密钥
429速率限制退避并重试
5xx服务器错误指数退避重试

重试模式

async function heliusRequest(url: string, data: object, maxRetries = 3) {
  for (let attempt = 0; attempt < maxRetries; attempt++) {
    const response = await fetch(url, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify(data),
    });

    if (response.ok) return response.json();

    if (response.status === 429) {
      const retryAfter = response.headers.get('Retry-After');
      const delay = retryAfter ? parseInt(retryAfter) * 1000 : Math.pow(2, attempt) * 1000;
      await new Promise(resolve => setTimeout(resolve, delay));
      continue;
    }

    if (response.status >= 500) {
      await new Promise(resolve => setTimeout(resolve, Math.pow(2, attempt) * 1000));
      continue;
    }

    throw new Error(`Request failed: ${response.status} ${await response.text()}`);
  }
  throw new Error('Max retries exceeded');
}

监控信用使用

helius usage --json

快速参考

  • 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