账号金额更新
订阅此主题以接收有关用户余额更新的通知。
订阅规则
- 主题名称:
account
- 订阅该主题是否需要提供ApiKey:是
参数列表
该主题支持一个可选的v3标记,用于表示是否订阅v3格式,即包含NFT信息的消息。
| Parameter |
Required |
Note |
| accountId |
N |
apiKey绑定了account,因此不必传 |
| v3 |
N |
是否订阅v3格式,默认为否,即兼容之前的订阅格式 |
推送示例
{
"topic": {
"topic:": "account"
},
"ts":1584717910000,
"data": {
"accountId":1,
"totalAmount": "24439253519655",
"tokenId": 2,
"amountLocked": "0"
}
}
模型
推送消息数据结构
如果是v3消息
| 字段 |
类型 |
必现 |
说明 |
| topic |
JSON |
是 |
主题和参数 |
| ts |
integer |
是 |
推送时间(毫秒) |
| data |
BalanceV3 |
是 |
余额信息(包含NFT信息) |
否则和之前一样
| 字段 |
类型 |
必现 |
说明 |
| topic |
JSON |
是 |
主题和参数 |
| ts |
integer |
是 |
推送时间(毫秒) |
| data |
Balance |
是 |
余额信息 |
BalanceV3
| Field |
Type |
Required |
Note |
| accountId |
integer |
Y |
Account ID |
| tokenId |
integer |
Y |
Token ID |
| total |
string |
Y |
Total token balance |
| locked |
string |
Y |
Token balance locked by orders |
| nftId |
string |
N |
NFT ID if it's NFT token |
| nftData |
string |
N |
NFT hash data if it's NFT token |
| tokenAddress |
string |
N |
Nft token address if it's NFT token |
Balance数据结构
| 字段 |
类型 |
必现 |
说明 |
| accountId |
integer |
是 |
账户ID |
| tokenId |
integer |
是 |
通证ID |
| totalAmount |
string |
是 |
用户余额 |
| amountLocked |
string |
是 |
冻结的余额 |