¿Qué es la OpenSea API?

Introducción a las NFTs

Las NFTs, o tokens no fungibles, son ítems digitales en la blockchain que son demostrablemente únicos. Desde su concepción, esta clase de activos ha crecido hasta incluir coleccionables en formato de imagen, video y audio, ítems de juegos, arte digital, entradas para eventos, nombres de dominio, e incluso registros de propiedad para activos físicos. Y los casos de uso siguen creciendo.

Generalmente asociadas a la blockchain de Ethereum, las NFTs se basan en los estándares de token ERC-721 y ERC-1155, y si se construye sobre este último, permiten la semi-fungibilidad: la capacidad de crear tokens que son intercambiables/fungibles al momento de acuñarse, pero que se vuelven no intercambiables/no fungibles al canjearse. Algunos ejemplos de tokens semi-fungibles incluyen entradas para conciertos, vales de regalo y cupones. Recientemente, también se ha hablado de NFTs "soulbound" que serían no transferibles una vez adquiridas, permitiendo a las personas verificar su identidad, confirmar asistencia a eventos, y tener derechos de gobernanza distribuidos y basados en participación en organizaciones descentralizadas (DAOs). Las NFTs soulbound servirían para expandir el espacio de las NFTs más allá de la señalización social y los incentivos financieros que actualmente dominan como resultado de la posibilidad de intercambiar estos activos en mercados secundarios.

Mientras tanto, a medida que el mercado de compra y venta de NFTs continúa creciendo hasta convertirse en una parte desproporcionadamente grande del espacio Web3, con más de $41 mil millones en volumen de transacciones a fines de 2021, los desarrolladores están acudiendo en masa a este espacio para construir sobre esta clase de activos única.

Las NFTs ofrecen una oportunidad única tanto para desarrolladores de aplicaciones como para desarrolladores de smart contracts. Independientemente de si los proyectos que estás construyendo requieren que interactúes directamente con la blockchain, un requisito importante es poder acceder a un índice del ecosistema de NFTs, con información detallada sobre propiedad, colecciones y eventos. Para los desarrolladores de smart contracts, es igualmente valioso poder construir marketplaces nativos de NFTs mediante funcionalidad que permita la compra y venta de NFTs.

OpenSea, el marketplace peer-to-peer líder para NFTs y otros activos digitales, cumple con estos requisitos clave para desarrolladores a través de su API y SDK, un conjunto de herramientas sencillo de integrar y usar que ya sirve de base para la mayoría de las apps convencionales que trabajan con NFTs hoy en día. Pero una porción tan grande del mercado dependiendo de un sistema tan centralizado no está exenta de problemas, especialmente dado que la plataforma de OpenSea ha enfrentado recientemente problemas de confiabilidad, y existen varias alternativas viables a la API de OpenSea.

¿Qué es OpenSea?

OpenSea funciona como un marketplace horizontal, peer-to-peer, para bienes digitales, permitiendo a los usuarios comprar, vender y subastar NFTs, ítems digitales raros y coleccionables cripto. Para los desarrolladores, OpenSea ofrece integraciones y herramientas extensas para apps en el espacio de las NFTs. Indexan y proveen el conjunto de datos de NFTs más grande (habiendo existido desde que se listaron los primeros proyectos), y actúan como mercado secundario para colecciones y proyectos populares. ‍ OpenSea soporta una serie de tokens y chains ampliamente utilizados, y están expandiendo esa lista activamente. Soportan tanto los no fungibles ERC-721 como los semi-fungibles ERC-1155, y son una plataforma multi-chain, ofreciendo herramientas para Polygon y Klaytn además de Ethereum. ‍ Junto a su marketplace, la plataforma de API de OpenSea impulsa herramientas de terceros, con su API REST sirviendo de base para varios proyectos grandes en la comunidad Web3, como MetaMask, Coinbase Wallet y Rainbow, entre otros.

La plataforma de desarrollo de OpenSea

Las herramientas de desarrollo de OpenSea consisten en una API REST que permite a los desarrolladores acceder y mostrar metadata sobre NFTs, y un Software Development Kit (SDK) que se construye sobre la API para habilitar el desarrollo que interactúa directamente con la blockchain, como para la creación de marketplaces de NFTs mediante la compra y venta de activos digitales. La plataforma de desarrollo de OpenSea ofrece varios valores agregados clave.

