Restful API 币币交易

市场行情(不需要apikey)

网络测试

// Request
{
    "cmd": "ping"
    "body": {}
}
{
    "url":"https://api.bibox.com/v2/mdata",
    "form":{
        "cmds":"[{\"body\":{},\"cmd\":\"ping\"}]",
    }
}

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

查询交易对

// Request
{
    "cmd": "api/pairList",
    "body": {}
}
{
    "url":"https://api.bibox.com/v2/mdata",
    "form":{
        "cmds":"[{\"cmd\":\"api/pairList\",\"body\":{}}]",
    }
}

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

查询k线

参数名称 是否必须 类型 描述 默认值 取值范围
pair true string 交易对 BIX_BTC, ETH_BTC, ...
period true string k线周期 '1min', '3min', '5min', '15min', '30min', '1hour', '2hour', '4hour', '6hour', '12hour', 'day', 'week'
size false integer 数量 1000 1-1000
  • 示例
// Request
{
    "cmd": "api/kline",
    "body": {
        "pair": "BIX_BTC",
        "period": "1min",
        "size": 10
    }
}
{
    "url":"https://api.bibox.com/v2/mdata",
    "form":{
        "cmds":"[{\"cmd\":\"api/kline\",\"body\":{\"pair\":\"BIX_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"
}

查询全币种市场行情

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

{
    "url":"https://api.bibox.com/v2/mdata",
    "form":{
        "cmds":"[{\"cmd\":\"api/marketAll\",\"body\":{}}]",
    }
}

// Response
{
    "result":[
        {
            "id":4,
            "coin_symbol":"BIX",            //交易币种
            "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"
        },
        {
            "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 交易对 BIX_BTC, ETH_BTC, ...
  • 示例
// Request
{
    "cmd": "api/market",
    "body": {
        "pair": "BIX_BTC"
    }
}
{
    "url":"https://api.bibox.com/v2/mdata",
    "form":{
        "cmds":"[{\"cmd\":\"api/market\",\"body\":{\"pair\":\"BIX_BTC\"}}]",
    }
}

// Response
{
    "result":[
        {
            "id":4,
            "coin_symbol":"BIX",            //交易币种
            "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"
}

查询市场深度

参数名称 是否必须 类型 描述 默认值 取值范围
pair true string 交易对 BIX_BTC, ETH_BTC, ...
size false integer 数量 200 1-200
  • 示例
// Request
{
    "cmd": "api/depth",
    "body": {
        "pair": "BIX_BTC"
    }
}
{
    "url":"https://api.bibox.com/v2/mdata",
    "form":{
        "cmds":"[{\"cmd\":\"api/depth\",\"body\":{\"pair\":\"BIX_BTC\"}}]",
    }
}

// Response
{
    "result":{
        "pair":"BIX_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 交易对 BIX_BTC, ETH_BTC, ...
size false integer 数量 200 1-200
  • 示例
// Request
{
    "cmd": "api/deals",
    "body": {
        "pair": "LTC_BTC"
    }
}
{
    "url":"https://api.bibox.com/v2/mdata",
    "form":{
        "cmds":"[{\"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 交易对 BIX_BTC, ETH_BTC, ...
  • 示例
// Request
{
    "cmd": "api/ticker",
    "body": {
        "pair": "BIX_BTC"
    }
}
{
    "url":"https://api.bibox.com/v2/mdata",
    "form":{
        "cmds":"[{\"cmd\":\"api/ticker\",\"body\":{\"pair\":\"BIX_BTC\"}}]",
    }
}

// Response
{
    "result":{
        "pair":"BIX_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.00000001",     //普通交易对最小下单价格限制0.00000001
            "USDT":"0.0001",            //USDT交易区最下下单价格限制0.0001，超过0.0001的小数部分会自动舍弃，适用于所有以USDT计价的交易对
            "DAI":"0.0001"              //DAI交易区最小下单价格限制0.0001，超过0.0001的小数部分会自动舍弃，适用于所有以DAI计价的交易对
        },
        "min_trade_amount":{            //最小下单数量
            "default":"0.0001"          //最小下单数量限制0.0001，超过0.0001的小数部分会自动舍弃，适用于所有交易对
        },
        "min_trade_money":{             //最小下单金额 (money = price * amount)
            "USDT":"1",                 //USDT交易区最小下单金额限制为1
            "DAI":"1",                  //DAI交易区最小下单金额限制为1，以此类推
            "GUSD":"1",
            "BIX":"3",
            "BTC":"0.0002",
            "ETH":"0.005"
        }
    },
    "cmd":"tradeLimit"
}

用户资产信息(需要apikey)

币币账户资产

参数名称 是否必须 类型 描述 默认值 取值范围
select false integer 是否查询资产明细 不传-各币种总资产合计，1-请求所有币种资产明细
  • 示例
// Request
{
    "cmd": "transfer/assets",
    "body": {
        "select": 1
    }
}
{
    "url":"https://api.bibox.com/v1/transfer",
    "form":{
        "cmds":"[{\"cmd\":\"transfer/assets\",\"body\":{\"select\":1}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"86e88a4bc8eedc795b453f121f5894ee"
    }
}

// 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":"BIX",
                "balance":"712.79411732",
                "freeze":"0.00000000",
                "BTCValue":"1100.35043000",     //btc估值
                "CNYValue":"59448654.69",       //cny估值
                "USDValue":"8945419.86",        //usd估值
            }
        ]
    },
    "cmd":"transfer/assets"
}

充值

参数名称 是否必须 类型 描述 默认值 取值范围
coin_symbol true string 充值币种 BIX, BTC, ...
  • 示例
// Request
{
    "cmd": "transfer/transferIn",
    "body":{
        "coin_symbol":"BIX"
    }
}
{
    "url":"https://api.bibox.com/v1/transfer",
    "form":{
        "cmds":"[{\"cmd\":\"transfer/transferIn\",\"body\":{\"coin_symbol\":\"BIX\"}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"05068bce6cf2eb7619440d99be86abde"
    }
}

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

提现

参数名称 是否必须 类型 描述 默认值 取值范围
coin_symbol true string 提现币种 BIX, BTC, ...
amount true double 提现数量 需大于各币种最小提现数量
totp_code false integer google验证码 新地址需要,旧地址不需要
trade_pwd false string 资金密码 新地址需要,旧地址不需要
addr true string 提现地址 币种合法地址
addr_remark true string 提现地址备注名称
memo false string 提现标签 一些币种提现必须指定标签，与地址组合标识唯一性，比如EOS
  • 示例
// Request
{
    "cmd": "transfer/transferOut",
    "body":{
        "coin_symbol":"BIX",
        "amount":1,
        "totp_code":703634,
        "trade_pwd":"12345678",
        "addr":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "addr_remark":"bibox-1",
        "memo":"",
    }
}
{
    "url":"https://api.bibox.com/v1/transfer",
    "form":{
        "cmds":"[{\"cmd\":\"transfer/transferOut\",\"body\":{\"coin_symbol\":\"BIX\",\"amount\":1,\"totp_code\":703634,\"trade_pwd\":\"12345678\",\"addr\":\"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\",\"addr_remark\":\"bibox-1\",\"memo\":\"\"}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"8260d0e280d2b2a78ff29bb92acf5e6b"
    }
}

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

查询充值记录

参数名称 是否必须 类型 描述 默认值 取值范围
filter_type false integer 充值记录筛选 0 0-全部，1-充值进行中，2-充值到账，3-充值失败
coin_symbol false string 充值币种 BIX, ETH, ...
page true integer 第几页 从1开始
size true integer 每页数量 1-50
  • 示例
// Request
{
    "cmd": "transfer/transferInList",
    "body": {
        "filter_type": 0,
        "page": 1,
        "size": 10,
    }
}
{
    "url":"https://api.bibox.com/v1/transfer",
    "form":{
        "cmds":"[{\"cmd\":\"transfer/transferInList\",\"body\":{\"filter_type\":0,\"page\":1,\"size\":10}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"7c515dc6b6ccb803115ce8653ef6eed3"
    }
}

// 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":"BIX",
                "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",
                "amount":"1.00000000",
                "confirmCount":"15",
                "createdAt":1540622460000,
                "status":2
            }
        ]
    },
    "cmd":"transfer/transferInList"
}

查询提现记录

参数名称 是否必须 类型 描述 默认值 取值范围
filter_type false integer 提现记录筛选 -2：审核不通过；-1: 用户撤销；0:待审核; 1:审核通过（待发币）; 2: 发币中； 3：发币完成
coin_symbol false string 提现币种 BIX, ETH, ...
page true integer 第几页 从1开始
size true integer 每页数量 1-50
  • 示例
// Request
{
    "cmd": "transfer/transferOutList",
    "body": {
        "page": 1,
        "size": 10,
    }
}
{
    "url":"https://api.bibox.com/v1/transfer",
    "form":{
        "cmds":"[{\"cmd\":\"transfer/transferOutList\",\"body\":{\"page\":1,\"size\":10}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"0702af0bab89897ffe0d486c265f2b21"
    }
}

// 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":"BIX",
                "to_address":"xxxxxxxxxxxxxxxxxxxxxxxxxx",
                "amount":"1.00000000",
                "fee":"0.00000000",
                "createdAt":1540622460000,
                "memo":"",
                "status":3
            }
        ]
    },
    "cmd":"transfer/transferOutList"
}

