API Reference
Common Error Codes
API Reference
Solana RPC APIs
- HTTP Methods
- WebSocket Methods
Solana APIs
- Digital Asset Standard (DAS)
- Priority Fee
- Enhanced Transactions
- ZK Compression
Data Streaming APIs
- LaserStream gRPC
Event Listening APIs
- Webhooks
Deprecated APIs
- Token Metadata
- Mint
API Reference
Common Error Codes
Learn about common RPC error messages and potential solutions
When interacting with Helius RPC endpoints, you may encounter the following standard HTTP error codes that indicate the status of your requests:
Invalid API key or restricted access due to Access Control Rules.
How to fix it
- Verify your API key is correctly formatted
- Check if your API key has the necessary permissions
- Ensure you’re including the API key in the query params
For more information on API authentication, see our Authentication page.
Exceeded Rate Limits.
How to fix it
- Check the
Rate Limited Requestsgraph in your RPC metrics dashboard - Optimize your code to reduce unnecessary API calls
- Implement rate limiting in your application
- Consider upgrading your plan for increased rate limits
More information
Review our Plans & Rate Limits page for details on the limits for each plan.
A server-side error occurred while processing your request.
How to fix it
- Check if your request payload is properly formatted
- Check the Helius Status Page for any ongoing issues
- If the error persists, contact Helius support with details of your request
Server errors are typically temporary and not related to your implementation.
The server is temporarily overloaded or undergoing maintenance.
How to fix it
- Implement exponential backoff for retries in your application
- Wait for a few minutes before trying again
- Check the Helius Status Page for any ongoing issues
- If the error persists, contact Helius support with details of your request
This error is usually temporary and resolves on its own as server load balances.
The server did not receive a timely response while acting as a gateway or proxy.
How to fix it
- Check your network connection
- Implement request timeouts in your client code
- Check the Helius Status Page for any ongoing issues
- If the error persists, contact Helius support with details of your request
This error often indicates network issues or that the server is processing a complex operation that exceeds the timeout limit.
Was this page helpful?