Skip to content

Home

Jump to bottom
BCEX-TECHNOLOGY-LIMITED edited this page Dec 3, 2018 · 3 revisions

请求说明

  • 本文档适用于已经在官方网站申请过api_key与私钥的用户。
  • 请使用中国大陆以外的服务器访问 API。
  • BCEX站请求地址为：www.bcex.top/api
  • KOREA站请求地址为：www.bcex.kr/api
  • 请求成功时，接口返回code值：0。

注意事项

  • 文档中所有接口参数中出现的'symbol'，需使用交易对替换，以ETH交易区的BTC为例：ETH_BTC。
  • 请求需page、size参数的接口，返回值中包含 count 字段，其值为符合条件的所有数据条目数，并不代表本次返回数据条目数。

关于认证

基于安全考虑，除行情API 外的 API 请求都必须进行签名运算。一个合法的请求由以下几部分组成：

  • 方法请求地址 即访问服务器地址，后面跟上方法名，比如www.bcex.top/api/api_market/getBalance。
  • 必选和可选参数 每个方法都有一组用于定义 API 调用的必需参数和可选参数。可以在每个方法的说明中查看这些参数及其含义。
  • API 访问密钥（api_key） 您申请api时返回的api_key。
  • 签名（sign）：用于校验请求参数是否被第三方截取篡改。

生成签名

按照ASCII码的顺序对参数名进行排序，转化为json字符串，使用私钥签名，得到签名计算结果进行 Base64编码，然后进行url编码。以查询资产余额接口为例进行说明

请求参数：

page=1
size=10
api_key=eb4f25dd532c14cee5e9b0301c8d4671

按照ASCII码的顺序对参数进行排序：

api_key=eb4f25dd532c14cee5e9b0301c8d4671
page=1
size=10

转化为json字符串：

{"api_key":"eb4f25dd532c14cee5e9b0301c8d4671","page":"1","size":"10"}

计算签名，将参数字符串、私钥传入加密函数，用sha1算法生成签名，计算结果并进行Base64编码：

c6jVyjdQ+KX5oDZGDOr0phH0JZPCZ4lgxva7iwPr2J9cHsCVNhJEmnUzHIYIUlemzSreXzl8Xt39mkQYPaH/Tt8eLqZf8QlUPIigy3MlKzq/BTDzXkJc4vna9ltT42W6ePwNi9q3Otm6FK6gMhiXqWwwUwa7OciHjYYehEomzoo=

提示！私钥是在您申请API时与api_key一起返回的，这里使用的私钥为：

-----BEGIN PRIVATE KEY-----
MIICdwIBADANBgkqhkiG9w0BAQEFAASCAmEwggJdAgEAAoGBALSQaafkE4wNY21T
+B2sCydP2FwkTQ6xi+bWLMVeF9bhFKyAZndmwxGgEc9bR6/rur5dAblka7OKpw3n
J27p3b5Ig/kd+dOSj4SfMp9pt96nHWud2KNZdAKUH4ybhg51D8TM0AXL474Gh8Cc
PrRvZspMdnlPM17YyUd6VjKQJs55AgMBAAECgYBF7mBdO8IuTckiQJEpvMYdFZlw
JkcJ182dO3nffs+w0z+Uh64ntE78dogvTOT4x01uCMtwJ+pmgN6uTcZB+KV+NEEC
7298kRZyclUZP4IDyc8qW95ljEHIJnDYwOzLop/IAY3PYwYT3ATJe8ceJ7nan32S
howHKNV+8abiD2yt4QJBANh/II1cF8wtSwVgUxaiKchZwz71GPIMxENRwF+Pgzpf
p61FIw8+If8sR1X036HgyY1+fmuakcqqjg68eF19SC0CQQDVgtOtx8BT9YtPEchv
dChqduHZi7f3IkrMuq7dzkZ9XI5QUdnAhnm8WiW8z8ruKUo32yyxJEWIUGOy6NLi
kqL9AkEAwGvVee7Vc/L5z/B6SQ6exmUJxUZBArnYIuFhc03x3Asy1C0z6RNXUh5/
1OVNcuqBGdLI+Eistg37LxvSe32jjQJAEWnPG9A7xl0zVGqN31Eo7q3tc5GqmlRI
p3PeSSbGpvjCfph+Wu5cxVjQ1RpZYZ0qeW29smDT7u8ngnLsqB/vfQJBAJwsJYVC
8V0D8waVTeDS0zgVcmKtjqHOtuJ3VuFivuSX0BZQALQIq5UlwUhIHwUKimEhffHc
84m43hIAVLHj7eM=
-----END PRIVATE KEY-----

对Base64编码后的结果进行URL编码：

