Skip to content

REST_API_Reference

BiboxEurope edited this page Apr 20, 2020 · 11 revisions

重要:完整的请求格式请参考API请求、返回格式说明,以下描述API接口时只列出部分。

目录

币币交易

市场行情(不需要apikey)

网络测试

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围

POST请求方法:ping

返回结果说明

{
    "result": {}, //测试成功
    "cmd":"ping"
}

示例

// Request
{
    "cmd": "ping"
    "body": {}
}

// Response
{
    "result": {},
    "cmd":"ping"
}

查询交易对

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围

POST请求方法:api/pairList

返回结果说明

{
    "result":[
        {
            "id":1,// 交易对id
            "pair":"ETH_BTC" //交易对symbol
        },
        {
            "id":2,
            "pair":"ETH_BTC"
        }
    ],
    "cmd":"api/pairList"
}

示例

// Request
{
    "cmd": "api/pairList"
    "body": {}
}

// Response
{
    "result":[
        {"id":1,"pair":"ETH_BTC"},
        {"id":2,"pair":"BTC_EUR"}
    ],
    "cmd":"api/pairList"
}

查询k线

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
pair true string 交易对 ETH_BTC, BTC_EUR, ...
period true string k线周期 '1min', '3min', '5min', '15min', '30min', '1hour', '2hour', '4hour', '6hour', '12hour', 'day', 'week'
size false integer 数量 1000 1-1000

POST请求方法:api/kline

返回结果说明

{
    "result":[
        {
            "time":1512660420000, // 时间戳
            "open":"0.00586568",  // 开盘价
            "high":"0.00586568",  // 最高价
            "low":"0.00586568",   // 最低价
            "close":"0.00586568", // 收盘价
            "vol":"0"             // 成交量
        },
        {
            "time":1512660480000,
            "open":"0.00586568",
            "high":"0.00586568",
            "low":"0.00586568",
            "close":"0.00586568",
            "vol":"10"
        }
    ],
    "cmd":"api/kline"
}

示例

// Request
{
    "cmd": "api/kline"
    "body": {
        "pair": "ETH_BTC",
        "period": "1min",
        "size": 10
    }
}

// Response
{
    "result":[
        {
            "time":1512660420000,
            "open":"0.00586568",
            "high":"0.00586568",
            "low":"0.00586568",
            "close":"0.00586568",
            "vol":"0"
        },
        {
            "time":1512660480000,
            "open":"0.00586568",
            "high":"0.00586568",
            "low":"0.00586568",
            "close":"0.00586568",
            "vol":"10"
        }
    ],
    "cmd":"api/kline"
}

查询全币种市场行情

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围

POST请求方法:api/marketAll

返回结果说明

{
    "result":{
        "id":4,
        "coin_symbol":"ETH",            //交易币种
        "currency_symbol":"BTC",        //定价币种
        "last":"0.00002704",            //24h最新价
        "high":"0.00003480",            //24h最高价
        "low":"0.00001951",             //24h最低价
        "change":"+0.00000715",         //24h涨跌
        "percent":"+35.95%",            //24h涨跌幅
        "vol24H":"641954",              //24h成交量
        "amount":"16.55",               //24h成交额
        "last_cny":"1.84",              //最新价折算cny
        "high_cny":"2.37",
        "low_cny":"1.33",
        "last_usd":"0.27",              //最新价折算usd
        "high_usd":"0.35",
        "low_usd":"0.19"
    },
    "cmd":"api/marketAll"
}

示例

// Request
{
    "cmd": "api/marketAll"
    "body": {}
}

// Response
{
    "result":[
        {
            "id":4,
            "coin_symbol":"ETH",
            "currency_symbol":"BTC",
            "last":"0.00002704",
            "high":"0.00003480",
            "low":"0.00001951",
            "change":"+0.00000715",
            "percent":"+35.95%",
            "vol24H":"641954",
            "amount":"16.55",
            "last_cny":"1.84",
            "high_cny":"2.37",
            "low_cny":"1.33",
            "last_usd":"0.27",
            "high_usd":"0.35",
            "low_usd":"0.19"
        },
        {
            "id":5,
            "coin_symbol":"ETH",
            "currency_symbol":"BTC",
            "last":"0.04341296",
            "high":"0.04884176",
            "low":"0.04321405",
            "change":"-0.00047878",
            "percent":"-1.09%",
            "vol24H":"86",
            "amount":"3.77",
            "last_cny":"2950.87",
            "high_cny":"3319.88",
            "low_cny":"2937.35",
            "last_usd":"432.60",
            "high_usd":"486.70",
            "low_usd":"430.62"
        }
    ],
    "cmd":"api/marketAll"
}

查询单币种市场行情

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
pair true string 交易对 ETH_BTC, BTC_EUR, ...

POST请求方法:api/market

返回结果说明

