Get user NFT transfer history

流量控制: 5 每 秒

摘要

HTTP 方法

GET

访问路径

/api/v3/user/nft/transfers

功能

Returns a list of NFT trade records for the given user.

API 描述

HTTP头

字段 类型 必须 说明 举例
X-API-KEY string 是 ApiKey "HlkcGxbqBeaF76j4rvPaOasyfPwnkQ
6B6DQ6THZWbvrAGxzEdulXQvOKLrRW
ZLnN"

请求参数

字段 类型 必须 说明 举例
accountId integer 是 users accountId. 10001
nftData string 否 the nftData of the NFT token "0xf7c9323511
86c3a9053f31
3eefa16209c0
18f7f1dba8aa
8ca7100400f7
c31085"
start integer 否 Start time in milliseconds 1567053142
end integer 否 End time in milliseconds 1567053142
startId integer 否 The begin id of the query. 1234
limit integer 否 Number of records to return 50
txStatus string 否 The transfer status
取值范围 : ['processing', 'processed', 'failed', 'received']		 "processing"
hashes string 否 The hashes (split by ,) of the transactions, normally its L2 tx hash, except the deposit which uses L1 tx hash. "0xf7c9323511
86c3a9053f31
3eefa16209c0
18f7f1dba8aa
8ca7100400f7
c31085"

请求示例

HTTP
CURL
GET https://api3.loopring.io/api/v3/user/nft/transfers?accountId=10001&nftData=0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085&start=1567053142&end=1567053142&startId=1234&limit=50&txStatus=processing&hashes=0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085 HTTP/1.1
Host: api3.loopring.io
Connection: keep-alive
Accept: */*
Accept-Encoding: gzip, deflate, br
Accept-Language: zh,en;q=0.9
X-API-KEY: sra1aavfa
curl -H "X-API-KEY:sra1aavfa" https://api3.loopring.io/api/v3/user/nft/transfers\?accountId\=10001\&nftData\=0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085\&start\=1567053142\&end\=1567053142\&startId\=1234\&limit\=50\&txStatus\=processing\&hashes\=0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085

响应字段

字段 类型 必须 说明 举例
totalNum integer 是 field.totalNum.description 100
transfers List[Nft
Transfer
Data]		 是 field.GetUserNftTransfersResponse.NftTransferDataList /

响应示例

{
  "totalNum" : 100,
  "transfers" : [
    {
      "id" : "",
      "requestId" : integer,
      "hash" : "",
      "txHash" : "",
      "accountId" : integer,
      "owner" : "",
      "status" : "",
      "nftData" : "",
      "amount" : "",
      "feeTokenSymbol" : "",
      "feeAmount" : "",
      "createdAt" : integer,
      "updatedAt" : integer,
      "memo" : "",
      "payeeId" : integer,
      "payeeAddress" : "",
      "blockIdInfo" : {
        "blockId" : integer,
        "indexInBlock" : integer
      },
      "storageInfo" : {
        "accountId" : integer,
        "tokenId" : integer,
        "storageId" : integer
      }
    }
  ]
}

状态码

状态码 描述
100000 Unknown error
104001 Empty ApiKey
104002 Invalid ApiKey
104003 Invalid Account ID

模型

NftTransferData

model.NftTransferData.description

字段 类型 必须 说明 举例
id string 是 field.NftTransferData.id /
requestId integer 是 field.NftTransferData.requestId /
hash string 是 field.NftTransferData.hash /
txHash string 是 field.NftTransferData.txHash /
accountId integer 是 field.NftTransferData.accountId /
owner string 是 field.NftTransferData.owner /
status string 是 field.NftTransferData.status /
nftData string 是 field.NftTransferData.nftData /
amount string 是 field.NftTransferData.amount /
feeTokenSymbol string 是 field.NftTransferData.feeTokenSymbol /
feeAmount string 是 field.NftTransferData.feeAmount /
createdAt integer 是 field.NftTransferData.createdAt /
updatedAt integer 是 field.NftTransferData.updatedAt /
memo string 是 field.NftTransferData.memo /
payeeId integer 是 field.NftTransferData.payeeId /
payeeAddress string 是 field.NftTransferData.payeeAddress /
blockIdInfo BlockId
Info		 否 /
storageInfo Storage
Info		 否 /

BlockIdInfo

字段 类型 必须 说明 举例
blockId integer 是 /
indexInBlock integer 是 /

StorageInfo

字段 类型 必须 说明 举例
accountId integer 是 /
tokenId integer 是 /
storageId integer 是 /

results matching ""

    No results matching ""