API Reference

Error Code Reference

Learn about the standard JSON-RPC error codes and BlockVision's custom error codes.

HTTP Status Codes

In addition to the standard Ethereum JSON-RPC error codes, Alchemy will return the following status codes for HTTP requests:

HTTP Status Codes

CodeMeaning
400Bad Request -- Your request is invalid. Double-check your JSON-RPC body.
401Unauthorized -- You must authenticate your request with an API key.
403Forbidden -- You've hit your capacity limit, or your request was rejected by your app's whitelist settings.
429Too Many Requests -- You've exceeded your concurrent requests capacity or Compute Units per second capacity. Check out the Throughput page for solutions.
500Internal Server Error -- We're unable to process your request right now. Get in touch with us if you see this.

JSON-RPC Error Codes

Code

Return Message

Description

-32700

Parse error

Invalid JSON was received by the server.
An error occurred on the server while parsing the JSON text.

-32600

Invalid Request

The JSON sent is not a valid Request object.

-32601

Method not found

The method does not exist / is not available

-32602

Invalid params

Invalid method parameter(s).

-32603

Internal error

Internal JSON-RPC error.

-32604

Record not found

No result returned

-32605

Rate Limit

Too many requests were made, these requests are be limited.

-32606

Illegal Ip

Request IP not in whitelist.

-32607

Call Limit

The call limit has been reached, please upgrade your subscription plan.

-32000

Server error

Reserved for implementation-defined server-errors. See hint below.

NOTE: -32000 is used for many server errors. Here are a few common examples:

"Already known"

  • This generally means the transaction already posted and is on the node in a pending state. Sometimes this error occurs when transactions fail at first but are retried when the node already knows of them

"Unspecified origin not on whitelist"

  • This error means whoever is making the request is not on the whitelist for using your API key.

"Filter not found"

  • Filters expire after 5 minutes of inactivity so if it's not found the filter likely expired.

"Request timed out. Client should retry."

  • Gateway timeouts (usually from nodes). Clients should retry the request.

"Transaction underpriced"

  • Transaction was sent with too low gas. Re-send the transaction with higher gas!