{
    "result":{
        "id":4,
        "coin_symbol":"ETH",            //交易币种
        "currency_symbol":"BTC",        //定价币种
        "last":"0.00002704",            //24h最新价
        "high":"0.00003480",            //24h最高价
        "low":"0.00001951",             //24h最低价
        "change":"+0.00000715",         //24h涨跌
        "percent":"+35.95%",            //24h涨跌幅
        "vol24H":"641954",              //24h成交量
        "amount":"16.55",               //24h成交额
        "last_cny":"1.84",              //最新价折算cny
        "high_cny":"2.37",
        "low_cny":"1.33",
        "last_usd":"0.27",              //最新价折算usd
        "high_usd":"0.35",
        "low_usd":"0.19"
    },
    "cmd":"api/market"
}

示例

// Request
{
    "cmd": "api/market"
    "body": {
        "pair": "ETH_BTC"
    }
}

// Response
{
    "result":[
        {
            "id":4,
            "coin_symbol":"ETH",
            "currency_symbol":"BTC",
            "last":"0.00002704",
            "high":"0.00003480",
            "low":"0.00001951",
            "change":"+0.00000715",
            "percent":"+35.95%",
            "vol24H":"641954",
            "amount":"16.55",
            "last_cny":"1.84",
            "high_cny":"2.37",
            "low_cny":"1.33",
            "last_usd":"0.27",
            "high_usd":"0.35",
            "low_usd":"0.19"
        }
    ],
    "cmd":"api/market"
}

查询市场深度

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
pair true string 交易对 ETH_BTC, BTC_EUR, ...
size false integer 数量 200 1-200

POST请求方法:api/depth

返回结果说明

{
    "result":{
        "pair":"ETH_BTC",
        "update_time":1510983122681,
        "asks":[                            //卖方深度
            {
                "price":"0.008654",         //挂单价格
                "volume":"200.9123"         //挂单数量
            }
        ],
        "bids":[                            //买方深度
            {
                "price":"0.008596",         //挂单价格
                "volume":"18.54306495"      //挂单数量
            },
            {
                "price":"0.00859289",
                "volume":"40.13567123"
            }
        ]
    },
    "cmd":"api/depth"
}

示例

// Request
{
    "cmd": "api/depth"
    "body": {
        "pair": "ETH_BTC"
    }
}

// Response
{
    "result":{
        "pair":"ETH_BTC",
        "update_time":1510983122681,
        "asks":[                            //卖方深度
            {
                "price":"0.008654",         //挂单价格
                "volume":"200.9123"         //挂单数量
            }
        ],
        "bids":[                            //买方深度
            {
                "price":"0.008596",         //挂单价格
                "volume":"18.54306495"      //挂单数量
            },
            {
                "price":"0.00859289",
                "volume":"40.13567123"
            }
        ]
    },
    "cmd":"api/depth"
}

查询成交记录

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
pair true string 交易对 ETH_BTC, BTC_EUR, ...
size false integer 数量 200 1-200

POST请求方法:api/deals

返回结果说明

{
    "result":[
        {
            "pair":"LTC_BTC",
            "price":"0.008601",                 //成交价格
            "amount":"24.12584739",             //成交数量
            "time":"1512721748000",             //成交时间
            "side":2                            //taker成交方向,1-买,2-卖
        },
        {
            "pair":"LTC_BTC",
            "price":"0.008611",                 //成交价格
            "amount":"24.23584739",             //成交数量
            "time":"1512721748000",             //成交时间
            "side":2                            //taker成交方向,1-买,2-卖
        }
    ],
    "cmd":"api/deals"
}

示例

// Request
{
    "cmd": "api/deals"
    "body": {
        "pair": "LTC_BTC"
    }
}

// Response
{
    "result":[
        {
            "pair":"LTC_BTC",
            "price":"0.008601",                 //成交价格
            "amount":"24.12584739",             //成交数量
            "time":"1512721748000",             //成交时间
            "side":2                            //taker成交方向,1-买,2-卖
        },
        {
            "pair":"LTC_BTC",
            "price":"0.008611",                 //成交价格
            "amount":"24.23584739",             //成交数量
            "time":"1512721748000",             //成交时间
            "side":2                            //taker成交方向,1-买,2-卖
        }
    ],
    "cmd":"api/deals"
}

查询市场ticker

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
pair true string 交易对 ETH_BTC, BTC_EUR, ...

POST请求方法:api/ticker

返回结果说明

{
    "result":{
        "pair":"ETH_BTC",           //交易对
        "buy":"0.00582132",         //最新买一价
        "buy_amount":"1",           //买一量
        "high":"0.00778847",        //24h最高价
        "last":"0.00582156",        //最新成交价
        "low":"0.00540611",         //24h最低价
        "sell":"0.00582152",        //最新卖一价
        "sell_amount":"1",           //卖一量
        "timestamp":1510983122665,  //时间戳
        "vol":"70.50811953"         //24h成交量
        "percent":"+10.02%"         //24h涨跌幅
        "last_cny":"621.53",        //最新成交价,cny计价
        "last_usd":"93.93"          //最新成交价,usd计价
    },
    "cmd":"api/ticker"
}