Para el desarrollo de aplicaciones a través de la API:

1. Proceso sencillo para mostrar NFTs y colecciones en el frontend.
2. Acceso a metadata sobre transacciones, propiedad y otros detalles de cada activo y colección en la base de datos de OpenSea.
3. La capacidad de monitorear la wallet de cualquier usuario en busca de transacciones de NFTs, y de obtener información sobre los activos de cualquier usuario.
4. Herramientas robustas de gestión de datos, incluyendo filtrado y estadísticas por categoría.
5. OpenSea provee documentación integral (documentación) que facilita empezar a usar su API.

Y para la interacción con smart contracts a través del SDK:

1. Acceso a la comunidad más grande del espacio para coleccionistas y vendedores a través del contrato de exchange de OpenSea.
2. La capacidad de construir funcionalidad de e-commerce que lee y escribe en la blockchain sin necesidad de desplegar tus propios contratos.
3. Construir marketplaces nativos para la compra y venta de NFTs con una amplia gama de funcionalidades y estructuras de pago.
4. OpenSea provee soporte integrado para regalías a través de Royalty Registry, estandarizado entre plataformas.
5. La documentación del SDK de OpenSea se actualiza regularmente para cumplir con los estándares más recientes de Solidity.

1. Herramientas de API

La API de OpenSea provee endpoints para los siguientes modelos indexados en la plataforma de OpenSea: assets (tokens individuales ERC-721/ERC-1155), colecciones de NFTs, eventos, órdenes, cuentas y contratos de activos. Como parte de la funcionalidad del SDK, la API de órdenes permite la obtención (GET) y el envío (POST) de órdenes de NFTs. OpenSea provee acceso a APIs tanto de Mainnet como de Testnet (a través de la red Ethereum Sepolia) para que los desarrolladores puedan construir y probar sin gastar dinero real.

Algunos endpoints de la API (orders y events) están restringidos por OpenSea para prevenir mal uso. Para construir con estos endpoints, puedes solicitar una API key en el portal de desarrolladores de OpenSea.

Ahora, exploraremos más de cerca los modelos de la API de OpenSea, y discutiremos el alcance y la función de cada uno. También se incluyen a continuación endpoints y llamadas a la API populares.

1. Contracts

Un contract es un smart contract desplegado en la red de Ethereum. Está asociado a una única cuenta propietaria. Los contracts se ejecutan automáticamente cuando se cumplen términos y condiciones predeterminados; en el caso de OpenSea, existen entre los compradores y el vendedor de una colección de NFTs, y se usan para ejecutar intercambios.

2. Assets

Los assets representan tokens individuales que surgen de un contract. Pueden pertenecer a una o más cuentas, y contienen metadata sobre cada activo. Estos datos incluyen información sobre el ID del activo, su propietario, su nombre y el contract en el que está contenido, así como los medios (la URL de la imagen que representa el activo) y los rasgos definidos por el creador. Los assets son la forma en que OpenSea se refiere a las NFTs.

3. Orders

Una order es una intención, enviada por una cuenta, de comprar/vender un activo. Existe fuera de la chain, y tiene un tipo: bid o ask. También contiene la metadata necesaria para vincularse con NFTs on-chain. Hay dos participantes en una order: un maker, que aporta liquidez y actúa como primer actor en una venta al declarar su intención de vender o comprar/ofertar por un ítem, y un taker, que toma liquidez y actúa como segundo actor en una venta al comprar o aceptar una oferta por el ítem. Las orders pueden agruparse dentro de una colección específica.

4. Events

Un event representa un cambio de estado en un asset. Hay events on-chain como transferencias, ventas y acuñaciones, así como events off-chain como ofertas y listados. Los events pueden ser privados.

5. Accounts

Las accounts representan usuarios en el marketplace de OpenSea a través de sus direcciones de wallet y nombres de usuario asociados. Pueden ser propietarias de uno o más assets, y actuar como makers o takers en una order.

6. Collections

Una collection es una agrupación de los assets de uno o más contracts. Contienen metadata como información de regalías y enlaces sociales, y tienen uno o más editores autorizados. Las collections existen completamente off-chain. Están asociadas a metadata como regalías del creador y descripciones. Algunas collections de NFTs populares incluyen Bored Ape Yacht Club, CryptoPunks y Crypto Coven.