获取币种配置

参数名称 是否必须 类型 描述 默认值 取值范围
coin_symbol false string 币种 BIX, ETH...
  • 示例
// Request
{
    "cmd": "transfer/coinConfig",
    "body": {

    }
}
{
    "url":"https://api.bibox.com/v1/transfer",
    "form":{
        "cmds":"[{\"cmd\":\"transfer/coinConfig\",\"body\":{}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"41babcc84fd5301117f4fcf66cd70b6f"
    }
}

// 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":"BIX",
            "original_decimals":18,
            "enable_deposit":0,
            "enable_withdraw":0,
            "withdraw_fee":2,
            "withdraw_min":10
        },
        ... //其他币种配置信息
    ],
    "cmd":"transfer/coinConfig"
}

查询某一条提现记录

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

示例

// Request
{
    "cmd": "transfer/withdrawInfo",
    "body": {
        "id": 228
    }
}
{
    "url":"https://api.bibox.com/v1/transfer",
    "form":{
        "cmds":"[{\"cmd\":\"transfer/withdrawInfo\",\"body\":{\"id\":228}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"e5a1067e1f2aee028989552c23425099"
    }
}

// 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)

下单

参数名称 是否必须 类型 描述 默认值 取值范围
pair true string 交易对 BIX_BTC, ETH_BTC, ...
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
client_oid false long to string 用户自定义id '110011223344'
  • 示例
