Todo lo que necesitas saber sobre la Optimism NFT API de Alchemy
Escrito por Mrig
Las colecciones de NFT están en auge en Optimism, con más desarrolladores construyendo nuevas apps de NFT en la red. Estos desarrolladores necesitan NFT APIs para consultar la red y obtener metadata de NFT que satisfaga las solicitudes de datos de los usuarios. Sin las NFT APIs adecuadas, indexar y consultar metadata de NFT se convierte en un procedimiento que consume tiempo y recursos para los desarrolladores individuales.
Aprende cómo empezar a construir herramientas, marketplaces, apps y más para NFT con la NFT API de Optimism de Alchemy.
El ecosistema NFT de Optimism
Optimism es una solución de escalado L2 (capa 2) de Ethereum, que corre sobre infraestructura de optimistic rollup. Los optimistic rollups reducen la carga sobre Ethereum al realizar transacciones fuera de la cadena, ofreciendo así mayor throughput de transacciones y menores comisiones de gas. Los optimistic rollups agrupan múltiples transacciones en una sola transacción y las envían de vuelta a Ethereum para su validación, mejorando así la escalabilidad de la red.
La escalabilidad incorporada de Optimism la convierte en una solución ideal para desarrollar proyectos de NFT. Los usuarios obtienen una experiencia mejorada al jugar NFT games o al comerciar coleccionables gracias a las transacciones de alta velocidad y las comisiones bajas de Optimism.
Con más de 1 millón de activos NFT en Optimism distribuidos en 238K wallets de NFT, según el sitio web de Optimism NFTScan, los desarrolladores necesitan el conjunto de herramientas adecuado para construir protocolos de NFT e interactuar con un alto volumen de NFTs. La NFT API de Optimism de Alchemy es una herramienta fundamental que los desarrolladores necesitan para construir proyectos de NFT en el ecosistema de Optimism.
¿Qué es una NFT API de Optimism?
La NFT API de Optimism ayuda a los desarrolladores a obtener información de la red L2 de forma instantánea. Los desarrolladores pueden leer datos de bloques/transacciones, ejecutar smart contracts, consultar información on-chain y almacenar datos on-chain con la NFT API de Optimism.
Alchemy ofrece una NFT API multichain para desarrolladores que usan las APIs estándar JSON-RPC para interactuar con la infraestructura de nodos descentralizada de Optimism. La NFT API de Optimism de Alchemy permite a los desarrolladores acceder a mayor throughput de solicitudes, aumentar las solicitudes concurrentes y usar archivos de datos gratuitos, logs y métricas de uso individuales. Además, la solución soporta todos los NFTs que siguen los estándares ERC-721 y ERC-1155, y algunos NFTs seleccionados anteriores a los contratos NFT estandarizados de Ethereum.
Los desarrolladores también tienen acceso a una amplia gama de NFTs y su metadata a través de múltiples rutas de código. La NFT API de Optimism de Alchemy puede manejar NFTs on-chain u off-chain en formato JSON, SVG, UTF-8, gateways de IPFS como Pinata, e imágenes codificadas en Base64.
Los desarrolladores pueden usar la NFT API de Alchemy para los siguientes propósitos:
- Mostrar NFTs a los usuarios
- Desarrollar un NFT marketplace
- Diseñar un protocolo de analítica de NFT
- Construir aplicaciones de gaming con NFT
- Verificar la propiedad de un NFT
¿Cómo funciona la NFT API de Optimism?
La NFT API de Optimism de Alchemy usa los siguientes mecanismos para lograr una funcionalidad de alto rendimiento: caché de imágenes, filtros de spam, redimensionamiento de imágenes y descripciones claras de errores.
Caché de imágenes
Los desarrolladores suelen interactuar con proveedores de almacenamiento descentralizado como IPFS y servidores de terceros para acceder a los archivos multimedia de los NFT. Sin embargo, se enfrentan a tiempos de carga más largos y errores de timeout.
Alchemy ofrece una solución de baja latencia con carga rápida y respuestas rápidas porque almacena en caché las imágenes de NFT con Cloudinary. Así, Alchemy puede servir las URLs de NFT desde su propia caché a los desarrolladores, reduciendo así el tiempo de respuesta.
Filtros de spam
Los NFT de spam no deseados pueden generar estafas y perjudicar la experiencia de usuario en un marketplace, galería o plataforma de analítica de NFT. Los desarrolladores generalmente tienen que leer y analizar smart contracts individuales para acceder a la metadata de NFT y filtrar los NFT de spam. Para simplificar esto, Alchemy ofrece los siguientes endpoints de API como filtros de spam de NFT:
- isSpamForContract: verifica si un smart contract de NFT es spam. Los desarrolladores también pueden filtrar direcciones de contrato para verificar a los propietarios de NFTs de spam.
- getSpamContracts: devuelve la lista de smart contracts ERC-721 y ERC-1155 marcados como spam en una red particular.
Los desarrolladores pueden usar los filtros de spam de Alchemy para enviar NFTs de spam a quemar o marcar direcciones de wallet que envían NFTs de spam. Para agosto de 2022, la NFT API de Alchemy había marcado 5,000 smart contracts como NFTs de spam.
Alchemy usa los siguientes criterios para identificar NFTs de spam:
- Incumple los estándares de token ERC-721 y ERC-1155
- Incumple los estándares de token durante las transferencias de tokens
- Acuña tokens hacia direcciones honeypot como vitalik.eth
- Proporciona datos falsos sobre el suministro total de tokens
Redimensionamiento de imágenes
Los NFTs necesitan diferentes tamaños de imagen para miniaturas, smartphones, escritorios y viewports de tablet. Los desarrolladores pueden redimensionar los NFTs alojados en Alchemy cambiando las URLs para incluir cualquier combinación de píxeles de alto y ancho y así crear la relación de aspecto. De esta forma, Alchemy facilita el redimensionamiento de imágenes para los desarrolladores de NFT.
Errores de NFT
Aunque la NFT API de Alchemy devuelve la mayoría de la metadata de NFT, no logra cumplir la solicitud en los siguientes casos:
- Token does not exist: Alchemy usa un ID de token para llamar al método tokenURI/uri, pero el smart contract no lo reconoce. Esto significa que el token aún no se acuñó o no existe.
- Malformed token URI: tokenURI/uri devuelve un sitio web "malformado" o inválido, por lo que no se puede acceder al sitio para devolver la metadata.
- Failed to get token URI: mensaje de error genérico cuando el ID de token no devuelve ninguna metadata, aunque el token exista.
- Token URI returns a non-200 response code: este error aparece cuando la URI devuelve un mensaje "502 Bad Gateway" si el sitio web está caído o limita la tasa de solicitudes a los servidores de Alchemy.
- Throttled token URI: este error devuelve un mensaje "429 Too Many Requests", indicando que Alchemy ha solicitado la metadata con demasiada frecuencia, por lo que se le ha aplicado un límite de tasa.
- Contract does not have any code: este error aparece cuando una dirección de token no tiene un código de smart contract correspondiente en la red blockchain.
- Contract returned a broken token URI, do not retry: este mensaje de error aparece cuando el tokenURI no responde porque la URL del sitio web puede no existir o carece de configuración DNS.
Métodos soportados por la NFT API de Optimism
La NFT API de Optimism de Alchemy ayuda a los desarrolladores a construir apps de NFT en Optimism con las siguientes categorías de endpoints de NFT API:
Propiedad de NFT y token gating en Optimism
- getNFTs: obtiene los NFTs de Optimism que posee una wallet
- getOwnersForToken: obtiene los propietarios de un token en Optimism
- getOwnersForCollection: obtiene los propietarios de NFT de una colección en Optimism
- isHolderOfCollection: verifica si una wallet de Optimism posee un NFT
- getNFTsForCollection: obtiene los NFTs de una colección de NFT en Optimism
Metadata de NFT en Optimism
- getNFTMetadata: obtiene la metadata de un NFT en Optimism
- getContractMetadata: obtiene la metadata del smart contract de un NFT en Optimism
Ejemplos de la NFT API de Optimism
getNFTs es un endpoint de NFT API versátil, que permite a los desarrolladores usarlo en múltiples protocolos de NFT. Para entender cómo funciona el endpoint de API getNFTs, considera los siguientes ejemplos.
1. Token gating en Optimism
Cuando los desarrolladores construyen un marketplace de NFT, diseñan una página de perfil de usuario que muestra los NFTs que posee el usuario. Los desarrolladores pueden usar la herramienta de token gating de NFT en Optimism, isHolderOfCollection, para obtener los NFTs de una dirección de wallet particular si esta posee un token específico de una colección determinada.
2. Herramienta de analítica de NFT en Optimism
Las herramientas de analítica de NFT, como los sitios de ranking de rareza o los agregadores, requieren metadata de NFT para crear listas y obtener datos de comercio. Los desarrolladores pueden usar la API de metadata de NFT de Optimism, getNFTMetadata, para recuperar la metadata on-chain usada en herramientas de analítica de NFT.
3. Listas de airdrop de NFT en Optimism
Un proyecto de NFT contrata desarrolladores para hacer airdrop de nuevos NFTs a los propietarios de un NFT específico. Sin una API, los desarrolladores tienen que analizar toda la blockchain para rastrear la propiedad de los activos NFT. Sin embargo, la API de colecciones de NFT de Optimism de Alchemy, getOwnersForToken, permite a los desarrolladores identificar instantáneamente a los propietarios y crear la lista de airdrop. Los desarrolladores también pueden usar esta API para verificar la propiedad de un activo cuando los usuarios quieren usar un NFT particular como su foto de perfil.
Cómo empezar a construir con la NFT API de Optimism
En lugar de correr tu propio nodo de Optimism, es fácil crear un nodo privado de Optimism en Alchemy, y luego seguir tres pasos sencillos para empezar a construir con la NFT API de Optimism de Alchemy:
- Elige un package manager: usa un package manager como npm o yarn
- Configura el repo: abre una terminal para crear un nuevo repositorio desde la línea de comandos para los scripts de quickstart
- Elige una librería: instala el SDK de Alchemy para interactuar con la NFT API de Optimism
Aunque los desarrolladores pueden usar Fetch y Axios, la forma más rápida de empezar a usar la NFT API de Optimism es con el SDK de Alchemy, porque ofrece mejores facilidades con soporte de WebSocket, reintentos y muchos otros beneficios.
Usa la mejor NFT API de Optimism con Alchemy
Durante el bull run de 2021, el mercado de NFT superó los $40 mil millones según Bloomberg. Aunque el sector de NFT actualmente atraviesa una fase de mercado bajista difícil, la tecnología NFT tiene un enorme potencial de crecimiento futuro.
Por lo tanto, los builders necesitarán las herramientas de desarrollo de NFT adecuadas para crear sus apps de NFT en la red escalable de Optimism. Crea una cuenta gratis en Alchemy y empieza a construir apps de NFT con la NFT API gratuita de Alchemy.
Resúmenes relacionados
Web329 de mayo de 2024
Conoce Key3: la DAO líder de educación Web3 en Japón
Japan Airlines y Calbee, una empresa japonesa de snacks, están usando NFTs para promover el turismo y la lealtad de marca.
Web329 de mayo de 2024
Wavehack: el hackathon Web3 más importante de Japón
WaveHack es el hackathon Web3 más grande de Japón, y se llevará a cabo desde mediados de abril hasta finales de agosto de 2024.
Web329 de mayo de 2024
Web3 en Japón: una visión completa
Descubre cómo el gobierno de Japón está acelerando la innovación y cómo las empresas están usando la tecnología blockchain.

Construye magia blockchain
Alchemy combina los productos y herramientas de desarrollo Web3 más potentes con recursos, comunidad y un soporte legendario.