ERC-1155 NFTs
Query ERC-1155 NFTs
GET
/
api
/
v1
/
erc1155
/
tokens
Authorization
Query
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
chainId
number
requiredThe id of the chain supporting the NFT. This cannot be changed after creation.
contractAddress
string
requiredThe NFT smart contract address.
tokenIds
string[]
A list of NFT token IDs to filter on.
page
number
Page index to fetch, page size is 50
.
Response
success
boolean
Indicates whether the call was successful.
tokens
object[]
Array of NFT objects.
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"
}
]
}
}
]
}