c6jVyjdQ%2BKX5oDZGDOr0phH0JZPCZ4lgxva7iwPr2J9cHsCVNhJEmnUzHIYIUlemzSreXzl8Xt39mkQYPaH%2FTt8eLqZf8QlUPIigy3MlKzq%2FBTDzXkJc4vna9ltT42W6ePwNi9q3Otm6FK6gMhiXqWwwUwa7OciHjYYehEomzoo%3D

最终，发送到服务器的 API 请求参数应该为：

page=1
size=10
api_key=eb4f25dd532c14cee5e9b0301c8d4671
sign=c6jVyjdQ%2BKX5oDZGDOr0phH0JZPCZ4lgxva7iwPr2J9cHsCVNhJEmnUzHIYIUlemzSreXzl8Xt39mkQYPaH%2FTt8eLqZf8QlUPIigy3MlKzq%2FBTDzXkJc4vna9ltT42W6ePwNi9q3Otm6FK6gMhiXqWwwUwa7OciHjYYehEomzoo%3D

sign生成代码示例：

<!--php代码-->

    //请求参数数组
    $params = [
        'page' => '1',
        'size' => '10',
        'api_key' => 'eb4f25dd532c14cee5e9b0301c8d4671'
    ];

    //按照键名对关联数组进行升序排序，排序规则依据ASCII码
    ksort($params);

    //参数转为json格式字符串
    $str = json_encode($params);

    //获取私钥字符串
    $key = file_get_contents('./private_key.pem');

    //解析私钥供其他函数使用
    $private_key = openssl_pkey_get_private($key);

    //生成签名
    openssl_sign($str, $sign, $private_key, OPENSSL_ALGO_SHA1);

    //从内存中释放密钥资源
    openssl_free_key($private_key);

    //签名进行base64编码
    $sign = base64_encode($sign);
    
    //签名进行urlencode编码
    $sign = urlencode($sign);
    
    //将签名加入参数数组
    $params['sign'] = $sign;
<?php

接口列表

接口类型 请求方法 描述
资产 POST /api_market/getBalance 获取余额
交易品种信息 POST /api_market/getTokenPrecision 币种精度
市场行情 GET /api_market/apiKline K线
市场行情 GET /api_market/getTradeLists 所有symbol24小时行情
市场行情 http://single.static.com/test.openex.top/9/rtdata/symbol/trade.json 单个symbol最新成交记录
市场行情 POST /api_market/getDataOfTradesLatest 单个symbol批量成交记录
市场行情 POST /api_market/market/depth 市场深度行情（单个symbol）
用户订单信息 POST /api_market/placeOrder 下单
用户订单信息 POST /api_market/batchPlaceOrder 批量下单
用户订单信息 POST /api_market/getOrdersByOrderNo 根据单号批量查询订单
用户订单信息 POST /api_market/cancelOrder 取消订单
用户订单信息 POST /api_market/batchCancelOrder 根据单号批量取消订单（停用）
用户订单信息 POST /api_market/getOrderByOrderNo 获取某一订单
用户订单信息 POST /api_market/getOrders 获取用户订单列表
用户订单信息 POST /api_market/getOrders 获取用户未成交订单列表
用户订单信息 POST /api_market/getTrades 获取用户成交单列表
用户订单信息 POST /api_market/getTrades 获取用户单个symbol批量成交单列表
充提币 POST /api_market/searchDepositlList 充币列表
充提币 POST /api_market/searchWithdrawlList 提币列表

获取余额

POST /api_market/getBalance

请求参数

参数名称 是否必须 数据类型 描述 默认值 取值范围
page 是 int 页码 1~10000
size 是 int 每页显示数量 1~100

响应参数

{
    "code": 0,
    "msg": "successful",
    "data": {
        "count": 3,
        "data": [
            {
                "user_id": 1,
                "org_id": 12,
                "token": "BTC",
                "usable": "0",
                "locked": "0",
                "total": "0"
            },
            {
                "user_id": 1,
                "org_id": 12,
                "token": "ETH",
                "usable": "0",
                "locked": "0",
                "total": "0"
            }
        ]
    }
}

data说明：

        "data": [
            {
                "user_id": 用户id,
                "org_id": 机构id,
                "token": 币名,
                "usable": 可用资产,
                "locked": 锁定资产,
                "total": 总资产
            }
        ]

所有币种精度

POST /api_market/getTokenPrecision

请求参数

响应参数

{
    "USDT": {
        "phy_precision": 8,
        "calc_precision": 8,
        "biz_precision": 4
    },
    "BTC": {
        "phy_precision": 8,
        "calc_precision": 8,
        "biz_precision": 4
    },
    "ETH": {
        "phy_precision": 8,
        "calc_precision": 8,
        "biz_precision": 4
    }
}

