“Hola, mundo” en OpenSea

Consultar los NFTs asociados a una billetera o colección utilizando la API v2 de OpenSea mediante Python y cURL.

📋 Copiar

# Usando Python y requests con la API v2 de OpenSea
import requests

api_key = "TU_OPENSEA_API_KEY"
wallet_address = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
chain = "matic"  # 'ethereum', 'matic', 'arbitrum', etc.

url = f"https://api.opensea.io/api/v2/chain/{chain}/account/{wallet_address}/nfts?limit=10"
headers = {
    "accept": "application/json",
    "x-api-key": api_key,
    "User-Agent": "Mozilla/5.0"
}

response = requests.get(url, headers=headers)
data = response.json()

for nft in data.get("nfts", []):
    print(f"NFT: {nft.get('name')} | Contrato: {nft.get('contract')}")

Resultado:

Output

NFT: Cromy® NFT Genesis (1982) Letter M | Contrato: 0x2953399124f0cbb46d2cbacd8a89cf0599974963
NFT: Cromy® NFT Genesis (1982) Letter O | Contrato: 0x2953399124f0cbb46d2cbacd8a89cf0599974963
NFT: Cromy® NFT Genesis (1982) Letter R | Contrato: 0x2953399124f0cbb46d2cbacd8a89cf0599974963

Comandos básicos

Familiarizarse con estos comandos es esencial para interactuar eficientemente con OpenSea:

Consultar NFTs por Billetera (v2)
📋 Copiar
```
curl -X GET "https://api.opensea.io/api/v2/chain/matic/account/0xWallet/nfts" -H "x-api-key: TU_KEY"
```
Obtiene la lista de NFTs que posee una cuenta en una cadena específica (Ethereum, Polygon, Arbitrum, etc.).
Consultar Metadata de un Token Específico
📋 Copiar
```
curl -X GET "https://api.opensea.io/api/v2/chain/matic/contract/0xContrato/nfts/TOKEN_ID" -H "x-api-key: TU_KEY"
```
Recupera los atributos detallados, imagen de alta resolución y creador de un NFT concreto.
Consultar Información de una Colección
📋 Copiar
```
curl -X GET "https://api.opensea.io/api/v2/collections/SLUG_COLECCION" -H "x-api-key: TU_KEY"
```
Devuelve estadísticas globales, volumen, precio piso (floor price) y redes soportadas de la colección.
Consultar Eventos de Transferencias y Ventas
📋 Copiar
```
curl -X GET "https://api.opensea.io/api/v2/events/chain/ethereum/contract/0xContrato?event_type=sale" -H "x-api-key: TU_KEY"
```
Monitorea las ventas y transferencias recientes de una colección en tiempo real.

Conceptos Clave

Comprender estos conceptos fundamentales te ayudará a dominar OpenSea de forma más organizada y eficiente:

API v2 Multichain:

Nueva versión unificada de OpenSea que estandariza la interacción con contratos ERC-721 y ERC-1155 en Ethereum, Polygon, Arbitrum, Optimism, Base y Avalanche.
CDN de Imágenes Resiliente (seadn.io):

OpenSea indexa y aloja en su propio CDN réplicas cacheadas en formatos optimizados (WebP, PNG) de imágenes originalmente almacenadas en IPFS, Arweave o servidores privados.
Seaport Protocol:

El protocolo de smart contracts de código abierto desarrollado por OpenSea para la compra, venta e intercambio seguro y eficiente de tokens y activos digitales.
Metadata Descentralizada vs Centralizada:

Estructura JSON estándar de atributos, rasgos (traits) y enlaces de imagen que definen las características visuales y lógicas de cada NFT.

Casos de uso

Algunos ejemplos de aplicaciones prácticas donde se utiliza OpenSea:

Galerías Web3 y Portafolios Personales:

Conectar billeteras MetaMask u otras wallets y desplegar de forma instantánea todos los coleccionables, badges y activos del usuario con imágenes de carga rápida.
Monitoreo de Precios Piso y Volúmenes de Trading:

Automatizar bots y dashboards de análisis financiero de colecciones para seguir el valor de mercado en USDT o criptomonedas nativas.
Sistemas de Token-Gating y Acceso Exclusivo:

Verificar si una dirección posee un NFT específico o membresía de una colección para habilitar funciones exclusivas en una aplicación web.

Consejos para Principiantes

Aquí tienes algunas recomendaciones para facilitar tus inicios en OpenSea:

Especificar siempre el parámetro chain correcto:

En la API v2 de OpenSea, asegúrate de utilizar el slug de red exacto (ej: "matic" para Polygon, "ethereum" para Mainnet, "arbitrum" para Arbitrum One).
Manejar la paginación mediante el token next:

Cuando una cuenta posee muchos NFTs, OpenSea divide las respuestas mediante el campo "next". Pásalo como "&next=VALOR" en solicitudes consecutivas.
Respaldo con User-Agent:

Al hacer consultas HTTP a endpoints públicos de OpenSea, incluye siempre una cabecera User-Agent estándar para evitar bloqueos preventivos por Cloudflare.

Herramientas relacionadas

Si te interesa OpenSea, también podrías explorar estas herramientas:

Recursos útiles

Amplía tus conocimientos con estos enlaces y materiales:

También te puede interesar

Continúa aprendiendo con estos contenidos relacionados: