---
title: "Multichain Transfers API (Beta)를 소개합니다"
description: "지갑의 전송 내역을 최대 5개 네트워크에 걸쳐 한 번의 호출로 가져오세요. 결과는 이미 병합되어 시간순으로 정렬됩니다."
datePublished: "2026-11-04"
dateModified: "2026-11-04T09:00:00-06:00"
---

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

지갑과 포트폴리오 앱은 온체인에서 가장 빠르게 성장하는 카테고리 중 하나입니다. 암호화폐 지갑 시장은 [2025년 $15.5B에서 2033년 $100.8B로, 연평균 26.6% 성장할 전망입니다](https://www.grandviewresearch.com/industry-analysis/crypto-wallet-market-report). Alchemy는 Zerion, Rainbow, Phantom, Trust Wallet, Coinbase Wallet과 같은 대표 지갑들이 전송 내역과 잔액 추적 기능을 구현하도록 돕고 있다는 점이 자랑스럽습니다.

이런 팀들이 가장 많이 사용하는 메서드 중 하나는 `alchemy_getAssetTransfers`입니다. 지난 30일 동안 수만 개의 팀이 이 메서드를 호출했으며, 요청 수 기준으로 두 번째로 많이 사용된 Data API입니다. 팀들은 이 메서드로 지갑의 네이티브, ERC-20, ERC-721, ERC-1155 전송 내역을 가져와 활동 피드, 잔액 추적, 포트폴리오 뷰를 구현합니다.

오늘 이 경험을 한 단계 업그레이드합니다. [Multichain Transfers API](https://www.alchemy.com/docs/data/portfolio-apis/portfolio-api-endpoints/portfolio-api-endpoints/get-transfers-by-address)는 하나의 지갑에 대한 전송 내역을 최대 5개 네트워크에 걸쳐 한 번의 호출로 반환하며, 결과는 이미 병합되어 시간순으로 정렬되어 있습니다.

지금 베타로 제공됩니다. [직접 사용해 보세요](https://www.alchemy.com/docs/data/portfolio-apis/portfolio-api-endpoints/portfolio-api-endpoints/get-transfers-by-address).

## 한 번의 호출로 여러 체인을

지금까지 `alchemy_getAssetTransfers`는 요청 한 번에 네트워크 하나만 조회할 수 있었습니다. 더 많은 체인으로 확장하려면 호출 횟수를 늘리고, 결과를 직접 병합하고, 네트워크 하나가 느리거나 오류를 반환할 때의 처리 방식까지 정해야 했습니다.

그래서 업그레이드했습니다. Multichain Transfers API의 네 가지 핵심 개선 사항은 다음과 같습니다.

- **한 번의 호출로 멀티체인.** 네트워크 목록을 전달하면 `blockTimestamp` 순으로 정렬된 하나의 목록을 받을 수 있습니다.
- **양방향을 동시에 조회.** `direction`을 `to`, `from`, `both` 중 하나로 설정하면 수신과 송신 전송 내역을 함께 가져옵니다.
- **시간 기반 필터링.** 블록 번호 대신 `fromTimestamp`와 `toTimestamp`로 필터링하고, `order`(`asc` 또는 `desc`)로 `blockTimestamp` 기준 정렬 방향을 정할 수 있습니다.
- **더 깔끔한 응답 구조.** 토큰 수량은 `fungible`에, NFT 데이터는 `nfts`에 담기고, `blockTimestamp`는 항상 최상위에 있습니다. 토큰 및 NFT 전송의 `contractAddress`도 마찬가지입니다.

요청한 네트워크 중 하나가 결과를 반환하지 못하더라도, 호출은 200 응답과 함께 불러온 모든 데이터를 돌려주며, 실패한 항목을 알려주는 `error.partialErrors` 배열이 포함됩니다.

## 직접 사용해 보기

<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
  }'`}
/>

응답은 요청한 모든 네트워크를 아우르는 하나의 `transfers` 배열이며, 최신순으로 정렬됩니다. 다음 페이지를 가져올 수 있는 `pageKey`도 함께 제공됩니다(가독성을 위해 일부 생략했습니다).

<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..."
}`}
/>

네이티브, ERC-20, ERC-721, ERC-1155 전송은 Ethereum, Base, Polygon, Arbitrum, Optimism, BNB Chain을 포함해 지원되는 14개 네트워크(메인넷 11개, 테스트넷 3개) 모두에서 사용할 수 있습니다([전체 목록](https://www.alchemy.com/docs/data/portfolio-apis/portfolio-api-endpoints/portfolio-api-endpoints/get-transfers-by-address)). 내부 전송은 Ethereum, Base, Polygon, Arc(메인넷과 테스트넷)에서, 특수 NFT는 Ethereum에서 사용할 수 있습니다. 앞으로도 계속해서 네트워크를 추가해 나갈 예정입니다.

알아두실 점이 하나 있습니다. `category`는 필수이므로 모든 요청에 최소 하나를 전달해야 합니다.

## 시작하기

Multichain Transfers API는 `POST /data/v1/{apiKey}/transfers/by-address`에서 베타로 제공됩니다. [문서 플레이그라운드](https://www.alchemy.com/docs/data/portfolio-apis/portfolio-api-endpoints/portfolio-api-endpoints/get-transfers-by-address)에서 가입 없이 직접 사용해 볼 수 있습니다. 또는 위 예시에 본인의 API 키를 넣어 실행해 보고, 기존 `getAssetTransfers` 연동을 새 엔드포인트로 마이그레이션해 네트워크별 반복 호출을 없애 보세요.

### alchemy_getAssetTransfers와 무엇이 다른가요?

`getAssetTransfers`는 호출 한 번에 네트워크 하나의 전송 내역을 반환합니다. Multichain Transfers API는 최대 5개 네트워크의 목록을 받아, 병합되고 시간순으로 정렬된 하나의 목록을 한쪽 방향 또는 양방향으로 단일 요청에 반환합니다.

### 네트워크 하나가 실패하면 어떻게 되나요?

성공적으로 불러온 모든 전송 내역과 함께 200 응답을 받게 되며, 어떤 네트워크나 카테고리의 결과가 오지 않았는지 알려주는 `error.partialErrors` 배열도 포함됩니다. 조용히 실패하는 일은 없고, 가장 느린 네트워크를 기다리느라 멈추는 일도 없습니다.