// Request
{
    "cmd": "orderpending/trade",
    "index": 12345,                  //随机数，批量时唯一标识某个cmd
    "body": {
        "pair": "BIX_BTC",           //交易对, BIX_BTC, BIX_ETH, ...
        "account_type": 0,           //账户类型，0-币币账户
        "order_type": 2,             //交易类型，2-限价单
        "order_side": 1,             //交易方向，1-买，2-卖
        "price": 0.00032,            //委托价格
        "amount": 1000               //委托数量
        "client_oid": '110011223344'               //用户自定义id
    }
}
{
    "url":"https://api.bibox.com/v1/orderpending",
    "form":{
        "cmds":"[{\"cmd\":\"orderpending/trade\",\"index\":12345,\"body\":{\"pair\":\"BIX_BTC\",\"account_type\":0,\"order_type\":2,\"order_side\":1,\"price\":0.00032,\"amount\":1000}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"2d775fdc61a2aaf63e9f40441c2040a8"
    }
}

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

撤单

参数名称 是否必须 类型 描述 默认值 取值范围
orders_id true string 委托单id
  • 示例
// Request
{
    "cmd": "orderpending/cancelTrade",
    "index": 12345,                  //随机数，批量时唯一标识某个cmd
    "body": {
        "orders_id": "8588285380268971"               //委托单id
    }
}
{
    "url":"https://api.bibox.com/v1/orderpending",
    "form":{
        "cmds":"[{\"cmd\":\"orderpending/cancelTrade\",\"index\":12345,\"body\":{\"orders_id\":\"8588285380268971\"}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"bf3882a208ada6ebc86a8cf8e3b5ea5a"
    }
}

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

