NFT Metadata API

NFT-Metadatenabruf – Name, Bild, Attribute, Sammlungsinformationen aus Vertrag und Token-ID. Ethereum und Base. Pay-per-Call über x402 (USDC auf Base L2) – kein API-Schlüssel, keine Anmeldung, keine Rate-Limit-Hürde.

Teil des klymax402-Marktplatzes – 100 x402-Mikrozahlungs-APIs für KI-Agenten, ein Wallet, USDC auf Base.

Schnellstart – MCP

Fügen Sie Folgendes in die Konfiguration Ihres MCP-Clients ein (Claude Desktop, Cursor, ElizaOS usw.):

{
  "mcpServers": {
    "nft-metadata": {
      "url": "https://nft-metadata.api.klymax402.com/mcp"
    }
  }
}

Related MCP server: nft-floor

Schnellstart – HTTP (x402)

curl -X POST "https://nft-metadata.api.klymax402.com/api/metadata" \
  -H "Content-Type: application/json" \
  -d '{"contract":"...","tokenId":"..."}'
# -> 402 Payment Required, with an x402 payment challenge in the response body

Jeder Client mit x402-Unterstützung (@x402/fetch, x402-agent-tools, ATXP) übernimmt den Zyklus 402 -> sign -> retry automatisch.

Tools

crypto_get_nft_metadata

Verwenden Sie dieses Tool, wenn Sie Metadaten für ein bestimmtes NFT anhand der Vertragsadresse und Token-ID abrufen müssen. Die vollständigen NFT-Details werden im JSON-Format zurückgegeben.

Parameter

Rückgabewerte

• name – Name des NFT-Tokens

• description – Beschreibungstext des Tokens

• imageUrl – URL für das Bild/die Medien des NFTs

• attributes – Array von Trait-Objekten mit trait_type und value

• collection – Name der Sammlung und Vertragsinformationen

• tokenStandard – ERC-721 oder ERC-1155

• chain – Blockchain, auf der das NFT liegt

Beispielantwort:

{"name":"Bored Ape #1234","description":"A unique digital collectible...","imageUrl":"ipfs://Qm...","attributes":[{"trait_type":"Background","value":"Blue"},{"trait_type":"Fur","value":"Gold"}],"collection":"BoredApeYachtClub","tokenStandard":"ERC-721","chain":"ethereum"}

Wann verwenden: NFT-Verifikation, Anzeige und Trait-Analyse. Unverzichtbar für NFT-Marktplatz-Agenten und Sammlungstools.

Nicht geeignet für: Wallet-Kontostände (wallet_get_portfolio verwenden), ENS-Auflösung (crypto_resolve_ens verwenden), Token-Sicherheit (token_check_safety verwenden).

Beispiel-Agent-Prompts

• Metadaten für ein bestimmtes NFT anhand von Vertragsadresse und Token-ID abrufen

Zahlung

• Protokoll: x402 – HTTP-natives Pay-per-Call, keine Anmeldung, kein API-Schlüssel

• Netzwerk: Base L2 (eip155:8453)

• Asset: USDC

• Facilitator: Coinbase CDP (primär), PayAI (Fallback)

• Auch erreichbar über ATXP (OAuth-verpacktes x402, RFC 9728-Metadaten für geschützte Ressourcen)

Teil von klymax402

100 x402-Mikrozahlungs-APIs für KI-Agenten – ein Wallet, USDC auf Base, keine Anmeldung.

• Katalog: https://klymax402.com/llms.txt

• Vollständige API-Referenz: https://klymax402.com/llms-full.txt

• Live-Statistiken: https://klymax402.com/stats

Lizenz

MIT