NFT-Metadaten prüfen: Zeigt der Marktplatz Ihr NFT richtig an?

02 / ABLAUF

So kommt ein Marktplatz zu Name und Bild

Die Felder der Token-Metadaten

Kein Feld ist Pflicht, auch nicht in ERC-721. Fehlen name oder image, zeigt der Marktplatz trotzdem nur eine Nummer und einen Platzhalter. Stand der Regeln 14. November 2026.

Das Bild verdient besondere Sorgfalt. Sammlungen sind optisch einheitlich, und neben dem bisherigen Verkaufsverlauf sagen die Bildmerkmale den Preis am besten voraus Nadini u. a. 2021. ERC-721 empfiehlt 320 bis 1080 Pixel Breite bei einem Seitenverhältnis zwischen 4:5 und 1,91:1, OpenSea dagegen mindestens 3000 × 3000 Pixel. Steht das Bild als data:-URI im Text, liest der Prüfer Format und Größe direkt aus den Bytes.

03 / MERKMALE

attributes: Merkmale so schreiben, dass Filter stimmen

Aus attributes entstehen die Filter einer Sammlung und, bei vielen Seiten, die Seltenheit eines NFTs. Das hat Folgen: In 410 Sammlungen mit 3,7 Millionen Transaktionen hing die aus den Merkmalen berechnete Seltenheit deutlich mit Preis und Handel zusammen Mekacher u. a. 2022. Ein Leerzeichen zu viel in „Farbe " macht aus einer Merkmalsart zwei, und schon stimmt die Zählung nicht mehr.

display_type: number, boost_number, boost_percentage, date, string, text. Andere Werte werden behandelt, als fehlte das Feld.

• Zahl ohne Anführungszeichen. "value": "5" ist Text, "value": 5 ist eine Zahl. Bei number, boost_number, boost_percentage und date muss es eine Zahl sein; OpenSea liest eine Zahl in Anführungszeichen ausdrücklich als Text.
• Datum in Sekunden. Unix-Zeit wie block.timestamp, also 1798761600 für den 1. Januar 2027. Werte ab 1.000.000.000.000 sind fast immer Millisekunden: 1798761600000 wäre als Sekunden gelesen das Jahr 58970.
• max_value nur bei Zahlen. Ohne max_value nimmt OpenSea den höchsten Wert, den es in der Sammlung gesehen hat. Ist max_value kleiner als value, ist die Angabe ungültig.
• Mehrere Werte, ein Name. Ein Hut und ein Schal: zweimal trait_type „Zubehör" mit je einem value. Ein Wert als Liste wird ignoriert.
• Schreibweise genau gleich. „Farbe" und „farbe" sind für den Marktplatz zwei Filter. Der Prüfer meldet solche Paare.

04 / SPEICHERORTE

data:, ipfs://, ar:// oder https: Wo Bild und JSON liegen sollten

Ein NFT ist so dauerhaft wie die Datei, auf die es zeigt. In einer Untersuchung von acht großen Marktplätzen lagen 80,69 Prozent der Metadaten-Adressen nicht auf IPFS; bei 2,89 Prozent der Token änderte sich die Adresse binnen drei Monaten, und Inhalte außerhalb von IPFS verschwanden häufiger Das u. a. 2022. Bei hochpreisiger Kunst sah es kaum besser aus: 19 von 51 Verträgen hatten die Metadaten-Adresse mindestens einmal geändert Balduf u. a. 2022.

https: der Normalfall, der nicht von Dauer ist

Eine Webadresse ist bequem, aber sie lebt nur so lange wie der Server und der Vertrag mit dem Hoster. Das ist kein NFT-Problem: Von gut einer Million Web-Verweisen in Fachartikeln führte bei jedem fünften Artikel mindestens einer ins Leere oder auf veränderten Inhalt Klein u. a. 2014. Für Dinge, die sich bewusst ändern sollen, etwa ein Zugangs-Token mit Gültigkeit, ist https trotzdem richtig; solche dynamischen NFTs sind inzwischen ein eigenes Forschungsfeld Guidi und Michienzi 2023. Dann sendet der Vertrag bei jeder Änderung das Ereignis MetadataUpdate nach ERC-4906, sonst zeigt der Marktplatz noch lange den alten Stand.

ipfs://: Inhaltsadresse, aber nur mit Pinning