data说明：

    {
        "calc_precision": 物理精度,
        "phy_precision":  计算精度,
        "biz_precision":  输入精度
    }

K线

GET /api_market/apiKline

请求参数

参数名称 是否必须 数据类型 描述 默认值 取值范围
time_type 是 string K线类型 1、5、10、15、30、60、240、1440、10080、43200
market 是 string 市场
token 是 string 币名
limit 是 string 数量
响应参数 
{
    "code": 0,
    "msg": "success",
    "data": [
        {
            "c_price": "100",
            "o_price": "100",
            "min_price": "100",
            "max_price": "100",
            "volume": "0",
            "timestamp": 1535618520000
        },
        {
            "c_price": "100",
            "o_price": "100",
            "min_price": "100",
            "max_price": "100",
            "volume": "0",
            "timestamp": 1535618580000
        }
    ]
}

data说明

    "data": [
        {
            "c_price": 收盘价,
            "o_price": 开盘价,
            "min_price": 最低价,
            "max_price": 最高价,
            "volume": 成交额,
            "timestamp": 时间点
        }
    ]

所有symbol24小时行情

GET /rt/getTradeLists

请求参数

响应参数

{
    "code": 0,
    "msg": "success",
    "data": {
        "USDT": [
            {
                "vol": "7.345",
                "market": "USDT",
                "token": "ONT",
                "amount": "2",
                "currency": {
                    "KRW": "2638.4784009881"
                },
                "max_price": "5",
                "min_price": "2.345",
                "latest_price": "2.345",
                "percent_change": "0.1725"
            }
        ]
    }
}

data说明

"USDT": [ //交易区
            {
                "vol": 交易额,
                "market": 市场,
                "token": 币名,
                "amount": 成交两,
                "currency": { //法币参考价格
                    "KRW": 韩元
                },
                "max_price": 最高价,
                "min_price": 最低价,
                "latest_price": 最新价格,
                "percent_change": 24h涨跌
            }
        ]

单个symbol最新成交记录

GET http://test.static.com/test.openex.top/rtdata/USDT_BTC/trade.json

请求参数

响应参数

[
    {
        "created_at": "2018-08-31 11:26:10",
        "price": "1",
        "amount": "0",
        "volume": "0",
        "dominance": "2"
    },
    {
        "created_at": "2018-08-31 10:26:14",
        "price": "1",
        "amount": "1",
        "volume": "1",
        "dominance": "1"
    }
]

data说明

[
    {
        "created_at": 创建时间,
        "price": 价格,
        "amount": 交易币数额,
        "volume": 市场币数额,
        "dominance":主动成交方 1买方 2卖方
    }
]

批量获取单个symbol最近成交记录

POSt /api_market/getDataOfTradesLatest

请求参数

参数名称 是否必须 数据类型 描述 默认值 取值范围
page 是 string 页码 1~10000
size 是 string 每页显示数量 1~100
market 是 string 市场
token 是 string 币名
响应参数 
{
    "code": 0,
    "msg": "successful",
    "data": {
        "data": [
            {
                "id": 1,
                "created_at": "2018-08-31 10:26:14",
                "price": "1",
                "amount": "1",
                "dominance": "1"
            },
            {
                "id": 2,
                "created_at": "2018-08-31 10:26:14",
                "price": "1",
                "amount": "1",
                "dominance": "1"
            }
        ]
    }
}

data说明

    "data": [
      {
        "id": 成交id,
        "price": 成交价,
        "amount": 成交量,
        "dominance": 主动成交方向,
        "created_at": 成交时间
      }
   ]

单个symbol市场深度行情

POST /api_market/market/depth

请求参数

参数名称 是否必须 数据类型 描述 默认值 取值范围
market 是 string 市场
token 是 string 币名
响应参数 
{
    "status": "ok",
    "ts": "1536551031108",
    "tick": {
        "bids": [
            [
                "2.8",
                "6.32"
            ],
            [
                "2.77",
                "6.72"
            ]
        ],
        "asks": [
            [
                "5.6",
                "2.3"
            ]
        ]
    }
}

data说明

{
        "bids": [
            [
                "2.8",   //价格
                "6.32"   //数量
            ],
            [
                "2.77",  //价格
                "6.72"   //数量
            ]
        ],
        "asks": [
            [
                "5.6",   //价格
                "2.3"    //数量
            ]
        ]
}

下单

POST /api_market/placeOrder

请求参数

