💸 Transfers APITransfers Endpoints

alchemy_getAssetTransfers

The Transfers API allows you to easily fetch historical transactions for any address across Ethereum and supported L2s including Polygon, Arbitrum, and Optimism.

Path parameters

apiKeystringRequired

Request

This endpoint expects an object.
fromBlockstringRequired

Inclusive from block (hex string, int, ‘latest’, or ‘indexed’). Defaults to 0x0.

toBlockstringRequired

Inclusive to block (hex string, int, ‘latest’, or ‘indexed’). Defaults to ‘latest’.

fromAddressstringRequiredformat: "^0x[0-9a-fA-F]{40}$"

Hex string ‘from’ address. Default is wildcard (any address).

toAddressstringRequiredformat: "^0x[0-9a-fA-F]{40}$"

Hex string ‘to’ address. Default is wildcard (any address).

contractAddresseslist of stringsRequired

Filter for ERC20/721/1155 transfers by contract address. Defaults to wildcard (any address).

categorylist of enumsRequired

Array of transfer categories: external, internal, erc20, erc721, erc1155, specialnft.

orderenumRequired

Return results in ascending (asc) or descending (desc) order. Defaults to ‘asc’.

Allowed values:
withMetadatabooleanRequired

Include additional metadata about each transfer event. Defaults to false.

excludeZeroValuebooleanRequired

Whether to exclude transfers with zero value. Defaults to true.

maxCountstringRequired

Max hex string number of results to return per call. Defaults to 0x3e8 (1000).

pageKeystringRequired

UUID for pagination. If more results are available, use the pageKey returned in the response to fetch the next page.

Response

Returns the list of transfers, and a pageKey if additional results remain.

Alchemy Get Asset Transfers Result0string
OR
Alchemy Get Asset Transfers Result1object