ERC-1155 NFTs
Query ERC-1155 Owners
ERC-1155 NFTs
Query ERC-1155 Owners
GET
/
api
/
v1
/
erc1155
/
owners
Authorization
string
*
Bearer
Authorization
Required
string
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
chainId
number
*
chainId
Required
number
The id of the chain supporting the NFT. This cannot be changed after creation.
contractAddress
string
*
contractAddress
Required
string
The NFT smart contract address.
ownerAddress
string
ownerAddress
string
An NFT owner to filter on.
page
number
page
number
Page index to fetch, page size is
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.
ownerAddress
string
Address of an owner (lower-cased).
totalBalance
string
Token balance across all tokens in this NFT collection.
tokens
object[]
Array of NFT balance objects.
tokenId
string
Token id of the NFT.
balance
string
The balance of tokens of tokenId
owned by ownerAddress
.
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"
}
]
}
]
}