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 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)