私有消息推送
私有消息推送包含订单和账务变更,先发送消息登陆再订阅私有推送。
订阅地址
| 环境 | 地址 |
|---|---|
| PROD | wss://stream.bittap.com/endpoint?format=JSON |
订阅参数
Stream 名称: s_private
数据更新
| 参数名 | 类型 | 描述 |
|---|
订阅示例
{
"id":"id",
"method": "LOGIN",
"params":
[
"3se60fJU9oJ3nCRnDHFiiFK2G1sxm3EqKZDYV5aKrUKa4smXaGxwbUS0Hm3Vhudo", // apiKey
"1762509526408", // 时间戳 不能晚于服务器时间5分钟 也不能早于服务器时间1分钟
"0270e250ffce18e605f95737d69c14a6f38909a7d727ae3f13ca374b94ec9a60" // 使用api_secret 对时间戳加密后的signature
]
}
{
"method": "SUBSCRIBE",
"params": [
"s_private"
]
}订阅成功示例
{
"code": 0, // 0代表成功 非0代表失败
"msg":"", // 失败原因 成功时值为null
"topic": ["", ""], // 订阅失败的topic
"id": 1
}数据更新示例
账务变更响应示例
{
"E": 1762226153952, // 事件时间
"T": 1762226153952, // 创建时间
"a": "USDT", //币种
"c": "BALANCE_UPDATE", // 事件类型
"d": "-0.00000000000923464", // 余额变量
"e": "s_private", // topic
"f": "846365.30981895727648403853272", // 可用余额 f = 上一个f + d(可为负)
"l": "100529.8", // 冻结余额
"v": 3224 // 版本号, 版本号作用于同一个币种
}普通订单变更响应示例
{
"e": "s_private", // topic
"c":"ORDER_UPDATE", // 事件类型
"E": 1499405658658, // 事件时间
"s": "ETH-BTC", // 交易对
"C": "mUvoqJxFIILMdfAW5iGSOW", // clientOrderId
"S": "BUY", // 订单方向
"o": "LIMIT", // 订单类型
"f": "GTC", // 有效方式
"q": "1.00000000", // 订单总数量
"Q": "1.1.00000000", // 订单总金额
"p": "0.10264410", // 订单原始价格
"X": "NEW", // 订单的当前状态
"r": "NONE", // 订单被撤销的原因
"i": 4293153, // orderId
"z": "0.00000000", // 订单累计已成交数量
"n": "0", // 手续费数量
"N": "ETH", // 手续费币种
"w": true, // 订单是否在订单簿上
"O": 1499405658657, // 订单创建时间
"Z": "0.00000000", // 订单累计已成交金额
"V": "NONE", // SelfTradePreventionMode
"po": true, // post only
"a": "1.00000000", //撤单数量
"A": "1.00000000", // 撤单金额
"se": 123243 //sequence
}取消订阅示例
{
"id":"id",
"method": "LOGIN",
"params":
[
"3se60fJU9oJ3nCRnDHFiiFK2G1sxm3EqKZDYV5aKrUKa4smXaGxwbUS0Hm3Vhudo", // apiKey
"1762509526408", // 时间戳 不能晚于服务器时间5分钟 也不能早于服务器时间1分钟
"0270e250ffce18e605f95737d69c14a6f38909a7d727ae3f13ca374b94ec9a60" // 使用api_secret 对时间戳加密后的signature
]
}
{
"method": "UNSUBSCRIBE",
"params": [
"s_private"
]
}错误码解释
| 错误码 | 描述 |
|---|
代码示例
最后更新于: