---
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)。我們很自豪能協助 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 個網路上的轉帳歷史，結果已合併並依時間排序。

它現已推出 beta 版：[立即試用](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 轉帳在全部 14 個支援的網路（11 個主網和 3 個測試網）上皆可使用，包括 Ethereum、Base、Polygon、Arbitrum、Optimism 和 BNB Chain（[完整清單](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 現已推出 beta 版，端點為 `POST /data/v1/{apiKey}/transfers/by-address`。你可以在[文件 playground](https://www.alchemy.com/docs/data/portfolio-apis/portfolio-api-endpoints/portfolio-api-endpoints/get-transfers-by-address) 中直接試用，無需註冊。也可以將你自己的 API key 填入上面的範例，並把現有的 `getAssetTransfers` 整合遷移到新端點，省去依網路逐一呼叫的迴圈。

### 它與 alchemy_getAssetTransfers 有什麼不同？

`getAssetTransfers` 每次呼叫只會回傳一個網路的轉帳。Multichain Transfers API 接收最多 5 個網路的清單，並在單次請求中回傳一份合併後、依時間排序的清單，可查詢單向或雙向轉帳。

### 如果某個網路失敗會怎樣？

你仍會收到 200 回應，其中包含所有成功載入的轉帳，以及一個 `error.partialErrors` 陣列，列出哪些網路或類別沒有回傳結果。不會有靜默失敗，也不會因為等待最慢的網路而被卡住。