helius-api

Helius API — Enhanced Solana RPC

Helius extends standard Solana RPC with parsed transaction history, a unified Digital Asset Standard (DAS) API, webhooks, and priority fee estimation. Essential for wallet analysis, token metadata, and transaction monitoring.

Quick Start

1. Get an API Key

Sign up at dashboard.helius.dev — free tier available (1M credits/mo, no card required).

export HELIUS_API_KEY="your-api-key"

2. Install Dependencies

uv pip install httpx python-dotenv

3. Two Base URLs

Helius uses different base URLs depending on the API:

API	Base URL	Protocol
RPC / DAS / Priority Fees	https://mainnet.helius-rpc.com/?api-key=KEY	JSON-RPC 2.0
Enhanced Transactions / Webhooks	https://api-mainnet.helius-rpc.com/v0/...?api-key=KEY	REST

DAS API (Digital Asset Standard)

Unified interface for querying all Solana digital assets — fungible tokens, NFTs, compressed NFTs, Token-2022.

Get Asset Metadata

import httpx, os

API_KEY = os.environ["HELIUS_API_KEY"]
RPC_URL = f"https://mainnet.helius-rpc.com/?api-key={API_KEY}"

resp = httpx.post(RPC_URL, json={
    "jsonrpc": "2.0", "id": 1,
    "method": "getAsset",
    "params": {
        "id": "So11111111111111111111111111111111111111112",  # wSOL
        "options": {"showFungible": True}
    }
})
asset = resp.json()["result"]
# asset.content.metadata.name, asset.token_info.decimals, etc.

Get All Assets for a Wallet

resp = httpx.post(RPC_URL, json={
    "jsonrpc": "2.0", "id": 1,
    "method": "getAssetsByOwner",
    "params": {
        "ownerAddress": "WALLET_ADDRESS",
        "page": 1,
        "limit": 100,
        "displayOptions": {
            "showFungible": True,
            "showNativeBalance": True,
            "showZeroBalance": False,
        }
    }
})
assets = resp.json()["result"]["items"]

Search Assets with Filters

resp = httpx.post(RPC_URL, json={
    "jsonrpc": "2.0", "id": 1,
    "method": "searchAssets",
    "params": {
        "ownerAddress": "WALLET_ADDRESS",
        "tokenType": "fungible",      # fungible | nonFungible | all
        "page": 1,
        "limit": 50,
    }
})

All DAS Methods

Method	Purpose	Credits
getAsset	Single asset metadata	10
getAssetBatch	Up to 1,000 assets	10
getAssetsByOwner	All assets for a wallet	10
getAssetsByGroup	Assets by collection	10
getAssetsByCreator	Assets by creator	10
getAssetsByAuthority	Assets by update authority	10
searchAssets	Multi-criteria filtered search	10
getAssetProof	Merkle proof (compressed NFTs)	10
getAssetProofBatch	Batch proofs	10
getSignaturesForAsset	Tx history for an asset	10
getNftEditions	All editions of a master	10
getTokenAccounts	Token accounts by mint/owner	10

See references/das_api.md for complete field documentation.

Enhanced Transactions API

Transforms raw Solana transactions into human-readable structured data with categorized types and sources.

Parse a Transaction

API_URL = f"https://api-mainnet.helius-rpc.com/v0/transactions?api-key={API_KEY}"

resp = httpx.post(API_URL, json={
    "transactions": ["SIGNATURE_HERE"],
})
parsed = resp.json()[0]
# parsed["type"]        → "SWAP"
# parsed["source"]      → "JUPITER"
# parsed["description"] → "User swapped 1 SOL for 150 USDC on Jupiter"
# parsed["tokenTransfers"] → [{mint, amount, from, to}, ...]
# parsed["nativeTransfers"] → [{from, to, amount}, ...]

Get Parsed Transaction History for a Wallet

url = f"https://api-mainnet.helius-rpc.com/v0/addresses/{wallet}/transactions"
resp = httpx.get(url, params={
    "api-key": API_KEY,
    "limit": 50,
    "type": "SWAP",  # optional filter
})
history = resp.json()

