获取用户订单

请求格式说明

GET ifmarket/getOrders

请求示例

https://api.bbx.com/v1/ifmarket/getOrders?stockCode=EOS/USDT&status=2&offset=1&size=2

请求Headers

详情见签名方式

请求参数

参数名 参数类型 是否必填 描述
stockCode string 现货对
status int 请求什么状态的订单 1:申报中的订单 2:委托和申报中的订单 3:已经完成的订单 默认值:所有状态的订单
offset int offset
size int size 可以不传 请求数量,如果size不传或size为0,系统最多返回60条

返回格式说明

参数名 参数类型 描述
order_id int 订单ID
account_id int 用户ID
stock_code string 现货代码
price string 报价
vol string 订单总量
done_vol string 成交量
swap_vol string 成交额
way int 订单方向 1:买 2:卖
category int 订单类型 1:限价单
fee string 交易手续费
fee_ratio string 交易手续费率
fee_coin_code string 交易手续费币
done_fee string 成交量产生的手续费
created_at string 创建时间(UTC时间)
finished_at string 完成时间(UTC时间)
status int 1 申报中 2 委托中,表示订单已经进撮合队列,订单信息中的done_vol表示订单成交部分,只要done_vol不为0就表示订单有成交 3 完成
errno int 0 没有错误,表示订单量全部交易完成 1 订单被用户取消 2 超时(预留) 3 用户资产错误 4 部分完成转撤销

返回示例

{
    "errno": "OK",
    "message": "Success",
    "data": {
        "orders": [
            {
                "order_id": 10284160,
                "account_id":23249999,
                "stock_code": "EOS/ETH",
                "price": "8",
                "vol": "4",
                "done_vol": "0",
                "swap_vol": "0",
                "way": 1,
                "category": 1,
                "fee": "0",
                "fee_ratio": "0",
                "fee_coin_code": "0",
                "done_fee": "", 
                "created_at": "2018-07-17T07:24:13.410507Z",
                "finished_at": null,
                "status": 2,
                "errno": 0
            }
        ]
    }
}

备注

获取用户的交易记录

请求格式说明

GET ifmarket/getUserTrades

请求示例

https://api.bbx.com/v1/ifmarket/getUserTrades?stockCode=ETH/USDT&offset=0&size=60

请求Headers

详情见签名方式

请求参数

参数名 参数类型 是否必填 描述
stockCode string 现货对 ETH/USDT
offset int offset 偏移量
size int size 请求数量,如果size不传或size为0,系统最多返回60条

返回格式说明

参数名 参数类型 描述
order_id int 主导该交易完成的订单id
trade_id int 交易id
stock_code string 现货代码
deal_price string 成交价格
deal_vol string 成交量
fee string 手续费
fee_coin_code string 手续费代币码
created_at string 创建时间(UTC时间)
way int 用户自己的订单主导该交易完成的订单方向1:买,2:卖
fluctuation string 对现货价格的影响,涨跌额度

返回示例

{
    "errno":"OK",
    "message":"Success",
    "data":{
        // 交易记录列表,按创建时间由近及远排序
        "trades":[
            {
                "order_id":100039430677,
                "trade_id":100039430678,
                "stock_code":"BBX/ETH",
                "deal_price":"0.06",
                "deal_vol":"21",
                "fee":"0.0000000126",
                "fee_coin_code":"ETH",
                "created_at":"2018-04-19T03:27:21.62635069Z",
                "way":2,
                "fluctuation":"0"
            }
        ]
    }
}

获取用户订单的交易记录

请求格式说明

GET ifmarket/getOrderTrades

请求示例

https://api.bbx.com/v1/ifmarket/getOrderTrades?stockCode=ETH/USDT&orderId=1000121232

请求Headers

详情见签名方式

请求参数

参数名 参数类型 是否必填 描述
stockCode string ETH/USDT 币对
orderId int 订单id

返回格式说明

参数名 参数类型 描述
order_id int 主导该交易完成的订单id
trade_id int 交易id
stock_code string 现货代码
deal_price string 成交价格
deal_vol string 成交量
fee string 手续费
fee_coin_code string 手续费代币码
created_at string 创建时间(UTC时间)
way int 用户自己的订单主导该交易完成的订单方向1:买,2:卖
fluctuation string 对现货价格的影响,涨跌额度

