helius-api

// 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 bal

$ git log --oneline --stat

stars:1,933

forks:367

updated:March 4, 2026

SKILL.mdreadonly

SKILL.md Frontmatter

namehelius-api

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