Transaction Types (151+)

Key types for trading analysis:

Type	Meaning
SWAP	DEX swap
TRANSFER	Token/SOL transfer
ADD_LIQUIDITY / REMOVE_LIQUIDITY	LP operations
NFT_SALE / NFT_MINT / NFT_LISTING	NFT marketplace
STAKE_SOL / UNSTAKE_SOL	Staking
CREATE_ORDER / FILL_ORDER	Limit orders

Transaction Sources (50+)

JUPITER, RAYDIUM, ORCA, MAGIC_EDEN, TENSOR, MARINADE, METEORA, PHANTOM, etc.

See references/enhanced_transactions.md for full type/source enums.

Webhooks

Real-time notifications for on-chain events — no polling required.

Create a Webhook

url = f"https://api-mainnet.helius-rpc.com/v0/webhooks?api-key={API_KEY}"
resp = httpx.post(url, json={
    "webhookURL": "https://your-server.com/helius-hook",
    "transactionTypes": ["SWAP", "TRANSFER"],
    "accountAddresses": ["WalletAddress1", "WalletAddress2"],
    "webhookType": "enhanced",
    "authHeader": "your-secret-token",
})
webhook_id = resp.json()["webhookID"]

Webhook Types

Type	Data Format	Filtering
enhanced	Parsed (like Enhanced Transactions API)	By transaction type + account
raw	Unprocessed transaction data	By account only (lower latency)
discord	Formatted messages to Discord channel	By transaction type + account

Manage Webhooks

# List all
webhooks = httpx.get(f"{url}?api-key={API_KEY}").json()

# Update
httpx.put(f"{url}/{webhook_id}?api-key={API_KEY}", json={
    "webhookURL": "https://new-url.com/hook",
    "transactionTypes": ["SWAP"],
    "accountAddresses": ["NewWallet..."],
    "webhookType": "enhanced",
})

# Delete
httpx.delete(f"{url}/{webhook_id}?api-key={API_KEY}")

Up to 100,000 addresses per webhook (via API). 1 credit per event delivered.

Priority Fee API

Estimate optimal priority fees for transaction landing.

resp = httpx.post(RPC_URL, json={
    "jsonrpc": "2.0", "id": 1,
    "method": "getPriorityFeeEstimate",
    "params": [{
        "accountKeys": ["JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"],
        "options": {
            "includeAllPriorityFeeLevels": True,
            "recommended": True,
        }
    }]
})
fees = resp.json()["result"]
# fees["priorityFeeEstimate"]  → recommended fee (microlamports/CU)
# fees["priorityFeeLevels"]    → {min, low, medium, high, veryHigh, unsafeMax}

Level	Percentile	Use Case
min	0-20th	Non-urgent
low	20-40th	Standard transfers
medium	40-60th	DEX swaps (recommended default)
high	60-80th	Time-sensitive
veryHigh	80-95th	Critical timing
unsafeMax	100th	Emergency only

Fee in microlamports/CU. Total priority fee = microlamports/CU × compute units consumed.

Pricing & Rate Limits

Plan	Price/mo	Credits	RPC req/s	DAS req/s
Free	$0	1M	10	2
Developer	$49	10M	50	10
Business	$499	100M	200	50
Professional	$999	200M	500	100

Credit costs: Standard RPC = 1, DAS = 10, Enhanced Txns = 100, Webhooks = 1/event. Additional credits: $5/million.

Files

References

• references/das_api.md — Complete DAS API field reference and response schemas
• references/enhanced_transactions.md — Transaction types, sources, and response structure
• references/webhooks.md — Webhook setup, management, and event handling
• references/error_handling.md — Rate limits, error codes, and retry strategies

Scripts

• scripts/wallet_analysis.py — Fetch wallet assets and parsed transaction history
• scripts/token_lookup.py — Look up token metadata and holder information via DAS