参数名称 是否必须 数据类型 描述 默认值 取值范围
market_type 是 string 市场类型 1
market 是 string 市场
token 是 string 币名
type 是 string 买/卖 1买 2卖
price 是 string 价格
amount 是 string 数量
响应参数 
{
    "code": 0,
    "msg": "successful",
    "data": {
        "id": 1,
        "status": 1,
        "order_no": "2018090313134038386500017289",
        "type": "1",
        "market_type": "1",
        "account_id": 6,
        "org_id": 12,
        "user_id": 1,
        "market": "BTC",
        "token": "ETH",
        "price": "0.05",
        "amount": "1",
        "volume": "0.05",
        "matched_amount": "0",
        "matched_volume": "0",
        "avg_price":"0",
        "created_at": "2018-09-03 13:13:40",
        "updated_at": "2018-09-03 13:13:40"
    }
}

data说明

    "data": {
        "id": 订单id,
        "status": 状态 0已取消 1已创建 2撮合中 3已完成,
        "order_no": 订单单号,
        "type": 类型 1买 2卖,
        "market_type": 市场类型 现阶段值为1,
        "account_id_from": 付款账号id',
        "account_id_to": 收款账号id',
        "org_id": 机构id,
        "user_id": 用户id,
        "market": 市场,
        "token": 币名,
        "price": 价格,
        "amount": 市场币数额,
        "volume": 交易币数额,
        "matched_amount": 已撮合市场币数额,
        "matched_volume": 已撮合交易币数额,
        "avg_price":已撮合部分平均单价,
        "created_at": 创建时间,
        "updated_at": 更新时间
    }

批量下单

POST /api_market/batchPlaceOrder

请求参数

参数名称 是否必须 数据类型 描述 默认值 取值范围
data 是 array 订单数组
请求参数说明 
data = [
    [
        'market_type' => 1, //市场类型 值为1
        'market' => 'USDT', //市场  
        'token' => 'ETH',   //币名
        'type' => 1,        //类型 1买 2卖
        'price' => '100',   //价格
        'amount' => '1'     //数量
    ],
    [
        'market_type' => 1,
        'market' => 'USDT',
        'token' => 'BTC',
        'type' => 1,
        'price' => '100',
        'amount' => '1'
    ]
]

响应参数

{
    "code": 0,
    "msg": "successful",
    "data": {
        "count": 10,
        "data": [
            {
                "id": 1,
                "status": 1,
                "type": 1,
                "market_type": 1,
                "order_no": "2018090313134038386500017289",
                "account_id": 6,
                "user_id": 1,
                "org_id": 12,
                "market": "BTC",
                "token": "ETH",
                "price": "0.05",
                "amount": "1",
                "volume": "0.05",
                "matched_amount": "0",
                "matched_volume": "0",
                "avg_price":"0",
                "created_at": "2018-09-03 13:13:40",
                "updated_at": "2018-09-03 13:13:40"
            },
            {
                "id": 2,
                "status": 1,
                "type": 1,
                "market_type": 1,
                "order_no": "2018090313134038386500017299",
                "account_id": 6,
                "user_id": 1,
                "org_id": 12,
                "market": "BTC",
                "token": "ETH",
                "price": "0.05",
                "amount": "1",
                "volume": "0.05",
                "matched_amount": "0",
                "matched_volume": "0",
                "avg_price":"0",
                "created_at": "2018-09-03 13:13:42",
                "updated_at": "2018-09-03 13:13:42"
            }
        ]
    }
}

data说明

    "data": {
        "id": 订单id,
        "status": 状态 0已取消 1已创建 2撮合中 3已完成,
        "order_no": 订单单号,
        "type": 类型 1买 2卖,
        "market_type": 市场类型 现阶段值为1,
        "account_id_from": 付款账号id',
        "account_id_to": 收款账号id',
        "org_id": 机构id,
        "user_id": 用户id,
        "market": 市场,
        "token": 币名,
        "price": 价格,
        "amount": 市场币数额,
        "volume": 交易币数额,
        "matched_amount": 已撮合市场币数额,
        "matched_volume": 已撮合交易币数额,
        "avg_price":已撮合部分平均单价,
        "created_at": 创建时间,
        "updated_at": 更新时间
    }

根据单号批量查询订单

POST /api_market/getOrdersByOrderNo

