Skip to main content

Status Codes

This section explains the HTTP status codes and GMO Coin-specific status codes returned by the API.

HTTP Status Codes​

HTTP status codes indicate the result of the HTTP request itself.

Status CodeDescription
200A response for successful HTTP requests.
400Bad request. The request was invalid or cannot be served.
401Unauthorized. Authentication failed or user does not have permissions.
404A response for when requested URL is invalid.
429Too many requests. Rate limit exceeded.
500Internal server error. Something went wrong on the server side.
503A response code that when WebSocket API is called while the service is in maintenance.

GMO Coin Status Codes​

GMO Coin status codes are included in the API response body to indicate the result of API processing.

Status CodeDescription
0A response for successful API processing.
5API processing failed. Check error codes for details.

Response Format​

When an API request is successful, the response will include:

{
  "status": 0,
  "data": { ... },
  "responsetime": "2025-12-25T12:00:00.123Z"
}

When an API request fails, the response will include:

{
  "status": 5,
  "messages": [
    {
      "message_code": "ERR-5xxx",
      "message_string": "Error description"
    }
  ],
  "responsetime": "2025-12-25T12:00:00.123Z"
}

Status Code Examples​

Successful Response​

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": 0,
  "data": {
    "symbol": "BTC",
    "amount": "0.1"
  },
  "responsetime": "2025-12-25T12:00:00.123Z"
}

Error Response​

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": 5,
  "messages": [
    {
      "message_code": "ERR-5106",
      "message_string": "The request parameter is invalid."
    }
  ],
  "responsetime": "2025-12-25T12:00:00.123Z"
}

HTTP Error Response​

HTTP/1.1 401 Unauthorized
Content-Type: application/json

{
  "status": 5,
  "messages": [
    {
      "message_code": "ERR-5012",
      "message_string": "The API authentication is invalid."
    }
  ],
  "responsetime": "2025-12-25T12:00:00.123Z"
}