Skip to main content

Handling Errors

HTTP Error Codes

HTTP Error CodesCauseSolution
400 - Bad RequestMalformed request syntaxCheck your JSON-RPC body is correct.
401 - UnauthorizedUnauthorized authentication of requestCheck your API key is correct
403 - ForbiddenYou may have used an unauthorized URLCheck your allowed list settings
405 - Method not AllowedRequest method is not supported for the requested resource.This is an unsupported method.
429 - Too many RequestsExceeded rate limit on concurrent number of requests per second or per day.Upgrade to Premium plan

JSON RPC Method Error Codes

codemessagemeaning
-32700Parse error

Invalid JSON was received by the server.

An error occurred on the server while parsing the JSON text.

-32600Invalid RequestThe JSON sent is not a valid Request object.
-32601Method not foundThe method does not exist / is not available.
-32602Invalid paramsInvalid method parameter(s).
-32603Internal errorInternal JSON-RPC error.
-32000 to -32099Server errorReserved for implementation-defined server-errors.

Websocket Error Codes

Status CodeMeaning
1001Indicates that an endpoint is "going away", such as a server going down or a browser having navigated away from a page.
1002Indicates that an endpoint is terminating the connection due to a protocol error.
1003

Indicates that an endpoint is terminating the connection

because it has received a type of data it cannot accept (e.g., an endpoint that understands only text data MAY send this if it receives a binary message).

1004Reserved
1005Indicates that no status code was actually present.
1006

Indicates that the connection was closed abnormally, e.g., without sending or

receiving a Close control frame.

1007

Indicates that an endpoint is terminating the connection

because it has received data within a message that was not consistent with the type of the message (e.g., non-UTF-8 data within a text message)

1008

Indicates that an endpoint is terminating the connection

because it has received a message that violates its policy.

1009

Indicates that an endpoint is terminating the connection

because it has received a message that is too big for it to process.

1010Indicates that the client endpoint is terminating the connection as the server did not respond.
1011Indicates that a server is terminating the connection because it encountered an unexpected condition that prevented it from fulfilling the request.