Multichain Transfers API (Beta)のご紹介

最終更新日: 2026年11月4日1分で読めます

ウォレットやポートフォリオアプリは、オンチェーンで最も急速に成長しているカテゴリの1つです。暗号資産ウォレット市場は、2025年の$15.5Bから2033年には$100.8Bへ、年平均成長率26.6%で拡大する見込みです。Alchemyは、Zerion、Rainbow、Phantom、Trust Wallet、Coinbase Walletといった主要ウォレットの送金履歴と残高トラッキングを支えていることを誇りに思います。

こうしたチームが特によく使うメソッドの1つがalchemy_getAssetTransfersです。過去30日間に数万のチームが呼び出しており、リクエスト数ではData APIの中で2番目に多く使われています。チームはこのメソッドを使って、ウォレットのネイティブ、ERC-20、ERC-721、ERC-1155の送金履歴を取得し、アクティビティフィード、残高トラッキング、ポートフォリオビューを実現しています。

本日、この体験をアップグレードします。Multichain Transfers APIは、1つのウォレットの送金履歴を最大5つのネットワークにまたがって1回の呼び出しで返します。結果は統合済みで、時間順に並んでいます。

ベータ版として提供を開始しました。ぜひお試しください。

1回の呼び出しで、複数のチェーンに対応

これまでalchemy_getAssetTransfersでは、1回のリクエストで取得できるのは1つのネットワークでした。対応チェーンを増やすには、呼び出しを増やし、結果を自分で統合し、ネットワークの遅延やエラーにどう対処するかも決めなければなりません。

そこで、アップグレードしました。Multichain Transfers APIの主な4つの進化は次のとおりです。

1回の呼び出しでマルチチェーン。 ネットワークのリストを渡すと、blockTimestamp順に並んだ1つのリストが返ります。
両方向を同時にクエリ。 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
}'

レスポンスは、リクエストしたすべてのネットワークにまたがる1つの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は必須です。すべてのリクエストで、少なくとも1つ指定してください。

利用開始にあたって

Multichain Transfers APIは、POST /data/v1/{apiKey}/transfers/by-addressでベータ版として利用できます。ドキュメントのプレイグラウンドで、サインアップなしでお試しいただけます。上の例にご自身のAPIキーを入れて試すこともできます。既存のgetAssetTransfersの実装を新しいエンドポイントに移行すれば、ネットワークごとのループを省けます。