示例

// Request
{
    "cmd": "api/ticker"
    "body": {
        "pair": "ETH_BTC"
    }
}

// Response
{
    "result":{
        "pair":"ETH_BTC",           //交易对
        "buy":"0.00582132",         //最新买一价
        "buy_amount":"1",           //买一量
        "high":"0.00778847",        //24h最高价
        "last":"0.00582156",        //最新成交价
        "low":"0.00540611",         //24h最低价
        "sell":"0.00582152",        //最新卖一价
        "sell_amount":"1",           //卖一量
        "timestamp":1510983122665,  //时间戳
        "vol":"70.50811953"         //24h成交量
        "percent":"+10.02%"         //24h涨跌幅
        "last_cny":"621.53",        //最新成交价,cny计价
        "last_usd":"93.93"          //最新成交价,usd计价
    },
    "cmd":"api/ticker"
}

下单限制信息

限制说明

{
    "result": {
        "min_trade_price": {  //最小下单价格
            "default": "0.01", //普通交易对最小下单价格限制0.01
            "ETH_BTC": "0.00000001",//ETH_BTC交易对最小下单价格限制0.00000001,超过0.00000001的小数部分会自动舍弃
            "ONT_CHF": "0.001",//ONT_CHF交易对最小下单价格限制0.001,超过0.001的小数部分会自动舍弃
            "ONT_EUR": "0.001",//ONT_EUR交易对最小下单价格限制0.001,超过0.001的小数部分会自动舍弃
            "XRP_EUR": "0.0001",//XRP_EUR交易对最小下单价格限制0.0001,超过0.0001的小数部分会自动舍弃
            "XRP_CHF": "0.0001",//XRP_CHF交易对最小下单价格限制0.0001,超过0.0001的小数部分会自动舍弃
            "XRP_GBP": "0.0001",//XRP_GBP交易对最小下单价格限制0.0001,超过0.0001的小数部分会自动舍弃
            "other": "0.01"//其他币对统一限制0.01,超过0.01的小数部分会自动舍弃
        },
        "min_trade_amount": {//最小下单数量
            "default": "0.0001",//最小下单数量限制0.0001,超过0.0001的小数部分会自动舍弃,适用于所有交易对
        },
        "min_trade_money": {//最小下单金额(money = price * amount)
            "BTC": "0.0002",//BTC交易区最小下单金额限制为0.0002
            "EUR": "5",//EUR交易区最小下单金额限制为5
            "CHF": "5",//CHF交易区最小下单金额限制为5
            "GBP": "5",//GBP交易区最小下单金额限制为5
        }
    },
    "cmd": "tradeLimit"
}

用户资产信息(需要apikey)

币币账户资产

POST https://api.bibox.cc/v1/transfer

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
select false integer 是否查询资产明细 不传-各币种总资产合计,1-请求所有币种资产明细

POST请求方法 transfer/assets

返回结果说明

{
    "result":{
        "total_btc":"107.71371658",             //各币种资产总和,btc计价
        "total_cny":"5587362.53",               //各币种资产总和,cny计价
        "total_usd":"4000.30",                  //各币种资产总和,usd计价
        "assets_list":[                         //币种资产明细,没有返回 []
            {
                "coin_symbol":"BTC",
                "balance":"102.31666784",       //可用
                "freeze":"0.01800000",          //冻结
                "BTCValue":"1100.35043000",     //btc估值
                "CNYValue":"59448654.69",       //cny估值
                "USDValue":"8945419.86",        //usd估值
            },
            {
                "coin_symbol":"ETH",
                "balance":"100.00000000",
                "freeze":"0.00000000",
                "BTCValue":"1100.35043000",     //btc估值
                "CNYValue":"59448654.69",       //cny估值
                "USDValue":"8945419.86",        //usd估值
            },
            {
                "coin_symbol":"LTC",
                "balance":"125.34853787",
                "freeze":"0.00000000",
                "BTCValue":"1100.35043000",     //btc估值
                "CNYValue":"59448654.69",       //cny估值
                "USDValue":"8945419.86",        //usd估值
            },
            {
                "coin_symbol":"ETH",
                "balance":"712.79411732",
                "freeze":"0.00000000",
                "BTCValue":"1100.35043000",     //btc估值
                "CNYValue":"59448654.69",       //cny估值
                "USDValue":"8945419.86",        //usd估值
            }
        ]
    },
    "cmd":"transfer/assets"
}

示例

// Request
{
    "cmd": "transfer/assets"
    "body": {
        "select": 1
    }
}

