---
title: "Apresentamos a Multichain Transfers API (Beta)"
description: "Obtenha o histórico de transferências de uma carteira em até 5 redes com uma única chamada, já combinado e ordenado por tempo."
datePublished: "2026-11-04"
dateModified: "2026-11-04T09:00:00-06:00"
---

# Apresentamos a Multichain Transfers API (Beta)

<ImageBlock
  src="https://media.alchemy.com/Alchemy-Multichain-transfers-API-(Beta).png"
  alt="Alchemy Multichain Transfers API (Beta)"
  width={3840}
  height={2160}
  priority
/>

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%](https://www.grandviewresearch.com/industry-analysis/crypto-wallet-market-report). 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](https://www.alchemy.com/docs/data/portfolio-apis/portfolio-api-endpoints/portfolio-api-endpoints/get-transfers-by-address) 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](https://www.alchemy.com/docs/data/portfolio-apis/portfolio-api-endpoints/portfolio-api-endpoints/get-transfers-by-address).

## 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

<CodeSnippet
  language="bash"
  code={`curl --request POST \\
  --url https://api.g.alchemy.com/data/v1/YOUR_API_KEY/transfers/by-address \\
  --header 'Content-Type: application/json' \\
  --data '{
    "address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "direction": "both",
    "networks": ["eth-mainnet", "base-mainnet", "matic-mainnet"],
    "fromTimestamp": "2026-08-01T00:00:00Z",
    "toTimestamp": "2026-08-06T00:00:00Z",
    "category": ["external", "erc20", "erc721", "erc1155"],
    "order": "desc",
    "maxCount": 100
  }'`}
/>

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):

<CodeSnippet
  language="json"
  code={`{
  "transfers": [
    {
      "network": "base-mainnet",
      "blockTimestamp": "2026-08-05T23:58:41Z",
      "category": "erc20",
      "from": "0x1f98abcd...",
      "to": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "contractAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "fungible": { "value": 250, "decimals": 6, "asset": "USDC" }
    },
    {
      "network": "eth-mainnet",
      "blockTimestamp": "2026-08-05T23:55:12Z",
      "category": "external",
      "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
      "to": "0x7a250d...",
      "fungible": { "value": 0.5, "decimals": 18, "asset": "ETH" }
    }
  ],
  "pageKey": "eyJ0cyI6..."
}`}
/>

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](https://www.alchemy.com/docs/data/portfolio-apis/portfolio-api-endpoints/portfolio-api-endpoints/get-transfers-by-address)). 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](https://www.alchemy.com/docs/data/portfolio-apis/portfolio-api-endpoints/portfolio-api-endpoints/get-transfers-by-address), 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.