参数名称 是否必须 数据类型 描述 默认值 取值范围
arr_order_no 是 array 状态,格式：['2018090313134038386500017289','2018090313134038386500017345']
响应参数 
{
    "code": 0,
    "msg": "successful",
    "data": {
        "count": 10,
        "data": [
            {
                "id": 1,
                "status": 1,
                "type": 1,
                "market_type": 1,
                "order_no": "2018090313134038386500017289",
                "account_id": 6,
                "user_id": 1,
                "org_id": 12,
                "market": "BTC",
                "token": "ETH",
                "price": "0.05",
                "amount": "1",
                "volume": "0.05",
                "matched_amount": "0",
                "matched_volume": "0",
                "avg_price":"0",
                "created_at": "2018-09-03 13:13:40",
                "updated_at": "2018-09-03 13:13:40",
                "unmatched_amount": "1"
            },
            {
                "id": 2,
                "status": 1,
                "type": 1,
                "market_type": 1,
                "order_no": "2018090313134038386500017299",
                "account_id": 6,
                "user_id": 1,
                "org_id": 12,
                "market": "BTC",
                "token": "ETH",
                "price": "0.05",
                "amount": "1",
                "volume": "0.05",
                "matched_amount": "0",
                "matched_volume": "0",
                "avg_price":"0",
                "created_at": "2018-09-03 13:13:42",
                "updated_at": "2018-09-03 13:13:42",
                "unmatched_amount": "1"
            }
        ]
    }
}

data说明

    "data": {
        "id": 订单id,
        "status": 状态 0已取消 1已创建 2撮合中 3已完成,
        "order_no": 订单单号,
        "type": 类型 1买 2卖,
        "market_type": 市场类型 现阶段值为1,
        "account_id_from": 付款账号id',
        "account_id_to": 收款账号id',
        "org_id": 机构id,
        "user_id": 用户id,
        "market": 市场,
        "token": 币名,
        "price": 价格,
        "amount": 市场币数额,
        "volume": 交易币数额,
        "matched_amount": 已撮合交易币数额,
        "matched_volume": 已撮合市场币数额,
        "unmatched_amount":未撮合交易币数额,
        "avg_price":已撮合部分平均单价,
        "created_at": 创建时间,
        "updated_at": 更新时间
    }

取消订单

POST /api_market/cancelOrder

请求参数

参数名称 是否必须 数据类型 描述 默认值 取值范围
order_nos 是 json 订单单号 ["2018091315164516313901209422","2018091315164516313901209644"]
响应参数 
{
    "code": 0,
    "msg": "successful",
    "data": null
}

根据单号批量取消订单

POST /api_market/batchCancelOrder

请求参数

参数名称 是否必须 数据类型 描述 默认值 取值范围
order_nos 是 array 订单单号数组 ['2018090414105069206400047564','2018090414105069206400047211']
响应参数 
{
    "code": 0,
    "msg": "successful"
}

获取某一订单

POST /api_market/getOrderByOrderNo

请求参数

参数名称 是否必须 数据类型 描述 默认值 取值范围
order_no 是 string 订单单号
响应参数 
{
    "code": 0,
    "msg": "successful",
    "data": {
        "id": 1,
        "status": 1,
        "order_no": "2018090313134038386500017289",
        "type": "1",
        "market_type": "1",
        "account_id": 6,
        "org_id": 12,
        "user_id": 1,
        "market": "BTC",
        "token": "ETH",
        "price": "0.05",
        "amount": "1",
        "volume": "0.05",
        "matched_amount": "0",
        "matched_volume": "0",
        "avg_price":"0",
        "created_at": "2018-09-03 13:13:40",
        "updated_at": "2018-09-03 13:13:40"
        "unmatched_amount":"0"
    }
}

data说明

    "data": {
        "id": 订单id,
        "status": 状态 0已取消 1已创建 2撮合中 3已完成,
        "order_no": 订单单号,
        "type": 类型 1买 2卖,
        "market_type": 市场类型 现阶段值为1,
        "account_id_from": 付款账号id',
        "account_id_to": 收款账号id',
        "org_id": 机构id,
        "user_id": 用户id,
        "market": 市场,
        "token": 币名,
        "price": 价格,
        "amount": 市场币数额,
        "volume": 交易币数额,
        "matched_amount": 已撮合交易币数额,
        "matched_volume": 已撮合市场币数额,
        "unmatched_amount":未撮合交易币数额,
        "avg_price":已撮合部分平均单价,
        "created_at": 创建时间,
        "updated_at": 更新时间
    }

获取用户订单列表

POST /api_market/getOrders