当前委托

参数名称 是否必须 类型 描述 默认值 取值范围
pair false string 交易对 BIX_BTC, ETH_BTC, ...
account_type true integer 账户类型 0-币币账户
order_side false integer 交易方向 1-买，2-卖
coin_symbol false string 交易币种 BIX, EOS, ...
currency_symbol false string 定价币种 BTC, USDT, ...
page true integer 第几页 从1开始
size true integer 每页数量 1-50
  • 示例
// Request
{
     "cmd": "orderpending/orderPendingList",
     "body": {
         "account_type": 0,
         "order_side": 2,
         "page": 1,
         "size": 10,
         "coin_symbol": "LTC",
         "currency_symbol": "BTC"
     }
 }
 {
     "url":"https://api.bibox.com/v1/orderpending",
     "form":{
         "cmds":"[{\"cmd\":\"orderpending/orderPendingList\",\"body\":{\"account_type\":0,\"order_side\":2,\"page\":1,\"size\":10,\"coin_symbol\":\"LTC\",\"currency_symbol\":\"BTC\"}}]",
         "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
         "sign":"15e0c711e4ad94b30245782147c9307f"
     }
 }

// 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"
}

历史委托

参数名称 是否必须 类型 描述 默认值 取值范围
pair false string 交易对 BIX_BTC, ETH_BTC, ...
account_type true integer 账户类型 0-币币账户
order_side false integer 交易方向 1-买，2-卖
coin_symbol false string 交易币种 BIX, EOS, ...
currency_symbol false string 定价币种 BTC, USDT, ...
hide_cancel false integer 隐藏已撤销订单 0-不隐藏，1-隐藏
page true integer 第几页 从1开始
size true integer 每页数量 1-50
  • 示例
// Request
{
    "cmd": "orderpending/pendingHistoryList",
    "body": {
        "account_type": 0,
        "order_side": 2,
        "page": 1,
        "size": 10,
        "coin_symbol": "LTC",
        "currency_symbol": "BTC"
    }
}
{
    "url":"https://api.bibox.com/v1/orderpending",
    "form":{
        "cmds":"[{\"cmd\":\"orderpending/pendingHistoryList\",\"body\":{\"account_type\":0,\"order_side\":2,\"page\":1,\"size\":10,\"coin_symbol\":\"LTC\",\"currency_symbol\":\"BTC\"}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"4e80fd525dbdebb74a60847308b50e37"
    }
}

// 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"
}

成交记录

参数名称 是否必须 类型 描述 默认值 取值范围
id true string 委托单id
account_type true integer 账户类型 0-币币账户
  • 示例
// Request
{
    "cmd": "orderpending/orderDetail",
    "body": {
        "id": "11221615825364891"
    }
}
{
    "url":"https://api.bibox.com/v1/orderpending",
    "form":{
        "cmds":"[{\"cmd\":\"orderpending/orderDetail\",\"body\":{\"id\":\"11221615825364891\"}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"3eead4ae66c0767be2d87ac4105f0dee"
    }
}

// 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_bix":0,                  //bix抵扣 0 未开启 1 开启
                "fee_symbol":"ETH",           //手续费币种
                "relay_id":"11221615825364891", //关联订单id
            }
        ]
    },
    "cmd":"orderpending/orderDetail"
}

委托单详情

参数名称 是否必须 类型 描述 默认值 取值范围
id true string 委托单id
account_type true integer 账户类型 0-币币账户
  • 示例
