Presentamos la Multichain Transfers API (Beta)

Las wallets y las apps de portafolio son una de las categorías de más rápido crecimiento onchain. Se espera que el mercado de wallets cripto crezca de $15.5B en 2025 a $100.8B en 2033, una CAGR del 26.6 %. Nos enorgullece ayudar a wallets líderes como Zerion, Rainbow, Phantom, Trust Wallet y Coinbase Wallet a impulsar su historial de transferencias y el seguimiento de balances.

Uno de los métodos más usados por estos equipos es alchemy_getAssetTransfers. Decenas de miles de equipos lo llamaron en los últimos 30 días, lo que lo convierte en la segunda Data API más usada por volumen de solicitudes. Los equipos lo usan para obtener el historial de transferencias nativas, ERC-20, ERC-721 y ERC-1155 de una wallet, y para alimentar feeds de actividad, seguimiento de balances y vistas de portafolio.

Hoy mejoramos esa experiencia: la Multichain Transfers API devuelve el historial de transferencias de una sola wallet en hasta 5 redes con una sola llamada, ya combinado y ordenado por tiempo.

Ya está disponible en beta: pruébala por tu cuenta.

Una llamada, varias cadenas

Hoy, llamar a alchemy_getAssetTransfers te da una red por solicitud. Escalar a más cadenas significa multiplicar las llamadas, combinar los resultados tú mismo y decidir qué hacer cuando una red es lenta o devuelve un error.

Así que lo mejoramos. Cuatro mejoras clave en nuestra Multichain Transfers API:

• Varias cadenas en una sola llamada. Pasa una lista de redes y recibe una sola lista, ordenada por blockTimestamp.
• Consulta en ambas direcciones a la vez. Configura direction como to, from o both y obtén las transferencias entrantes y salientes juntas.
• Filtrado por tiempo. Filtra con fromTimestamp y toTimestamp en lugar de números de bloque, y ordena los resultados por blockTimestamp con order (asc o desc).
• Una estructura de respuesta más limpia. Los montos de tokens están en fungible, los datos de NFT en nfts, blockTimestamp siempre está en el nivel superior, y también contractAddress en las transferencias de tokens y NFT.

Si una de las redes que pediste no devuelve un resultado, la llamada igual responde con un 200 y todo lo que sí se cargó, además de un arreglo error.partialErrors que indica qué falló.

Pruébalo

La respuesta es un solo arreglo transfers que abarca todas las redes que pediste, de la más reciente a la más antigua, con un pageKey para obtener la siguiente página (recortada para facilitar la lectura):

Las transferencias nativas, ERC-20, ERC-721 y ERC-1155 funcionan en las 14 redes admitidas (11 mainnets y 3 testnets), incluidas Ethereum, Base, Polygon, Arbitrum, Optimism y BNB Chain (lista completa). Las transferencias internas están disponibles en Ethereum, Base, Polygon y Arc (mainnet y testnet), y los NFT especiales en Ethereum. Estamos agregando más redes constantemente.

Algo que debes saber: category es obligatorio, así que pasa al menos una en cada solicitud.

Cómo empezar

La Multichain Transfers API ya está en beta en POST /data/v1/{apiKey}/transfers/by-address. Pruébala por tu cuenta en el playground de la documentación, sin necesidad de registrarte. O coloca tu propia API key en el ejemplo anterior y migra tu integración actual de getAssetTransfers al nuevo endpoint para eliminar el bucle por red.

¿En qué se diferencia de alchemy_getAssetTransfers?

getAssetTransfers devuelve las transferencias de una red por llamada. La Multichain Transfers API recibe una lista de hasta 5 redes y devuelve una sola lista combinada y ordenada por tiempo, en una dirección o en ambas, en una sola solicitud.

¿Qué pasa si falla una red?

Igual recibes una respuesta 200 con todas las transferencias que se cargaron correctamente, además de un arreglo error.partialErrors que indica qué redes o categorías no respondieron. Nada falla en silencio y nada se bloquea esperando a la red más lenta.