参数名称 是否必须 数据类型 描述 默认值 取值范围
page 是 string 页码 1~10000
size 是 string 每页显示数量 1~100
type 否 string 类型 1买 2卖
market 否 string 市场
token 否 string 币名
status 否 array 状态,格式：[0,1,2,3] 0取消 1已创建 2撮合中 3已完成
begin_time 否 string 开始时间， 例2018-08-20 00:00:00； 必须与end_time结合使用
end_time 否 string 结束时间， 例2018-08-21 23:59:59；必须与start_time结合使用
响应参数 
{
    "code": 0,
    "msg": "successful",
    "data": {
        "count": 10,
        "data": [
            {
                "id": 1,
                "status": 1,
                "type": 1,
                "market_type": 1,
                "order_no": "2018090313134038386500017289",
                "account_id": 6,
                "user_id": 1,
                "org_id": 12,
                "market": "BTC",
                "token": "ETH",
                "price": "0.05",
                "amount": "1",
                "volume": "0.05",
                "matched_amount": "0",
                "matched_volume": "0",
                "avg_price":"0",
                "created_at": "2018-09-03 13:13:40",
                "updated_at": "2018-09-03 13:13:40",
                "unmatched_amount": "1"
            },
            {
                "id": 2,
                "status": 1,
                "type": 1,
                "market_type": 1,
                "order_no": "2018090313134038386500017299",
                "account_id": 6,
                "user_id": 1,
                "org_id": 12,
                "market": "BTC",
                "token": "ETH",
                "price": "0.05",
                "amount": "1",
                "volume": "0.05",
                "matched_amount": "0",
                "matched_volume": "0",
                "avg_price":"0",
                "created_at": "2018-09-03 13:13:42",
                "updated_at": "2018-09-03 13:13:42",
                "unmatched_amount": "1"
            }
        ]
    }
}

data说明

    "data": {
        "id": 订单id,
        "status": 状态 0已取消 1已创建 2撮合中 3已完成,
        "order_no": 订单单号,
        "type": 类型 1买 2卖,
        "market_type": 市场类型 现阶段值为1,
        "account_id_from": 付款账号id',
        "account_id_to": 收款账号id',
        "org_id": 机构id,
        "user_id": 用户id,
        "market": 市场,
        "token": 币名,
        "price": 价格,
        "amount": 市场币数额,
        "volume": 交易币数额,
        "matched_amount": 已撮合交易币数额,
        "matched_volume": 已撮合市场币数额,
        "unmatched_amount":未撮合交易币数额,
        "avg_price":已撮合部分平均单价,
        "created_at": 创建时间,
        "updated_at": 更新时间
    }

获取用户未成交订单列表

POST /api_market/getOrders

参数名称 是否必须 数据类型 描述 默认值 取值范围
page 是 string 页码 1~10000
size 是 string 每页显示数量 1~100
status 否 array 状态(1未撮合 2撮合中) [1,2]
响应参数 
{
    "code": 0,
    "msg": "successful",
    "data": {
        "count": 10,
        "data": [
            {
                "id": 1,
                "status": 1,
                "type": 1,
                "market_type": 1,
                "order_no": "2018090313134038386500017289",
                "account_id": 6,
                "user_id": 1,
                "org_id": 12,
                "market": "BTC",
                "token": "ETH",
                "price": "0.05",
                "amount": "1",
                "volume": "0.05",
                "matched_amount": "0",
                "matched_volume": "0",
                "avg_price":"0",
                "created_at": "2018-09-03 13:13:40",
                "updated_at": "2018-09-03 13:13:40",
                "unmatched_amount": "1"
            },
            {
                "id": 2,
                "status": 1,
                "type": 1,
                "market_type": 1,
                "order_no": "2018090313134038386500017299",
                "account_id": 6,
                "user_id": 1,
                "org_id": 12,
                "market": "BTC",
                "token": "ETH",
                "price": "0.05",
                "amount": "1",
                "volume": "0.05",
                "matched_amount": "0",
                "matched_volume": "0",
                "avg_price":"0",
                "created_at": "2018-09-03 13:13:42",
                "updated_at": "2018-09-03 13:13:42",
                "unmatched_amount": "1"
            }
        ]
    }
}

data说明

    "data": {
        "id": 订单id,
        "status": 状态 0已取消 1已创建 2撮合中 3已完成,
        "order_no": 订单单号,
        "type": 类型 1买 2卖,
        "market_type": 市场类型 现阶段值为1,
        "account_id_from": 付款账号id',
        "account_id_to": 收款账号id',
        "org_id": 机构id,
        "user_id": 用户id,
        "market": 市场,
        "token": 币名,
        "price": 价格,
        "amount": 市场币数额,
        "volume": 交易币数额,
        "matched_amount": 已撮合交易币数额,
        "matched_volume": 已撮合市场币数额,
        "unmatched_amount":未撮合交易币数额,
        "avg_price":已撮合部分平均单价,
        "created_at": 创建时间,
        "updated_at": 更新时间
    }

获取用户成交单列表

POST /api_market/getTrades