// Response
{
    "result":{
        "total_btc":"107.71371658",             //各币种资产总和,btc计价
        "total_cny":"5587362.53",               //各币种资产总和,cny计价
        "total_usd":"4000.30",                  //各币种资产总和,usd计价
        "assets_list":[                         //币种资产明细,没有返回 []
            {
                "coin_symbol":"BTC",
                "balance":"102.31666784",       //可用
                "freeze":"0.01800000",          //冻结
                "BTCValue":"1100.35043000",     //btc估值
                "CNYValue":"59448654.69",       //cny估值
                "USDValue":"8945419.86",        //usd估值
            },
            {
                "coin_symbol":"ETH",
                "balance":"100.00000000",
                "freeze":"0.00000000",
                "BTCValue":"1100.35043000",     //btc估值
                "CNYValue":"59448654.69",       //cny估值
                "USDValue":"8945419.86",        //usd估值
            },
            {
                "coin_symbol":"LTC",
                "balance":"125.34853787",
                "freeze":"0.00000000",
                "BTCValue":"1100.35043000",     //btc估值
                "CNYValue":"59448654.69",       //cny估值
                "USDValue":"8945419.86",        //usd估值
            },
            {
                "coin_symbol":"ETH",
                "balance":"712.79411732",
                "freeze":"0.00000000",
                "BTCValue":"1100.35043000",     //btc估值
                "CNYValue":"59448654.69",       //cny估值
                "USDValue":"8945419.86",        //usd估值
            }
        ]
    },
    "cmd":"transfer/assets"
}

充值

POST https://api.bibox.cc/v1/transfer

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
coin_symbol true string 充值币种 ETH, BTC, ...

POST请求方法:transfer/transferIn

返回结果说明

{
    "result":"xxxxxxxxxxxxxxxxx", //充值地址
    "cmd":"transfer/transferIn"
}

示例

// Request
{
    "cmd": "transfer/transferIn"
    "body":{
        "coin_symbol":"ETH"
    }
}

// Response
{
    "result":"xxxxxxxxxxxxxxxxx", //充值地址
    "cmd":"transfer/transferIn"
}

提现

POST https://api.bibox.cc/v1/transfer

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
coin_symbol true string 提现币种 ETH, BTC, ...
amount true double 提现数量 需大于各币种最小提现数量
totp_code false integer google验证码 新地址需要,旧地址不需要
trade_pwd false string 资金密码 新地址需要,旧地址不需要
addr true string 提现地址 币种合法地址
addr_remark true string 提现地址备注名称
memo false string 提现标签 一些币种提现必须指定标签,与地址组合标识唯一性,比如EOS

POST请求方法:transfer/transferOut

返回结果说明

{
    "result":228   //提现id
    "cmd":"transfer/transferOut"
}

示例

// Request
{
    "cmd": "transfer/transferOut"
    "body":{
        "coin_symbol":"ETH",
        "amount":1,
        "totp_code":703634,
        "trade_pwd":"12345678",
        "addr":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "addr_remark":"bibox-1",
        "memo":"",
    }
}

// Response
{
    "result":228   //提现id
    "cmd":"transfer/transferOut"
}

查询充值记录

POST https://api.bibox.cc/v1/transfer

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
filter_type false integer 充值记录筛选 0 0-全部,1-充值进行中,2-充值到账,3-充值失败
coin_symbol false string 充值币种 ETH, BTC, ...
page true integer 第几页 从1开始
size true integer 每页数量 1-50

POST请求方法:transfer/transferInList

返回结果说明

{
    "result":{
        "count":2,
        "page":1,
        "items":[
            {
                "coin_symbol":"ETH",                        // 充值币种
                "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",  // 充值地址
                "amount":"1.00000000",                      // 充值数量
                "confirmCount":"15",                        // 充值确认数
                "createdAt":1540641511000,
                "status":2                                 // 充值状态,  1-充值进行中,2-充值到账,3-充值失败
            },
            {
                "coin_symbol":"ETH",
                "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",
                "amount":"1.00000000",
                "confirmCount":"15",
                "createdAt":1540622460000,
                "status":2
            }
        ]
    },
    "cmd":"transfer/transferInList"
}

示例

// Request
{
    "cmd": "transfer/transferInList"
    "body": {
        "filter_type": 0,
        "page": 1,
        "size": 10,
    }
}

// Response
{
    "result":{
        "count":2,
        "page":1,
        "items":[
            {
                "coin_symbol":"ETH",                        // 充值币种
                "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",  // 充值地址
                "amount":"1.00000000",                      // 充值数量
                "confirmCount":"15",                        // 充值确认数
                "createdAt":1540641511000,
                "status":2                                 // 充值状态,  1-充值进行中,2-充值到账,3-充值失败
            },
            {
                "coin_symbol":"ETH",
                "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",
                "amount":"1.00000000",
                "confirmCount":"15",
                "createdAt":1540622460000,
                "status":2
            }
        ]
    },
    "cmd":"transfer/transferInList"
}

查询提现记录

POST https://api.bibox.cc/v1/transfer

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
filter_type false integer 提现记录筛选 -2:审核不通过;-1: 用户撤销;0:待审核; 1:审核通过(待发币); 2: 发币中; 3:发币完成
coin_symbol false string 提现币种 ETH, BTC, ...
page true integer 第几页 从1开始
size true integer 每页数量 1-50

