ERC-1155 NFTs
Query ERC-1155 Owners
ERC-1155 NFTs
Query ERC-1155 Owners
GET
/
api
/
v1
/
erc1155
/
owners
Authorization
Query
curl --location 'https://groupos.xyz/api/v1/erc1155/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": "12",
"tokens": [
{
"tokenId": "1",
"balance": "10"
},
{
"tokenId": "2",
"balance": "1"
},
{
"tokenId": "3",
"balance": "1"
}
]
}
]
}
Query Params
chainId
number
requiredThe id of the chain supporting the NFT. This cannot be changed after creation.
contractAddress
string
requiredThe NFT smart contract address.
ownerAddress
string
An NFT owner to filter on.
page
number
Page index to fetch, page size is 50.
Response
success
boolean
Indicates whether the call was successful.
owners
object[]
Array of owner objects.
curl --location 'https://groupos.xyz/api/v1/erc1155/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": "12",
"tokens": [
{
"tokenId": "1",
"balance": "10"
},
{
"tokenId": "2",
"balance": "1"
},
{
"tokenId": "3",
"balance": "1"
}
]
}
]
}