Helius API
Query comprehensive Solana data via REST endpoints. Requires HELIUS_API_KEY env var.
Setup
CODEBLOCK0
Get a key at
Base URLs
- - Wallet API: INLINECODE1
- Enhanced Transactions: INLINECODE2
Auth: ?api-key=$HELIUS_API_KEY query param or X-Api-Key header.
Wallet API Endpoints
| Endpoint | Path | Description |
|---|
| Balances | INLINECODE5 | Token + NFT holdings with USD values |
| History |
/v1/wallet/{address}/history | Parsed transaction history with balance changes |
| Transfers |
/v1/wallet/{address}/transfers | Token transfer activity (sent/received) |
| Identity |
/v1/wallet/{address}/identity | Known wallet labels (exchanges, protocols) |
| Batch Identity |
/v1/wallet/batch-identity (POST) | Look up up to 100 addresses at once |
| Funded By |
/v1/wallet/{address}/funded-by | Original funding source of a wallet |
Enhanced Transactions Endpoints
| Endpoint | Path | Description |
|---|
| Parse Transactions | INLINECODE11 (POST) | Parse signatures into human-readable data |
| Transaction History |
/v0/addresses/{address}/transactions | Enhanced tx history with type/time/slot filtering |
Reference Files
Read the appropriate file for detailed parameters, response formats, and examples:
Implementation Notes
- - Use
curl or fetch — no SDK required - All endpoints return JSON
- Pagination: use
page param (balances) or before/cursor (history, transfers) - Default limit: 100 per request
- Wallet API requests cost 100 credits each
- Identity returns 404 for unknown wallets — handle gracefully
- Funded By returns 404 if wallet never received SOL
- Enhanced Transactions uses a different base URL (
api-mainnet.helius-rpc.com)
Helius API
通过REST端点查询全面的Solana数据。需要设置HELIUSAPIKEY环境变量。
设置
bash
export HELIUSAPIKEY=your-key-here
在获取密钥
基础URL
- - 钱包API: https://api.helius.xyz/v1/wallet/{address}/...?api-key=KEY
- 增强交易: https://api-mainnet.helius-rpc.com/v0/...?api-key=KEY
认证方式：?api-key=$HELIUSAPIKEY查询参数或X-Api-Key请求头。
钱包API端点
| 端点 | 路径 | 描述 |
|---|
| 余额 | /v1/wallet/{address}/balances | 代币+NFT持仓及美元价值 |
| 历史 |
/v1/wallet/{address}/history | 带余额变动的解析交易历史 |
| 转账 | /v1/wallet/{address}/transfers | 代币转账活动（发送/接收） |
| 身份 | /v1/wallet/{address}/identity | 已知钱包标签（交易所、协议） |
| 批量身份 | /v1/wallet/batch-identity (POST) | 一次性查询最多100个地址 |
| 资金来源 | /v1/wallet/{address}/funded-by | 钱包的原始资金来源 |
增强交易端点
| 端点 | 路径 | 描述 |
|---|
| 解析交易 | /v0/transactions/ (POST) | 将签名解析为人类可读数据 |
| 交易历史 |
/v0/addresses/{address}/transactions | 带类型/时间/槽位过滤的增强交易历史 |
参考文件
阅读相应文件获取详细参数、响应格式和示例：
实现说明
- - 使用curl或fetch——无需SDK
- 所有端点返回JSON格式
- 分页：使用page参数（余额）或before/游标（历史、转账）
- 默认限制：每次请求100条
- 钱包API请求每次消耗100积分
- 身份端点对未知钱包返回404——请优雅处理
- 资金来源端点对从未接收过SOL的钱包返回404
- 增强交易使用不同的基础URL（api-mainnet.helius-rpc.com）
