NFT Metadata API

Поиск метаданных NFT — название, изображение, атрибуты, сведения о коллекции — по адресу контракта и идентификатору токена. Ethereum и Base. Оплата за каждый вызов через x402 (USDC в Base L2) — без API-ключей, без регистрации, без ограничений на частоту запросов.

Часть маркетплейса klymax402 — 100 микроплатёжных API на x402 для ИИ-агентов: один кошелёк, USDC в Base.

Быстрый старт — MCP

Добавьте в конфигурацию вашего MCP-клиента (Claude Desktop, Cursor, ElizaOS и др.):

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

Related MCP server: nft-floor

Быстрый старт — 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

Любой клиент с поддержкой x402 (@x402/fetch, x402-agent-tools, ATXP) автоматически обрабатывает цикл «402 → подпись → повторный запрос».

Инструменты

crypto_get_nft_metadata

Используйте этот инструмент, когда нужно получить метаданные конкретного NFT по адресу контракта и идентификатору токена. Возвращает полные данные об NFT в формате JSON.

Параметры

Возвращаемые данные

• name — название токена NFT

• description — текст описания токена

• imageUrl — URL изображения/медиафайла NFT

• attributes — массив объектов атрибутов вида c trait_type и value

• collection — название коллекции и сведения о контракте

• tokenStandard — ERC-721 или ERC-1155

• chain — блокчейн, в котором находится NFT

Пример ответа:

{"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"}

Когда использовать: верификация NFT, отображение информации, анализ атрибутов. Необходим для агентов NFT-маркетплейсов и инструментов работы с коллекциями.

Не предназначен для: запросов балансов кошельков (используйте wallet_get_portfolio), резолвинга ENS (используйте crypto_resolve_ens), проверки безопасности токена (используйте token_check_safety).

Примеры запросов для агентов

• «Получить метаданные NFT по адресу контракта и идентификатору токена»

Оплата

• Протокол: x402 — нативный HTTP-протокол оплаты за вызов, без регистрации и API-ключей

• Сеть: Base L2 (eip155:8453)

• Актив: USDC

• Посредник: Coinbase CDP (основной), PayAI (резервный)

• Также доступен через ATXP (x402 в обёртке OAuth, метаданные защищённого ресурса RFC 9728)

Часть платформы klymax402

100 микроплатёжных API на x402 для ИИ-агентов — один кошелёк, USDC в Base, без регистрации.

• Каталог: https://klymax402.com/llms.txt

• Полная документация API: https://klymax402.com/llms-full.txt

• Статистика в реальном времени: https://klymax402.com/stats

Лицензия

MIT