Get user NFT withdraw history
流量控制: 5 每 秒
摘要
HTTP 方法
GET
访问路径
/api/v3/user/nft/withdrawals
功能
Returns a list of NFT withdraw 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 withdrawal 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/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\=0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085响应字段
| 字段 | 类型 | 必须 | 说明 | 举例 |
|---|---|---|---|---|
| totalNum | integer | 是 | field.totalNum.description | 100 |
| withdrawals | List[Nft Withdrawal Data] |
是 | field.GetUserNftWithdrawalResponse.NftWithdrawalDataList | / |
响应示例
{
"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
}
}
]
}
状态码
| 状态码 | 描述 |
|---|---|
| 100000 | Unknown error |
| 104001 | Empty ApiKey |
| 104002 | Invalid ApiKey |
| 104003 | Invalid Account ID |
模型
NftWithdrawalData
model.NftWithdrawalData.description
| 字段 | 类型 | 必须 | 说明 | 举例 |
|---|---|---|---|---|
| id | integer | 是 | field.NftWithdrawalData.id | / |
| requestId | integer | 是 | field.NftWithdrawalData.requestId | / |
| hash | string | 是 | field.NftWithdrawalData.hash | "0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085" |
| txHash | string | 是 | field.NftWithdrawalData.txHash | "0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085" |
| accountId | integer | 是 | field.NftWithdrawalData.accountId | 10000 |
| owner | string | 是 | field.NftWithdrawalData.owner | / |
| status | string | 是 | field.NftWithdrawalData.status | / |
| nftData | string | 否 | field.NftWithdrawalData.nftData | / |
| amount | string | 否 | field.NftWithdrawalData.amount | "100000000000" |
| feeTokenSymbol | string | 否 | field.NftWithdrawalData.feeTokenSymbol | / |
| feeAmount | string | 是 | field.NftWithdrawalData.feeAmount | "100000000000 0" |
| createdAt | integer | 是 | field.NftWithdrawalData.createdAt | 1627629262706 |
| updatedAt | integer | 是 | field.NftWithdrawalData.updatedAt | 1627629262706 |
| memo | string | 否 | field.NftWithdrawalData.memo | / |
| recipient | string | 是 | field.NftWithdrawalData.recipient | / |
| distributeHash | string | 是 | field.NftWithdrawalData.distributeHash | "0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085" |
| fastWithdrawStatus | string | 是 | field.NftWithdrawalData.fastWithdrawStatus | / |
| isFast | boolean | 是 | field.NftWithdrawalData.isFast | "false" |
| blockIdInfo | BlockId Info |
否 | / | |
| storageInfo | Storage Info |
否 | / |
BlockIdInfo
| 字段 | 类型 | 必须 | 说明 | 举例 |
|---|---|---|---|---|
| blockId | integer | 是 | / | |
| indexInBlock | integer | 是 | / |
StorageInfo
| 字段 | 类型 | 必须 | 说明 | 举例 |
|---|---|---|---|---|
| accountId | integer | 是 | / | |
| tokenId | integer | 是 | / | |
| storageId | integer | 是 | / |