# 基础信息

# 常见错误码

常见HTTP错误码

# 类型:

  • 4XX 错误码用于指示错误的请求内容、行为、格式

  • 5XX 错误码用于指示BingX服务侧的问题

# 错误码:

  • 400 Bad Request – Invalid request format 请求格式无效

  • 401 Unauthorized – Invalid API Key 无效的API Key

  • 403 Forbidden – You do not have access to the requested resource 请求无权限

  • 404 - Not Found 没有找到请求

  • 429 - Too Many Requests 请求太频繁被系统限流

  • 418 - 表示收到429后继续访问,于是被封了

  • 500 - Internal Server Error – We had a problem with our server 服务器内部错误

  • 504 - 表示API服务端已经向业务核心提交了请求但未能获取响应(特别需要注意的是504代码不代表请求失败,而是未知。很可能已经得到了执行,也有可能执行失败,需要做进一步确认)

# 注意:

  • 如果失败,response body 带有错误描述信息

  • 每个接口都有可能抛出异常

# 时间戳规范

除非另外指定,API中的所有时间戳均以微秒为单位返回。

请求的时间戳必须在API服务时间的30秒内,否则请求将被视为过期并被拒绝。如果本地服务器时间和API服务器时间之间存在较大的偏差,那么我们建议您使用通过查询API服务器时间来更新http header。

例如 1587091154123

# 数字规范

为了保持跨平台时精度的完整性,十进制数字作为字符串返回。建议您在发起请求时也将数字转换为字符串以避免截断和精度错误。

整数(如交易编号和顺序)不加引号。

# 频率限制

如果请求过于频繁系统将自动限制请求。

# REST API

  • 行情接口:通过IP限制公共接口的调用,每1秒最多60个请求。

  • 账户和交易接口:通过用户ID限制私人接口的调用,每1秒最多10个请求。

  • 某些接口的特殊限制在具体的接口上注明

# 查询系统时间

HTTP请求

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

请求方式

GET / POST

请求参数

返回值说明

参数名 参数类型 描述
code Int64 错误码,0表示成功,不为0表示异常失败
msg String 错误信息提示
currentTime Int64 系统当前时间,单位毫秒
    # Response
    {
        "code": 0,
        "msg": "",
        "currentTime": 1534431933321
    }
Last Updated: 2021/12/2 下午2:36:56