helius-api

name

helius-api

description

Query Solana data via the Helius API. Use when the user asks about Solana wallet balances, token holdings, NFT holdings, transaction history, transfer activity, wallet identity/labels, wallet funding sources, parsing transactions, or other Solana on-chain data. Triggers on: "solana wallet", "sol balance", "solana transactions", "wallet history", "who funded this wallet", "wallet identity", "solana transfers", "solana NFTs", "helius", "check solana address", "solana data", "parse transaction", "enhanced transactions", "transaction details".

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)