Skip to main content

Error Codes

All API errors follow a consistent JSON structure. Errors consist of two parts: an error code and a message. Codes are universal, but messages can vary based on the specific context.

Error Response Format​

{
  "code": -1100,
  "errMsg": "Invalid parameter"
}

Error Code Categories​

10xx - System and Server Issues​

-1000 INTERNAL_ERROR​

Message: Internal server error

Description: An internal server error occurred while processing the request. The server encountered an unexpected condition that prevented it from fulfilling the request.

-1001 NOT_FOUND​

Message: Resource not found

Description: The requested resource was not found. The endpoint or resource you are trying to access does not exist.

11xx - Request Validation Issues​

-1100 INVALID_PARAMETER​

Message: Invalid parameter

Description: Invalid data sent for a parameter. The parameter value does not meet the expected format or constraints.

-1101 MISSING_PARAMETER​

Message: Missing required parameter

Description: A mandatory parameter was not sent, was empty, or was null. Required parameters must be included in the request.

-1102 INVALID_ADDRESS​

Message: Invalid address format

Description: Invalid blockchain address format. The address provided does not conform to the expected address format.

-1103 INVALID_TX​

Messages:

  • Invalid transaction - General transaction validation error
  • Not a value transfer transaction - Transaction is not of the expected type

Description: Invalid transaction data or format. The transaction could not be processed due to validation failures.

-1104 METHOD_NOT_ALLOWED​

Message: Method not allowed

Description: The HTTP method is not supported for this endpoint. Use the correct HTTP method (GET, POST, PUT, DELETE) as specified in the API documentation.

12xx - Order, Cancel, and Modify Operations​

-1200 ORDER_REJECTED​

Message: Order rejected

Description: The order was rejected and could not be processed. The order did not meet the requirements for placement.

-1201 CANCEL_REJECTED​

Message: Cancel rejected

Description: The cancel request was rejected and could not be processed. The order could not be cancelled.

-1202 MODIFY_REJECTED​

Message: Modify rejected

Description: The modify request was rejected and could not be processed. The order could not be modified.

-1203 ORDER_LIMIT_EXCEEDED​

Message: Maximum open orders limit exceeded

Description: The maximum number of open orders has been exceeded. Users are limited in the number of concurrent open orders they can have.

-1204 SUBMIT_TX_RATE_LIMIT_EXCEEDED​

Message: Transaction rate limit exceeded

Description: The transaction submission rate limit has been exceeded. Slow down the frequency of transaction submissions.

13xx - Market Related​

-1300 MARKET_NOT_AVAILABLE​

Message: Market is not available for trading

Description: The requested market is not currently available for trading. The market may be temporarily halted, under maintenance, or in a non-trading state.

-1301 MARKET_NOT_FOUND​

Message: Market not found

Description: The requested market does not exist. Verify the market ID is correct.

20xx - Authentication and Authorization Issues​

-2000 UNAUTHORIZED​

Message: Unauthorized

Description: Authentication is required to access this endpoint. The request lacks valid authentication credentials.

-2001 NOT_AUTHORIZED​

Message: Not authorized

Description: You do not have permission to access this resource. Valid authentication provided, but insufficient privileges.

30xx - Business Logic​

-3000 BUSINESS_RULE​

Message: Business rule error

Description: A valid request that failed due to business logic rules. The request is technically correct but violates one or more business constraints.