NFT Metadata
Query an NFT's Metadata
GET
/
api
/
v1
/
nft
/
metadata
Authorization
Query
Body
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
requiredThe id of the chain supporting the NFT. This cannot be changed after creation.
contractAddress
string
requiredThe NFT smart contract address.
tokenId
string
requiredAn 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.
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"
},
...
]
}