Skip to main content

Sui Error Code Reference

Updated on
Sep 30, 2025
QuickNode now provides Logs for your RPC endpoints. Easily identify and resolve issues by viewing detailed error information directly from your dashboard.

HTTP Error Codes

Let's look at the common HTTP errors you can encounter, what they mean and what you can do to prevent them.

400
Bad Request
Incorrect HTTP Request type (e.g. using GET instead of POST) or Invalid Characters
401
Unauthorized
This can happen when one or multiple security requirements are not met such as incorrect Token Auth, IP not in the whitelist, invalid JWT, etc.
403
Forbidden
Endpoint Disabled (One of the reasons for this could be a past due payment)
403
Forbidden - custom trace not found
Custom trace code not whitelisted (Submit a ticket to go through the approval process)
404
Not Found
Incorrect URL or Incorrect method
413
Content Too Large
Body of the request is too large
413
Request Entity Too Large
Some methods may have limits to prevent overly large requests.
429
Too Many Requests
The requests per second (RPS) of your requests are higher than your plan allows. Learn more about the 429 errors in our support documentation.
500
Internal Server Error
Submit a ticket for the support team to take a look at the errors asap
503
Service Unavailable
Submit a ticket for the support team to take a look at the errors asap

HTTP Error Code Example

The code snippet below is an example of Error Code 429.

{
"jsonrpc": "2.0",
"error": {
"code": 429,
"message": "The requests per second (RPS) of your requests are higher than your plan allows."
},
"id": 1
}

Endpoint Logs

QuickNode provides logs for your RPC endpoints to help you diagnose issues and track transaction activity. You can view logs directly in your QuickNode dashboard by navigating to:


  1. Endpoints in the sidebar
  2. Selecting your endpoint
  3. Opening the Logs tab

You can filter logs by time window, response type, method, and network.

What Gets Logged

RPC Errors
All failed requests including invalid methods, malformed parameters, execution errors, and network timeouts.

Transaction Submissions
Send transaction requests and their success or failure status.

Logging Limitations

Only RPC errors and transaction submissions are logged — successful read operations are not captured. To maintain optimal endpoint performance, logging operates on a best-effort basis. Some logs may be dropped during high-traffic periods to preserve low latency.

Retention and Access

Build and Scale plans include dashboard access with standard log retention. Enterprise plans provide extended retention periods and programmatic API access for log retrieval.

If you're experiencing other error codes, please let us know by submitting a ticket. We're more than happy to assist

Share this doc