Algunos endpoints y llamadas a la API populares incluyen:

• Get/ Assets: Obtiene una lista de tokens según criterios de filtrado (como asset_contract_address o collection_slug)

• GET /asset/:contract_address/:token_id

  • Obtiene información detallada sobre un token específico, incluyendo una lista de propietarios para tokens ERC-1155 y todas las órdenes abiertas sobre un token.

• GET /collections

  • Obtiene una lista de colecciones. También soporta opciones de filtrado, como asset_owner.

• GET /collections/:slug/stats

  • Obtiene información estadística sobre una colección específica, incluyendo un floor price actualizado.

• GET /events

  • Obtiene una lista de events según filtros.
  • Requiere un header de API key (X-API-KEY: {KEY}).

• GET /orders

  • Obtiene una lista de orders. Puede modificarse con opciones de filtrado como el tipo de order o con un maker o taker específico.

Puedes encontrar una lista completa de las llamadas y endpoints de la API de OpenSea aquí.

2. Herramientas de SDK

Las herramientas del SDK de OpenSea son un paquete npm disponible para desarrolladores web que buscan integrar funcionalidad de e-commerce en sus aplicaciones. A través de la librería JavaScript del SDK, puedes construir marketplaces nativos para la compra y venta de NFTs sin necesidad de desplegar smart contracts ni orderbooks de backend.

El SDK de OpenSea se apoya en la API REST que exploramos anteriormente, y emplea Web3.js (un paquete popular para interacciones con EVM) para impulsar las interacciones con la blockchain en la creación y el cumplimiento de órdenes de NFTs.

El SDK soporta funcionalidad como obtener assets, hacer ofertas, crear listados y vender ítems, ejecutar crowdsales, obtener orders, comprar ítems, aceptar ofertas, y transferir ítems o monedas (regalos).

También ofrece un conjunto avanzado de funcionalidades que incluye la capacidad de programar listados futuros, comprar ítems para otros usuarios, hacer transferencias masivas de NFTs, crear bundles de NFTs, usar tokens ERC-20 como pago en lugar de Ether, crear subastas privadas, compartir comisiones de venta con OpenSea, y escuchar events.

Es fácil de configurar (mediante npm install) y se integra de forma nativa con el exchange de OpenSea para crear y cumplir directamente órdenes de compra/venta.

Puedes instalar y explorar la funcionalidad de la librería JavaScript del SDK de OpenSea aquí.

Adopción de la comunidad y perspectivas

La plataforma de desarrollo de OpenSea ha tenido una adopción generalizada en toda la comunidad Web3. Está integrada en productos como Coinbase Wallet, MetaMask, Rainbow, 3Box, Opera Wallet, Trust Wallet, Editorial, Balance, CryptoGoods, y, más recientemente, Twitter, cuando agregó soporte para fotos de perfil con NFTs.

Esta dependencia casi generalizada del mercado en el índice centralizado de la API de OpenSea ha resultado ser problemática. En las últimas semanas, OpenSea ha atravesado una serie de "caídas de base de datos", y como resultado, varios servicios que dependen de las APIs de OpenSea no han podido mostrar NFTs. Aunque esto no afecta a los tokens subyacentes ni a la blockchain, resulta en tiempo de inactividad sostenido para todos los servicios de cara al usuario que dependen de datos de NFTs mientras dure la caída de OpenSea.

Estas caídas han generado más conversaciones sobre la falta de descentralización en los servicios del espacio de las NFTs, y en el ecosistema Web3 en general. En relación con esto, hay algunos proyectos en desarrollo que apuntan a distintos niveles de descentralización del índice de NFTs, pero todavía no hay actores completamente descentralizados en el mercado.

De todos modos, los eventos recientes indican que los desarrolladores deberían considerar todos los principales proveedores de API de NFTs antes de decidir si usar OpenSea.

Alternativas a OpenSea

Además de OpenSea, a continuación se detallan algunas de las APIs de NFTs más utilizadas y con más funcionalidades. Es importante notar que actualmente no hay ningún servicio que ofrezca un equivalente al SDK de OpenSea para la creación de marketplaces de NFTs y sus funcionalidades asociadas.

1. Alchemy NFT API

