Create Metadata | Dynamic Metadata | Utiliti Developer Docs

In order to get started with Dynamic Metadata, create the namespace that the metadata will be stored under. Namespaces are unique. Think of namespaces like a bucket where you can store metadata items into.

Namespaces may only consist of lower-case letters, numbers, and hyphens.

Creating metadata namespace

In the following example, we will create a "Heroes" namespace and add hero metadata under the namespace.


...const response = await fetch('https://api.utiliti.ai/metadata', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-key': '<YOUR_API_KEY_HERE>',
  },
  body: JSON.stringify({
    namespace: 'heroes',
    description: 'This is the heroes namespace',
  }),
})



SDK coming soon...


CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.utiliti.ai/metadata");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
headers = curl_slist_append(headers, "content-type: application/json");
headers = curl_slist_append(headers, "X-API-key: <YOUR_API_KEY_HERE>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"namespace\":\"heroes\",\"description\":\"This is the heroes namespace\"}");

CURLcode ret = curl_easy_perform(hnd);


curl --request POST \
     --url https://api.utiliti.ai/metadata \
     --header 'X-API-key: <YOUR_API_KEY_HERE>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
     "namespace": "heroes",
     "description": "This is the heroes namespace"
}
'


$python -m pip install requests

---
import requests

url = "https://api.utiliti.ai/metadata"

payload = {
    "namespace": "heroes",
    "description": "This is the heroes namespace"
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "X-API-key": "<YOUR_API_KEY_HERE>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Add metadata to the namespace


...const response = await fetch('https://api.utiliti.ai/metadata/ + "heroes"', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-key': '<YOUR_API_KEY_HERE>',
  },
  body: JSON.stringify({
    id: '5226',
    name: 'Hero Galaxy #5226',
    image:
      'https://herogalaxy.mypinata.cloud/ipfs/QmQq6ejvT6Ut3eBiGShxLuVG88a4EdsHuyesDBVeFT6ZwB/5226.png',
    description: 'Hero Galaxy Heroes',
    attributes: [
      {
        trait_type: 'Background',
        value: 'Blue Sky',
      },
      {
        trait_type: 'Aura',
        value: 'None',
      },
      {
        trait_type: 'Skin',
        value: 'Silver',
      },
      {
        trait_type: 'Mouth',
        value: 'Base mouth',
      },
      {
        trait_type: 'Eyes',
        value: 'Pink Feline',
      },
      {
        trait_type: 'Eyebrows',
        value: 'Quizzical',
      },
    ],
  }),
})



SDK coming soon...


CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "POST");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.utiliti.ai/metadata/heroes");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
headers = curl_slist_append(headers, "content-type: application/json");
headers = curl_slist_append(headers, "X-API-key: <YOUR_API_KEY_HERE>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"id\":\"5226\",\"name\":\"Hero Galaxy #5226\",\"image\":\"https://herogalaxy.mypinata.cloud/ipfs/QmQq6ejvT6Ut3eBiGShxLuVG88a4EdsHuyesDBVeFT6ZwB/5226.png\",\"description\":\"Hero Galaxy Heroes\",\"attributes\":\"[{trait_type: 'Background',value: 'Blue Sky',},{trait_type: 'Aura',value: 'None',},{trait_type: 'Skin',value: 'Silver',},{trait_type: 'Mouth',value: 'Base mouth',},{trait_type: 'Eyes',value: 'Pink Feline',},{trait_type: 'Eyebrows',value: 'Quizzical',},],\"}");

CURLcode ret = curl_easy_perform(hnd);


curl --request POST \
     --url https://api.utiliti.ai/metadata/heroes \
     --header 'X-API-key: <YOUR_API_KEY_HERE>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data @- <<EOF
{
     "id": "5226",
     "name": "Hero Galaxy #5226",
     "image": "https://herogalaxy.mypinata.cloud/ipfs/QmQq6ejvT6Ut3eBiGShxLuVG88a4EdsHuyesDBVeFT6ZwB/5226.png",
     "description": "Hero Galaxy Heroes",
     "attributes": "[{trait_type: 'Background',value: 'Blue Sky',},{trait_type:'Aura',value: 'None',},{trait_type: 'Skin',value: 'Silver',},{trait_type:'Mouth',value: 'Base mouth',},{trait_type: 'Eyes',value: 'Pink Feline',},{trait_type: 'Eyebrows',value: 'Quizzical',},],"
}
EOF


$python -m pip install requests

---
import requests

url = "https://api.utiliti.ai/metadata/heroes"

payload = {
    "id": "5226",
    "name": "Hero Galaxy #5226",
    "image": "https://herogalaxy.mypinata.cloud/ipfs/QmQq6ejvT6Ut3eBiGShxLuVG88a4EdsHuyesDBVeFT6ZwB/5226.png",
    "description": "Hero Galaxy Heroes",
    "attributes": "[{trait_type: 'Background',value: 'Blue Sky',},{trait_type: 'Aura',value: 'None',},{trait_type: 'Skin',value: 'Silver',},{trait_type: 'Mouth',value: 'Base mouth',},{trait_type: 'Eyes',value: 'Pink Feline',},{trait_type: 'Eyebrows',value: 'Quizzical',},],"
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "X-API-key": "<YOUR_API_KEY_HERE>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Update metadata


...const response = await fetch('https://api.utiliti.ai/metadata/ + "heroes"', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'X-API-key': '<YOUR_API_KEY_HERE>',
  },
  body: JSON.stringify({
    id: '5226',
    name: 'Hero Galaxy Heroes #5226',
  }),
})



SDK coming soon...


CURL *hnd = curl_easy_init();

curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "PUT");
curl_easy_setopt(hnd, CURLOPT_URL, "https://api.utiliti.ai/metadata/heroes");

struct curl_slist *headers = NULL;
headers = curl_slist_append(headers, "accept: application/json");
headers = curl_slist_append(headers, "content-type: application/json");
headers = curl_slist_append(headers, "X-API-key: <YOUR_API_KEY_HERE>");
curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers);

curl_easy_setopt(hnd, CURLOPT_POSTFIELDS, "{\"id\":\"5226\",\"name\":\"Hero Galaxy #5226\"}");

CURLcode ret = curl_easy_perform(hnd);


curl --request PUT \
     --url https://api.utiliti.ai/metadata/heroes \
     --header 'X-API-key: <YOUR_API_KEY_HERE>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
     "id": "5226",
     "name": "Hero Galaxy #5226"
}
'


$python -m pip install requests

---
import requests

url = "https://api.utiliti.ai/metadata/heroes"

payload = {
    "id": "5226",
    "name": "Hero Galaxy #5226"
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "X-API-key": "<YOUR_API_KEY_HERE>"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

Token URI with Dynamic Metadata

Most ERC-721 and ERC-1155 contracts implement the tokenURI(uint256 tokenId) method to vend metadata information about their NFT.

Your dynamic token metadata will be vended from: https://api.utiliti.ai/metadata/{namespace}/{metadata_id}

We recommend setting the base URI of the NFT contract to: https://api.utiliti.ai/metadata/{namespace}/