Error codes

When an API call fails, the response uses a unified error format; HTTP status codes are used together with the codes below.

json

{
    "code": -1121,
    "msg": "Invalid symbol."
}

Code	Meaning
`4XX`	Invalid request content, behavior, or format
`429`	Rate limit exceeded; IP may be blocked soon
`418`	Continued calling after `429`; IP blocked
`5XX`	Internal server error; do not assume failure—state may be unknown
`504`	Gateway timeout—request may or may not have executed; verify separately

Code	Description
`-1000`	Unknown error
`-1001`	Service unavailable
`-1002`	Unauthorized
`-1003`	Rate limit exceeded
`-1017`	Invalid `Content-Type` header
`-1021`	Timestamp outside allowed `recvWindow`
`-1022`	Invalid signature
`-1100`	Illegal parameter
`-1101`	Missing required parameter
`-1102`	Wrong parameter type
`-1121`	Invalid symbol / contract

Error codes ​