Query ERC-1155 NFTs
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.
A list of NFT token IDs to filter on.
Page index to fetch, page size is
curl --location 'https://groupos.xyz/api/v1/erc1155/tokens' \
--request GET \
-d 'chainId=1' \
-d 'contractAddress=0x67F4732266C7300cca593C814d46bee72e40659F' \
-d 'ownerAddress=0xc517c83f417b73dA98647dad0FCB80af9f3b9531' \
-d 'tokenIds=[69, 420]' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"tokens": [
{
"tokenId": "69",
"metadata": {
"name": "...",
"description": "...",
"image": "https://...",
"attributes": [
{
"trait_type": "Hat",
"value": "Backwards cap"
}
]
}
},
{
"tokenId": "420",
"metadata": {
"name": "...",
"description": "...",
"image": "https://...",
"attributes": [
{
"trait_type": "Eyes",
"value": "Bloodshot"
}
]
}
}
]
}
Query Params
The id of the chain supporting the NFT. This cannot be changed after creation.
The NFT smart contract address.
A list of NFT token IDs to filter on.
Page index to fetch, page size is 50
.
Response
Indicates whether the call was successful.
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/erc1155/tokens' \
--request GET \
-d 'chainId=1' \
-d 'contractAddress=0x67F4732266C7300cca593C814d46bee72e40659F' \
-d 'ownerAddress=0xc517c83f417b73dA98647dad0FCB80af9f3b9531' \
-d 'tokenIds=[69, 420]' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"tokens": [
{
"tokenId": "69",
"metadata": {
"name": "...",
"description": "...",
"image": "https://...",
"attributes": [
{
"trait_type": "Hat",
"value": "Backwards cap"
}
]
}
},
{
"tokenId": "420",
"metadata": {
"name": "...",
"description": "...",
"image": "https://...",
"attributes": [
{
"trait_type": "Eyes",
"value": "Bloodshot"
}
]
}
}
]
}