返回示例

{
    "errno":"OK",
    "message":"Success",
    "data":{
        // 交易记录列表,按创建时间由近及远排序
        "trades":[
            {
                "order_id":100039430677,
                "trade_id":100039430678,
                "stock_code":"BBX/ETH",
                "deal_price":"0.06",
                "deal_vol":"21",
                "fee":"0.0000000126",
                "fee_coin_code":"ETH",
                "created_at":"2018-04-19T03:27:21.62635069Z",
                "way":2,
                "fluctuation":"0"
            }
        ]
    }
}

提交订单

请求格式说明

POST ifmarket/submitOrder

请求示例

https://api.bbx.com/v1/ifmarket/submitOrder

请求Headers

详情见签名方式

POST请求格式

参数名 参数类型 是否必填 描述
stock_code string 现货币值对
price string 订单价格,必须满足现货对配置里的价格精度要求
vol string 订单量,必须满足现货对配置里的量精度要求
way int 订单方向,1:为买,2:为卖
category int 订单类型,1:限价单,2:为市价单,市价单时价格必须为字符串的"0"
nonce int 提交订单是的时间戳,单位是秒

POST请求示例

{
   "stock_code":"EOS/ETH",  
   "price":"0.01",
   "vol":"10.2",
   "way":2,
   "category":1,
   "nonce":1545820222
}

返回格式说明

参数名 参数类型 描述
order_id int 生成的订单ID

返回示例

成功: 
{ 
    "errno": "OK", 
    "message": "Success",
    "data": { "order_id": 10540013 }
}

失败: 
{
 "errno": "failed",
 "message": "失败原因" 
}

备注

取消订单

请求格式说明

POST ifmarket/cancelOrder

请求示例

https://api.bbx.com/v1/ifmarket/cancelOrder

请求Headers

详情见签名方式

POST请求格式

参数名 参数类型 是否必填 描述
order_id int 订单ID
stock_code string 现货币值对
nonce int 时间戳

POST请求示例

{
    "order_id":14369318,
    "stock_code":"EOS/ETH",
    "nonce":1545735606
}

返回格式说明

参数名 参数类型 描述
errno string 错误码
message string 错误原因

返回示例


  成功
  { 
      "errno": "OK",
      "message": "Success"
  }

  失败
  {
      "errno": "FAILED",
      "message": "失败原因"
  }

备注

批量提交订单

请求格式说明

POST ifmarket/batchOrders

请求示例

https://api.bbx.com/v1/ifmarket/batchOrders

请求Headers

详情见签名方式

POST请求格式

参数名 参数类型 是否必填 描述
stock_code string 现货币值对,在一次批量订单里所有的订单的stock_code必须是一致的
price string 订单价格,必须满足现货对配置里的价格精度要求
vol string 订单量,必须满足现货对配置里的量精度要求
way int 订单方向,1:为买,2:为卖
category int 订单类型,1:限价单,2:为市价单,市价单时价格必须为字符串的"0"
custom_id int 客户自定义ID
nonce int 提交订单是的时间戳,单位是秒

POST请求示例

{
    "orders":[
        {
           "stock_code":"EOS/ETH",
           "category":1,
           "custom_id":1,
           "way":1,
           "price":998,
           "vol":10
        }
    ],
   "nonce":1533876299 // 时间戳
}

返回格式说明

参数名 参数类型 描述
custom_id int 客户ID
order_id int 订单ID
errno string 错误码
message string 错误原因

返回示例

成功:
{
    "errno": "OK",
    "message": "Success",
    "data": {
        "orders": [
            {
                "custom_id": 1,
                "order_id": 10540013
            },
            {
                "custom_id": 2,
                "order_id": 10540014
            }
        ]
    }
}
部分成功:
{
    "errno": "OK",
    "message": "Success",
    "data": {
        "orders": [
            {
                "custom_id": 1,
                "err": {
                    "http_err":405,
                    "err_code":"code",
                    "err_msg":"失败原因"
                }
            },
            {
                "custom_id": 2,
                "order_id": 10540014
            }
        ]
    }
}
失败:
{
    "errno": "FAILED",
    "message": "失败原因"
}

备注

批量取消订单

请求格式说明

POST ifmarket/cancelOrders

