Helius 给代理商 - Helius Docs

Helius 为在 Solana 上构建的 AI 代理提供一流支持。从程序化帐户创建到实时数据流，代理可以在无需人工干预的情况下访问 Helius 的全部功能。

Helius MCP — 超过60种工具用于查询区块链、发送交易等
Claude Code Plugin — 一键安装: MCP服务器+技能+参考文件
Skills — Claude的专家指令集：Build, Phantom, DFlow, SVM
TypeScript SDK — 为所有Helius API提供类型安全的方法
Rust SDK — 高性能的Rust SDK，用于Helius API
Helius CLI — 账户管理和脚本编写

本节的机器可读版本可在 agents/llms.txt 获得，以供 AI 代理使用。

MCP vs CLI

Helius MCP 服务器是AI代理与Helius交互的推荐方式。提供60多种工具，使AI直接、结构化地访问Solana —— 无需使用shell命令、解析输出或手动API调用。

	MCP	CLI
最佳用途	Claude Code、Cursor、Claude Desktop中的AI代理以及任何兼容MCP的工具	Shell脚本、CI/CD管道、终端工作流
接口	结构化工具调用，具有类型化输入/输出	命令行，带`--json`输出
功能	60多种工具：区块链查询、交易、webhooks、流媒体、钱包分析、文档和注册	超过95个命令：相同功能外加配置管理和交互式流程
账户设置	内置：`generateKeypair` → `agenticSignup` — 无需外部工具	`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
# 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` + `getTransaction`	`getTransactionsForAddress`	单次调用返回完整的交易历史和代币账户数据
`getTokenAccountsByOwner`	`getAssetsByOwner` (DAS API)	返回丰富的元数据，而不仅仅是原始账户
`getRecentPrioritizationFees`	`getPriorityFeeEstimate`	预先计算的最佳费用，无需手动计算
`getSignaturesForAddress` (对于 cNFTs)	`getSignaturesForAsset` (DAS API)	标准 RPC 不适用于压缩 NFT
`getProgramAccounts` (对于 NFT 搜索)	`searchAssets` 或 `getAssetsByGroup`	更快、更便宜、索引的数据
轮询实时数据	增强型 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` 与 `showFungible`）+ Enhanced Transactions
钱包监控	Enhanced WebSockets 或 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	积分	备注
标准RPC调用	1	大多数Solana RPC方法
`getProgramAccounts`	10	尽可能使用DAS API
DAS API	10	所有DAS端点
增强交易	100	解析的交易数据
`getTransactionsForAddress`	100	仅限Developer+计划
钱包API	100	所有钱包API端点
Priority Fee API	1	费用估算
Sender	0	所有计划免费
Webhook事件	1	每个事件传递
Webhook管理	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 状态码

重试模式

监控信用使用情况

快速参考