盯链开放平台On this page
2. 交易记录
接入要求
1、交易记录支持 GET 请求方式，不支持分页
2、接⼝可使⽤ curl 访问
3、图⽚需要可使⽤提供的地址访问，且必须为 https，否则可能会造成图⽚显示异常
4、若您的地址有防⽕墙，请将以下IP加入白名单中：
101.132.77.44 101.132.122.106 101.132.122.49
106.15.91.193 139.196.124.185 120.55.190.164
47.100.240.73 47.100.1.155 47.100.54.9 47.101.31.59
139.224.235.230
接入样式
交易记录接入后，用于计算交易量和交易额，也可用于向用户脱敏展示
请求字段
我们将使用如下字段对您发起请求，获取start和end之间的交易记录
例如：https://yourdomain?start=678413573000&end=1678417173000
| 参数 | 类型 | 描述 |
|---|---|---|
| start | Long | 获取此时间之后的交易记录，值为毫秒时间戳，必填，例如：1678413573000 |
| end | Long | 获取此时间之后的交易记录，值为毫秒时间戳，必填，例如：1678417173000 |
响应字段
| 参数 | 类型 | 描述 |
|---|---|---|
| data | Array<Result> | 业务数据，响应成功时，返回请求的时间范围内所有的交易数据 |
响应成功后，返回数据中data列表需要包含以下参数：
| 参数 | 类型 | 描述 |
|---|---|---|
| txId | String | 交易唯一标识，必填 |
| albumName | String | 交易的藏品名称，必填 |
| albumImage | String | 交易的藏品的图片，必填 |
| itemNo | String | 交易的藏品的编号，必填 |
| buyerId | String | 买家ID |
| buyerName | String | 买家昵称 |
| buyerWallet | String | 买家钱包地址 |
| sellerId | String | 卖家ID |
| sellerName | String | 卖家昵称 |
| sellerWallet | String | 卖家钱包地址 |
| date | Long | 交易日期，必填（需要为毫秒时间戳，例如：1678413573000） |
| count | Integer | 交易数量，默认为 1，必填 |
| totalAmount | Integer | 交易金额（单位为分），必填 |
响应示例
请使用以下示例给出的结构返回
JSON
{
"data":[
{
"txId": "0x1111111111111",
"albumName": "龙",
"albumImage": "http://img.com",
"itemNo": "100",
"buyerId": "1001",
"buyerName": "哇卡",
"buyerWallet": "0x1111111111111",
"sellerId": "2002",
"sellerName": "拉卡",
"sellerWallet": "0x22222222222222",
"date": 1673945817000,
"count": 2,
"totalAmount": 200
},
{
"txId": "0x1111111111112",
"albumName": "兔",
"albumImage": "http://img.com",
"itemNo": "99",
"buyerId": "1001",
"buyerName": "哇卡",
"buyerWallet": "0x1111111111111",
"sellerId": "2002",
"sellerName": "拉卡",
"sellerWallet": "0x22222222222222",
"date": 1673945817000,
"count": 2,
"totalAmount": 200
}
]
}
以下为响应成功后各参数在APP中的展示位置
