Get user NFT withdraw history
Rate limit: 5 every second
API Overview
HTTP method
GET
Path
/api/v3/user/nft/withdrawals
Summary
Returns a list of NFT withdraw 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 withdrawal 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/withdrawals?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/withdrawals\?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 |
| withdrawals | List[Nft Withdrawal Data] |
Y | field.GetUserNftWithdrawalResponse.NftWithdrawalDataList | / |
Response example
{
"totalNum" : 100,
"withdrawals" : [
{
"id" : integer,
"requestId" : integer,
"hash" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085",
"txHash" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085",
"accountId" : 10000,
"owner" : "",
"status" : "",
"nftData" : "",
"amount" : "100000000000",
"feeTokenSymbol" : "",
"feeAmount" : "1000000000000",
"createdAt" : 1627629262706,
"updatedAt" : 1627629262706,
"memo" : "",
"recipient" : "",
"distributeHash" : "0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085",
"fastWithdrawStatus" : "",
"isFast" : false,
"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
NftWithdrawalData
model.NftWithdrawalData.description
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| id | integer | Y | field.NftWithdrawalData.id | / |
| requestId | integer | Y | field.NftWithdrawalData.requestId | / |
| hash | string | Y | field.NftWithdrawalData.hash | "0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085" |
| txHash | string | Y | field.NftWithdrawalData.txHash | "0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085" |
| accountId | integer | Y | field.NftWithdrawalData.accountId | 10000 |
| owner | string | Y | field.NftWithdrawalData.owner | / |
| status | string | Y | field.NftWithdrawalData.status | / |
| nftData | string | N | field.NftWithdrawalData.nftData | / |
| amount | string | N | field.NftWithdrawalData.amount | "100000000000" |
| feeTokenSymbol | string | N | field.NftWithdrawalData.feeTokenSymbol | / |
| feeAmount | string | Y | field.NftWithdrawalData.feeAmount | "100000000000 0" |
| createdAt | integer | Y | field.NftWithdrawalData.createdAt | 1627629262706 |
| updatedAt | integer | Y | field.NftWithdrawalData.updatedAt | 1627629262706 |
| memo | string | N | field.NftWithdrawalData.memo | / |
| recipient | string | Y | field.NftWithdrawalData.recipient | / |
| distributeHash | string | Y | field.NftWithdrawalData.distributeHash | "0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085" |
| fastWithdrawStatus | string | Y | field.NftWithdrawalData.fastWithdrawStatus | / |
| isFast | boolean | Y | field.NftWithdrawalData.isFast | "false" |
| 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 | / |