1. 交易实盘

接入要求

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

接入样式

左图：实盘接入后，会在首页展示平台藏品列表以及平台的成交数据

右图：藏品详情页会展示当前藏品的成交数据

响应字段

参数	类型	描述
data	Array<Result>	业务数据，响应成功时，返回所有的藏品数据，必填

响应成功后，返回数据中data列表需要包含以下参数：

参数	类型	描述
name	String	藏品名称，必填注意：当 name 重复时，仅取最低价作为实际价格
image	String	藏品图片，必填注意：图⽚需要可使⽤提供的地址访问，且必须为 https，否则可能会造成图⽚显示异常
price	Float	当前藏品最低挂单价格(单位为元)，必填，若藏品已退市，此处返回限价
lastTxPrice	Float	当前藏品最近成交价(单位为元)，若已提供成交记录，可不返回此字段，优先展示最近一条成交记录的价格
circulateCount	Integer	当前藏品流通数量
lockedCount	Integer	藏品锁单量
releaseCount	Integer	藏品发行量
releaseTime	Long	藏品发行时间，毫秒时间戳
releasePrice	Float	藏品发行价格
creatorName	String	藏品创作者名称（和藏品创作者头像需要同时存在）
creatorAvatar	String	藏品创作者头像图片（和藏品创作者名称需要同时存在）
collectionName	String	当前藏品归属的合集名称，其他接口中用到的albumName为藏品名称，collectionName为多个不同藏品归属的合集的名称
txCount5m	Integer	当前藏品在请求时间之前5分钟内的交易量，必填例如16:00请求，即为15:55到16:00的交易量
txAmount5m	Float	当前藏品在请求时间之前5分钟内的交易额 (单位为元)，必填例如16:00请求，即为15:55到16:00的交易额
txCount1h	Integer	当前藏品在请求时间之前1小时内的交易量，必填例如16:00请求，即为15:00到16:00的交易量
txAmount1h	Float	当前藏品在请求时间之前1小时内的交易额 (单位为元)，必填例如16:00请求，即为15:00到16:00的交易额
txCount24h	Integer	当前藏品在请求时间之前24小时内的交易量，必填例如16:00请求，即为前一天16:00到今日16:00的交易量
txAmount24h	Float	当前藏品在请求时间之前24小时内的交易额 (单位为元)，必填例如16:00请求，即为前一天16:00到今日16:00的交易额
txCountToday	Integer	当前藏品从当日0点到请求时间内的交易量，必填例如16:00请求，即为当日00:00到当日16:00的交易量
txAmountToday	Float	当前藏品从当日0点到请求时间内的交易额 (单位为元)，必填例如16:00请求，即为当日00:00到当日16:00的交易额
computeTime	Long	最后计算时间

响应示例

请使用以下示例给出的结构返回

JSON

{
  "data": [
    {
      "image": "https://yourdemain.com/collection_test1",
      "name": "藏品示例1",
      "circulateCount": 5555,
      "lockedCount": 100,
      "releaseCount": 10000,
      "price": 99.00,
      "lastTxPrice": 95.00,
      "creatorName": "创作者名称",
      "creatorAvatar": "https://yourdemain.com/creatorAvatar1",
      "collectionName": "水浒传系列",
      "txCount5m": 10,
      "txAmount5m": 20.01,
      "txCount1h": 12,
      "txAmount1h": 32.79,
      "txCount24h": 44,
      "txAmount24h": 122.30,
      "txCountToday": 41,
      "txAmountToday": 96.27,
      "releaseTime": 1672502400000,
      "releasePrice": 100.00,
      "computeTime": 1672502400000
    },
    {
      "image": "https://yourdemain.com/collection_test2",
      "name": "藏品示例2",
      "circulateCount": 5555,
      "lockedCount": 100,
      "releaseCount": 10000,
      "price": 99.00,
      "lastTxPrice": 95.00,
      "creatorName": "创作者名称",
      "creatorAvatar": "https://yourdemain.com/creatorAvatar1",
      "collectionName": "西游记系列",
      "txCount5m": 10,
      "txAmount5m": 20.01,
      "txCount1h": 12,
      "txAmount1h": 32.79,
      "txCount24h": 44,
      "txAmount24h": 122.30,
      "txCountToday": 41,
      "txAmountToday": 96.27,
      "releaseTime": 1672502400000,
      "releasePrice": 100.00,
      "computeTime": 1672502400000
    }
  ]
}

以下为响应成功后各参数在APP中的展示位置

查看旧版文档 >

1. 交易实盘 #

接入样式 #

响应字段 #

响应示例 #

1. 交易实盘

接入样式

响应字段

响应示例