Helius API
Query comprehensive Solana data via REST endpoints. Requires HELIUS_API_KEY env var.
Setup
export HELIUS_API_KEY="your-key-here"
Get a key at https://dashboard.helius.dev
Base URLs
- Wallet API:
https://api.helius.xyz/v1/wallet/{address}/...?api-key=KEY - Enhanced Transactions:
https://api-mainnet.helius-rpc.com/v0/...?api-key=KEY
Auth: ?api-key=$HELIUS_API_KEY query param or X-Api-Key header.
Wallet API Endpoints
| Endpoint | Path | Description |
|---|---|---|
| Balances | /v1/wallet/{address}/balances | 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 | /v0/transactions/ (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:
- Balances (portfolio, holdings, USD values): See references/balances.md
- History (wallet tx history, P&L, tax reports): See references/history.md
- Transfers (sent/received, payment tracking): See references/transfers.md
- Identity (wallet labels, exchange detection): See references/identity.md
- Funded By (funding source, sybil detection): See references/funded-by.md
- Enhanced Transactions (parse tx, enhanced history): See references/enhanced-transactions.md
Implementation Notes
- Use
curlorfetch— no SDK required - All endpoints return JSON
- Pagination: use
pageparam (balances) orbefore/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)