SkillHub

helius-api

v1.0.0

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

Sourced from ClawHub, Authored by itsahedge

Installation

Please help me install the skill `helius-api` from SkillHub official store. npx skills add itsahedge/helius-api

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)