Alchemy, una plataforma de infraestructura de desarrollo Web3, anunció recientemente el lanzamiento de su NFT API, que permite acceder a metadata de NFTs tanto en ERC-721 como en ERC-1155, de forma muy similar a como lo hace OpenSea. Actualmente soporta el acceso a metadata de NFTs en múltiples blockchains, la búsqueda del propietario de una NFT, y actualizaciones de información en tiempo real, entre otras funcionalidades. La API de Alchemy está disponible en Mainnets para Ethereum, Polygon y Flow, con soporte planeado para otras, comenzando por Solana y Avalanche, y en Testnets para Ethereum y Polygon. Actualmente impulsa plataformas de NFTs como Adobe Behance, Shopify, Dapper Labs y SuperRare, entre otras.

Puedes leer más sobre la NFT API de Alchemy aquí y encontrar la documentación aquí.

2. NFT port

Otro proveedor de API de NFTs es NFTPort, una plataforma de infraestructura de NFTs, que soporta funcionalidades como:

• Acuñar NFTs en la chain de Polygon.
• Desplegar contracts compatibles con OpenSea con soporte para NFTs dinámicas, así como soporte planeado para la gestión programática de regalías.
• Indexado y cacheo en vivo de datos de NFTs, con datos de transacciones/órdenes on-chain.
• APIs más avanzadas que incluyen búsqueda multi-chain de NFTs, recomendaciones de NFTs, y detección de NFTs falsificadas.

Puedes leer más sobre NFTPort aquí y encontrar la documentación aquí.

3. Uniswap token lists

Para los desarrolladores a quienes les atrae la idea de un índice completamente descentralizado para datos de NFTs, las Token Lists de Uniswap actúan como un punto intermedio entre un nivel de centralización tipo OpenSea y colecciones de NFTs curadas de forma personal e ingresadas por usuarios individuales de la red en sus wallets. Con la solución de Uniswap, la comunidad puede reunirse para listar collections de NFTs, creando descentralización y agregando confianza al proceso de indexado.

Puedes leer más sobre el intento de Uniswap de descentralizar aún más las interfaces de NFTs aquí y crear tu propia lista de tokens aquí.

4. Indexado completamente descentralizado... ¿pronto?

En respuesta a las recientes caídas de OpenSea, Dan Finlay, uno de los fundadores de MetaMask, describió algunas alternativas a la dependencia centralizada de OpenSea aquí.

En su publicación, argumenta que: "una mejor solución es hacer que la detección de activos sea un acto de consentimiento centrado en el cliente".

A través de EIP-747, MetaMask ya permite que un sitio sugiera un activo personalizado a la wallet del usuario, convirtiendo a la wallet en el índice de activos, sin necesidad de un servidor central. Al parecer, MetaMask pretende expandir esta funcionalidad para incluir NFTs, creando un sistema completamente descentralizado que además mejora el rendimiento.

A medida que más y más APIs de NFTs de este tipo llegan al mercado, los desarrolladores cuentan con más y más opciones, no solo en cuanto al nivel de descentralización que mejor les conviene a ellos y a sus proyectos, sino también en cuanto a elegir el proveedor de estos servicios, lo que resulta en menos caídas a nivel de todo el mercado.

Reflexiones finales

La plataforma de desarrollo de OpenSea para NFTs es robusta, cuenta con muchas funcionalidades, y es fácil de desplegar y usar. Ofrece funcionalidades extensas de lectura y escritura de datos para desarrolladores que buscan entrar al espacio de las NFTs, ya sea que busquen interactuar directamente con smart contracts o no. Es el proveedor líder del mercado en servicios de API de NFTs, y con razón.

Si bien la API de OpenSea en sí es relativamente confiable, la dependencia generalizada de las herramientas de la empresa significa que, si falla, como en las últimas semanas, arrastrará con ella a gran parte del mercado de NFTs. Para reducir suficientemente el riesgo en este espacio, los desarrolladores deberían seguir explorando una variedad de opciones descentralizadas y centralizadas sobre las cuales construir sus proyectos, y los proveedores de infraestructura deberían trabajar para igualar y competir con el potente conjunto de funcionalidades de OpenSea.

Independientemente de la API que elijan los desarrolladores, el espacio de las NFTs avanza rápidamente hacia una adopción generalizada y una innovación sostenida a medida que el ecosistema y las herramientas en torno a esta clase de activos siguen creciendo. Nunca ha habido un mejor momento para empezar como desarrollador Web3.