Multichain Transfers API (Beta)를 소개합니다

작성자: Alchemy

마지막 업데이트: 2026년 11월 4일2분 읽기

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

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

오늘 이 경험을 한 단계 업그레이드합니다. Multichain Transfers API는 하나의 지갑에 대한 전송 내역을 최대 5개 네트워크에 걸쳐 한 번의 호출로 반환하며, 결과는 이미 병합되어 시간순으로 정렬되어 있습니다.

지금 베타로 제공됩니다. 직접 사용해 보세요.

한 번의 호출로 여러 체인을

지금까지 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 배열이 포함됩니다.

직접 사용해 보기

bash

Copied

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도 함께 제공됩니다(가독성을 위해 일부 생략했습니다).

jsonCopied
{
"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개) 모두에서 사용할 수 있습니다(전체 목록). 내부 전송은 Ethereum, Base, Polygon, Arc(메인넷과 테스트넷)에서, 특수 NFT는 Ethereum에서 사용할 수 있습니다. 앞으로도 계속해서 네트워크를 추가해 나갈 예정입니다.

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

시작하기

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

alchemy_getAssetTransfers와 무엇이 다른가요?

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

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

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

Alchemy 뉴스레터

출시 소식을 가장 먼저 받아보세요

뉴스레터 구독하기

Alchemy의 최신 제품 업데이트와 리소스 받기

구독자 80,000명 이상

이메일 주소를 입력하면 마케팅 커뮤니케이션 및 제품 업데이트 수신에 동의하게 됩니다. Alchemy는 저희 개인정보 처리방침에 따라 수집한 정보를 처리합니다. 언제든지 구독을 취소할 수 있습니다.

Multichain Transfers API (Beta)를 소개합니다

한 번의 호출로 여러 체인을

직접 사용해 보기

시작하기

alchemy_getAssetTransfers와 무엇이 다른가요?

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

Alchemy 뉴스레터

뉴스레터 구독하기

관련 아티클

대시보드 AI 어시스턴트 출시

이달의 Alchemy: 10월호

HyperCore 스트리밍, Alchemy에서 얼리 액세스 시작