GET
/
api
/
v1
/
nft
/
metadata
curl --location --request GET 'https://groupos.xyz/api/v1/nft/metadata' \
--header 'Content-Type: application/json' \
{
  "success": true,
  "name": "Zed Horse",
  "description": "...",
  "image": "https://...",
  "attributes": [
      {
          "trait_type": "Points",
          "value": 100
      },
      {
          "trait_type": "Guild",
          "value": "Racers"
      },
      ...
  ]
}

How NFT metadata querying works

The combination of an NFT collection’s default metadata and overriden token-specific metadata are combined together when fetching the metadata of a specific token. This API route follows the informal specification standardized by Opensea which is compatible with most marketplaces, indexers, and wallets.

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.

tokenId
string
required

An NFT tokenId within the collection.

Response

success
boolean

Indicates whether the call was successful.

name
string

Name of the token.

description
string

Description of the token.

image
string

URL of the hosted image asset.

attributes
object[]

Array of Attribute objects.