请求示例

https://api.bbx.com/v1/ifmarket/cancelOrders

请求Headers

详情见签名方式

POST请求格式

参数名 参数类型 是否必填 描述
stock_code string 现货币值对
orders array 订单列表

POST请求示例

{
    "orders":[
        {
           "stock_code":"EOS/ETH",
           "orders":[
                   10116356,
                   10116357
            ]
        }
     ],
    "nonce":1531968125
}

返回格式说明

参数名 参数类型 描述
errno string 错误码
message string 错误原因

返回示例

{
    "errno": "OK",
    "message": "Success",
    "data": {
        // 取消成功的列表
        "succeed": [ 
            10116356,
            10116357
        ],
        // 取消失败的列表
        "failed": null
    }
}

备注

获取用户资产

请求格式说明

GET ifaccount/users/me

请求示例

https://api.bbx.com/v1/ifaccount/users/me

请求Headers

详情见签名方式

GET请求格式

返回格式说明

参数名 参数类型 描述
account_id int 用户ID
email string 用户邮箱
phone string 手机号码
account_type int 账户类型
status int 账号状态
asset_password_effective_time string 资金密码有效时间
ga_key string google验证码是否绑定
kyc_type string kyc 认证类型
kyc_status string kyc 认证状态
coin_code string coin_code
freeze_vol string 冻结量
available_vol string 可用量
created_at string 创建时间
updated_at string 更新时间

返回示例

{
    "errno": "OK",
    "message": "Success",
    "data": {
        "account_id": 100039428965,                 // 用户ID
        "email": "",                                // 用户邮箱
        "phone":"",                                 // 手机号码
        "account_type": 1,                          // 账号类型
        "status": 2,                                // 账号状态
        "asset_password_effective_time": -2,        // 资金密码有效时间
        "ga_key": "unbound",                        // google验证码是否绑定
        "kyc_type": 0,                              // kyc 认证类型
        "kyc_status": 1,                            // kyc 认证状态
        "user_assets":[
            {
                "coin_code":"",
                "freeze_vol":"",
                "available_vol":""
            }
        ]
        "created_at": "2018-04-08T04:04:25.26468Z",
        "updated_at": "2018-04-23T03:25:16.408297Z"
    }
}

查询订单详情

请求格式说明

POST ifmarket/queryOrder

请求示例

https://api.bbx.com/v1/ifmarket/queryOrder

请求Headers

详情见签名方式

POST请求格式

参数名 参数类型 是否必填 描述
orders array 订单列表
stock_code string XDAG/ETH

POST请求示例

{
    "stock_code":"ETH/USDT", // 币对
    "orders":[
        10000234234,  // 订单id
        10000343434    // 订单id
    ]
}

返回格式说明

参数名 参数类型 描述
order_id int order_id
account_id int 用户id
stock_code string XDAG/ETH
price string 订单申报价
vol int 申报量
done_vol int 成交量
swap_vol string 交易额量
way int 订单方向,1:买,2:卖
category int 订单类型,1:限价,2:市价
fee string 订单手续费冻结量
fee_ratio string 订单手续费比例
fee_coin_code string 订单手续费code
done_fee string 订单成交产生手续费
created_at string 创建时间
finished_at string 完成时间
status int 状态
errno int 错误码

返回示例

{
    "errno":"OK",
    "message":"Success",
    "data":{
        "orders":[
            {
                "order_id":2192079529,
                "stock_code":"XDAG/ETH",
                "price":"1.1",  // 订单申报价
                "vol":"1",      // 申报量  
                "done_vol":"1", // 成交量
                "swap_vol":"1.1",  // 交易额量
                "way":1,  // 订单方向,1:买,2:卖
                "category":1,  // 订单类型,1:限价,2:市价
                "fee":"0.0011", // 订单手续费冻结量
                "fee_ratio":"0.001", // 订单手续费比例
                "fee_coin_code":"ETH", // 订单手续费code
                "done_fee":"0.0011",  // 订单成交产生手续费
                "account_id":2000628412, // 用户id
                "created_at":"2019-02-28T10:28:14.01776Z",
                "finished_at":"2019-02-28T10:28:14.040836Z",
                "status":3, // 状态
                "errno":0 
            }
        ]
    }
}

results matching ""

    No results matching ""