私有消息推送
私有消息推送包含订单和账务变更，先发送消息登陆再订阅私有推送。
订阅地址
| 环境 | 地址 |
|---|---|
| PROD | wss://stream.bittap.com/endpoint?format=JSON |
订阅参数
Stream 名称: f_private
数据更新
| 参数名 | 类型 | 描述 |
|---|
订阅示例
{
"id":"id",
"method": "LOGIN",
"params":
[
"3se60fJU9oJ3nCRnDHFiiFK2G1sxm3EqKZDYV5aKrUKa4smXaGxwbUS0Hm3Vhudo", // apiKey
"1762509526408", // 时间戳 不能晚于服务器时间5分钟 也不能早于服务器时间1分钟
"0270e250ffce18e605f95737d69c14a6f38909a7d727ae3f13ca374b94ec9a60" // 使用api_secret 对时间戳加密后的signature
]
}
{
"method": "SUBSCRIBE",
"params": [
"f_private"
]
}订阅成功示例
{
"code": 0, // 0代表成功 非0代表失败
"msg":"", // 失败原因 成功时值为null
"topic": ["", ""], // 订阅失败的topic
"id": 1
}数据更新示例
账务变更响应示例 事件类型：ACCOUNT_UPDATE
{
"e": "f_private", // topic
"c": "ACCOUNT_UPDATE", // 事件类型
"E": 1564745798939, // 事件时间
"a": { // 账户更新事件
"B": [ // 余额信息
{
"a": "USDT", // 资产名称币种
"wb": "122624.12345678", // 钱包总余额 balance
"aq": "122624.12345678", // 账户总权益 = 钱包总余额 + 全仓未实现盈亏
"bc": "50.12345678", // 可划转 = balance - locked - lockedCrossUnrealizedPnL
"aw":"80.12345678", // 可用 = 可划转 + 全仓未实现盈亏
"tcp":"4321.12345678", // 全部全仓总的未实现盈亏
"tip":"5321.12345678", // 全部逐仓总的未实现盈亏
"cmm":"8000.12345678", // 总的全仓维持保证金
"cmmr":"0.80000", // 总的全仓维持保证金率
"tf":"0.80000", // 总的体验金金额
"aseq":"1" // 版本号
}
]
}
}普通订单变更响应示例 事件类型：ORDER_UPDATE
{
"e": "f_private",
"c": "ORDER_UPDATE",
"E": 1735286923983, //事件推送时间
"A": "10284.76142857142857144", //撤单金额
"O": 1734856922479, //下单时间
"P": 251396096, //position id
"Q": "19284.76142857142857144", //下单金额，quote币种的数量，比如USDT数量
"S": "SELL", //买卖方向，BUY,SELL
"X": "CANCELED", //订单状态 OPEN,FILLED,CANCELED
"a": "0.1", //撤单数量 base币种的数量，比如BTC的数量
"ap": "90000", //订单成交平均价格
"o": "MARKET", //订单类型，LIMIT，MARKET
"f": "GTC", //time inforce, GTC, IOC,FOK
"i": "78429693349888", //订单ID
"l": 20, //杠杆倍数
"m": "CROSSED", //保证金模式，CROSSED-全仓，ISOLATION-逐仓
"N": "USDT", //交易手续费币种
"n": "2.25", //交易手续费
"p": "91602.6168", //价格
"pm": "HEDGE", //持仓模式：HEDGE-双向持仓，ONE_WAY-单向持仓
"pnl": "0", //已实现盈亏
"po": false, //post only, true/false
"q": "0.2000", //下单数量，base币种的数量
"r": "NO_MAKER", //撤单原因
"ro": false, // reduce only, true/false
"s": "BTC-USDT-M", //symbol id
"se": 2, //订单版本号，如果最新版本号大于当前版本号，就替换，小于等于就丢掉该推送消息
"Z": "9000", //成交金额，quote币种金额，比如： usdt的金额
"z": "0.1" , //成交数量，base币种数量，比如： BTC的数量
"rl": "765", //订单剩余冻结
"tt": "1", // 止盈类型
"tp": "1", // 止盈触发价格
"tep": "1", // 止盈执行价格
"st": "1", // 止损类型
"sp": "1", // 止损触发价格
"sep": "1" // 止损执行价格
}计划委托变更响应示例 事件类型：STOP_ORDER
{
"O": 1751096610257, // 订单时间
"P": "2418200649890055606", // 仓位id
"X": "CANCELED", // 状态
"c": "STOP_ORDER", // 类型
"cb": "0", // 回调比例
"codi": "LTE", // 触发条件
"e": "f_private",
"ep": "0", // 执行价格
"l": "20", // 杠杆
"m": "ISOLATED", // 保证金模式
"o": "64742480704180224", // 订单id
"opt": "DEFAULT", // 订单计划类型
"ot": "PLAN_LIMIT", // 订单类型 普通止盈止损、仓位止盈止损 PLAN_MARKET
"pt": "MARK", // 价格类型
"q": "1", // 订单数量
"se": 2, // 版本号
"si": "SELL", // 方向
"sy": "BTC-USDT-M", // 币对
"tp": "105000", // 触发价格
"f": "GTC", //time inforce, GTC, IOC,FOK
"po": false, //post only, true/false
"tt": "1", // 止盈类型
"tpp": "1", // 止盈触发价格
"tep": "1", // 止盈执行价格
"st": "1", // 止损类型
"sp": "1", // 止损触发价格
"sep": "1" // 止损执行价格
}仓位变更响应示例 事件类型：POSTION_UPDATE
{
"e": "f_private", // topic
"c": "POSTION_UPDATE", // 事件类型
"t": "1", // 事件周期ID
"E": 1564745798939, // 事件时间
"T": 1564745798938, // 撮合时间
"a": {
"P":
{
"id": "0", // 仓位id
"s": "BTCUSDT", // 交易对
"qty": "100.00000", // 持仓数量
"ep": "35000.00000", // 入仓价格
"aep": "34500.00000", // 持仓均价
"ev": "3450000.00000", // 仓位价值
"bep": "34800.00000", // 盈亏平衡价
"up": "-50000.00000", // 持仓未实现盈亏
"mt": "ISOLATED", // 保证金模式 ISOLATED/CROSSED
"mg": "10000.00000", // 仓位实际保证金
"im": "8000.00000", // 初始保证金
"pmm": "5000.00000", // 全仓仓位维持保证金
"ps": "SELL", // 持仓方向 BUG/SELL
"rp": "1000.00000", // 已实现盈亏
"pnl": "950.00000", // 平仓盈亏
"lp": "32000.00000", // 强平价格
"lv": "3200000.00000", // 强平价值
"bp": "31000.00000", // 破产价格
"bv": "3100000.00000", // 破产价值
"mp": "34800.00000", // 标记价格
"mv": "3480000.00000", // 仓位标记价值
"mm": "4000.00000", // 维持保证金
"mr": "0.85", // 保证金比率
"pm": "ONE_WAY", // 持仓模式 ONE_WAY/HEDGE
"m": "10", // 杠杆倍数
"adl": "5", // ADL排序
"pseq": "1", // 版本号
"omm":"5002.00000", // 其他仓位维持保证金
"ocf":"500.12345", // 其他合约预计平仓手续费
"pst":"COMPLETED", // 仓位状态 OPEN/COMPLETED
"upr":"0.5" // 未实现盈亏率
"bf":"0.2", // 破产手续费
"fr":"0.0001", // 资金费用
"ct":"1736995070115", // 仓位创建时间
"mt":"1736995070115", // 仓位更新时间
"ff": 12 // 冻结手续费
}
}
}用户设置变更响应示例 事件类型：SETTING_UPDATE
{
"e": "f_private",
"c": "SETTING_UPDATE",
"E": 1735286371528, //事件推送时间
"l": 50, //杠杆倍数
"m": "CROSSED", //保证金模式
"p": "HEDGE", //持仓模式
"s": "ETH-USDT-M", //合约交易对Id
"t": 1735286371491 //最新修改时间
}取消订阅示例
{
"id":"id",
"method": "LOGIN",
"params":
[
"3se60fJU9oJ3nCRnDHFiiFK2G1sxm3EqKZDYV5aKrUKa4smXaGxwbUS0Hm3Vhudo", // apiKey
"1762509526408", // 时间戳 不能晚于服务器时间5分钟 也不能早于服务器时间1分钟
"0270e250ffce18e605f95737d69c14a6f38909a7d727ae3f13ca374b94ec9a60" // 使用api_secret 对时间戳加密后的signature
]
}
{
"method": "UNSUBSCRIBE",
"params": [
"f_private"
]
}错误码解释
| 错误码 | 描述 |
|---|
代码示例
最后更新于: