helius-api
Enhanced Solana RPC with DAS API, parsed transactions, webhooks, and priority fee estimation via Helius
agiprolabs · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add agiprolabs/claude-trading-skills --skill helius-api技能说明
name: helius-api description: Enhanced Solana RPC with DAS API, parsed transactions, webhooks, and priority fee estimation via Helius
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
Estimat
阅读完整来源 ↗