Query NFT holders by looprings nftData
Rate limit: every seconds
API Overview
HTTP method
GET
Path
/api/v3/nft/info/nftHolders
Summary
Query NFT holders by looprings nftData
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 |
|---|---|---|---|---|
| nftData | string | Y | The Loopring's NFT token data identifier which is a hash string of NFT token address and NFT_ID | "0xf7c9323511 86c3a9053f31 3eefa16209c0 18f7f1dba8aa 8ca7100400f7 c31085" |
| offset | integer | N | Number of records to skip | 0 |
| limit | integer | N | Number of records to return | 100 |
Request example
HTTP
CURL
GET https://api3.loopring.io/api/v3/nft/info/nftHolders?nftData=0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085&offset=0&limit=100 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/nft/info/nftHolders\?nftData\=0xf7c932351186c3a9053f313eefa16209c018f7f1dba8aa8ca7100400f7c31085\&offset\=0\&limit\=100Response fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| totalNum | integer | Y | field.totalNum.description | / |
| nftHolders | List[Nft Holder] |
Y | model.nftHolders.description | / |
Response example
{
"totalNum" : integer,
"nftHolders" : [
{
"accountId" : 12345,
"tokenId" : 0,
"amount" : "1"
}
]
}
Status code
| Value | Description |
|---|---|
| 100000 | Unknown error |
| 100001 | Invalid argument |
| 102001 | Exchange ID is incorrect |
| 102021 | Nonce is invalid |
| 102022 | Transfer sender is invalid |
| 102023 | Transfer receiver is invalid |
| 102024 | Fee token is unsupported |
| 102025 | Transfer token isnt consistent with fee token |
Model
NftHolder
model.NftHolder.description
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
| accountId | integer | Y | Sender accountId of the Tx | 12345 |
| tokenId | integer | Y | The Loopring's NFT token identifier. | 0 |
| amount | string | Y | The amount of the NFT token | "1" |