Coineal-Api接口文档

接口地址

请求地址:https://exchange-open-api.coineal.com

详细说明:

所有接口使用此域名:https://exchange-open-api.coineal.com

Api签名文档

详细说明:

签名: 
请求参数按照字典排序,然后以keyvalue的形式拼接成字符串string,最后sign=MD5(string+secretKey)。注意:如果请求参数中value为NULL的 情况,则在拼接字符串时不计入签名字符串。
例如:
参数如下:
country = 86;
mobile = 15882133579;
password = 654321zz;
time = 1516007245;
}
拼接完成后:
string = country86mobile15882133579password654321zztime1516007278
使用MD5签名
sign=MD5(string+secretKey)

获取24小时行情

请求方式:GET

请求地址:/open/api/get_ticker

Query参数名 类型 必需 描述 示例 e.g.
symbol string 交易对 btcusdt

详细说明:

获取最新的行情数据

返回示例:

                                {
    "code": "0",
    "msg": "suc",
    "data": {
        "high": 6796.63, 
        "vol": 2364.85442742,
        "last": 6722.37, 
        "low": 6399.28,
        "buy": "6721.56", 
        "sell": "6747.47",
        "time": 1529406706715
        
    }
    
}
                            
参数名 描述 类型
code 状态码,0表示成功,其他请查看状态码列表 number
data.low 最近24小时最低价 float
data.buy 最新买一价 float
data.high 最近24小时最高价 float
data.vol 最近24小时交易量 float
data.last 最新成交价 float
data.sell 最新卖一价 float
data.time 服务器更新时间戳 datetime

获取K线接口

请求方式:GET

请求地址:/open/api/get_records

Query参数名 类型 必需 描述 示例 e.g.
symbol string 交易对 btcusdt
period string 单位为分钟,比如1分钟则为1,一天则为1440 1

详细说明:

 获取交易对最新K线数据   获取最新的300条k线数据

返回示例:

                                {
    'code': '0', 
    'msg': 'suc',
    'data': [
                [
                    1529387760,  //时间戳
                    7585.41,  //开盘价
                    7585.41,  //最高价
                    7585.41,  //最低价
                    7585.41,  //收盘价
                    0.0       //成交量
                ]
            ]
    
}
                            
参数名 描述 类型
code 状态码,0表示成功,其他请查看状态码列表 string
msg 错误信息 string
data K线列表 array

获取市场深度

请求方式:GET

请求地址:/open/api/market_dept

Query参数名 类型 必需 描述 示例 e.g.
symbol string 交易对 btcusdt
type string 深度类型,step0, step1, step2(合并深度0-2);step0时,精度最高,一般来说分别是精度的1倍、10倍、100倍 step0, step1, step2

详细说明:

获取某个币对深度摆盘信息

