helius

Capabilities

Helius is a comprehensive Solana infrastructure platform enabling developers to build high-performance blockchain applications. Agents can leverage Helius to query blockchain data, stream real-time events, send optimized transactions, analyze wallet activity, and access comprehensive digital asset information across Solana mainnet and devnet.

Skills

RPC Infrastructure & Blockchain Queries

• Standard RPC Endpoints: Access full Solana JSON-RPC API compatibility via https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY or devnet equivalent
• Gatekeeper (Beta): Ultra-low latency edge gateway at https://beta.helius-rpc.com/?api-key=YOUR_API_KEY for significantly faster response times
• Staked Connections: Automatic routing to block leaders on paid plans for near-guaranteed transaction delivery
• Global Node Fleet: Automatic routing to nearest node across Pittsburgh, Newark, Salt Lake City, Los Angeles, Vancouver, Dublin, London, Amsterdam, Frankfurt, Singapore, and Tokyo

Account & Balance Queries

• getAccountInfo: Retrieve detailed account data including lamports, owner, executable status, and rent epoch
• getBalance: Query SOL balance for any account
• getMultipleAccounts: Fetch data for multiple accounts in a single request
• getTokenAccountBalance: Get SPL token balance for a specific token account
• getTokenAccountsByOwner: List all token accounts owned by a wallet with optional mint filter
• getTokenAccountsByDelegate: Find token accounts delegated to a specific address
• getTokenLargestAccounts: Identify the largest token holders for a mint
• getTokenSupply: Get total supply and decimal information for a token

Transaction & Block Data

• getTransaction: Retrieve full transaction details including instructions, account changes, and logs
• getTransactionsForAddress: Get transaction history for any address with optional filtering
• getBlock: Fetch complete block data including all transactions and rewards
• getBlockTime: Get Unix timestamp for a specific block
• getLatestBlockhash: Retrieve current blockhash for transaction construction
• getSignaturesForAddress: Get transaction signatures for an address with pagination
• getSignatureStatuses: Check confirmation status of multiple transaction signatures
• getTransactionCount: Get total number of transactions processed by the cluster

Program & State Queries

• getProgramAccounts: Query all accounts owned by a program with optional filters
• getProgramAccountsV2: Enhanced version with advanced filtering capabilities
• getLeaderSchedule: Get upcoming block leaders and their slots
• getSlotLeader: Identify current slot leader
• getVoteAccounts: Retrieve all vote accounts with delegation information

Network & Cluster Information

• getClusterNodes: Get information about all cluster nodes
• getHealth: Check cluster health status
• getIdentity: Get cluster identity information
• getVersion: Retrieve Solana version information
• getSlot: Get current slot number
• getEpochInfo: Get current epoch and slot progress
• getEpochSchedule: Retrieve epoch schedule parameters
• getSupply: Get total SOL supply and circulating supply
• getInflationRate: Get current inflation rate
• getInflationGovernor: Retrieve inflation governor parameters

Digital Asset Standard (DAS) API

• getAsset: Fetch detailed metadata for individual NFTs, tokens, or compressed assets
• getAssetBatch: Retrieve data for up to 1,000 assets in a single request
• getAssetsByOwner: List all assets (NFTs, tokens, cNFTs) owned by a wallet with pagination
• getAssetsByGroup: Query assets by collection, grouping, or authority
• getAssetsByCreator: Find all assets created by a specific address
• getAssetsByAuthority: Retrieve assets managed by a specific authority
• searchAssets: Advanced search with complex filtering by attributes, creators, collections, and more
• getAssetProof: Get Merkle proof for compressed NFTs (required for on-chain operations)
• getAssetProofBatch: Retrieve proofs for multiple compressed assets
• getNftEditions: Get all editions for a master NFT
• getTokenAccounts: Query token accounts by mint or owner
• getSignaturesForAsset: Get transaction history for compressed assets

Enhanced Transactions API

