Logo
New RPC users get 35% off their first monthView the offer
Helius
Helius5 min read

Helius Free RPC: What to Expect and How to Get Started

A practical guide to Helius free RPC, covering access, endpoint formats, API keys, and important usage considerations for Solana developers.

TL;DR

Helius offers a free tier for its Solana RPC services, but access requires an API key and the exact limits may change. This guide explains how to get started, the endpoint format, and what to watch for when using the free RPC.

What Is Helius Free RPC?

Helius is a Solana infrastructure provider that offers RPC services, including a free tier. The Helius free RPC allows developers to interact with the Solana blockchain without an upfront cost, subject to usage limits that Helius may adjust over time.

The free RPC is typically accessed through an endpoint that includes a unique API key. This key identifies your project and helps Helius enforce rate limits and usage policies.

  • Free tier availability and limits are subject to change by Helius.
  • An API key is required for most Helius RPC endpoints.
  • The free RPC is intended for development and low-volume use.

How to Get a Helius Free RPC Endpoint

To use Helius free RPC, you need to sign up for a Helius account. After registering and logging in to the Helius dashboard, you can create a project or API key. The dashboard provides the RPC URL that you can use in your applications.

The typical endpoint format is a URL that includes your API key as a path parameter. For example, a mainnet endpoint may look like this:

  • Sign up at the Helius website and log in to the dashboard.
  • Create a new project or API key in the dashboard.
  • Copy the RPC URL provided, which includes your API key.
https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY

Using the Helius RPC URL

Once you have your Helius RPC URL, you can use it with Solana client libraries such as @solana/web3.js or solana-py. The URL is passed as the connection endpoint.

Here is an example of how to connect using JavaScript:

  • Replace YOUR_API_KEY with the key from your Helius dashboard.
  • Keep your API key secure and do not expose it in client-side code.
  • Test the endpoint with a simple call like getVersion or getHealth.
const { Connection } = require('@solana/web3.js');
const connection = new Connection('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY');
connection.getVersion().then(console.log);

Helius RPC API Key and Security

Your Helius RPC API key is a sensitive credential. It should be stored securely, such as in environment variables, and not committed to public repositories.

If you suspect your key has been compromised, you can regenerate it in the Helius dashboard. Be aware that regenerating the key will invalidate the old one and require updating your applications.

  • Use environment variables to store your API key.
  • Avoid sharing your API key in public forums or code repositories.
  • Regenerate keys periodically or if compromised.

Helius Free RPC Limitations and Pricing

The Helius free RPC tier comes with usage limits, such as requests per second or per month. These limits are set by Helius and may change. For current details, refer to the Helius dashboard or official documentation.

If your project outgrows the free tier, Helius offers paid plans with higher limits and additional features. Pricing information is available on the Helius website.

  • Free tier limits are subject to change; check the Helius dashboard for current quotas.
  • Paid plans offer higher throughput and additional services.
  • Consider your expected request volume when choosing a plan.

Helius gRPC and Other Services

In addition to RPC, Helius offers gRPC services for real-time data streaming. The free tier may include limited access to gRPC, but availability and limits should be confirmed in the Helius dashboard.

Helius also provides enhanced APIs and webhooks, which may have separate usage allowances. Review the documentation for details.

  • gRPC access may require a separate endpoint and API key.
  • Enhanced APIs and webhooks may have different rate limits.
  • Check the Helius dashboard for service-specific quotas.

Troubleshooting Common Issues

If you encounter errors when using Helius free RPC, common causes include invalid API keys, rate limiting, or network issues. Ensure your API key is correct and that you are not exceeding the free tier limits.

For persistent issues, consult the Helius documentation or support channels. The Helius dashboard may also provide usage metrics to help diagnose problems.

  • Verify the API key in your endpoint URL.
  • Check for rate limit errors (HTTP 429) and adjust request frequency.
  • Ensure your network allows outbound connections to the Helius endpoint.

Never Worry about Infrastructure Again

OnFinality takes away the heavy lifting of DevOps so you can build smarter and faster.

Get Started