Query ERC-721 Owners
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
The id of the chain supporting the NFT. This cannot be changed after creation.
The NFT smart contract address.
An NFT owner to filter on.
Page index to fetch, page size is
curl --location 'https://groupos.xyz/api/v1/erc721/owners' \
--request GET \
-d 'chainId=1' \
-d 'contractAddress=0x67F4732266C7300cca593C814d46bee72e40659F' \
-d 'ownerAddress=0xc517c83f417b73dA98647dad0FCB80af9f3b9531' \
-d 'tokenId=69' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"owners": [
{
"ownerAddress": "0xc517c83f417b73dA98647dad0FCB80af9f3b9531",
"totalBalance": "3",
"tokens": [
{
"tokenId": "2",
"metadata": {...}
},
{
"tokenId": "15",
"metadata": {...}
},
{
"tokenId": "48",
"metadata": {...}
}
]
}
]
}
Query Params
The id of the chain supporting the NFT. This cannot be changed after creation.
The NFT smart contract address.
An NFT owner to filter on.
Page index to fetch, page size is 50
.
Response
Indicates whether the call was successful.
Array of owner objects.
Address of an owner (lower-cased).
Token balance across all tokens in this NFT collection.
Array of NFT objects.
Token id of the NFT.
Metadata of the NFT.
Name of the token.
Description of the token.
Url of the hosted image asset.
Url for the external link associated with the NFT.
Array of Attribute objects.
Name for the trait.
Value for the trait.
Type of display to use.
curl --location 'https://groupos.xyz/api/v1/erc721/owners' \
--request GET \
-d 'chainId=1' \
-d 'contractAddress=0x67F4732266C7300cca593C814d46bee72e40659F' \
-d 'ownerAddress=0xc517c83f417b73dA98647dad0FCB80af9f3b9531' \
-d 'tokenId=69' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"owners": [
{
"ownerAddress": "0xc517c83f417b73dA98647dad0FCB80af9f3b9531",
"totalBalance": "3",
"tokens": [
{
"tokenId": "2",
"metadata": {...}
},
{
"tokenId": "15",
"metadata": {...}
},
{
"tokenId": "48",
"metadata": {...}
}
]
}
]
}