• Parse Transactions: Transform raw Solana transactions into human-readable format with decoded instructions
• Get Transaction History: Retrieve parsed transaction history for any address with balance changes
• Filter by Type: Filter transactions by type (NFT_SALE, SWAP, TRANSFER, LIQUIDATION, etc.)
• Pagination Support: Efficiently fetch large transaction histories with cursor-based pagination

Wallet API (Beta)

• Get Wallet Identity: Identify known wallets (exchanges, protocols, institutions) from 5,100+ tagged accounts
• Batch Identity Lookup: Identify up to 100 addresses in a single request
• Get Wallet Balances: Retrieve all token and NFT holdings with USD values (hourly price updates)
• Get Wallet History: Fetch complete transaction history with balance changes for each transaction
• Get Token Transfers: List all incoming and outgoing token transfers with counterparty information
• Get Funding Source: Discover the original funding source and amount for wallet attribution

Priority Fee API

• Estimate Fees (Serialized Transaction): Get accurate priority fee recommendations by analyzing exact transaction operations
• Estimate Fees (Account Keys): Get fee estimates based on account keys involved in transaction
• Six Priority Levels: Choose from Low, Medium, High, VeryHigh, UltraHigh, and Min priority levels
• Real-time Network Conditions: Recommendations account for current network congestion and transaction complexity

Transaction Sending

• Staked Connections: Send transactions directly to block leaders with priority lane access (paid plans)
• Helius Sender: Ultra-low latency transaction sending with dual routing to validators and Jito infrastructure
• Global Endpoints: Multiple regional endpoints for optimal latency
• Backrun Rebates: Earn automatic SOL rebates via post-trade backruns with no additional MEV risk
• sendTransaction: Submit transactions with automatic optimization and routing

Real-Time Data Streaming

LaserStream gRPC

• Ultra-Low Latency: Purpose-built streaming with processed data and commitment-level guarantees
• Historical Replay: Automatically backfill missed data from last 24 hours (up to 216,000 slots)
• Multi-Node Reliability: Stream from multiple aggregated nodes simultaneously for maximum uptime
• Advanced Filtering: Filter by accounts, transaction types, commitment levels, and data content
• Regional Endpoints: Available in 9 regions (Newark, Pittsburgh, Salt Lake City, Los Angeles, London, Amsterdam, Frankfurt, Tokyo, Singapore)
• Auto-Reconnection: SDK automatically handles reconnections and data gaps

Enhanced WebSockets

• Advanced Filtering: Powerful filtering options for accounts and transactions
• Granular Subscriptions: Fine-grained control over subscription parameters
• Real-time Updates: Instant notifications for account changes and transactions

Standard WebSockets

• Account Monitoring: Subscribe to account changes with accountSubscribe
• Transaction Monitoring: Monitor program transactions with programSubscribe
• Block Monitoring: Track block production with blockSubscribe
• Slot Updates: Monitor slot progression with slotSubscribe
• Log Monitoring: Filter transaction logs with logsSubscribe

Webhooks

• Event-Driven Notifications: Receive HTTP POST notifications for on-chain events
• Enhanced Transaction Webhooks: Human-readable, parsed data for specific transaction types
• Raw Transaction Webhooks: Raw transaction data for all monitored addresses
• Discord Webhooks: Stream updates directly to Discord channels
• Custom Filtering: Filter by transaction type (NFT sales, swaps, transfers, liquidations, etc.)
• Retry Logic: Automatic retries with potential for duplicate events

ZK Compression APIs

• getCompressedAccount: Retrieve compressed account data
• getCompressedAccountProof: Get proof for compressed account verification
• getCompressedAccountsByOwner: List compressed accounts owned by an address
• getCompressedBalance: Get balance of compressed accounts
• getCompressedTokenAccountBalance: Query compressed token account balances
• getCompressedTokenAccountsByOwner: List compressed token accounts by owner
• getCompressedTokenBalancesByOwner: Get all compressed token balances for an owner
• getCompressedMinttokenHolders: Find holders of a compressed token
• getCompressionSignaturesForAddress: Get transaction history for compressed accounts
• getValidityProof: Generate zero-knowledge proofs for compressed data operations
• getIndexerHealth: Check ZK compression indexer status

