# Basic Information

# Common Error Codes

Common HTTP Error Codes

# Types

  • 4XX error codes are used to indicate wrong request content, behavior, format.
  • 5XX error codes are used to indicate problems with the BingX service.

# Error Codes

  • 400 Bad Request – Invalid request format
  • 401 Unauthorized – Invalid API Key
  • 403 Forbidden – You do not have access to the requested resource
  • 404 Not Found
  • 429 Too Many Requests - Return code is used when breaking a request rate limit.
  • 418 return code is used when an IP has been auto-banned for continuing to send requests after receiving 429 codes.
  • 500 Internal Server Error – We had a problem with our server
  • 504 return code means that the API server has submitted a request to the service center but failed to get a response. It should be noted that the 504 return code does not mean that the request failed. It refers to an unknown status. The request may have been executed, or it may have failed. Further confirmation is required.

# Notes:

  • If it fails, there will be an error description included in the response body.
  • Errors may be thrown from every interface.

# Timestamp

Unless otherwise specified, all timestamps from the API are returned with microseconds resolution.

Requests that have a 30+ second difference between the timestamp and the API service time will be considered expired or rejected. We recommend using the time endpoint to query for the API server time if you believe there may be time skew between your server and the API servers.

# Example

1587091154123

# Numbers

Decimal numbers are returned as "Strings" in order to preserve full precision. It is recommended that the numbers are converted to "Strings" to avoid truncation and precision loss.

Integer numbers (such as trade ID and sequences) are unquoted.

# Rate Limits

To prevent abuse, BingX imposes rate limits on incoming requests. When a rate limit is exceeded, the system will automatically limit the requests.

# REST API

  • Market Interface is the public interface. The rate limit of public interfaces is 10 requests every 1 second at most for each IP.
  • Account Interface and Transaction Interface are private interfaces. Generally, the private interface rate limit is at most 10 requests every 1 second for each UID.
  • The specific rate limits are indicated in the documentation for some endpoints.

# Get Server Time

HTTP Requests

      # Request
      POST api/v1/common/server/time

Request Method

GET / POST

Request Parameters

null   

Return Parameters

Field Type Description
code Int64 error code, 0 means successfully response, others means response failure
msg String Error Details Description
currentTime Int64 The current time of the system,unit: ms
# Response
    {
        "code": 0,
        "msg": "",
        "currentTime": 1534431933321
    }
Last Updated: 12/2/2021, 2:36:56 PM