参数名称 是否必须 数据类型 描述 默认值 取值范围
page 是 string 页码 1~10000
size 是 string 每页显示数量 1~100
type 否 string 类型 1买 2卖
market 否 string 市场
token 否 string 币名
begin_time 否 string 开始时间， 例2018-08-20 17:59:33； 必须与end_time结合使用
end_time 否 string 结束时间， 例2018-08-31 17:59:33； 必须与start_time结合使用
响应参数 
{
    "code": 0,
    "msg": "successful",
    "data": {
        "count": 10,
        "data": [
            {
                "id": 1,
                "trade_no": "2243534656575453445453343423",
                "buy_order_id": 1,
                "buy_order_no": "2243534656575453445453343465",
                "sell_order_id": 1,
                "sell_order_no": "12135647586799657463241324",
                "dominance": 1,
                "buyer_user_id": 1,
                "seller_user_id": 2,
                "org_id": 12,
                "trade_strategy": 1,
                "market": "ETH",
                "token": "BTC",
                "price": "10.00000000",
                "amount": "1.00000000",
                "volume": "1.00000000",
                "created_at": "1970-01-01 08:00:01",
                "updated_at": "2018-08-29 10:19:12"
            },
            {
                "id": 2,
                "trade_no": "2243534656575453445453345523",
                "buy_order_id": 1,
                "buy_order_no": "2243534656575453445453343472",
                "sell_order_id": 1,
                "sell_order_no": "12135647586799657463241367",
                "dominance": 1,
                "buyer_user_id": 1,
                "seller_user_id": 2,
                "org_id": 12,
                "trade_strategy": 1,
                "market": "ETH",
                "token": "BTC",
                "price": "10.00000000",
                "amount": "1.00000000",
                "volume": "1.00000000",
                "created_at": "1970-01-01 08:00:01",
                "updated_at": "2018-08-29 10:19:12"
            }
        ]
    }
}

data说明

        "data": {
            "id": 1,
            "trade_no": 成交单号,
            "buy_order_id": 买入的订单id,
            "buy_order_no": 买入的订单单号,
            "sell_order_id": 卖出的订单id,
            "sell_order_no": 卖出的订单单号,
            "dominance": 主动成交方,
            "buyer_user_id": 买入的用户id,
            "seller_user_id": 卖出的用户id,
            "org_id": 机构id,
            "trade_strategy": 交易类型 1限价交易,
            "market": 市场,
            "token": 币名,
            "price": 价格,
            "amount": 市场币数额,
            "volume": 交易币数额,
            "created_at": 创建时间,
            "updated_at": 更新时间
        }

用户单个symbol批量成交记录

POST /api_market/getTrades

参数名称 是否必须 数据类型 描述 默认值 取值范围
page 是 string 页码 1~10000
size 是 string 每页显示数量 1~100
market 否 string 市场
token 否 string 币名
响应参数 
{
    "code": 0,
    "msg": "successful",
    "data": {
        "count": 10,
        "data": [
            {
                "id": 1,
                "trade_no": "2243534656575453445453343423",
                "buy_order_id": 1,
                "buy_order_no": "2243534656575453445453343465",
                "sell_order_id": 1,
                "sell_order_no": "12135647586799657463241324",
                "dominance": 1,
                "buyer_user_id": 1,
                "seller_user_id": 2,
                "org_id": 12,
                "trade_strategy": 1,
                "market": "ETH",
                "token": "BTC",
                "price": "10.00000000",
                "amount": "1.00000000",
                "volume": "1.00000000",
                "created_at": "1970-01-01 08:00:01",
                "updated_at": "2018-08-29 10:19:12"
            },
            {
                "id": 2,
                "trade_no": "2243534656575453445453345523",
                "buy_order_id": 1,
                "buy_order_no": "2243534656575453445453343472",
                "sell_order_id": 1,
                "sell_order_no": "12135647586799657463241367",
                "dominance": 1,
                "buyer_user_id": 1,
                "seller_user_id": 2,
                "org_id": 12,
                "trade_strategy": 1,
                "market": "ETH",
                "token": "BTC",
                "price": "10.00000000",
                "amount": "1.00000000",
                "volume": "1.00000000",
                "created_at": "1970-01-01 08:00:01",
                "updated_at": "2018-08-29 10:19:12"
            }
        ]
    }
}

data说明

        "data": {
            "id": 1,
            "trade_no": 成交单号,
            "buy_order_id": 买入的订单id,
            "buy_order_no": 买入的订单单号,
            "sell_order_id": 卖出的订单id,
            "sell_order_no": 卖出的订单单号,
            "dominance": 主动成交方,
            "buyer_user_id": 买入的用户id,
            "seller_user_id": 卖出的用户id,
            "org_id": 机构id,
            "trade_strategy": 交易类型 1限价交易,
            "market": 市场,
            "token": 币名,
            "price": 价格,
            "amount": 市场币数额,
            "volume": 交易币数额,
            "created_at": 创建时间,
            "updated_at": 更新时间
        }

