OKEX API笔记系列（一）：API概述

• API概述

• 撮合引擎

  • 成交价
    1. 提交订单的优先级：挂单价格 > 挂单时间
    2. 订单撮合时，以maker按挂单价，而非taker吃单价格成交
  • 订单生命周期
    1. 未成交
    2. 已成交
    3. 部分成交
    4. 已撤销
    5. 撤单中
  • 币币交易限价规则
    1. FOK现价规则：如果下单成交深度对应的价格与同方向盘口价的偏差超过30%，则订单立即被全数撤销。
  • 合约交易限价规则

• 费用

  • 交易费用：maker-taker收费规则，maker挂单成交手续费低于taker吃单；阶梯费用；市商计划返还Maker手续费。
  • 充/提币费用

• 服务器

  • 在香港

• 请求

  • 介绍
    1. REST API提供账户管理、行情查询、交易功能。
    2. REST API终端URL https://www.okex.com/
    3. 提供了WebSocket流，订阅WebSocket可以获取行情数据的推送
    4. 所有请求基于Https协议，请求头信息中contentType需要统一设置为:’application/json’
  • 错误
    1. 通过HTTP 4xx或者状态码进行返回，返回内容还将包含错误原因、参数信息。
    2. HTTP库应配置为非2xx请求提供消息主体

  400	Bad Request — Invalid request fotmat
  401	Unauthorized — Invalid API Key
  403	Forbidden — You do not have access to the requested resource
  404	Not Found
  500	Intermal Server Error — We had a problem with our server

  • 成功
    1. HTTP状态码200表示成功响应，并可能包含内容

• 分页

• 标准规范

  • 时间戳
  • 数字
  • ID

• 接口类型

  • 公共接口：获取配置信息和行情数据，无需认证
  • 私有接口：订单管理和账户管理，需要API Key验证

• 访问限制

  • 当访问超过频率限制时，将返回429状态：请求太频繁
  • REST API：如果传入有效的API key 用user id限速；如果没有则拿公网IP限速。限速规则：各个接口上有单独的说明，如果没有一般接口限速为 6次/秒。
  • WebSocket将每个命令类型限制为每秒50条命令。

• 验证

  • 生成API Key：API Key、Secret、Passphrase
  • 发起请求
  • 签名
  • 时间戳
    1. OK-ACCESS-TIMESTAMP请求头必须是UTC时区Unix时间戳的十进制秒数格式或ISO8601标准的时间格式。
    2. 精确到毫秒
    3. 时间戳和服务器时间相差30秒以上的请求将被系统视为过期并拒绝
  • 获取服务器时间
    1. 获取API服务器的时间。此接口为公共接口，不需要身份验证
    2. HTTP请求GET /api/general/v3/time
    3. 返回参数isoISO8601标准的时间格式；epochUTC时区Unix时间戳的十进制秒数格式。

.
.
.
2019-01-17 10:59:46写于德州