Apresentamos a Multichain Transfers API (Beta)

Carteiras e apps de portfólio estão entre as categorias de crescimento mais rápido onchain. O mercado de carteiras cripto deve crescer de $15.5B em 2025 para $100.8B em 2033, um CAGR de 26.6%. Temos orgulho de ajudar carteiras líderes como Zerion, Rainbow, Phantom, Trust Wallet e Coinbase Wallet a impulsionar o histórico de transferências e o acompanhamento de saldos.

Um dos métodos mais usados por essas equipes é o alchemy_getAssetTransfers. Dezenas de milhares de equipes o chamaram nos últimos 30 dias, o que o torna a segunda Data API mais usada por volume de requisições. As equipes o usam para obter o histórico de transferências nativas, ERC-20, ERC-721 e ERC-1155 de uma carteira e alimentar feeds de atividade, acompanhamento de saldos e visões de portfólio.

Hoje, estamos melhorando essa experiência: a Multichain Transfers API retorna o histórico de transferências de uma única carteira em até 5 redes com uma única chamada, já combinado e ordenado por tempo.

Ela já está disponível em beta: experimente você mesmo.

Uma chamada, várias chains

Hoje, chamar o alchemy_getAssetTransfers retorna uma rede por requisição. Escalar para mais chains significa multiplicar as chamadas, combinar os resultados por conta própria e decidir o que fazer quando uma rede está lenta ou retorna um erro.

Então nós o melhoramos. Quatro melhorias principais na nossa Multichain Transfers API:

• Várias chains em uma única chamada. Passe uma lista de redes e receba uma única lista, ordenada por blockTimestamp.
• Consulte nas duas direções ao mesmo tempo. Defina direction como to, from ou both e receba as transferências de entrada e de saída juntas.
• Filtragem por tempo. Filtre por fromTimestamp e toTimestamp em vez de números de bloco, e ordene os resultados por blockTimestamp com order (asc ou desc).
• Um formato de resposta mais limpo. Os valores de tokens ficam em fungible, os dados de NFT em nfts, blockTimestamp está sempre no nível superior, e contractAddress também, nas transferências de tokens e NFTs.

Se uma das redes que você pediu não retornar um resultado, a chamada ainda volta com um 200 e tudo o que foi carregado, além de um array error.partialErrors indicando o que falhou.

Experimente

A resposta é um único array transfers que abrange todas as redes que você pediu, da mais recente para a mais antiga, com um pageKey para buscar a próxima página (reduzida para facilitar a leitura):

Transferências nativas, ERC-20, ERC-721 e ERC-1155 funcionam em todas as 14 redes suportadas (11 mainnets e 3 testnets), incluindo Ethereum, Base, Polygon, Arbitrum, Optimism e BNB Chain (lista completa). Transferências internas estão disponíveis em Ethereum, Base, Polygon e Arc (mainnet e testnet), e NFTs especiais na Ethereum. Estamos adicionando mais redes o tempo todo.

Uma coisa importante: category é obrigatório, então passe pelo menos uma em cada requisição.

Como começar

A Multichain Transfers API já está em beta em POST /data/v1/{apiKey}/transfers/by-address. Experimente você mesmo no playground da documentação, sem precisar se cadastrar. Ou coloque a sua própria API key no exemplo acima e migre a sua integração atual do getAssetTransfers para o novo endpoint para eliminar o loop por rede.

Qual é a diferença em relação ao alchemy_getAssetTransfers?

O getAssetTransfers retorna as transferências de uma rede por chamada. A Multichain Transfers API recebe uma lista de até 5 redes e retorna uma única lista combinada e ordenada por tempo, em uma ou nas duas direções, em uma única requisição.

O que acontece se uma rede falhar?

Você ainda recebe uma resposta 200 com todas as transferências que foram carregadas com sucesso, além de um array error.partialErrors listando quais redes ou categorias não voltaram. Nada falha em silêncio e nada fica esperando pela rede mais lenta.