Skip to main content
Helius Wallet API routes proxy the Helius Wallet API (api.helius.xyz/v1/wallet/*) and are gated with x402 exact payment on Solana mainnet. They are a Helius-only REST surface, distinct from Solana RPC and DAS.

​
Conventions

All Helius Wallet routes share the same shape:
  • Path template: GET /v1/x402/helius/wallet/{method}/:wallet (or POST /v1/x402/helius/wallet/batch-identity)
  • Access mode: exact (paid per call)
  • Alternate methods accepted on the path: HEAD (used for the 402 discovery probe)
  • Request shape:
    • GET routes forward URL query params directly to the upstream.
    • POST /batch-identity forwards a JSON object body.
  • Success body: { ok: true, provider: "helius", cluster: "mainnet", surface: "wallet", method, priceUsd, result }
  • Payment network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp (mainnet)
  • Payment asset: USDC mainnet mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v (6 decimals)
  • Rate limit: 10 rps per helius:mainnet:wallet scope
The Helius Wallet API is mainnet-only. There is no devnet counterpart — domain resolution (SNS .sol, ANS custom TLDs) and identity data only exist on Solana mainnet.
Pricing comes from the Helius per-credit PAYG schedule:
  • Helius Wallet API — 100 credits per call → $0.000500 at $5 / 1 000 000 credits.
Authoritative values are always reported by GET /v1/catalog and by the 402 challenge envelope.

​
Wallet input

Every per-wallet route accepts a single :wallet path parameter. Accepted formats:
  • Base58 Solana address (e.g. GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz)
  • SNS .sol domain (e.g. toly.sol)
  • ANS custom TLD (e.g. miester.bonk, bob.wen)
The gateway accepts any non-empty :wallet value and relies on Helius to return 4xx if the input cannot be resolved.

​
identity

Resolve on-chain identity for a single Solana address or domain.
PathProviderClusterPrice (USD)Cost unit
GET /v1/x402/helius/wallet/identity/:walletheliusmainnet$0.000500100 credits
Query params None. Example 
curl -G "https://gateway.agonx402.com/v1/x402/helius/wallet/identity/toly.sol" \
  -H "PAYMENT-SIGNATURE: <base64 x402 exact payment>"

​
batchIdentity

Batch lookup of identity information for up to 100 Solana addresses and/or domains.
PathProviderClusterPrice (USD)Cost unit
POST /v1/x402/helius/wallet/batch-identityheliusmainnet$0.000500100 credits
Body
FieldTypeRequiredNotes
walletsstring[]yes1..100 entries, each a base58 address or SNS/ANS domain.
Example 
curl -X POST https://gateway.agonx402.com/v1/x402/helius/wallet/batch-identity \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64 x402 exact payment>" \
  -d '{"wallets":["GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz","toly.sol"]}'

​
balances

Retrieve SPL token and NFT balances for a Solana wallet, sorted by USD value.
PathProviderClusterPrice (USD)Cost unit
GET /v1/x402/helius/wallet/balances/:walletheliusmainnet$0.000500100 credits
Query params
FieldTypeRequiredNotes
pageintegerno1..1000.
limitintegerno1..100.
showZeroBalancebooleanno"true" or "false".
showNativebooleannoInclude native SOL balance.
showNftsbooleannoInclude NFT holdings.
Example 
curl -G "https://gateway.agonx402.com/v1/x402/helius/wallet/balances/GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz" \
  --data-urlencode "limit=25" \
  --data-urlencode "showNative=true" \
  -H "PAYMENT-SIGNATURE: <base64 x402 exact payment>"

​
history

Retrieve parsed transaction history with balance changes for a Solana wallet, newest first.
PathProviderClusterPrice (USD)Cost unit
GET /v1/x402/helius/wallet/history/:walletheliusmainnet$0.000500100 credits
Query params
FieldTypeRequiredNotes
limitintegerno1..100.
beforestringnoSignature to paginate before.
afterstringnoSignature to paginate after.
typestringnoOne of the Helius parsed transaction types (e.g. SWAP, TRANSFER, NFT_SALE, NFT_BID, NFT_LISTING, NFT_MINT, TOKEN_MINT, BURN, COMPRESSED_NFT_MINT, etc.).
tokenAccountsstringnonone, balanceChanged, or all.
Example 
curl -G "https://gateway.agonx402.com/v1/x402/helius/wallet/history/GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz" \
  --data-urlencode "limit=25" \
  --data-urlencode "tokenAccounts=balanceChanged" \
  -H "PAYMENT-SIGNATURE: <base64 x402 exact payment>"

​
transfers

Retrieve all token and SOL transfer activity for a Solana wallet with cursor pagination.
PathProviderClusterPrice (USD)Cost unit
GET /v1/x402/helius/wallet/transfers/:walletheliusmainnet$0.000500100 credits
Query params
FieldTypeRequiredNotes
limitintegerno1..100.
cursorstringnoOpaque cursor returned by the previous response.
Example 
curl -G "https://gateway.agonx402.com/v1/x402/helius/wallet/transfers/GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz" \
  --data-urlencode "limit=25" \
  -H "PAYMENT-SIGNATURE: <base64 x402 exact payment>"

​
fundedBy

Discover the original funding source of a Solana wallet (first incoming SOL transfer). Useful for attribution and sybil analysis.
PathProviderClusterPrice (USD)Cost unit
GET /v1/x402/helius/wallet/funded-by/:walletheliusmainnet$0.000500100 credits
Query params None. Example 
curl -G "https://gateway.agonx402.com/v1/x402/helius/wallet/funded-by/GQUtvPx89ZNCwmvQqFmH59bJcU8fW8siETpaxod7Aydz" \
  -H "PAYMENT-SIGNATURE: <base64 x402 exact payment>"

​
See also