# Helius — Full Agent Context

> Helius is Solana's leading infrastructure provider and developer platform. From high-performance RPC nodes and transaction sending (Sender) to gRPC streaming (LaserStream), webhooks, and digital asset APIs — Helius powers teams like Phantom, Jupiter, DFlow, Coinbase, and Bitwise.

This file aggregates the agent-readable surfaces on helius.dev into one document so an agent can ingest the full context in a single request. Per-product llms.txt files (LaserStream, Sender, RPC, DAS, etc.) will land in follow-up PRs and be appended below.

For a navigation-only directory, see https://www.helius.dev/llms.txt. For narrower section-level indexes, see https://www.helius.dev/blog/llms.txt, https://www.helius.dev/use-case/llms.txt, https://www.helius.dev/staking/llms.txt, https://www.helius.dev/api/llms.txt, https://www.helius.dev/docs/llms.txt.


---

## Agent Onboarding

_Source: https://www.helius.dev/AGENTS.md_

> Helius is Solana's leading infrastructure provider and developer platform — RPC nodes, transaction sending (Sender), gRPC streaming (LaserStream), webhooks, and digital asset APIs.

This file is a focused onboarding document for autonomous agents (Claude, Cursor, Codex, custom). For the full machine-readable index, see [/llms.txt](https://www.helius.dev/llms.txt).

## Quick Start

```bash
# 1. Get an API key (autonomous, costs 1 USDC on Solana mainnet)
npx helius-cli signup --json

# 2. Or get one interactively
open https://dashboard.helius.dev

# 3. Run the MCP server (works with any MCP-compatible client)
npx helius-mcp@latest
```

Set `HELIUS_API_KEY` from the dashboard or the CLI signup output.

## API Surfaces

Each surface has a per-API OpenAPI spec at `https://www.helius.dev/openapi/<id>.json`. The merged catalog is at [/openapi.json](https://www.helius.dev/openapi.json) and the RFC 9727 linkset is at [/.well-known/api-catalog](https://www.helius.dev/.well-known/api-catalog).

| Surface                               | Endpoint                             | Spec                                                                          | Docs                                                                                         |
| ------------------------------------- | ------------------------------------ | ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- |
| Solana RPC (HTTP) + Helius extensions | `https://mainnet.helius-rpc.com`     | [rpc-http.json](https://www.helius.dev/openapi/rpc-http.json)                 | [/docs/rpc/overview](https://www.helius.dev/docs/rpc/overview)                               |
| Digital Asset Standard (DAS)          | `https://mainnet.helius-rpc.com`     | [das-api.json](https://www.helius.dev/openapi/das-api.json)                   | [/docs/das-api](https://www.helius.dev/docs/das-api)                                         |
| Sender (transaction submission)       | `https://sender.helius-rpc.com` (global HTTPS, frontend) or `http://{region}-sender.helius-rpc.com` (regional HTTP, backend: `slc`, `ewr`, `lon`, `fra`, `ams`, `sg`, `tyo`) | [sender-api.json](https://www.helius.dev/openapi/sender-api.json)             | [/docs/sending-transactions/sender](https://www.helius.dev/docs/sending-transactions/sender) |
| Wallet API                            | `https://api.helius.xyz/v1/wallet`   | [wallet-api.json](https://www.helius.dev/openapi/wallet-api.json)             | [/docs/wallet-api/overview](https://www.helius.dev/docs/wallet-api/overview)                 |
| Priority Fee                          | `https://mainnet.helius-rpc.com`     | [priority-fee-api.json](https://www.helius.dev/openapi/priority-fee-api.json) | [/docs/priority-fee-api](https://www.helius.dev/docs/priority-fee-api)                       |
| ZK Compression Indexer                | `https://mainnet.helius-rpc.com`     | [zk-compression.json](https://www.helius.dev/openapi/zk-compression.json)     | [/docs/zk-compression/introduction](https://www.helius.dev/docs/zk-compression/introduction) |
| Admin (project usage, billing)        | `https://admin-api.helius.xyz`       | [admin-api.json](https://www.helius.dev/openapi/admin-api.json)               | [/docs/api-reference/admin](https://www.helius.dev/docs/api-reference/admin)                 |
| Webhooks                              | `https://api.helius.xyz/v0/webhooks` | [webhooks.json](https://www.helius.dev/openapi/webhooks.json)                 | [/docs/webhooks](https://www.helius.dev/docs/webhooks)                                       |
| LaserStream (gRPC streaming)          | `https://laserstream-{network}-{region}.helius-rpc.com` (mainnet regions: `slc`, `ewr`, `lon`, `fra`, `ams`, `sgp`, `tyo`, `lax`, `pitt`; devnet: `ewr`). Auth: `x-token` gRPC metadata header. | gRPC, no OpenAPI — SDK: [helius-labs/laserstream-sdk](https://github.com/helius-labs/laserstream-sdk) | [/docs/laserstream/grpc](https://www.helius.dev/docs/laserstream/grpc) |

## Errors & Retries

- **Auth:** every surface requires an `api-key` query parameter (e.g. `?api-key=YOUR_KEY`). A missing or invalid key returns `401`.
- **Rate limits:** `429` means you exceeded your plan's RPS or credit budget. Back off and honor the `Retry-After` header when present. Per-plan limits are at [/pricing.md](https://www.helius.dev/pricing.md).
- **Transient failures:** retry `429` and `5xx` with exponential backoff (e.g. 2s, 4s, 8s; ~3 attempts). Do not retry `400`/`401`/`404` — those are permanent and need a fixed request.
- **CLI:** `helius` commands emit distinct exit codes per error class and, with `--json`, a `{ error, message, retryable }` body — see [/cli.md](https://www.helius.dev/cli.md). The full auth/error/revocation contract is at [/auth.md](https://www.helius.dev/auth.md).
- **Live status:** [helius.statuspage.io](https://helius.statuspage.io/) — check here before retrying if calls fail broadly.

## MCP Server

Helius ships a stdio MCP server distributed via npm. It exposes 10 routed tools covering 60+ Solana operations: RPC, DAS, parsed transactions, wallet intelligence, webhooks, Laserstream, priority fees, staking, and onchain API key signup.

- Install + run: `npx helius-mcp@latest`
- Server card: [/.well-known/mcp-server-card](https://www.helius.dev/.well-known/mcp-server-card)
- Source: [helius-labs/core-ai/helius-mcp](https://github.com/helius-labs/core-ai/tree/main/helius-mcp)
- Docs: [/docs/agents/mcp](https://www.helius.dev/docs/agents/mcp)

The server is verified and listed in [Anthropic's Claude Code plugin marketplace](https://github.com/anthropics/claude-plugins-official). Install in Claude Code: `/plugin marketplace add helius-labs/core-ai && /plugin install helius@helius-labs`.

## Discovery Surfaces

| Path                                                                               | Purpose                                                           |
| ---------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
| [/llms.txt](https://www.helius.dev/llms.txt)                                       | Broad markdown index of pages, posts, APIs, and agent surfaces    |
| [/openapi.json](https://www.helius.dev/openapi.json)                               | Merged OpenAPI 3.1 catalog across all REST surfaces               |
| [/.well-known/api-catalog](https://www.helius.dev/.well-known/api-catalog)         | RFC 9727 linkset enumerating each API                             |
| [/.well-known/agent-card.json](https://www.helius.dev/.well-known/agent-card.json) | A2A-compatible agent card                                         |
| [/.well-known/mcp-server-card](https://www.helius.dev/.well-known/mcp-server-card) | SEP-2127 MCP server card                                          |
| [/api/agents.md](https://www.helius.dev/api/agents.md)                             | Step-by-step CLI signup flow for autonomous API key acquisition   |
| [/api/agents.json](https://www.helius.dev/api/agents.json)                         | Same signup flow, machine-readable                                |
| [/?mode=agent](https://www.helius.dev/?mode=agent)                                 | Structured JSON summary of every agent-facing surface on the site |

Most pages also advertise a markdown alternate via `Link: <...>; rel="alternate"; type="text/markdown"`. Append `.md` to a page URL or send `Accept: text/markdown` to fetch the markdown variant.

## Repos

- [helius-labs/core-ai](https://github.com/helius-labs/core-ai) — monorepo for the MCP server, Claude Code plugin, agent skills, and CLI
  - [MCP server](https://github.com/helius-labs/core-ai/tree/main/helius-mcp) — 10 routed tools covering 60+ Solana operations for any MCP client; `npx helius-mcp@latest` (npm: `helius-mcp`)
  - [Claude Code plugin](https://github.com/helius-labs/core-ai/tree/main/helius-plugin) — verified in Anthropic's official marketplace; `/plugin marketplace add helius-labs/core-ai && /plugin install helius@helius-labs`
  - [Agent skills](https://github.com/helius-labs/core-ai/tree/main/helius-skills) — helius, helius-phantom, helius-jupiter, helius-okx, helius-dflow, svm — also comes bundled with the plugin
  - [helius-cli](https://github.com/helius-labs/core-ai/tree/main/helius-cli) — CLI used by the autonomous signup flow above; `npm install -g helius-cli` (npm: `helius-cli`)
- [helius-labs/helius-sdk](https://github.com/helius-labs/helius-sdk) — TypeScript SDK (npm: `helius-sdk`)
- [helius-labs/helius-rust-sdk](https://github.com/helius-labs/helius-rust-sdk) — Rust SDK (crates.io: `helius`)

## Support

- Docs: [/docs](https://www.helius.dev/docs)
- Status: [helius.statuspage.io](https://helius.statuspage.io/)
- Support: support@helius.xyz · [/docs/support/contact-support](https://www.helius.dev/docs/support/contact-support)
- Sales / partnerships: [/contact](https://www.helius.dev/contact)


---

## Agent Signup Flow

_Source: https://www.helius.dev/api/agents.md_

> Machine-readable instructions for AI agents to obtain a Helius API key via CLI.

## Quick Reference

| Requirement | Value |
|-------------|-------|
| Cost | 1 USDC (mainnet) |
| Transaction Fee | ~0.001 SOL |
| Network | Solana Mainnet |
| CLI Install | `npm install -g helius-cli` |
| Output Format | JSON (use `--json` flag) |

## Prerequisites

1. Node.js 18+ installed
2. A funded Solana wallet with:
   - **1 USDC** (mainnet) - for signup payment
   - **~0.001 SOL** - for transaction fees

## Complete Flow

### Step 1: Install CLI

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

### Step 2: Generate Keypair

```bash
helius keygen
```

**Output:** Creates keypair at `~/.helius-cli/keypair.json`

**Returns:** Wallet address to fund

### Step 3: Login (Authenticate)

```bash
helius login --json
```

**Output:** Authenticates with the generated keypair

**Note:** This step authenticates your wallet with Helius. Required before signup.

### Step 4: Fund Wallet

Send to the wallet address from Step 2:
- 1 USDC (token: `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v`)
- ~0.001 SOL

**Track funding transactions:** `https://orbmarkets.io/tx/{transaction_hash}`

### Step 5: Signup and Get API Key

```bash
helius signup --json
```

**Success Response (exit code 0):**
```json
{
  "status": "SUCCESS",
  "wallet": "YourWalletAddress...",
  "projectId": "project-uuid",
  "projectName": "Project Name",
  "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,
  "transaction": "transaction-signature"
}
```

**Extract API key:** `response.apiKey`

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

**Track signup transaction:** `https://orbmarkets.io/tx/{response.transaction}`

## Error Handling

All errors return JSON with `--json` flag and specific exit codes.

### Exit Codes

| Code | Meaning | Action |
|------|---------|--------|
| 0 | Success | Extract `apiKey` from response |
| 1 | General error | Check message, retry with backoff |
| 10 | Not logged in | Run `helius login` first |
| 11 | Keypair not found | Run `helius keygen` first |
| 12 | Auth failed | Check keypair validity |
| 20 | Insufficient SOL | Fund wallet with ~0.001 SOL |
| 21 | Insufficient USDC | Fund wallet with 1 USDC |
| 22 | Payment failed | Retry or check network status |
| 30 | No projects | Run `helius signup` first |
| 31 | Project not found | Check project ID |
| 40 | API error | Retry with exponential backoff |
| 41 | No API keys | Create one with `helius apikeys create` |

### Error Response Format

```json
{
  "error": "INSUFFICIENT_USDC",
  "message": "Insufficient USDC",
  "have": 0.5,
  "need": 1,
  "fundAddress": "YourWalletAddress..."
}
```

## Existing Account Flow

If the wallet already has a Helius account, `signup` returns existing project (no payment required):

```json
{
  "status": "EXISTING_PROJECT",
  "wallet": "YourWalletAddress...",
  "projectId": "existing-project-uuid",
  "projectName": "Existing Project",
  "apiKey": "existing-api-key",
  "endpoints": {
    "mainnet": "https://mainnet.helius-rpc.com/?api-key=existing-api-key",
    "devnet": "https://devnet.helius-rpc.com/?api-key=existing-api-key"
  },
  "credits": 950000
}
```

## Alternative: Login with Existing Wallet

If you have a funded wallet that already has a Helius account:

```bash
helius login --keypair /path/to/keypair.json --json
```

Then retrieve API key:

```bash
helius apikeys --json
```

**Response:**
```json
{
  "projectId": "project-uuid",
  "projectName": "Project Name",
  "apiKeys": [
    { "keyId": "your-api-key", "name": "Default" }
  ]
}
```

## Command Reference

| Command | Purpose | JSON Output |
|---------|---------|-------------|
| `helius keygen` | Generate new keypair | Address printed to stdout |
| `helius keygen -o <path>` | Generate keypair at custom path | Address printed to stdout |
| `helius signup --json` | Create account + get API key | Full project response |
| `helius signup -k <path> --json` | Signup with custom keypair | Full project response |
| `helius login --json` | Auth with default keypair | Auth confirmation |
| `helius login -k <path> --json` | Auth with custom keypair | Auth confirmation |
| `helius projects --json` | List all projects | Project array |
| `helius project [id] --json` | Get project details | Full project object |
| `helius apikeys --json` | List API keys | Key array |
| `helius apikeys create --json` | Create new API key | New key object |
| `helius rpc --json` | Get RPC endpoints | Endpoint URLs |
| `helius usage --json` | Check credit usage | Usage stats |

## Agent Implementation Pseudocode

```
1. CHECK if helius-cli installed
   - Run: `helius --version`
   - If fails: run `npm install -g helius-cli`

2. CHECK if keypair exists at ~/.helius-cli/keypair.json
   - If not: run `helius keygen`, capture wallet address from output

3. RUN `helius login --json` to authenticate with Helius

4. CHECK wallet balances (via Solana RPC or external service)
   - SOL balance: getBalance RPC call
   - USDC balance: getTokenAccountsByOwner for mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
   - If SOL < 0.001: fund wallet, wait for confirmation
   - If USDC < 1: fund wallet, wait for confirmation
   - Track transactions at: https://orbmarkets.io/tx/{txHash}

5. RUN `helius signup --json`
   - Parse JSON response from stdout
   - Check exit code:
     - 0: Success - extract apiKey
     - 20: Need SOL - return to step 4
     - 21: Need USDC - return to step 4
     - 11: Need keypair - return to step 2
     - Other: Log error, retry with backoff

6. STORE for future use:
   - apiKey: response.apiKey
   - projectId: response.projectId
   - rpcMainnet: response.endpoints.mainnet
   - rpcDevnet: response.endpoints.devnet

7. VERIFY API key works:
   - POST to RPC endpoint with getHealth method
   - Expected: {"jsonrpc":"2.0","result":"ok","id":1}
```

## Solana Token Addresses

| Token | Mainnet Address |
|-------|-----------------|
| USDC | `EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v` |
| SOL | Native (no token address) |

**Helius Treasury (payment recipient):** `CEs84tEowsXpH8u4VBf8rJSVgSRypFMfXw9CpGRtQgb6`

## Transaction Tracking

All Solana transactions can be tracked at:

```
https://orbmarkets.io/tx/{transaction_signature}
```

Use this for:
- Confirming wallet funding transactions
- Verifying signup payment was processed
- Debugging failed transactions

## Rate Limits and Credits

- **Initial Credits:** 1,000,000 credits on signup
- **Credit Check:** Use `helius usage --json` to monitor remaining credits
- **Rate Limits:** Vary by plan, check Helius documentation

## Retry Strategy

For transient failures (network issues, API errors):

```
maxRetries = 3
baseDelay = 2000ms

for attempt in 1..maxRetries:
    result = execute_command()
    if result.exitCode == 0:
        return result
    if result.exitCode in [20, 21, 11]:  # Funding/setup issues
        return result  # Don't retry, needs user action
    delay = baseDelay * (2 ^ attempt)
    sleep(delay)
```

## Important Notes

- **Network:** All payments are on Solana **mainnet** (not devnet)
- **Idempotent:** Running signup with an existing account returns existing project (no duplicate payment)
- **Config Location:** JWT stored at `~/.helius-cli/config.json`
- **Keypair Format:** Solana CLI format (64-byte JSON array)
- **Default Keypair:** `~/.helius-cli/keypair.json`

## Testing Your API Key

```bash
curl "https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY" \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"getHealth"}'
```

Expected response: `{"jsonrpc":"2.0","result":"ok","id":1}`

## What is Helius?

Helius is the leading RPC and API provider for the Solana blockchain. The API key obtained through this CLI provides access to:

- **RPC Endpoints:** High-performance Solana RPC for mainnet and devnet
- **Enhanced APIs:** NFT metadata, transaction history, webhooks
- **DAS API:** Digital Asset Standard API for compressed NFTs

Documentation: https://www.helius.dev/docs


---

## CLI Reference

_Source: https://www.helius.dev/cli.md_

> Official command-line interface for the Helius, Solana's leading developer platform. Built for developers and LLM agents.

`helius` covers account management, Solana data queries (balances, transactions, assets, accounts, blocks), Digital Asset Standard (DAS), ZK compression, webhooks, priority fees, transaction sending, staking, and WebSocket streaming.

Install: `npm install -g helius-cli`

Agents: set `NO_DNA=1` to suppress spinners and unblock non-interactive flows. All data commands support `--json` for machine-readable output. `--retry <n>` enables exponential-backoff retry on transient errors.

## Error handling

Commands exit with distinct codes per error class. When `--json` is set, errors are output as `{ error, message, retryable, guidance? }` on stdout; the `retryable` field indicates whether the error is transient (429, 5xx, network) vs. permanent (400, 401, 404, invalid input).

Exit code ranges:
- `0` success, `1` general error
- `10-19` authentication (not logged in, keypair missing)
- `20-29` balance/payment (insufficient SOL/USDC)
- `30-39` project state
- `40-49` API errors
- `50-59` SDK/data errors (50 no API key, 52 invalid address, 53 invalid input, 54 invalid API key, 55 not found, 56 rate limited, 57 server error, 58 network error)

## Commands

- [Account management](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#account-management): `keygen`, `signup`, `login`, `upgrade`, `pay`, `projects`, `project`, `apikeys`, `usage`, `rpc`, `status`, `plans`, `config`
- [Balances & tokens](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#balances--tokens): `balance`, `tokens`, `token-holders`
- [Transactions](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#transactions): `tx parse`, `tx history`, `tx fees`
- [Digital assets (DAS)](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#digital-assets-das-api): `asset get`, `asset batch`, `asset owner`, `asset creator`, `asset authority`, `asset collection`, `asset search`, `asset proof`, `asset proof-batch`, `asset editions`, `asset signatures`, `asset token-accounts`
- [Account & network](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#account--network): `account`, `network-status`, `block`
- [Wallet API](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#wallet-api): `wallet identity`, `wallet identity-batch`, `wallet balances`, `wallet history`, `wallet transfers`, `wallet funded-by`
- [Webhooks](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#webhooks): `webhook list`, `webhook get`, `webhook create`, `webhook update`, `webhook delete`
- [Program accounts](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#program-accounts): `program accounts`, `program accounts-all`, `program token-accounts`
- [Staking](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#staking): `stake create`, `stake unstake`, `stake withdraw`, `stake accounts`, `stake withdrawable`, `stake instructions`
- [ZK compression](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#zk-compression): `zk account`, `zk balance`, `zk token-holders`, `zk proof`, `zk validity-proof`, `zk tx`, `zk indexer-health`, and more
- [Transaction sending](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#transaction-sending): `send broadcast`, `send raw`, `send sender`, `send poll`, `send compute-units`
- [WebSocket streaming](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#websocket-streaming): `ws account`, `ws logs`, `ws slot`, `ws signature`, `ws program`
- [SIMDs](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md#simds): `simd list`, `simd get`

## Global options

- `--api-key <key>` — override the configured API key
- `--network <net>` — `mainnet` (default) or `devnet`
- `--json` — machine-readable JSON output
- `--retry <n>` — retry transient errors up to `n` times with exponential backoff (default `0`)
- `-k, --keypair <path>` — keypair file path (for `signup`, `login`, `upgrade`, `pay`, `stake`)

## Resources

- [Full README](https://github.com/helius-labs/core-ai/blob/main/helius-cli/README.md): Complete command reference, configuration, and development setup for the Helius CLI
- [Helius Agents Documentation](https://www.helius.dev/docs/agents/llms.txt): Machine-readable index of all agent-focused documentation for the Helius Solana platform
- [Helius for Agents](https://www.helius.dev/docs/agents/overview.md): Everything AI agents need to build on Solana with Helius
- [Helius Docs](https://www.helius.dev/docs): Platform API documentation (RPC, DAS, Sender, webhooks, Laserstream)
- [Helius Dashboard](https://dashboard.helius.dev): Manage API keys, billing, and webhooks in the browser


---

## API Catalog

_Source: https://www.helius.dev/api/llms.txt_

> Solana RPC, DAS, Sender, Wallet, Webhooks, Priority Fee, ZK Compression, and Admin — every Helius API surface with its OpenAPI spec and docs URL.

This is a narrower agent-readable index than the site-wide https://www.helius.dev/llms.txt. For the merged OpenAPI catalog as a single JSON document, see https://www.helius.dev/openapi.json. For the RFC 9727 discovery linkset, see https://www.helius.dev/.well-known/api-catalog.

## Authentication

All Helius public API endpoints accept the API key as the `api-key` query parameter (e.g. `https://mainnet.helius-rpc.com/?api-key=YOUR_KEY`). Obtain a key at https://dashboard.helius.dev or programmatically via `helius signup --json` (CLI; 1 USDC on Solana mainnet).

## Networks

Mainnet (`mainnet.helius-rpc.com`) and devnet (`devnet.helius-rpc.com`) are supported across RPC, WebSocket, and LaserStream. Sender adds 7 regional endpoints (`slc-`, `ewr-`, `lon-`, `fra-`, `ams-`, `sg-`, `tyo-` prefixes on `sender.helius-rpc.com`).

## API Surfaces

### Solana RPC (HTTP) + Helius extensions

High-performance Solana RPC plus Helius extensions like getTransactionsForAddress and getTransfersForAddress for single-call address history.

- Endpoint: `https://mainnet.helius-rpc.com`
- OpenAPI spec: https://www.helius.dev/openapi/rpc-http.json
- Documentation: https://www.helius.dev/docs/rpc/overview

### Digital Asset Standard (DAS) API

Unified API for Solana NFTs, compressed NFTs, and tokens — metadata, ownership, Merkle proofs, and search.

- Endpoint: `https://mainnet.helius-rpc.com`
- OpenAPI spec: https://www.helius.dev/openapi/das-api.json
- Documentation: https://www.helius.dev/docs/das-api

### Helius Sender

Reliable transaction submission with Jito bundle support and staked-connection routes. 7 regional endpoints for low-latency global coverage.

- Endpoint: `https://sender.helius-rpc.com`
- OpenAPI spec: https://www.helius.dev/openapi/sender-api.json
- Documentation: https://www.helius.dev/docs/sending-transactions/sender

### Wallet API

REST endpoints for wallet-level portfolio views: USD balances, holdings, transfer history, funding source, and identity resolution.

- Endpoint: `https://api.helius.xyz/v1/wallet`
- OpenAPI spec: https://www.helius.dev/openapi/wallet-api.json
- Documentation: https://www.helius.dev/docs/wallet-api/overview

### Priority Fee API

Recommended priority fee estimates for reliable transaction landing under network load.

- Endpoint: `https://mainnet.helius-rpc.com`
- OpenAPI spec: https://www.helius.dev/openapi/priority-fee-api.json
- Documentation: https://www.helius.dev/docs/priority-fee-api

### ZK Compression Indexer

Compressed-account queries: state, balances, proofs, validity proofs, and compression history.

- Endpoint: `https://mainnet.helius-rpc.com`
- OpenAPI spec: https://www.helius.dev/openapi/zk-compression.json
- Documentation: https://www.helius.dev/docs/zk-compression/introduction

### Admin API

Project usage and billing data for Helius accounts (admin-authenticated).

- Endpoint: `https://admin-api.helius.xyz`
- OpenAPI spec: https://www.helius.dev/openapi/admin-api.json
- Documentation: https://www.helius.dev/docs/api-reference/admin

### Helius Webhooks

Create, update, list, and delete webhooks that push transaction and account events to an HTTPS endpoint.

- Endpoint: `https://api.helius.xyz/v0/webhooks`
- OpenAPI spec: https://www.helius.dev/openapi/webhooks.json
- Documentation: https://www.helius.dev/docs/webhooks

## SDKs

- **TypeScript** — [helius-sdk on npm](https://www.npmjs.com/package/helius-sdk) (`npm install helius-sdk`). Source: https://github.com/helius-labs/helius-sdk
- **Rust** — [helius on crates.io](https://crates.io/crates/helius) (`cargo add helius`). Source: https://github.com/helius-labs/helius-rust-sdk. Docs: https://docs.rs/helius

## Rate Limits

Vary by plan. Full per-feature table: https://www.helius.dev/pricing.md.

- Free: 10 RPS, 1 sendTransaction/sec, 1M credits/month
- Developer: 50 RPS, 5 sendTx/sec, 10M credits
- Business: 200 RPS, 50 sendTx/sec, 5 sendBundle/sec, 100M credits
- Professional: 500 RPS, 100 sendTx/sec, 5 sendBundle/sec, 200M credits


---

## Documentation Index

_Source: https://www.helius.dev/docs/llms.txt_

---
url: https://www.helius.dev/docs
last_updated: 2026-06-16
---

# 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 (`--pay` / `--resume`).

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

### Step 4: Signup and Get API Key

```bash
helius signup --email you@example.com --first-name Jane --last-name Doe --json
```

#### Success Response (exit code 0):

```json
{
  "status": "SUCCESS",
  "wallet": "YourWalletAddress...",
  "projectId": "project-uuid",
  "projectName": "Project Name",
  "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,
  "transaction": "transaction-signature"
}
```

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 (Standard and Enhanced WebSockets)
- Mainnet WSS (Gatekeeper Beta): wss://beta.helius-rpc.com/?api-key=YOUR_API_KEY (Standard and Enhanced WebSockets)
- Devnet WSS: wss://devnet.helius-rpc.com/?api-key=YOUR_API_KEY (Standard and Enhanced WebSockets)
- 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.
https://www.helius.dev/docs/api-reference/das/llms.txt

### Solana Enhanced Transactions API
Parsed, human-readable transaction data with automatic labeling.
https://www.helius.dev/docs/api-reference/enhanced-transactions/llms.txt

### Helius LaserStream gRPC
Lowest latency data streaming via gRPC.
https://www.helius.dev/docs/api-reference/laserstream/grpc/llms.txt

### Helius Sender
Lowest latency transaction sending service.
https://www.helius.dev/docs/api-reference/sender/llms.txt

### Helius Shred Delivery
Self-serve raw Solana shreds via UDP. $1,000/month per IP ($800/month per IP on Pro plans).
https://www.helius.dev/docs/shred-delivery/llms.txt

### Helius Priority Fee API
Optimal priority fee estimation for transaction landing.
https://www.helius.dev/docs/api-reference/priority-fee/llms.txt

### Dedicated Nodes
Private Solana nodes with no rate limits, no credits, and full Yellowstone gRPC support.
https://www.helius.dev/docs/dedicated-nodes/llms.txt

### Solana Webhooks
Real-time HTTP POST notifications for blockchain events.
https://www.helius.dev/docs/api-reference/webhooks/llms.txt

### Helius Wallet API
Query Solana wallet balances, transaction history, transfers, identities, and funding sources with structured REST endpoints.
https://www.helius.dev/docs/api-reference/wallet-api/llms.txt

### ZK Compression API
Compressed account and token operations.
https://www.helius.dev/docs/api-reference/zk-compression/llms.txt

## 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|
| NFT marketplace | DAS API (searchAssets, getAssetsByGroup) + Webhooks (track sales/listings) |
| Token launcher | Helius Sender + Priority Fee API + Webhooks (monitor new token) |
| Analytics dashboard** | Enhanced Transactions API + getTransactionsForAddress (historical data) |
| DeFi protocol | LaserStream (real-time account updates) + Helius Sender + Priority Fee API |
| Sniper/MEV bot | Shred Delivery (earliest transaction signal) + LaserStream gRPC (processed confirmation) + Helius Sender (staked connections) |
| Portfolio tracker | DAS API (getAssetsByOwner with showFungible) + Enhanced Transactions |
| Airdrop tool | AirShip (95% cheaper with ZK compression) |
| Jupiter/swap integration | Helius RPC + Helius Sender for transaction submission |

## Which API should I use?

| Need | API |
|------|-----|
| Get wallet NFTs and tokens | DAS API |
| Parse transaction history | Enhanced Transactions |
| Real-time event notifications (HTTP) | Webhooks |
| Real-time streaming (WebSocket) | WebSockets |
| Earliest transaction signal (pre-execution) | Shred Delivery (raw shreds via dashboard) |
| Lowest latency processed streaming | LaserStream gRPC |
| Standard Solana RPC calls | RPC |
| Estimate priority fees | Priority Fee API |
| Work with compressed accounts | ZK Compression |
| Simple REST endpoints for querying Solana wallet data | Wallet API |

## Don't Confuse These

| If you want to... | Use this | NOT this | Why |
|-------------------|----------|----------|-----|
| Get wallet's NFTs and tokens | `getAssetsByOwner` (DAS API) | `getTokenAccountsByOwner` | `getTokenAccountsByOwner` returns raw accounts, not token metadata |
| Get complete transaction history | `getTransactionsForAddress` | `getSignaturesForAddress` | `getTransactionsForAddress` includes token accounts and `getSignaturesForAddress` does not |
| Get transaction history for cNFTs | `getSignaturesForAsset` (DAS API) | `getSignaturesForAddress` | `getSignaturesForAddress` doesn't work for compressed NFTs |
| Stream real-time data (new projects) | LaserStream gRPC | Yellowstone gRPC on dedicated nodes | LaserStream is simpler, provides 24-hour replay, supports auto-reconnects | 
| Send transactions reliably | Helius Sender (dual routes to validators + Jito) | Standard `sendTransaction` | sendTransaction uses a single path and has lower landing rates |
| Get priority fee estimates | `getPriorityFeeEstimate` | `getRecentPrioritizationFees` | `getRecentPrioritizationFees` requires manual calculation |
| Search NFTs by collection | DAS API `getAssetsByGroup` or `searchAssets` | `getProgramAccounts` | `getProgramAccounts` is expensive, slow, and data could be unindexed |
| Get real-time data | WebSockets or LaserStream gRPC | Polling for real-time data | Polling is inefficient, higher latency, uses credits |
| Get the earliest transaction signal | Shred Delivery (raw shreds) | LaserStream gRPC at `processed` | Shreds arrive before execution; LaserStream delivers post-execution data with commitment guarantees |

## 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 routing through staked connections (via Solana's largest validator) and Jito simultaneously |
| LaserStream | Helius's managed gRPC streaming service with historical replay and auto-reconnection. Wire-compatible with the Yellowstone gRPC protocol |
| Yellowstone gRPC | Open-source Solana Geyser plugin protocol for streaming. LaserStream is wire-compatible with it; raw Yellowstone is also available on Helius dedicated nodes |
| Priority Fee | Additional fee (in microlamports) to prioritize transaction inclusion in blocks |
| Staked Connections | Direct connections to validators through stake-weighted routing for faster and more reliable transaction landing |
| Associated Token Account (ATA) | The standard token account address derived from a wallet + mint; holds tokens on behalf of wallet |
| Commitment Level | Transaction finality: `processed` (fastest, may revert), `confirmed` (basically final), `finalized` (guaranteed) |

## Guides
- Quickstart: https://www.helius.dev/docs/quickstart.md
- Getting Data: https://www.helius.dev/docs/getting-data.md
- Data Streaming: https://www.helius.dev/docs/data-streaming.md
- Data Streaming quickstart: https://www.helius.dev/docs/data-streaming/quickstart.md
- Authentication: https://www.helius.dev/docs/api-reference/authentication.md
- Endpoints: https://www.helius.dev/docs/api-reference/endpoints.md
- Autoscaling: https://www.helius.dev/docs/billing/additional-credits.md
- Pay with Crypto: https://www.helius.dev/docs/billing/pay-with-crypto.md

## SDKs
Official SDKs that wrap all Helius APIs with type-safe methods and built-in error handling.

- Node.js: https://github.com/helius-labs/helius-sdk
- Rust: https://github.com/helius-labs/helius-rust-sdk
- SDK Overview: https://www.helius.dev/docs/sdks.md
- Rust SDK Docs: https://docs.rs/helius/latest/helius/

## Developer Tools

- Helius MCP: https://www.helius.dev/docs/agents/mcp.md
- Orb Explorer: https://orbmarkets.io
- AirShip: https://airship.helius.dev

## Agents
AI agent documentation, including programmatic signup, API guidance, MCP skills, and SDK usage.
- Agents Index: https://www.helius.dev/docs/agents/llms.txt
- Agents Overview: https://www.helius.dev/docs/agents/overview.md
- Helius CLI: https://www.helius.dev/docs/agents/cli.md
- Helius MCP: https://www.helius.dev/docs/agents/mcp.md
- Build Skill: https://www.helius.dev/docs/agents/skills/build.md
- Phantom Skill: https://www.helius.dev/docs/agents/skills/phantom.md
- Jupiter DeFi Skill: https://www.helius.dev/docs/agents/skills/jupiter.md
- DFlow Trading Skill: https://www.helius.dev/docs/agents/skills/dflow.md
- OKX Trading & Intelligence Skill: https://www.helius.dev/docs/agents/skills/okx.md
- SVM Skill: https://www.helius.dev/docs/agents/skills/svm.md
- Claude Code Plugin: https://www.helius.dev/docs/agents/claude-code-plugin.md
- TypeScript SDK for Agents: https://www.helius.dev/docs/agents/typescript-sdk.md
- Rust SDK for Agents: https://www.helius.dev/docs/agents/rust-sdk.md

## Resources
- Dashboard: https://dashboard.helius.dev
- Status: https://helius.statuspage.io
- Discord: https://discord.com/invite/6GXdee3gBj
- Support: https://dashboard.helius.dev/support
- FAQs: https://www.helius.dev/docs/faqs.md
- Error Codes: https://www.helius.dev/docs/faqs/error-codes.md