Daraus folgen drei Regeln. Pinnen Sie bei mindestens zwei unabhängigen Anbietern oder auf einem eigenen Knoten. Liegt die Datei in einem Ordner (ipfs://…/1.png), pinnen Sie den ganzen Ordner, denn ohne den Ordnerblock findet niemand die Datei. Und tragen Sie ipfs:// ein, nie eine Gateway-Adresse.

Gateway-Adressen: der häufigste vermeidbare Fehler

Viele Verträge tragen https://gateway.pinata.cloud/ipfs/… oder https://ipfs.io/ipfs/… ein statt ipfs://. Damit hängt die Anzeige an genau einem Betreiber, und Verfügbarkeit und Unversehrtheit sinken auf das Niveau eines gewöhnlichen Webservers Balduf u. a. 2022. Antworten eines Gateways lassen sich unterwegs sogar austauschen, ohne dass es auffällt, solange niemand die CID nachrechnet Stöger u. a. 2023. Der Entwurf ERC-8495 nennt eine eigene Stichprobe: 113 von 204 Token-Adressen mit Gateway luden nicht. Und Gateways verschwinden tatsächlich; Cloudflare hat cloudflare-ipfs.com und cf-ipfs.com am 14.08.2024 abgeschaltet. Der Prüfer erkennt Pfad- und Subdomain-Gateways und schlägt die ipfs://-Form vor.

ar://: bezahlt für lange Zeit

Arweave verfolgt einen anderen Ansatz. Hochladen kostet einmal eine Gebühr, und das Netz soll die Daten dauerhaft halten Daniel und Tschorsch 2022. Die Adresse ist ar:// mit einer Transaktions-ID aus 43 Zeichen Base64URL, bei der Groß- und Kleinschreibung zählt. Ein kürzerer Name hinter ar:// ist ein ArNS-Name: praktisch, aber umstellbar und damit veränderlich.

05 / ONCHAIN

Metadaten im Vertrag: data:-URIs ohne Stolperfallen

Am dauerhaftesten sind Metadaten, die der Vertrag selbst zurückgibt. Forscher, die besonders teuer gehandelte Kunst-NFTs untersucht haben, empfehlen genau das für alles, was klein genug ist Balduf u. a. 2022. tokenURI liefert dann keine Adresse, sondern eine data:-URI mit dem JSON darin, und das Bild steckt als SVG oft gleich mit drin. Was das an Gas kostet, rechnet der Gas-Rechner aus.

• Base64 statt unkodiert. data:application/json;base64,… ist die empfohlene Form. Unkodiert bricht der Browser beim ersten # ab, und ein Name wie „Pass #42" oder eine Farbe wie #fff im SVG zerreißt das Dokument.
• ;utf8 ist kein Parameter. data:application/json;utf8,… ist verbreitet und wird gelesen, RFC 2397 kennt aber nur attribut=wert, also ;charset=utf-8. Mit Base64 stellt sich die Frage nicht.
• SVG ohne Skripte. SVG kann ausführbaren Code enthalten Heiderich u. a. 2011. Marktplätze zeigen es deshalb nur als Bild: Skripte laufen nicht, externe Schriften und Bilder werden nicht geladen, und OpenSea speichert SVG als PNG zwischen. Was davon abhängt, fehlt in der Anzeige.
• Medientyp passend. In image gehört image/svg+xml, image/png und so weiter. Der Prüfer vergleicht die Angabe mit den tatsächlichen Bytes.

Für jedes gültige JSON erzeugt der Prüfer die Base64-Fassung zum Kopieren, nach den sicheren Korrekturen wie # vor der Farbe, Zahlen in Anführungszeichen oder Gateway-Adressen.

06 / ERC-1155

ERC-1155: {id}, Dateinamen und Übersetzungen

07 / SAMMLUNG

contractURI: die Metadaten der ganzen Sammlung

Name, Banner und Beschreibung der Sammlungsseite kommen aus einer eigenen Datei, auf die die Funktion contractURI zeigt. ERC-7572 beschreibt sie; der Standard ist noch ein Entwurf, OpenSea liest ihn trotzdem. Pflicht ist nur name. Ändert sich die Datei, sendet der Vertrag ContractURIUpdated().

Die Adressen in collaborators prüft der Prüfer auf Format und Prüfsumme nach EIP-55. Eine falsche Groß- und Kleinschreibung deutet fast immer auf einen Tippfehler. Einzelne Adressen vergleichen Sie Zeichen für Zeichen mit dem Ethereum-Adress-Prüfer.

08 / FORSCHUNG

Was die Forschung zu NFT-Metadaten sagt

Die Einstufungen im Prüfer stützen sich auf Messungen im NFT-Ökosystem und im IPFS-Netz. Fünf Befunde tragen die wichtigsten Entscheidungen; die vollständige Liste mit Prüfvermerk steht weiter unten.

• Metadaten-Adressen ändern sich, und Webinhalte verschwinden. 2,89 Prozent der Adressen änderten sich in drei Monaten, Inhalte außerhalb von IPFS gingen häufiger verloren Das u. a. 2022. Darum stuft der Prüfer https als veränderlich ein.
• Gateway-Adressen machen aus IPFS einen Webserver. Fest eingetragene Gateways senken die Verfügbarkeit auf Cloud-Niveau Balduf u. a. 2022, und ihre Antworten lassen sich unterwegs verändern Stöger u. a. 2023. Der Prüfer meldet jede Gateway-Adresse mit Ersatz.
• IPFS hält Daten nicht von allein. Viele NFT-Dateien brauchten mehrere Abrufversuche Shi u. a. 2024, und Marktplätze zeigen oft eine eigene Kopie Guidi u. a. 2025. Darum steht bei jeder ipfs://-Adresse der Pinning-Hinweis.
• Merkmale bewegen Preise. Seltenheit aus attributes hängt mit Preis und Rendite zusammen Mekacher u. a. 2022. Darum meldet der Prüfer schon ein Leerzeichen am Rand.
• Fehlerhafte Metadaten trennen Token und Inhalt. So beschreibt es der NIST-Bericht zu NFT-Schwachstellen Mell und Yaga 2024; ein ungültiges image ist deshalb ein Fehler, keine Kleinigkeit.

09 / VORGEHEN

So bringen Sie eine Sammlung sauber an den Start

1. Speicherort festlegen. Kleine Metadaten und SVG als data:-URI im Vertrag, größere Bilder und Videos auf IPFS oder Arweave. https nur für Inhalte, die sich ändern sollen.
2. Eine Datei je Token prüfen. Name, Bild und Merkmale hier einfügen, bis keine Fehler und Warnungen mehr kommen. Bei ERC-1155 die Token-ID eintragen und die Dateinamen vergleichen.
3. Pinning doppelt anlegen. Bei zwei unabhängigen Anbietern oder auf eigenem Knoten, den ganzen Ordner.
4. Sammlungsdatei schreiben. contractURI mit name, Bild, Banner und external_link, und hier gegenprüfen.
5. Auf dem Testnetz ansehen. Ein Token prägen und auf dem Testnetz eines Marktplatzes und in zwei Wallets anschauen, bevor das Hauptnetz drankommt.
6. Änderungen melden. MetadataUpdate (ERC-4906), URI (ERC-1155) oder ContractURIUpdated() senden, wenn sich etwas ändert.

Wo der Prüfer aufhört

• Er ruft nichts ab. Ob ein Bild unter ipfs:// noch gepinnt ist oder ein Server antwortet, sieht er nicht. Für das Abrufen nennt er die Gateway-Adresse als Text.
• Marktplätze weichen ab. Geprüft wird nach den Standards, der OpenSea-Dokumentation und dem Entwurf ERC-8495. Einzelne Wallets lesen weniger, manche Marktplätze eigene Zusatzfelder.
• Kein Urteil über Wert oder Echtheit. Name und Bild lassen sich beliebig kopieren; Fälschungen nutzten oft sogar dieselben Bildadressen wie das Original Das u. a. 2022. Ein NFT erkennen Sie an Vertragsadresse und Token-ID.

Weitere Werkzeuge für Vorhaben auf der Blockchain stehen in der Übersicht Web3-Werkzeuge. Wie wir Sammlungen, Zugangs-Token und die Anwendungen drumherum bauen, beschreibt die Seite Web3-Entwicklung.

10 / FÜR KI-ASSISTENTEN

Dieses Werkzeug aus einem KI-Assistenten nutzen

Assistenten wie Claude oder ChatGPT, die das Model Context Protocol (MCP) sprechen, können die Rechnung dieser Seite direkt aufrufen, statt sie nachzubauen. Der Server ist öffentlich, braucht keine Anmeldung und speichert nichts. Die Antwort enthält immer den Link auf diese Seite, den Stand der Daten und die Grenzen des Ergebnisses.

Endpunkt

https://aureum-tech.com/mcp

Werkzeug

werkzeug_nft_metadaten_pruefer

Transport

Streamable HTTP, nur lesend

Fragen, bei denen ein Assistent es aufrufen sollte

• „Sind diese NFT-Metadaten korrekt, und zeigt OpenSea die Merkmale richtig an?"
• „Meine tokenURI liefert eine data:-URI mit Base64-JSON zurück. Ist das gültig?"
• „Wie muss die Datei für ERC-1155-Token 314592 heißen, wenn die URI {id}.json enthält?"
• „Ist ipfs://Qm… oder die Gateway-Adresse von Pinata die bessere Wahl für das Bild?"

Wie die Anbindung funktioniert und was MCP im eigenen Betrieb leisten kann, steht auf der Seite zu MCP-Integrationen.

11 / HÄUFIGE FRAGEN

Häufige Fragen zu NFT-Metadaten