Get NFT metadata

GEThttps://solana-gateway.moralis.io/nft/:network/:address/metadata

Get the global NFT metadata for a given network and contract (mint, standard, name, symbol, metaplex).

PATH PARAMS

networkstringrequired

The network to query

mainnetdevnet

addressstringrequired

The address of the contract

Responses

API KEY

Node.js

import Moralis from 'moralis';

try {
  await Moralis.start({
    apiKey: "YOUR_API_KEY"
  });

  const response = Moralis.SolApi.nft.getNFTMetadata({
    "network": "mainnet",
    "address": "FVzM6rUA1SigPxh6e3iQ8dAPjQNf2guap3Xcdj8Q6R2H"
  });

  console.log(response.raw);
} catch (e) {
  console.error(e);
}

Python

from moralis import sol_api

api_key = "YOUR_API_KEY"

params = {
  "network": "mainnet",
  "address": "FVzM6rUA1SigPxh6e3iQ8dAPjQNf2guap3Xcdj8Q6R2H"
}

result = sol_api.nft.get_nft_metadata(
  api_key=api_key,
  params=params,
)

print(result)

cURL

curl --request GET \
     --url 'https://solana-gateway.moralis.io/nft/mainnet/FVzM6rUA1SigPxh6e3iQ8dAPjQNf2guap3Xcdj8Q6R2H/metadata' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://solana-gateway.moralis.io/nft/mainnet/FVzM6rUA1SigPxh6e3iQ8dAPjQNf2guap3Xcdj8Q6R2H/metadata"

  req, _ := http.NewRequest("GET", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

PHP

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://solana-gateway.moralis.io/nft/mainnet/FVzM6rUA1SigPxh6e3iQ8dAPjQNf2guap3Xcdj8Q6R2H/metadata', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 Returns a Solana NFT by address400 Bad request. Invalid address or other request error.

{
  "address": "FVzM6rUA1SigPxh6e3iQ8dAPjQNf2guap3Xcdj8Q6R2H",
  "mint": "FVzM6rUA1SigPxh6e3iQ8dAPjQNf2guap3Xcdj8Q6R2H",
  "standard": "metaplex",
  "name": "Mad Lads #7256",
  "symbol": "MAD",
  "description": "Fock it.",
  "imageOriginalUrl": "https://madlads.s3.us-west-2.amazonaws.com/images/7256.png",
  "externalUrl": "https://madlads.com",
  "metadataOriginalUrl": "https://madlads.s3.us-west-2.amazonaws.com/json/7256.json",
  "totalSupply": "1",
  "metaplex": {
    "metadataUri": "https://madlads.s3.us-west-2.amazonaws.com/json/7256.json",
    "updateAuthority": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW",
    "sellerFeeBasisPoints": 420,
    "primarySaleHappened": 1,
    "isMutable": true,
    "masterEdition": ""
  },
  "attributes": [
    {
      "traitType": "Gender",
      "value": "Male"
    }
  ],
  "contract": {
    "type": "non-fungible-programmable",
    "name": "Mad Lads",
    "symbol": "MAD"
  },
  "collection": {
    "collectionAddress": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w",
    "name": "Mad Lads",
    "description": "Fock it.",
    "imageOriginalUrl": "https://madlads.s3.us-west-2.amazonaws.com/images/7256.png",
    "externalUrl": "https://madlads.com",
    "metaplexMint": "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w",
    "sellerFeeBasisPoints": 500
  },
  "firstCreated": {
    "mintTimestamp": 1682119190,
    "mintBlockNumber": 189744752,
    "mintTransaction": "2yZw1LEKuFydmg6bQd3jWoeZGYytyrmC1dBkdhco8kbkmtBi2FiuW1TfBvToRqougfcogrqQvD5c2Kk25auw4wXA"
  },
  "creators": [
    {
      "address": "5XvhfmRjwXkGp3jHGmaKpqeerNYjkuZZBYLVQYdeVcRv",
      "share": "",
      "verified": true
    }
  ],
  "properties": {
    "files": [
      {
        "id": "portrait",
        "uri": "https://madlads.s3.us-west-2.amazonaws.com/images/7256.png",
        "type": "image/png"
      }
    ],
    "category": "image",
    "collection": {
      "name": "Mad Lads",
      "family": "MAD"
    },
    "creators": [
      {
        "address": "2RtGg6fsFiiF1EQzHqbd66AhW7R5bWeQGpTbv2UMkCdW",
        "share": 100
      }
    ]
  }
}