OnBlock API接口文档

鉴权机制

API分为公共接口和私有接口，你可以使用公共接口查询行情数据，并使用私有接口进行交易。所有以 /public/ 开头的是公共接口，此外的都是私有接口。公共接口允许直接访问。私有接口需要使用您的API Key做签名认证，以保证我们收到的请求为您本人发出。

私有接口除了接口本身参数外，还需要三个额外的鉴权参数：api_key，req_time，sign（除去sign之外的参数都需要参与签名）。一个合法的签名是将所有参数名按字母顺序排列，用&连接各参数，再加上您的api_secret，做MD5生成签名。需将签名放入参数sign中。

例如：如果您要取消 "id" 为 13579 的Order，此时您的api_key为keykeykey，api_secret为secsecsec，当前时间戳为1561270877，首先将需要签名的参数按照参数名进行排序(首先比较所有参数名的第一个字母，按英文字母顺序排列，若遇到相同首字母，则看第二个字母，以此类推)。所以第一个参数为api_key，第二个参数为id，第三个参数为req_time。将得到的值用&进行连接，得到api_key=keykeykey&id=13579&req_time=1561270877
在最后连接&api_secret=secsecsec，得到api_key=keykeykey&id=13579&req_time=1561270877&api_secret=secsecsec。将得到的字符串用MD5摘要算法进行签名，得到6f40159a8ce5e2ab828e55849b1450b8，加入到sign参数中，之后将api_key，req_time和sign三个参数放入请求中并发送请求即可。

API列表

下面所有API，都需要 /exchangeapi/v2/botapi 的前缀。

/public/markets

获得所有市场（即交易对）
参数：无
返回：返回数组，数组内容如下：

/public/markets/depth

返回某市场深度
参数：

返回：
asks和bids都是数组的数组。每个元素都是一个 价格，该价格总单量，该价格累计单量的三元组。

{
    "timestamp": 1561351446,
    "asks": [
        [
            "0.0541",
            "1.0",
            "9.9999"
        ],
        [
            "0.054",
            "8.9999",
            "8.9999"
        ]
    ],
    "bids": [
        [
            "0.053",
            "12.0",
            "12.0"
        ],
        [
            "0.0004",
            "0.06",
            "12.06"
        ]
    ]
}

/public/markets/trades

获得市场成交信息
参数：

返回：
返回数组，具体格式如下

/public/markets/tickers

获得Ticker信息
参数

返回：
下面的 "ticker.volume" 表示 json 的嵌套

/public/markets/k-line

获得K线信息
参数：当仅提供 market 参数时，会返回过去30min按照分钟为单位的K线数据。

返回：
返回值为数组的数组。每个K线数据点是一个长度为6的数据。按顺序每项意义如下：

/account/balances

返回用户各账户余额。
参数：无
返回：每项内容如下的数组：

/market/orders

返回用户全部委托
参数

返回

/market/current_orders

获得用户活跃委托。实际上等价于 /market/orders 接口只返回状态为 'wait' 的部分。接口格式和 /market/orders 一致。

/market/order

按照ID获取Order状态。
参数：

返回：同 '/market/orders'

/market/create_order

下单
参数：

返回：

/market/cancel_order

按照订单号取消订单
参数：

返回：无。确认"code"时200, msg时"OK"即可。