POST请求方法:transfer/transferOutList

返回结果说明

{
    "result":{
        "count":2,
        "page":1,
        "items":[
            {
                "coin_symbol":"ETH",                        // 提现币种
                "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",  // 提现地址
                "amount":"1.00000000",                      // 提现数量
                "fee":"0.00000000",                         // 提现手续费
                "createdAt":1540641511000,
                "memo":"",
                "status":-2                                 // 提现状态,  -2:审核不通过;-1: 用户撤销;0:待审核; 1:审核通过(待发币);  2: 发币中; 3:发币完成
            },
            {
                "coin_symbol":"ETH",
                "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",
                "amount":"1.00000000",
                "fee":"0.00000000",
                "createdAt":1540622460000,
                "memo":"",
                "status":3
            }
        ]
    },
    "cmd":"transfer/transferOutList"
}

示例

// Request
{
    "cmd": "transfer/transferOutList"
    "body": {
        "page": 1,
        "size": 10,
    }
}

// Response
{
    "result":{
        "count":2,
        "page":1,
        "items":[
            {
                "coin_symbol":"ETH",                        // 提现币种
                "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",  // 提现地址
                "amount":"1.00000000",                      // 提现数量
                "fee":"0.00000000",                         // 提现手续费
                "createdAt":1540641511000,
                "memo":"",
                "status":-2                                 // 提现状态,  -2:审核不通过;-1: 用户撤销;0:待审核; 1:审核通过(待发币);  2: 发币中; 3:发币完成'
            },
            {
                "coin_symbol":"ETH",
                "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",
                "amount":"1.00000000",
                "fee":"0.00000000",
                "createdAt":1540622460000,
                "memo":"",
                "status":3
            }
        ]
    },
    "cmd":"transfer/transferOutList"
}

获取币种配置

POST https://api.bibox.cc/v1/transfer

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
coin_symbol false string 币种 ETH, BTC...

POST请求方法:transfer/coinConfig

返回结果说明

{
    "result":[
        {
            "coin_symbol":"BTC",
            "original_decimals":8,              //币种原值精度
            "enable_deposit":1,                 //是否可充值,0-禁止,1-可以
            "enable_withdraw":1,                //是否可提现,0-禁止,1-可以
            "withdraw_fee":0.0005,              //提现手续费
            "withdraw_min":0.005                //最小提现数量
        },
        {
            "coin_symbol":"ETH",
            "original_decimals":18,
            "enable_deposit":0,
            "enable_withdraw":0,
            "withdraw_fee":2,
            "withdraw_min":10
        },
        ... //其他币种配置信息
    ],
    "cmd":"transfer/coinConfig"
}

示例

// Request
{
    "cmd": "transfer/coinConfig"
    "body": {
        
    }
}

// Response
{
    "result":[
        {
            "coin_symbol":"BTC",
            "original_decimals":8,              //币种原值精度
            "enable_deposit":1,                 //是否可充值,0-禁止,1-可以
            "enable_withdraw":1,                //是否可提现,0-禁止,1-可以
            "withdraw_fee":0.0005,              //提现手续费
            "withdraw_min":0.005                //最小提现数量
        },
        {
            "coin_symbol":"ETH",
            "original_decimals":18,
            "enable_deposit":0,
            "enable_withdraw":0,
            "withdraw_fee":2,
            "withdraw_min":10
        },
        ... //其他币种配置信息
    ],
    "cmd":"transfer/coinConfig"
}

查询某一条提现记录

POST https://api.bibox.cc/v1/transfer

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
id true integer 提现id

POST请求方法:transfer/withdrawInfo

返回结果说明

{
    "result":{
        "id":228,
        "createdAt": 1512756997000,
        "coin_symbol":"LTC",                        // 币种
        "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",  // 提现地址
        "status":3,                                 // 状态,  -2:审核不通过;-1: 用户撤销;0:待审核; 1:审核通过(待发币);  2: 发币中; 3:发币完成'
        "amount":"1.00000000",                      // 数量
        "fee":0.1                                   // 手续费
    },
    "cmd":"transfer/withdrawInfo"
}

示例

// Request
{
    "cmd": "transfer/withdrawInfo"
    "body": {
        "id": 228
    }
}

// Response
{
    "result":{
        "id":228,
        "createdAt": 1512756997000,
        "coin_symbol":"LTC",                        // 币种
        "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",  // 提现地址
        "status":3,                                 // 状态,  -2:审核不通过;-1: 用户撤销;0:待审核; 1:审核通过(待发币);  2: 发币中; 3:发币完成'
        "amount":"1.00000000",                      // 数量
        "fee":0.1                                   // 手续费
    },
    "cmd":"transfer/withdrawInfo"
}

交易(需要apikey)

下单

