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中的展示位置
![img](https://oss.dingblock.site/upload/66917d799057d15761fedc22c6095c9189b4046e7266574bd6d7ade7fb6a434f1696154392373.png)