Get user NFT transfer history

Rate limit: every seconds

API Overview


HTTP method

GET

Path

/api/v3/user/nft/transfers

Summary

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

API description


HTTP Header

Field Type Required Description Example
X-API-KEY string Y ApiKey "HlkcGxbqBeaF76j4rvPaOasyfPwnkQ
6B6DQ6THZWbvrAGxzEdulXQvOKLrRW
ZLnN"

Request parameters

Field Type Required Description Example
accountId integer Y users accountId. 10001
nftData string N the nftData of the NFT token "0xf7c9323511
86c3a9053f31
3eefa16209c0
18f7f1dba8aa
8ca7100400f7
c31085"
start integer N Start time in milliseconds 1567053142
end integer N End time in milliseconds 1567053142
startId integer N The begin id of the query. 1234
limit integer N Number of records to return 50
txStatus string N The transfer status
Allowable : ['processing', 'processed', 'failed', 'received']
"processing"
hashes string N 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"

Request example

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

Response fields

Field Type Required Description Example
totalNum integer Y field.totalNum.description 100
transfers List[Nft
Transfer
Data
]
Y field.GetUserNftTransfersResponse.NftTransferDataList /

Response example

{
  "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
      }
    }
  ]
}

Status code

Value Description
100000 Unknown error
104001 Empty ApiKey
104002 Invalid ApiKey
104003 Invalid Account ID

Model


NftTransferData

model.NftTransferData.description

Field Type Required Description Example
id string Y field.NftTransferData.id /
requestId integer Y field.NftTransferData.requestId /
hash string Y field.NftTransferData.hash /
txHash string Y field.NftTransferData.txHash /
accountId integer Y field.NftTransferData.accountId /
owner string Y field.NftTransferData.owner /
status string Y field.NftTransferData.status /
nftData string Y field.NftTransferData.nftData /
amount string Y field.NftTransferData.amount /
feeTokenSymbol string Y field.NftTransferData.feeTokenSymbol /
feeAmount string Y field.NftTransferData.feeAmount /
createdAt integer Y field.NftTransferData.createdAt /
updatedAt integer Y field.NftTransferData.updatedAt /
memo string Y field.NftTransferData.memo /
payeeId integer Y field.NftTransferData.payeeId /
payeeAddress string Y field.NftTransferData.payeeAddress /
blockIdInfo BlockId
Info
N /
storageInfo Storage
Info
N /

BlockIdInfo

Field Type Required Description Example
blockId integer Y /
indexInBlock integer Y /

StorageInfo

Field Type Required Description Example
accountId integer Y /
tokenId integer Y /
storageId integer Y /

results matching ""

    No results matching ""