Query ERC-721 NFTs
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
The NFT smart contract address.
A list of NFT token IDs to filter on. Structure as comma-separated values with no brackets, e.g.
An NFT owner to filter on.
A Discord user to filter on.
Page index to fetch, page size is
The id of the chain supporting the NFT. This cannot be changed after creation.
curl --location 'https://groupos.xyz/api/v1/erc721/tokens' \
--request GET \
-d 'chainId=1' \
-d 'contractAddress=0x67F4732266C7300cca593C814d46bee72e40659F' \
-d 'tokenIds=69,420' \
-d 'ownerAddress=0xc517c83f417b73dA98647dad0FCB80af9f3b9531' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"tokens": [
{
"tokenId": "69",
"ownerAddress": "0xc517c83f417b73da98647dad0fcb80af9f3b9531",
"tbaAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"metadata": {
"name": "...",
"description": "...",
"image": "https://...",
"external_url": "https://...",
"attributes": [
{
"trait_type": "Points",
"value": 100
},
{
"trait_type": "Guild",
"value": "..."
},
...
]
}
},
{
"tokenId": "420",
"ownerAddress": "0xc517c83f417b73da98647dad0fcb80af9f3b9531",
"tbaAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"metadata": {
"name": "...",
"description": "...",
"image": "https://...",
"attributes": []
}
}
]
}
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. Structure as comma-separated values with
no brackets, e.g. '1,3,5'.
An NFT owner to filter on.
A Discord user 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.
Address of the current owner (lower-cased).
Address of the associated token-bound account (lower-cased).
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/tokens' \
--request GET \
-d 'chainId=1' \
-d 'contractAddress=0x67F4732266C7300cca593C814d46bee72e40659F' \
-d 'tokenIds=69,420' \
-d 'ownerAddress=0xc517c83f417b73dA98647dad0FCB80af9f3b9531' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'
{
"success": true,
"tokens": [
{
"tokenId": "69",
"ownerAddress": "0xc517c83f417b73da98647dad0fcb80af9f3b9531",
"tbaAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"metadata": {
"name": "...",
"description": "...",
"image": "https://...",
"external_url": "https://...",
"attributes": [
{
"trait_type": "Points",
"value": 100
},
{
"trait_type": "Guild",
"value": "..."
},
...
]
}
},
{
"tokenId": "420",
"ownerAddress": "0xc517c83f417b73da98647dad0fcb80af9f3b9531",
"tbaAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"metadata": {
"name": "...",
"description": "...",
"image": "https://...",
"attributes": []
}
}
]
}