-
Notifications
You must be signed in to change notification settings - Fork 0
REST_API_Reference
重要:完整的请求格式请参考API请求、返回格式说明,以下描述API接口时只列出部分。
目录
请求参数
| 参数名称 | 是否必须 | 类型 | 描述 | 默认值 | 取值范围 |
|---|
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"
}
- GET https://api.bibox.cc/v1/api?cmd=kline&pair=ETH_BTC&period=1min&size=10
- POST https://api.bibox.cc/v1/api
请求参数
| 参数名称 | 是否必须 | 类型 | 描述 | 默认值 | 取值范围 |
|---|---|---|---|---|---|
| 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"
}
请求参数
| 参数名称 | 是否必须 | 类型 | 描述 | 默认值 | 取值范围 |
|---|---|---|---|---|---|
| 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"
}
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"
}
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,便于投资者查看行情、快速交易。