POST https://api.bibox.cc/v1/orderpending

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
pair true string 交易对 ETH_BTC, BTC_EUR, ...
account_type true integer 账户类型 0-币币账户
order_type true integer 交易类型 2-限价单
order_side true integer 交易方向 1-买,2-卖
price true double 委托价格 最小值 0.00000001
amount true double 委托数量 最小值 0.0001

POST请求方法:orderpending/trade

返回结果说明

{
    "result": 34,     //返回委托单id
    "index": 12345,   //用户自定义随机数
    "cmd":"orderpending/trade"
}

示例

// Request
{
    "cmd": "orderpending/trade",
    "index": 12345,                  //随机数,批量时唯一标识某个cmd
    "body": {
        "pair": "ETH_BTC",           //交易对, ETH_BTC, BTC_EUR, ...
        "account_type": 0,           //账户类型,0-币币账户
        "order_type": 2,             //交易类型,2-限价单
        "order_side": 1,             //交易方向,1-买,2-卖
        "price": 0.00032,            //委托价格
        "amount": 1000               //委托数量
    }
}

// Response
{
    "result": "100055558128036",     //返回委托单id
    "index": 12345,   //用户自定义随机数
    "cmd":"orderpending/trade"
}

撤单

POST https://api.bibox.cc/v1/orderpending

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
orders_id true string 委托单id

POST请求方法:orderpending/cancelTrade

返回结果说明

{
    "result":"OK", //注意:该结果只表示服务器接收到撤单请求,撤销结果可查询订单记录
    "index": 12345,   //用户自定义随机数
    "cmd":"orderpending/cancelTrade"
}

示例

// Request
{
    "cmd": "orderpending/cancelTrade",
    "index": 12345,                  //随机数,批量时唯一标识某个cmd
    "body": {
        "orders_id": "8588285380268971"               //委托单id
    }
}

// Response
{
    "result":"OK",
    "index": 12345,   //用户自定义随机数
    "cmd":"orderpending/cancelTrade"
}

当前委托

POST https://api.bibox.cc/v1/orderpending

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
pair false string 交易对 ETH_BTC, BTC_EUR, ...
account_type true integer 账户类型 0-币币账户
order_side false integer 交易方向 1-买,2-卖
coin_symbol false string 交易币种 ETH, BTC, ...
currency_symbol false string 定价币种 CHF, EUR, ...
page true integer 第几页 从1开始
size true integer 每页数量 1-50

POST请求方法:orderpending/orderPendingList

返回结果说明

{
    "result":{
        "count":1,
        "page":1,
        "items":[
            {
                "id":159,
                "createdAt": 1512756997000,
                "account_type":0,                       //账户类型 0-币币账户
                "coin_symbol":"LTC",                    //交易币种
                "currency_symbol":"BTC",                //定价币种
                "order_side":2,                         //交易方向,1-买,2-卖
                "order_type":2,                         //订单类型,2-限价单
                "price":"0.00900000",                   //委托价格,市价单是0
                "amount":"1.00000000",                  //委托数量,市价买单是0
                "money":"0.00900000",                   //委托金额,市价卖单是0
                "deal_amount":"0.00000000",             //已成交数量
                "deal_percent":"0.00%",                 //成交百分比
                "unexecuted":"0.00000000",              //未成交数量
                "status":1                              //状态,-1 失败 0或1-待成交,2-部分成交,3-完全成交,4-部分撤销,5-完全撤销,6-待撤销
            }
        ]
    },
    "cmd":"orderpending/orderPendingList"
}

示例

// Request
{
    "cmd": "orderpending/orderPendingList",
    "body": {
        "account_type": 0,
        "order_side": 2,
        "page": 1,
        "size": 10,
        "coin_symbol": "LTC",
        "currency_symbol": "BTC"
    }
}

// Response
{
    "result":{
        "count":1,
        "page":1,
        "items":[
            {
                "id":159,
                "createdAt": 1512756997000,
                "account_type":0,                       //账户类型 0-币币账户
                "coin_symbol":"LTC",                    //交易币种
                "currency_symbol":"BTC",                //定价币种
                "order_side":2,                         //交易方向,1-买,2-卖
                "order_type":2,                         //订单类型,2-限价单
                "price":"0.00900000",                   //委托价格,市价单是0
                "amount":"1.00000000",                  //委托数量,市价买单是0
                "money":"0.00900000",                   //委托金额,市价卖单是0
                "deal_amount":"0.00000000",             //已成交数量
                "deal_percent":"0.00%",                 //成交百分比
                "unexecuted":"0.00000000",              //未成交数量
                "status":1                              //状态,-1 失败 0或1-待成交, 2-部分成交,3-完全成交,4-部分撤销,5-完全撤销,6-待撤销
            }
        ]
    },
    "cmd":"orderpending/orderPendingList"
}

历史委托

