Helius 给代理商 - Helius Docs

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	CLI
最佳用途	Claude Code、Cursor、Claude Desktop中的AI代理以及任何兼容MCP的工具	Shell脚本、CI/CD管道、终端工作流
接口	具有类型化输入/输出的结构化工具调用	命令行与`--json`输出
功能	10个路由工具（`heliusWallet`, `heliusAsset`, `heliusTransaction`, …）涵盖区块链查询、交易、webhooks、流媒体、钱包分析、文档和注册	95+命令：相同功能加上配置管理和交互式流程
账户设置	内置：`heliusAccount`动作 `generateKeypair` → `signup`（链接或自动支付）— 不需要外部工具	`helius keygen` → `helius signup`
何时使用	默认选择任何AI代理	当您需要shell级自动化或不使用兼容MCP的工具时

从MCP开始。 如果您的AI工具支持MCP（Claude Code, Cursor, Claude Desktop等），请使用MCP服务器或Claude Code Plugin。CLI对shell脚本和CI/CD非常有用，但对于AI驱动的工作流程，MCP提供了更无缝的体验——AI直接调用工具，而不是生成shell命令并解析输出。

快速入门：代理注册

代理可以使用 Helius CLI 通过四个步骤创建一个 Helius 账户并获取一个 API 密钥：

npm install -g helius-cli    # Install CLI
helius keygen                 # Generate keypair
# (Autopay only) Fund wallet with 1 USDC + ~0.001 SOL — skip if paying via the hosted link
helius signup --email you@example.com --first-name Jane --last-name Doe --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` + `getTransaction`	`getTransactionsForAddress`	单次调用获取完整交易历史和代币账户数据
`getTokenAccountsByOwner`	`getAssetsByOwner` (DAS API)	返回丰富的元数据，而不仅仅是原始账户
`getRecentPrioritizationFees`	`getPriorityFeeEstimate`	预先计算最佳费用，无需手动计算
`getSignaturesForAddress` (用于 cNFTs)	`getSignaturesForAsset` (DAS API)	标准 RPC 不适用于压缩 NFT
`getProgramAccounts` (用于 NFT 搜索)	`searchAssets` 或 `getAssetsByGroup`	更快、更便宜、索引化数据
轮询实时数据	LaserStream WebSocket 或 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` 与 `showFungible`) + Enhanced Transactions
钱包监控器	LaserStream WebSocket 或 Webhooks 实时通知
分析仪表板	Enhanced Transactions API + `getTransactionsForAddress`
空投工具	AirShip （使用 ZK 压缩便宜 95%）

速查限制

速率限制取决于您的计划。代理以Agent级别开始，有1,000,000积分。Agent级别需要支付1美元以防止滥用。

计划	价格	每月积分	RPC速率限制	DAS & 增强API
Agent	$1 注册	1M	10 请求/s	2 请求/s
Developer	$49/月	10M	50 请求/s	10 请求/s
Business	$499/月	100M	200 请求/s	50 请求/s
Professional	$999/月	200M	500 请求/s	100 请求/s

有关每个API的详细速率限制，请参见速率限制。

每次API调用的积分

API	Credits	备注
Standard RPC calls	1	大多数 Solana RPC 方法
`getProgramAccounts`	10	尽可能使用 DAS API
DAS API	10	所有 DAS 端点
Enhanced Transactions	100	解析的交易数据
`getTransactionsForAddress`	10+	仅限 Developer+ 计划。完整交易每返回 100 条需 10 积分；仅签名响应固定为 10 积分。
`getTransfersByAddress`	10	仅限 Developer+ 计划
Wallet API	100	所有 Wallet API 端点
Priority Fee API	1	费用估算
Sender	0	所有计划免费
Webhook events	1	每个事件传送
Webhook management	100	创建、编辑、删除

有关完整的明细，请参阅Credits。

重试和错误处理

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

​MCP vs CLI

​快速入门：代理注册

​认证

​Helius 特定 API 指南

​推荐工作流程

​速查限制

​每次API调用的积分

​重试和错误处理

​HTTP 状态码

​重试模式

​监控信用使用情况

​快速参考

MCP vs CLI

快速入门：代理注册

认证

Helius 特定 API 指南

推荐工作流程

速查限制

每次API调用的积分

重试和错误处理

HTTP 状态码

重试模式

监控信用使用情况

快速参考