获取充币记录

POST /api_market/searchDepositList

参数名称 是否必须 数据类型 描述 默认值 取值范围
page 是 string 页码 1~10000
size 是 string 每页显示数量 1~100
token 是 string 币名，可为空
begin_time 是 string 开始时间， 例2018-08-20 17:59:33，可为空；必须与end_time结合使用
end_time 是 string 结束时间， 例2018-08-31 17:59:33，可为空；必须与start_time结合使用
响应参数 
{
    "code": 0,
    "msg": "ok",
    "data": {
        "data": [
            {
                "id": 1,
                "user_id": 1,
                "org_id": 12,
                "account_id": 1,
                "token": "BTC",
                "amount": "1",
                "blockchain_tx_id": "ardtyuijuytredsasdfg",
                "deposit_no": "123456789765432133453",
                "address": "aSDFGUIYTREWAaertyrewasSDFGHJK",
                "confirm_count": 0,
                "status": 1,
                "created_at": "2018-09-03 17:23:20",
                "updated_at": "2018-09-03 17:24:24"
            },
            {
                "id": 2,
                "user_id": 1,
                "org_id": 12,
                "account_id": 1,
                "token": "BTC",
                "amount": "2",
                "blockchain_tx_id": "Awedtyuiuyfgdsa",
                "deposit_no": "345678985432132446577",
                "address": "asertyuiouytredasdrtyuiuytfdssasdfgh",
                "confirm_count": 12,
                "status": 5,
                "created_at": "2018-09-03 17:24:18",
                "updated_at": "2018-09-03 17:24:18"
            }
        ],
        "count": 2
    }

data说明：

        "data": {
            "id": 充币单id,
            "user_id": 用户,
            "org_id": 机构id,
            "account_id": 账号id,
            "token": 币名,
            "amount": 数量,
            "blockchain_tx_id": txid,
            "deposit_no": 充币单号,
            "address": 充币地址,
            "confirm_count": 确认数,
            "status": 状态 1已创建 5已完成,
            "created_at": 创建时间,
            "updated_at": 更新时间
        }

获取提币记录

POST /api_market/searchWithdrawalList

参数名称 是否必须 数据类型 描述 默认值 取值范围
page 是 string 页码 1~10000
size 是 string 每页显示数量 1~100
token 是 string 币名，可为空
begin_time 是 string 开始时间， 例2018-08-20 17:59:33，可为空；必须与end_time结合使用
end_time 是 string 结束时间， 例2018-08-31 17:59:33，可为空；必须与start_time结合使用
响应参数 
{
    "code": 0,
    "msg": "ok",
    "data": {
        "data": [
            {
                "id": 1,
                "user_id": 1,
                "org_id": 12,
                "account_id": 6,
                "fee_account_id": 3,
                "token": "BTC",
                "fee_token": "BTC",
                "protocol": 2,
                "amount": "",
                "apply_amount": "1",
                "blockchain_tx_id": null,
                "network_fee": "0.01",
                "withdrawal_no": "2018090317160306293300011976",
                "address_to": "1QT6UzFLZHtQKhWqUEXJgPWY1j5QevxfRk",
                "address_from": "ertyuiytrewrtyui987654ewsdftyu876t5rdsf1s",
                "fee_address": "ertyuiytrewrtyui987654ewsdftyu876t5rdsf1s",
                "reason": null,
                "confirm_count": 0,
                "status": 1,
                "created_at": "2018-09-03 17:16:03",
                "updated_at": "2018-09-03 17:16:03"
            }
        ],
        "count": 1
    }

data说明：

        "data": {
            "id": 提币单id,
            "user_id": 用户,
            "org_id": 机构id,
            "account_id": 账号id,
            "fee_account_id": 手续费账号id,
            "token": 币名,
            "fee_token": 网络费币名,
            "protocol": 协议,
            "amount": 实际到账数量,
            "apply_amount": 申请数量,
            "blockchain_tx_id": txid,
            "network_fee": 网络费,
            "withdrawal_no": 提币单号,
            "address_to": 收款地址,
            "address_from": 付款地址,
            "fee_address": 手续费地址,
            "reason": 审核原因,
            "confirm_count": 确认数,
            "status": 状态 0未审核 1已审核 2钱包已拉取 3已产生矿工费 4已产生第一块 5已完成 6审核未通过 7取消,
            "created_at": 创建时间,
            "updated_at": 更新时间
        }

请求说明

注意事项

关于认证

生成签名

接口列表

错误码说明

Clone this wiki locally