Workflows

Query Wallet Portfolio

1. Call getAssetsByOwner with wallet address to get all NFTs and tokens
2. Use getBalance to get SOL balance
3. Call Wallet API balances endpoint to get USD values for all holdings
4. Combine results to display complete portfolio with market values

Monitor NFT Collection Sales

1. Create webhook for collection address with type filter for NFT_SALE
2. Webhook delivers parsed transaction data when sales occur
3. Extract buyer, seller, price, and NFT details from webhook payload
4. Use getAsset to fetch additional NFT metadata if needed

Track Transaction History with Balance Changes

1. Call Wallet API history endpoint for address
2. Receive parsed transactions with balance changes for each transaction
3. Use pagination with before parameter to fetch older transactions
4. Display chronological transaction history with human-readable descriptions

Stream Real-Time Market Data

1. Subscribe to LaserStream gRPC with account filters for DEX pools or AMM programs
2. Specify fromSlot parameter for historical replay if reconnecting
3. Receive real-time transaction and account updates as they occur
4. Process streamed data for price feeds, arbitrage detection, or liquidation monitoring

Send Optimized Transaction

1. Build transaction with all instructions
2. Call Priority Fee API with serialized transaction to get fee estimate
3. Add priority fee instruction using recommended price per compute unit
4. Send via Helius Sender endpoint with tips for Jito auction participation
5. Monitor confirmation status with getSignatureStatuses

Identify Wallet Type

1. Call Wallet API identity endpoint with wallet address
2. Receive identity information if wallet is known (exchange, protocol, institution)
3. Use batch endpoint to identify up to 100 addresses in single request
4. Filter results by category (exchange, protocol, validator, etc.)

Analyze Compressed NFT Operations

1. Call getAsset to retrieve compressed NFT data
2. Call getAssetProof to get Merkle proof for the compressed NFT
3. Use proof in on-chain transaction for transfer or burn operations
4. Call getSignaturesForAsset to retrieve transaction history for the cNFT

Integration

Helius integrates with:

• Solana Programs: Direct access to all Solana RPC methods and custom program data
• DEX Protocols: Monitor swaps, liquidity pools, and price data via transaction streaming
• NFT Marketplaces: Track sales, listings, and transfers via webhooks and DAS API
• Wallet Applications: Provide portfolio data, transaction history, and balance information
• Trading Bots: Real-time data streaming for arbitrage and liquidation detection
• Analytics Platforms: Comprehensive transaction and wallet data for on-chain analysis
• Discord: Direct webhook integration for event notifications
• Custom Backends: REST and gRPC APIs for server-side integration
• JavaScript/TypeScript: Official SDKs for easy integration
• Rust: Native Rust SDK support

Context

API Authentication: All requests require an API key from the Helius Dashboard. Pass via query parameter ?api-key=YOUR_API_KEY or header X-Api-Key: YOUR_API_KEY.

Rate Limits: Vary by plan (free to enterprise). RPC rate limits apply across all methods collectively, not per-method. DAS and Wallet API have separate rate limit pools.

Credits System: Different operations consume different credit amounts. Wallet API requests cost 100 credits each. ZK Compression API costs 10 credits per call (100 for getValidityProof). LaserStream costs 3 credits per 0.1 MB of data.

Commitment Levels: Transactions can be queried at processed, confirmed, or finalized commitment levels. Staked connections default to confirmed commitment.

Pagination: DAS API pagination starts at page 1 (not 0). Wallet API uses cursor-based pagination with before parameter and pagination.nextCursor in responses.

Compressed Assets: Compressed NFTs (cNFTs) require Merkle proofs for on-chain operations. Use getAssetProof to retrieve proofs before constructing transactions.

Network Availability: Mainnet endpoints available for production. Devnet endpoints available for testing. LaserStream mainnet requires Professional plan or higher.

Latency Optimization: Use Gatekeeper (beta) for lower latency RPC queries. Use LaserStream for ultra-low latency streaming. Use regional endpoints closest to your application server.

For additional documentation and navigation, see: https://www.helius.dev/docs/llms.txt