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.
categorylist of enumsRequired

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

fromBlockstringOptionalDefaults to 0x0

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

toBlockstringOptionalDefaults to latest

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

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

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

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

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

contractAddresseslist of stringsOptional

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

orderenumOptional

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

Allowed values:
withMetadatabooleanOptionalDefaults to false

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

excludeZeroValuebooleanOptionalDefaults to true

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

maxCountstringOptionalDefaults to 0x3e8

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

pageKeystringOptional

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.

string
OR
object