返回示例:

                                {
    "code": "0",
    "msg": "suc", 
    "data": {
        "tick": {
            "time": 1529408112000,  //深度刷新时间
            "asks": //卖盘挂单
            [
                [
                    "6753.31", //卖一挂单价格
                    0.00306    //卖一挂单量
                ],
                [
                    "6754.78", //卖二挂单价格
                    0.61112   //卖二挂单量
                ]
                ...
            ],
            "bids": //买盘挂单
            [
                [
                    "6732.02",  //买一挂单价
                    0.18444     //买一挂单量
                ],
                [
                    "6730.08", //买一挂单价
                    0.14662    //买一挂单量
                ]
                ...
            ]
            
        }


                            
参数名 描述 类型
code 状态码,0表示成功,其他请查看状态码列表 string
msg 错误信息 string
data 返回数据 string
data.tick 深度数据 string
data.tick.time 深度刷新时间 string
data.tick.asks 卖盘挂单 string
data.tick.bids 买盘挂单 string

获取各币对最新成交价

请求方式:GET

请求地址:/open/api/market

Query参数名 类型 必需 描述 示例 e.g.
api_key string 用户账号申请的ApiKey
time string Unix时间戳
sign string 请求参数签名字符串,具体请查看签名规则

详细说明:

获取各币对最新成交价

返回示例:

                                {
    "code": "0",
    "msg": "suc", 
    "data": {
        "btcusdt":15000,
        "ethusdt":800
    }
}
                            
参数名 描述 类型
code 状态码,0表示成功,其他请查看状态码列表 string
msg 错误信息 string
data 返回数据 根据不同的交易对获取各个交易对的最小成交价 string
data.ethusdt ethusdt最新成交价 number
data.btcusdt btcusdt最新成交价 number

获取行情成交记录

请求方式:GET

请求地址:/open/api/get_trades

Query参数名 类型 必需 描述 示例 e.g.
symbol string 交易对 btcusdt

详细说明:

获取币对行情最新成交记录

返回示例:

                                {
    "code": "0", 
    "msg": "suc",
    "data":
    [
        {
            "amount": 0.99583, 
            "trade_time": 1529408112000, 
            "price": 6763.9,
            "id": 280101,
            "type": "sell"
            
        }
    ]
    
}
                            
参数名 描述 类型
code 状态码,0表示成功,其他请查看状态码列表 string
data.amount 成交额 number
data.trade_time 交易时间戳 number
data.price 成交价格 number
data.id 交易id number
data.type 交易类型 buy:买进 sell:卖出 string

获取交易对及精度信息

请求方式:GET

请求地址:/open/api/common/symbols

详细说明:

查询系统支持的所有交易对及精度

返回示例:

                                {
    "code": "0",
    "msg": "suc",
    "data": [
        {
            "symbol": "btcusdt",
            "count_coin": "usdt",
            "amount_precision": 5,
            "base_coin": "btc",
            "price_precision": 2
        }
    ]
}
                            
参数名 描述 类型
code 状态码,0表示成功,其他请查看状态码列表 number
msg 消息 string
data 数据对象 array
data.symbol 交易对 string
data.count_coin 定价币 string
data.amount_precision 交易量精度,表示保留几位小数 number
data.base_coin string
data.price_precision 价格精度,表示表示几位小数,此处表示保留2位小数的价格 number

创建订单

请求方式:POST

请求地址:/open/api/create_order

Header参数名 类型 必需 描述 示例 e.g.
Content-Type string POST请求需要填写此参数 application/x-www-form-urlencoded
Body参数名 类型 必需 描述 示例 e.g.
time string Unix时间戳
side string 买卖方向BUY、SELL
type string 挂单类型,1:限价委托、2:市价委托
price string 委托单价,type=2时不需要此参数 注意:请根据价格精度设置下单价格
volume string 购买数量(多义,复用字段)type=1:表示买卖数量 type=2:买则表示总价格,卖表示总个数
symbol string 交易对 btcusdt
api_key string 申请的ApiKey,在API管理中获取
sign string 请求参数签名字符串,具体请查看签名规则

详细说明:

application/x-www-form-urlencoded

返回示例:

                                {
"code": "0",
"msg": "suc",
"data": 
    {
        "order_id":34343
    }
}
                            
参数名 描述 类型
code 状态码,0表示成功,其他请查看状态码列表 string
msg 错误信息 string
data 返回数据 string
data.order_id 订单号 number

取消委托单

请求方式:POST

请求地址:/open/api/cancel_order

Header参数名 类型 必需 描述 示例 e.g.
Content-Type string POST请求需要填写此参数 application/x-www-form-urlencoded
Body参数名 类型 必需 描述 示例 e.g.
order_id string 订单编号
symbol string 交易对 btcusdt
api_key string 申请的ApiKey,在API管理中获取
time string Unix时间戳
sign string 请求参数签名字符串,具体请查看签名规则

详细说明:

取消委托单

返回示例:

                                {
    "code": "0",
    "msg": "suc", 
    "data": {
    }
}
                            
参数名 描述 类型
code 状态码,0表示成功,其他请查看状态码列表 string
msg 错误信息 string
data string

获取当前委托

请求方式:GET

请求地址:/open/api/new_order

Query参数名 类型 必需 描述 示例 e.g.
symbol string 交易对 btcusdt
api_key string 申请的ApiKey,在API管理中获取
time string Unix时间戳
page string 页码 1
pageSize string 页码大小 20
sign string 请求参数签名字符串,具体请查看签名规则

详细说明:

 订单状态(status)说明:

0、订单,未成交未进入盘口
1、新订单,未成交进入盘口
2、完全成交
3、部分成交
4、已撤单
5、待撤单
6、异常订单

返回示例:

                                {
    "code": "0",
    "msg": "suc", 
    "data": {   
            "count":10,    
            "resultList":
            [      
                {           
                    "side":"BUY",
                     "total_price":"0.10000000",   
                     "created_at":1510993841000,   
                     "avg_price":"0.10000000",     
                     "countCoin":"btc",     
                     "source":1,     
                     "type":1,       
                     "side_msg":"买入",  
                     "volume":"1.000",    
                     "price":"0.10000000",   
                     "source_msg":"WEB",       
                     "status_msg":"完全成交",     
                     "deal_volume":"1.00000000",    
                     "id":424,     
                     "remain_volume":"0.00000000",      
                     "baseCoin":"eth",         
                     "tradeList":[     
                            {       
                                 "volume":"1.000",       
                                 "price":"0.10000000",     
                                 "fee":"0.16431104",          
                                 "ctime":1510996571195,          
                                 "deal_price":"0.10000000",         
                                 "id":306,          
                                 "type":"买入" 
                            }      
                        ],    
                     "status":2    
                }
            ]
        }
}
                            
参数名 描述 类型
data.resultList.side 买卖类型 BUY、SELL string
data.resultList 委托列表 array
data.resultList.total_price 总金额 string
data.resultList.created_at 委托创建时间 number
data.resultList.avg_price 平均成交价 string
data.resultList.countCoin 定价币 string
data.resultList.type 委托类型 1、限价委托 2、市价委托 number
data.resultList.volume 委托量 string
data.resultList.price 委托价格 string
data.resultList.source_msg 订单来源 string
data.resultList.deal_volume 成交量 string
data.resultList.id 订单ID number
data.resultList.remain_volume 未成交量 string
data.resultList.baseCoin string
data.resultList.tradeList 成交记录列表 array
data.resultList.tradeList.volume 成交量 string
data.resultList.tradeList.price 成交价格 string
data.resultList.tradeList.fee 手续费 string
data.resultList.tradeList.ctime 成交时间 number
data.resultList.tradeList.deal_price 成交价格 string
data.resultList.tradeList.id 成交ID number
data.resultList.status 订单状态 number

获取订单详情

请求方式:GET

请求地址:/open/api/order_info

Query参数名 类型 必需 描述 示例 e.g.
symbol string 交易对 btcusdt
order_id string 订单编号
api_key string 申请的ApiKey,在API管理中获取
time string Unix时间戳
sign string 请求参数签名字符串,具体请查看签名规则

详细说明:

获取订单详情

 订单状态(status)说明:

0、订单,未成交未进入盘口
1、新订单,未成交进入盘口
2、完全成交
3、部分成交
4、已撤单
5、待撤单
6、异常订单

返回示例:

                                {
    "code": "0",
    "msg": "suc", 
    "data": {   
            "order_info":
                {           
                     "side":"BUY",
                     "total_price":"0.10000000",   
                     "created_at":1510993841000,   
                     "avg_price":"0.10000000",     
                     "countCoin":"btc",     
                     "source":1,     
                     "type":1,       
                     "side_msg":"买入",  
                     "volume":"1.000",    
                     "price":"0.10000000",   
                     "source_msg":"WEB",       
                     "status_msg":"完全成交",     
                     "deal_volume":"1.00000000",    
                     "id":424,     
                     "remain_volume":"0.00000000",      
                     "baseCoin":"eth",         
                     "tradeList":[     
                            {       
                                 "volume":"1.000",       
                                 "price":"0.10000000",     
                                 "fee":"0.16431104",          
                                 "ctime":1510996571195,          
                                 "deal_price":"0.10000000",         
                                 "id":306,          
                                 "type":"买入" 
                            }      
                        ],    
                     "status":2    
                }
        }
}
                            
参数名 描述 类型
data.order_info.side 委托买卖类型 BUY:买入 SELL:卖出 string
data.order_info.total_price 委托总额 string
data.order_info.created_at 创建时间 number
data.order_info.avg_price 成交平均价 string
data.order_info.countCoin 定价币 string
data.order_info.source 来源 number
data.order_info.type 委托类型 1、限价委托 2、市价委托 number
data.order_info.volume 委托数量 string
data.order_info.price 委托价格 string
data.order_info.source_msg 来源 string
data.order_info.status_msg 订单状态 string
data.order_info.deal_volume 成交量 string
data.order_info.id 委托订单编号 number
data.order_info.remain_volume 剩余数量 string
data.order_info.baseCoin string
data.order_info.tradeList 成交列表 array
data.order_info.tradeList.volume 交易量 string
data.order_info.tradeList.price 交易价格 string
data.order_info.tradeList.fee 手续费 string
data.order_info.tradeList.ctime 成交时间 number
data.order_info.tradeList.deal_price 成交额 string
data.order_info.tradeList.type 委托买卖类型 string
code 状态码,0表示成功,其他请查看状态码列表 string
msg 错误信息 string

获取全部成交记录

请求方式:GET

请求地址:/open/api/all_trade

Query参数名 类型 必需 描述 示例 e.g.
symbol string 交易对 btcusdt
api_key string 申请的ApiKey,在API管理中获取
time string Unix时间戳
page string 页码,从1开始 1
pageSize string 每页大小 20
sign string 请求参数签名字符串,具体请查看签名规则

返回示例:

                                {
    "code": "0",
    "msg": "suc", 
    "data": {
       "count":22,   
            "resultList":[       
                {           
                    "volume":"1.000",   
                    "side":"BUY",       
                    "price":"0.10000000",    
                    "fee":"0.16431104",        
                    "ctime":1510996571195,     
                    "deal_price":"0.10000000",   
                    "id":306,       
                    "type":"买入"  
                }
            ]
   }
}
                            
参数名 描述 类型
code 状态码,0表示成功,其他请查看状态码列表 string
data.resultList.volume 成交量 string
data.resultList.side 买卖方向 string
data.resultList.price 成交价格 string
data.resultList.fee 手续费 string
data.resultList.ctime 创建时间 number
data.resultList.deal_price 成交额 string

获取资产余额

请求方式:GET

请求地址:/open/api/user/account

Query参数名 类型 必需 描述 示例 e.g.
api_key string 申请的ApiKey,在API管理中获取
time string Unix时间戳
sign string 请求参数签名字符串,具体请查看签名规则

返回示例:

                                {
    "code": "0",
    "msg": "suc", 
    "data": {
        "total_asset": 432323.23,
        "coin_list":[
                {
                    "coin":"btc",
                    "normal": 32323.233,
                    "locked":  32323.233,
                    "btcValuatin":112.33
                }
            ]

        }
}
                            
参数名 描述 类型
data.total_asset 总资产 number
data.coin_list 各币资产 array
data.coin_list.coin string
data.coin_list.normal 可用余额 number
data.coin_list.locked 冻结金额 number
data.coin_list.btcValuatin BTC估值 number
code 状态码,0表示成功,其他请查看状态码列表 string
msg 错误信息 string

附录

环境变量

变量名 变量值
host https://exchange-open-api.coineal.com/open/api

状态码

状态码 描述
0 成功
5 下单失败
6 数量小于最小值
7 数量大于最大值
8 订单取消失败
9 交易被冻结
13 对不起,程序出现系统错误,请和网站管理员联系
19 可用余额不足
22 订单不存在
23 缺少交易数量参数
24 缺少交易价格参数
100001 系统异常
100002 系统升级
100004 请求参数不合法
100005 参数签名错误
100007 非法IP
110002 未知的货币代号
110003 资金密码错误
110004 提现被冻结
110005 可用余额不足
110020 用户名不存在
110023 手机号已注册
110024 邮箱已注册
110025 帐户被后台管理员锁定
110032 该用户无权限进行此操作
110033 充值失败
110034 提现失败
在线编辑
目录