POST https://api.bibox.cc/v1/orderpending

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
pair false string 交易对 ETH_BTC, BTC_EUR, ...
account_type true integer 账户类型 0-币币账户
order_side false integer 交易方向 1-买,2-卖
coin_symbol false string 交易币种 ETH, BTC, ...
currency_symbol false string 定价币种 BTC, EUR, ...
hide_cancel false integer 隐藏已撤销订单 0-不隐藏,1-隐藏
page true integer 第几页 从1开始
size true integer 每页数量 1-50

POST请求方法:orderpending/pendingHistoryList

返回结果说明

{
    "result":{
        "count":1,
        "page":1,
        "items":[
            {
                "id":159,
                "createdAt": 1512756997000,
                "account_type":0,                       //账户类型 0-币币账户
                "coin_symbol":"LTC",                    //交易币种
                "currency_symbol":"BTC",                //定价币种
                "order_side":2,                         //交易方向,1-买,2-卖
                "order_type":2,                         //订单类型,2-限价单
                "price":"0.00900000",                   //委托价格,市价单是0
                "amount":"1.00000000",                  //委托数量,市价买单是0
                "money":"0.00900000",                   //委托金额,市价卖单是0
                "deal_price":"0.00900000",              //成交均价
                "deal_amount":"1.00000000",             //已成交数量
                "deal_money":"0.00900000",              //已成交金额
                "deal_percent":"100%",                  //成交百分比
                "status":3                              //状态,-1 失败 0或1-待成交,,2-部分成交,3-完全成交,4-部分撤销,5-完全撤销,6-待撤销
            }
        ]
    },
    "cmd":"orderpending/pendingHistoryList"
}

示例

// Request
{
    "cmd": "orderpending/pendingHistoryList",
    "body": {
        "account_type": 0,
        "order_side": 2,
        "page": 1,
        "size": 10,
        "coin_symbol": "LTC",
        "currency_symbol": "BTC"
    }
}

// Response
{
    "result":{
        "count":1,
        "page":1,
        "items":[
            {
                "id":159,
                "createdAt": 1512756997000,
                "account_type":0,                       //账户类型 0-币币账户
                "coin_symbol":"LTC",                    //交易币种
                "currency_symbol":"BTC",                //定价币种
                "order_side":2,                         //交易方向,1-买,2-卖
                "order_type":2,                         //订单类型,2-限价单
                "price":"0.00900000",                   //委托价格,市价单是0
                "amount":"1.00000000",                  //委托数量,市价买单是0
                "money":"0.00900000",                   //委托金额,市价卖单是0
                "deal_price":"0.00900000",              //成交均价
                "deal_amount":"1.00000000",             //已成交数量
                "deal_money":"0.00900000",              //已成交金额
                "deal_percent":"100%",                  //成交百分比
                "status":3                              //状态,-1 失败 0或1-待成交,2-部分成交,3-完全成交,4-部分撤销,5-完全撤销,6-待撤销
            }
        ]
    },
    "cmd":"orderpending/pendingHistoryList"
}

成交记录

POST https://api.bibox.cc/v1/orderpending

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
id true string 委托单id
account_type true integer 账户类型 0-币币账户

POST请求方法:orderpending/orderDetail

返回结果说明

{
    "result":{
        "sum":"0.00588746",                 // 成交总额
        "orderList":[
            {
                "id":"2251799813844119243",   // 成交记录ID
                "createdAt":1561007144000,    // 成交时间
                "account_type":0,             // 币币账户
                "coin_symbol":"KAT",          // 交易币种
                "currency_symbol":"ETH",      // 定价币种
                "order_side":2,               //交易方向,1-买,2-卖
                "order_type":2,               //订单类型,1-市价单,2-限价单 
                "price":"0.00001183",         //成交价格
                "amount":"497.6722",          //成交数量
                "money":"0.00588746",         //成交额
                "fee":"0.00000000",           //手续费
                "pay_ETH":0,                  //ETH抵扣 0 未开启 1 开启
                "fee_symbol":"ETH",           //手续费币种
                "relay_id":"11221615825364891" //关联订单id
            }
        ]
    },
    "cmd":"orderpending/orderDetail"
}

示例

// Request
{
    "cmd": "orderpending/orderDetail",
    "body": {
        "id": "11221615825364891"
    }
}

// Response
{
    "result":{
        "sum":"0.00588746",                 // 成交总额
        "orderList":[
            {
                "id":"2251799813844119243",   // 成交记录ID
                "createdAt":1561007144000,    // 成交时间
                "account_type":0,             // 币币账户
                "coin_symbol":"KAT",          // 交易币种
                "currency_symbol":"ETH",      // 定价币种
                "order_side":2,               //交易方向,1-买,2-卖
                "order_type":2,               //订单类型,1-市价单,2-限价单 
                "price":"0.00001183",         //成交价格
                "amount":"497.6722",          //成交数量
                "money":"0.00588746",         //成交额
                "fee":"0.00000000",           //手续费
                "pay_ETH":0,                  //ETH抵扣 0 未开启 1 开启
                "fee_symbol":"ETH",           //手续费币种
                "relay_id":"11221615825364891", //关联订单id
            }
        ]
    },
    "cmd":"orderpending/orderDetail"
}

