拉取数字资产历史登记记录
接口描述
- 本接口用于拉取资产登记历史记录。包括资产创造、碎片授予、碎片转移的全部操作纪录,按时间倒序排序
- shard_id是可选参数,用户查询指定藏品、指定碎片的历史记录。
请求结构
POST /xasset/horae/v1/history HTTP/1.1
Host: xuper.baidu.com
Authorization: Authorization string
Content-Type: application/x-www-form-urlencoded;charset=utf-8
asset_id={asset_id}
&page={page}
&limit={limit}
&shard_id={shard_id}
请求头域
请求参数
参数名 |
参数类型 |
是否可选 |
参数说明 |
asset_id |
int64 |
可选 |
要查询的资产id |
page |
int |
必选 |
要拉取页数,第一页为1 |
limit |
int |
可选 |
默认20,最大50 |
shard_id |
int64 |
可选 |
指定的话查询指定藏品、指定碎片的历史记录 |
响应头域
响应参数
参数名 |
参数类型 |
参数说明 |
list |
array |
资产登记历史记录 |
total_cnt |
int |
总条目数 |
请求示例
Post xasset/horae/v1/history
Host: xuper.baidu.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2022-04-18T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
asset_id=123123123
&page=1
&limit=20
响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 18 Apr 2022 03:28:11 GMT
X-Trace-Id: "1182282645"
{
"errmsg": "succ",
"errno": 0,
"request_id": "916556533358021977",
"total_cnt": 10,
"list": [
{
"asset_id": 123,
"type": 1,
"shard_id": 123,
"price": 1000,
"tx_id": "abcd1cadfa",
"from": "TeyyPLpp9L7QAcxHangtcHTusHUZ6iydN", ""
"to": "Tadfasdfp9L7QAcxHangtcHTusHUZ6iydN",
"ctime": 12312312
}
]
}