Кошельки и приложения для работы с портфелями — одна из самых быстро растущих категорий в блокчейне. Рынок криптокошельков активно растет с $15.5B in 2025 to $100.8B by 2033, a 26.6% CAGR. Мы гордимся тем, что помогаем ведущим кошелькам, таким как Zerion, Rainbow, Phantom, Trust Wallet и Coinbase Wallet, обеспечивать работу их истории переводов и отслеживания балансов.
Один из наиболее часто используемых этими командами методов — alchemy_getAssetTransfers. Десятки тысяч команд вызывали его за последние 30 дней, что делает его вторым по популярности Data API по объему запросов. Команды используют его для получения истории нативных переводов, а также переводов ERC-20, ERC-721 и ERC-1155, чтобы обеспечивать работу лент активности, отслеживания балансов и представлений портфеля.
Сегодня мы выводим этот опыт на новый уровень: API мульitichain-переводов возвращает историю переводов одного кошелька по 5 сетям за один вызов, уже объединенную и отсортированную по времени.
Он уже доступен в бета-версии: попробуйте его сами.
Один вызов, несколько сетей
Сегодня вызов alchemy_getAssetTransfers возвращает одну сеть за запрос. Масштабирование на большее количество сетей означает умножение вызовов, самостоятельное объединение результатов и принятие решений о том, что делать, если одна сеть работает медленно или возвращает ошибку.
Поэтому мы усовершенствовали его. Четыре ключевых улучшения в нашем API мультичейн-переводов:
- Мультичейн за один вызов. Передайте список сетей и получите один список, упорядоченный по blockTimestamp.
- Запросы в обоих направлениях одновременно. Установите направление в to, from или both и получайте входящие и исходящие переводы вместе.
- Фильтрация по времени. Фильтруйте по fromTimestamp и toTimestamp вместо номеров блоков и сортируйте результаты по blockTimestamp с помощью порядка (asc или desc).
- Более чистая структура ответа. Суммы токенов находятся в fungible, данные NFT — в nfts, blockTimestamp всегда находится на верхнем уровне, как и contractAddress для переводов токенов и NFT.
Если одна из запрошенных сетей не возвращает результат, вызов все равно возвращает 200 и все, что удалось загрузить, а также массив error.partialErrors, в котором указано, что именно не удалось выполнить.
Попробовать
bash
Скопировано
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 }'
Ответ представляет собой один массив переводов, охватывающий все запрошенные вами сети, начиная с самых свежих, с pageKey для получения следующей страницы (сокращено для удобочитаемости):
json
Скопировано
{ "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 является обязательным, поэтому передавайте хотя бы одну категорию в каждом запросе.
Начать работу
API мультичейн-переводов теперь находится в бета-версии по адресу POST /data/v1/{apiKey}/transfers/by-address. Попробуйте его самостоятельно в песочнице документации, регистрация не требуется. Или подставьте свой собственный API-ключ в приведенный выше пример и перенесите существующую интеграцию getAssetTransfers на новый эндпоинт, чтобы избавиться от цикла по каждой сети.
Чем это отличается от alchemy_getAssetTransfers?
getAssetTransfers возвращает переводы для одной сети за один вызов. API мультичейн-переводов принимает список из максимум 5 сетей и возвращает один объединенный, отсортированный по времени список в одном или обоих направлениях за один запрос.
Что произойдет, если одна из сетей завершится с ошибкой?
Вы все равно получите ответ 200 со всеми переводами, которые загрузились успешно, а также массив error.partialErrors, перечисляющий сети или категории, которые не вернулись. Ничего не падает молча, и ничто не блокируется из-за самой медленной сети.
