Skip to content
Alchemy Logo

Transfers By Wallet (Beta)

POST
https://api.g.alchemy.com/data/v1/{apiKey}/transfers/by-address

Beta: This endpoint is production-ready and fully supported. While it's in beta, the API may still change, including breaking changes.

Fetches historical transfers (native, ERC-20, ERC-721, ERC-1155, special NFT, and internal) for a single wallet address and multiple networks. Returns a list of transfers ordered by blockTimestamp. Supported on 14 EVM networks — see the networks request-body field for the enumerated list.

Note: the internal category is only supported on Ethereum Mainnet, Base Mainnet, Polygon Mainnet, Arc Mainnet, and Arc Testnet. The specialnft category is only supported on Ethereum Mainnet.

This endpoint fans out across every requested network and merges the results. A partially fulfilled request still returns HTTP 200 with every transfer that was retrieved successfully and a top-level error.partialErrors array. A partial error can apply to an entire network or to one unsupported category. If only a category is unsupported, transfers from other categories on the same network are still returned. Always process the transfers array even when error is present. See Handling partial failures for the recommended client pattern.

Path Parameters

stringrequireddefaults to docs-demo

For higher throughput, create your own API key

Request Body

Responses

200

Successful response!

400

Bad Request: Invalid input (e.g., malformed JSON).

429

Too Many Requests: Rate limit exceeded.

Was this page helpful?