getNFTMetadata API

  • contract: Contract name, address, external domain and metadata
  • id: NFT ID and UUID
  • title: NFT Title
  • description: NFT description
  • media: Media url for the NFT
  • metadata: Metadata for the NFT

Here is an example request for querying the metadata for tokenId 1117 from contractAddress 0x8b148183c28ff88f, owned by 0x9eef2e4511390ce4.

curl https://flow-mainnet.g.alchemy.com/v2/<your-api-key>/getNFTMetadata/?owner=0x9eef2e4511390ce4&contractName=Gaia&contractAddress=0x8b148183c28ff88f&tokenId=1117

{
"contract":{
"name":"Gaia",
"address":"0x8b148183c28ff88f",
"externalDomain":"ballerz.xyz",
"contractMetadata":{
"storagePath":"Gaia.CollectionStoragePath",
"publicPath":"Gaia.CollectionPublicPath",
"publicCollectionName":"Gaia.CollectionPublic"
}
},
"id":{
"tokenId":"1117",
"tokenMetadata":{
"uuid":"74657965"
}
},
"title":"BALLER #1012",
"description":"A basketball-inspired generative NFT living on the Flow blockchain",
"externalDomainViewUrl":"/collection/ballerz//1012",
"media":{
"uri":"ipfs://QmaUhmEgy5Znagz2ayY2uyn5Xdbsvzm8PkBM1GghtsXihv/1012.png",
"mimeType":"image"
},
"metadata":{
"metadata":[
{
"name":"playmaking",
"value":"78"
},
{
"name":"uri",
"value":"/collection/ballerz//1012"
},
{
"name":"role",
"value":"Player"
},
{
"name":"img",
"value":"ipfs://QmaUhmEgy5Znagz2ayY2uyn5Xdbsvzm8PkBM1GghtsXihv/1012.png"
},
{
"name":"shooting",
"value":"81"
},
{
"name":"jersey",
"value":"Home"
},
{
"name":"title",
"value":"BALLER #1012"
},
{
"name":"defense",
"value":"86"
},
{
"name":"team",
"value":"Cleveland Firebirds"
},
{
"name":"body",
"value":"Human IV"
},
{
"name":"description",
"value":"A basketball-inspired generative NFT living on the Flow blockchain"
},
{
"name":"accessories",
"value":"None"
},
{
"name":"id",
"value":"1012"
},
{
"name":"hair",
"value":"Afro"
},
{
"name":"number",
"value":"13"
},
{
"name":"dunks",
"value":"82"
}
]
}
Copy link
On this page
Parameters
Returns
Example
Request
Response