委托单详情

POST https://api.bibox.cc/v1/orderpending

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
id true string 委托单id
account_type true integer 账户类型 0-币币账户

POST请求方法:orderpending/order

返回结果说明

{
    "result":{
        "id":"100055558128036",
         "createdAt": 1512756997000,
         "account_type":0,                       //账户类型 0-币币账户
         "pair":"LTC_BTC",                       //交易对
         "coin_symbol":"LTC",                    //交易币种
         "currency_symbol":"BTC",                //定价币种
         "order_side":2,                         //交易方向,1-买,2-卖
         "order_type":2,                         //订单类型,2-限价单
         "price":"0.00900000",                   //委托价格,市价单是0
         "amount":"1.00000000",                  //委托数量,市价买单是0
         "money":"0.00900000",                   //委托金额,市价卖单是0
         "deal_amount":"0.00000000",             //已成交数量
         "deal_percent":"0.00%",                 //成交百分比
         "unexecuted":"0.00000000",              //未成交数量
         "status":1                              //状态,-1 失败 0或1-待成交, 2-部分成交,3-完全成交,4-部分撤销,5-完全撤销,6-待撤销
    },
    "cmd":"orderpending/order"
}

示例

// Request
{
    "cmd": "orderpending/order",
    "body": {
        "id": "100055558128036"
    }
}

// Response
{
    "result":{
        "id":"100055558128036",
         "createdAt": 1512756997000,
         "account_type":0,                       //账户类型 0-币币账户
         "pair":"LTC_BTC",                       //交易对
         "coin_symbol":"LTC",                    //交易币种
         "currency_symbol":"BTC",                //定价币种
         "order_side":2,                         //交易方向,1-买,2-卖
         "order_type":2,                         //订单类型,2-限价单
         "price":"0.00900000",                   //委托价格,市价单是0
         "amount":"1.00000000",                  //委托数量,市价买单是0
         "money":"0.00900000",                   //委托金额,市价卖单是0
         "deal_amount":"0.00000000",             //已成交数量
         "deal_percent":"0.00%",                 //成交百分比
         "unexecuted":"0.00000000",              //未成交数量
         "status":1                              //状态,-1 失败 0或1-待成交, 2-部分成交,3-完全成交,4-部分撤销,5-完全撤销,6-待撤销
    },
    "cmd":"orderpending/order"
}

成交明细

POST https://api.bibox.cc/v1/orderpending

请求参数

参数名称 是否必须 类型 描述 默认值 取值范围
pair false string 交易对 ETH_BTC, BTC_EUR, ...
account_type true integer 账户类型 0-币币账户
order_side false integer 交易方向 1-买,2-卖
coin_symbol false string 交易币种 ETH, BTC, ...
currency_symbol false string 定价币种 BTC, EUR, ...
page true integer 第几页 从1开始
size true integer 每页数量 1-50

POST请求方法:orderpending/orderHistoryList

返回结果说明

{
    "result":{
        "count":1,
        "page":1,               //当前第几页
        "items":[               //记录明细
            {
                "id":"100055558128033",
                "createdAt": 1512756997000,
                "account_type":0,                           //账户类型 0-币币账户
                "coin_symbol":"LTC",                        //交易币种
                "currency_symbol":"BTC",                    //定价币种
                "order_side":2,                             //交易方向,1-买,2-卖
                "order_type":2,                             //订单类型,2-限价单
                "price":"0.00886500",                       //成交价格
                "amount":"1.00000000",                      //成交量
                "money":"0.00886500",                       //成交额,单位是定价币种
                "fee":0                                     //手续费
            }
        ]
    },
    "cmd":"orderpending/orderHistoryList"
}

示例

// Request
{
    "cmd": "orderpending/orderHistoryList",
    "body": {
        "account_type": 0,
        "order_side": 2,
        "page": 1,
        "size": 10,
        "coin_symbol": "ETH",
        "currency_symbol": "BTC"
    }
}

// Response
{
    "result":{
        "count":1,
        "page":1,               //当前第几页
        "items":[               //记录明细
            {
                "id":"100055558128033",
                "createdAt": 1512756997000,
                "account_type":0,                           //账户类型 0-币币账户
                "coin_symbol":"LTC",                        //交易币种
                "currency_symbol":"BTC",                    //定价币种
                "order_side":2,                             //交易方向,1-买,2-卖
                "order_type":2,                             //订单类型,2-限价单
                "price":"0.00886500",                       //成交价格
                "amount":"1.00000000",                      //成交量
                "money":"0.00886500",                       //成交额,单位是定价币种
                "fee":0                                     //手续费
            }
        ]
    },
    "cmd":"orderpending/orderHistoryList"
}

Bibox欧洲站交易所提供REST API 和 WebSocket API,便于投资者查看行情、快速交易。

Bibox欧洲站交易所

https://www.bibox.cc

REST API

WebSocket API

Clone this wiki locally