Get user NFT deposit history
Rate limit: 5 every second
API Overview
HTTP method
GET
Path
/api/v3/user/nft/deposits
Summary
Returns a list of NFT deposit 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 deposit 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/deposits?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: sra1aavfacurl -H "X-API-KEY:sra1aavfa" https://api3.loopring.io/api/v3/user/nft/deposits\?accountId\=10001\&nftData\=0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085\&start\=1567053142\&end\=1567053142\&startId\=1234\&limit\=50\&txStatus\=processing\&hashes\=0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085Response fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| totalNum | integer | Y | field.totalNum.description | 100 |
| deposits | List[Nft Deposit Data] |
Y | field.GetUserNftDepositResponse.NftDepositData | / |
Response example
{
"totalNum" : 100,
"deposits" : [
{
"id" : 1,
"requestId" : 1,
"hash" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085",
"txHash" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085",
"accountId" : 10001,
"owner" : "",
"status" : "",
"nftData" : "",
"amount" : "10000000000000",
"feeTokenSymbol" : "",
"feeAmount" : "1000000000000",
"createdAt" : 1627629262706,
"updatedAt" : 1627629262706,
"memo" : "",
"depositFrom" : "",
"depositFromAccountId" : 10001,
"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
NftDepositData
model.NftDepositData.description
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| id | integer | Y | field.NftDepositData.id | 1 |
| requestId | integer | Y | field.NftDepositData.requestId | 1 |
| hash | string | Y | field.NftDepositData.hash | "0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085" |
| txHash | string | Y | field.NftDepositData.txHash | "0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085" |
| accountId | integer | Y | field.NftDepositData.accountId | 10001 |
| owner | string | Y | field.NftDepositData.owner | / |
| status | string | Y | field.NftDepositData.status | / |
| nftData | string | Y | field.NftDepositData.nftData | / |
| amount | string | Y | field.NftDepositData.amount | "100000000000 00" |
| feeTokenSymbol | string | Y | field.NftDepositData.feeTokenSymbol | / |
| feeAmount | string | Y | field.NftDepositData.feeAmount | "100000000000 0" |
| createdAt | integer | Y | field.NftDepositData.createdAt | 1627629262706 |
| updatedAt | integer | Y | field.NftDepositData.updatedAt | 1627629262706 |
| memo | string | N | field.NftDepositData.memo | / |
| depositFrom | string | Y | field.NftDepositData.depositFrom | / |
| depositFromAccountId | integer | Y | field.NftDepositData.depositFromAccountId | 10001 |
| 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 | / |