隆重推出 Multichain Transfers API (Beta)

最後更新：2026年11月4日1 分鐘閱讀

錢包和投資組合應用程式是鏈上成長最快的類別之一。加密錢包市場預計將從 2025 年的 $15.5B 成長到 2033 年的 $100.8B，複合年成長率為 26.6%。我們很自豪能協助 Zerion、Rainbow、Phantom、Trust Wallet 和 Coinbase Wallet 等領先錢包支撐其轉帳歷史與餘額追蹤功能。

這些團隊最常使用的方法之一是 alchemy_getAssetTransfers。過去 30 天內，有數萬個團隊呼叫過它，以請求量計算，它是使用量排名第二的 Data API。團隊用它來取得錢包的原生代幣、ERC-20、ERC-721 和 ERC-1155 轉帳歷史，並藉此支撐活動動態、餘額追蹤和投資組合檢視。

今天，我們升級了這項體驗：Multichain Transfers API 一次呼叫即可回傳單一錢包在最多 5 個網路上的轉帳歷史，結果已合併並依時間排序。

它現已推出 beta 版：立即試用。

一次呼叫，涵蓋多條鏈

過去，呼叫 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 轉帳在全部 14 個支援的網路（11 個主網和 3 個測試網）上皆可使用，包括 Ethereum、Base、Polygon、Arbitrum、Optimism 和 BNB Chain（完整清單）。內部轉帳支援 Ethereum、Base、Polygon 和 Arc（主網和測試網），特殊 NFT 支援 Ethereum。我們會持續新增更多網路。

有一點需要注意：category 為必填，因此每個請求都需要至少傳入一個。

開始使用

Multichain Transfers API 現已推出 beta 版，端點為 POST /data/v1/{apiKey}/transfers/by-address。你可以在文件 playground 中直接試用，無需註冊。也可以將你自己的 API key 填入上面的範例，並把現有的 getAssetTransfers 整合遷移到新端點，省去依網路逐一呼叫的迴圈。