GET
/
api
/
v1
/
erc721
/
tokens
Authorization
Query
Body
curl --location 'https://groupos.xyz/api/v1/erc721/tokens' \
--request GET \
-d 'chainId=1' \
-d 'contractAddress=0x67F4732266C7300cca593C814d46bee72e40659F' \
-d 'ownerAddress=0xc517c83f417b73dA98647dad0FCB80af9f3b9531' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>'

{
  "success": true,
  "tokens": [
    {
      "tokenId": "69",
      "ownerAddress": "0xc517c83f417b73da98647dad0fcb80af9f3b9531",
      "metadata": {
        "name": "...",
        "description": "...",
        "image": "https://...",
        "external_url": "https://...",
        "attributes": [
            {
                "trait_type": "Points",
                "value": 100
            },
            {
                "trait_type": "Guild",
                "value": "..."
            },
            ...
        ]
      }
    },
    {
      "tokenId": "420",
      "ownerAddress": "0xc517c83f417b73da98647dad0fcb80af9f3b9531",
      "metadata": {
        "name": "...",
        "description": "...",
        "image": "https://...",
        "attributes": []
      }
    }
  ]
}

​
Query Params

chainId
number
required

The id of the chain supporting the NFT. This cannot be changed after creation.

contractAddress
string
required

The NFT smart contract address.

tokenIds
string[]

A list of NFT token IDs to filter on.

ownerAddress
string

An NFT owner to filter on.

discordId
number

A Discord user 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.

Query OwnersCreate NFTs