# Helius Documentation

The leading Solana RPC and infrastructure platform. Fast, reliable APIs for building on Solana.

## Getting Started

1. Sign up at https://dashboard.helius.dev
2. Get your API key
3. Start building with any of our APIs below

## Getting Started (Agents)

Programmatically create a Helius account and generate an API key.

Guide: https://www.helius.dev/docs/agents/cli.md  
Full instructions: https://dashboard.helius.dev/agents.md

### Step 1: Install CLI

Programmatically create accounts and get API keys via CLI:

```bash
npm install -g helius-cli
```

### Step 2: Generate Keypair

```bash
helius keygen
```

Output: Creates keypair at `~/.helius/keypair.json`

Returns: Wallet address to fund

### Step 3: Fund Wallet (Autopay only)

Skip this step if paying via the hosted payment link (the default signup mode, finalized with `helius signup --resume`). Autopay (`--pay`) pays USDC from the local keypair, which must be funded first.

For autopay, send to the wallet address from Step 2:
- Plan USDC (token: `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`)
- ~0.001 SOL

### Step 4: Signup and Get API Key

Two payment modes:

```bash
# Default: prints a hosted payment link — pay with any wallet in the browser
helius signup --email you@example.com --first-name Jane --last-name Doe --json

# After paying via the link, finalize the account
helius signup --resume --json

# Or autopay from the funded local keypair (Step 3); Agent is the default plan
helius signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe --json
```

Note: the default `helius signup` returns a hosted payment URL, not an API key. The success fields below come from `helius signup --resume` or autopay (`--pay`).

#### Success Response from `--resume` or `--pay` (exit code 0):

```json
{
  "status": "SUCCESS",
  "apiKey": "your-api-key-here",
  "endpoints": {
    "mainnet": "https://mainnet.helius-rpc.com/?api-key=your-api-key-here",
    "devnet": "https://devnet.helius-rpc.com/?api-key=your-api-key-here"
  },
  "credits": 1000000
}
```

Extract API key: `response.apiKey`

Extract RPC URL: `response.endpoints.mainnet` or `response.endpoints.devnet`

## Quick Reference

- Mainnet RPC: https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
- Mainnet RPC (Gatekeeper Beta): https://beta.helius-rpc.com/?api-key=YOUR_API_KEY
- Devnet RPC: https://devnet.helius-rpc.com/?api-key=YOUR_API_KEY
- Mainnet WSS: wss://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY (LaserStream WebSocket: standard Solana subscriptions plus Helius extensions)
- Mainnet WSS (Gatekeeper Beta): wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY (LaserStream WebSocket: standard Solana subscriptions plus Helius extensions)
- Devnet WSS: wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY (LaserStream WebSocket: standard Solana subscriptions plus Helius extensions)
- Auth: API key via query parameter (?api-key=YOUR_API_KEY)
- Billing: https://www.helius.dev/docs/billing/llms.txt
- Dashboard: https://dashboard.helius.dev
- Status: https://helius.statuspage.io

## API Documentation

### Solana RPC
Standard Solana JSON-RPC methods with enhanced performance.  
https://www.helius.dev/docs/api-reference/rpc/http/llms.txt

### LaserStream WebSocket
Helius's WebSocket streaming product. Serves the standard Solana WebSocket subscriptions plus Helius extensions (`transactionSubscribe`, enhanced `accountSubscribe`) for advanced filtering on a single unified endpoint, on the same backend as LaserStream gRPC. Standard methods are available on all plans; Helius extensions require a Developer, Business, or Professional plan.  
https://www.helius.dev/docs/api-reference/rpc/websocket/llms.txt

### Solana DAS API
Unified interface for all Solana digital assets: NFTs, compressed NFTs, fungible tokens.
- Overview: https://www.helius.dev/docs/das-api.md
- API index: https://www.helius.dev/docs/api-reference/das/llms.txt

### Solana Enhanced Transactions API (legacy, maintenance mode)
Parsed, human-readable transaction data with automatic labeling. Legacy product in maintenance mode — its successor is Parsed Events (below); use Parsed Events for new builds.
- Parsed Events overview: https://www.helius.dev/docs/parsed-events.md
- Parsed Events quickstart: https://www.helius.dev/docs/parsed-events/quickstart.md
- Migration guide: https://www.helius.dev/docs/parsed-events/guides/migrate-from-enhanced-transactions.md

### Helius Parsed Events (open beta)
Parse transaction signatures or address history into decoded instructions, transfers, and summaries over REST and GraphQL. Successor to Enhanced Transactions, built on the same IDL catalog (3,600+ programs) as Parsed Streams. Available on paid plans — authenticate with your API key.
Base URL: `https://mainnet.helius-rpc.com`. REST methods: `POST /v1/parsed-events/transactions`, `POST /v1/parsed-events/transaction-history`. GraphQL: `POST /v1/parsed-events/graphql`.  
- Overview: https://www.helius.dev/docs/parsed-events.md
- Quickstart and REST reference: https://www.helius.dev/docs/parsed-events/quickstart.md
- API reference: https://www.helius.dev/docs/api-reference/parsed-events/overview.md
- Response field reference: https://www.helius.dev/docs/parsed-events/parsed-response.md
- Query with GraphQL: https://www.helius.dev/docs/parsed-events/guides/query-with-graphql.md
- Migrate from Enhanced Transactions: https://www.helius.dev/docs/parsed-events/guides/migrate-from-enhanced-transactions.md

### Helius LaserStream gRPC
...

### Helius Sender
...

### Common Use Cases

| I'm building... | Use these Helius products |
|-----------------|---------------------------|
| Trading bot | Helius Sender (fast tx submission) + Priority Fee API + LaserStream (real-time prices) |
| Wallet app | DAS API (getAssetsByOwner) + getTransactionsForAddress (complete history with token accounts) or Wallet API for REST endpoints |
| App with built-in wallets (no seed phrases) | WaaS embedded wallets (`helius-wallet-kit`) + Helius Sender (transaction landing) |
| Private payments | Helius Privacy (beta, devnet only) |
| NFT marketplace | DAS API (searchAssets, getAssetsByGroup) + Webhooks (track sales/listings) |
| Token launcher | Helius Sender + Priority Fee API + Webhooks (monitor new token) |
| Analytics dashboard | Parsed Events + getTransactionsForAddress (historical data) |
| DeFi protocol | LaserStream (real-time account updates) + Helius Sender + Priority Fee API |
| Sniper/MEV bot | Preconfirmations (earliest scheduled-transaction signal) + Shred Delivery (raw shreds) + LaserStream gRPC (processed confirmation) + Helius Sender (staked connections) |
| Portfolio tracker | DAS API (getAssetsByOwner with showFungible) + Parsed Events |
| Airdrop tool | AirShip (95% cheaper with ZK compression) |
| Jupiter/swap integration | Helius RPC + Helius Sender for transaction submission |

## Key Concepts

| Term | Definition |
|------|------------|
| DAS (Digital Asset Standard) | Standardized API for querying NFTs, tokens, and compressed assets with a unified interface |
| cNFT (Compressed NFT) | NFTs stored in merkle trees instead of individual accounts; 1000x cheaper to mint |
| ZK Compression | Technology to reduce on-chain storage costs by 98% using zero-knowledge proofs |
| Helius Sender | Ultra low latency transaction submission service; the Sender Max tier submits a transaction across all pathways (Helius, Jito, Harmonic, Rakurai, etc.) simultaneously |
| LaserStream | Helius's managed gRPC streaming service with historical replay and auto-reconnection. Wire-compatible with the Yellowstone gRPC protocol |
| .... | ...