// Request
{
    "cmd": "orderpending/order",
    "body": {
        "id": "100055558128036"
    }
}
{
    "url":"https://api.bibox.com/v1/orderpending",
    "form":{
        "cmds":"[{\"cmd\":\"orderpending/order\",\"body\":{\"id\":\"100055558128036\"}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"970983d6d8ddf9c0db5181d4ce7b744b"
    }
}

// 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"
}

成交明细

参数名称 是否必须 类型 描述 默认值 取值范围
pair false string 交易对 BIX_BTC, ETH_BTC, ...
account_type true integer 账户类型 0-币币账户
order_side false integer 交易方向 1-买，2-卖
coin_symbol false string 交易币种 BIX, EOS, ...
currency_symbol false string 定价币种 BTC, USDT, ...
page true integer 第几页 从1开始
size true integer 每页数量 1-50
  • 示例
// Request
{
    "cmd": "orderpending/orderHistoryList",
    "body": {
        "account_type": 0,
        "order_side": 2,
        "page": 1,
        "size": 10,
        "coin_symbol": "LTC",
        "currency_symbol": "BTC"
    }
}
{
    "url":"https://api.bibox.com/v1/orderpending",
    "form":{
        "cmds":"[{\"cmd\":\"orderpending/orderHistoryList\",\"body\":{\"account_type\":0,\"order_side\":2,\"page\":1,\"size\":10,\"coin_symbol\":\"LTC\",\"currency_symbol\":\"BTC\"}}]",
        "apikey":"1e01c22ff8c59e9d98d93423817303f0e7c6d79d",
        "sign":"443c8f691f9072c5c0bd3258f4ce89a1"
    }
}

// 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"
}

最新成交明细

参数名称 是否必须 类型 描述 默认值 取值范围
pair false string 交易对 BIX_BTC, ETH_BTC, ...
account_type true integer 账户类型 0-币币账户
id true string 成交记录开始的id号 大于"1000000000"
page true integer 第几页 从1开始
  • 示例
// Request
{
    "cmd": "orderpending/orderDetailsLast",
    "body": {
        "account_type": 0,
        "id": "1000000000",
        "page": 1,
        "pair": "LTC_BTC",
    }
}
{
    "url":"https://api.bibox.com/v1/orderpending",
    "form":{
       "cmds":"[{\"cmd\":\"orderpending/orderDetailsLast\",\"body\":{\"account_type\":0,\"id\":\"1000000000\",\"page\":1,\"pair\":\"LTC_BTC\"}}]",
       "apikey":"*****",
       "sign":"*****"
   }
}


// Response
{
    "result":[
        {
            "result":{
                "count":4,
                "page":1,
                "items":[
                    {
                        "id":"2251799818808964061",
                        "createdAt":1587004749000,
                        "account_type":0,
                        "coin_symbol":"LTC",
                        "currency_symbol":"BTC",
                        "order_side":1,
                        "order_type":2,
                        "price":"0.00587833",
                        "amount":"0.8497",
                        "money":"0.00499481",
                        "pay_bix":1,
                        "fee_symbol":"BIX",
                        "fee":"-0.26381928",
                        "is_maker":1,
                        "relay_id":"12557522307843276"
                    },
                    {
                        "id":"2251799818808964511",
                        "createdAt":1587004752000,
                        "account_type":0,
                        "coin_symbol":"LTC",
                        "currency_symbol":"BTC",
                        "order_side":1,
                        "order_type":2,
                        "price":"0.00587833",
                        "amount":"0.6864",
                        "money":"0.00403488",
                        "pay_bix":1,
                        "fee_symbol":"BIX",
                        "fee":"-0.21311705",
                        "is_maker":1,
                        "relay_id":"12557522307843276"
                    }
                ]
            },
            "cmd":"orderpending/orderDetailsLast"
        }
    ]
}
Copyright © bibox.com 2019 all right reserved，powered by GitbookUpdate Date: 2021-01-20

results matching ""

    No results matching ""