API Reference
Alchemy Login
Start typing to search…

alchemy_getAssetTransfers

post https://{network}.g.alchemy.com/v2/

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

Path Params
string
required
Defaults to docs-demo

For higher throughput, create your own API key

Body Params
integer
Defaults to 1
string
Defaults to 2.0
string
Defaults to alchemy_getAssetTransfers
params
array of objects
length between 1 and 1
params
string
Defaults to 0x0

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

string
Defaults to latest

String - Inclusive to block (hex string, int, latest, or indexed). Defaults to latest. Read more about block tags here

string

String - From address (hex string). Default wildcard - any address

string
Defaults to 0x5c43B1eD97e52d009611D89b74fA829FE4ac56b1

String - To address (hex string). Default wildcard - any address

contractAddresses
array of strings

String - List of contract addresses (hex strings) to filter for - only applies to "erc20", "erc721", "erc1155" transfers. Default wildcard - any address

contractAddresses
category
array of strings
required
length ≥ 1

'Array of categories, can be any of the following: "external", "internal", "erc20", "erc721", "erc1155", or "specialnft". See the table above for supported categories on each network.'

category*
string

String - Whether to return results in ascending (asc) or descending (desc) order. Ascending order is from oldest to newest transactions, descending order is from newest to oldest. Defaults to asc.

boolean
Defaults to false

Boolean - Whether or not to include additional metadata about each transfer event. Defaults to false.

boolean
Defaults to true

Boolean - A boolean to exclude transfers with zero value - zero value is not the same as null value. Defaults to true.

string
Defaults to 0x3e8

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

string

String - UUID for pagination. If more results are available, a uuid pageKey will be returned in the response. Pass that uuid into pageKey to fetch the next 1000 or maxCount.

Response

Response body
object
integer
string
result
object

An object with the following fields.

string

Uuid of next page of results (if exists, else blank).

transfers
array of objects

Array of objects - sorted in ascending order by block number, ties broken by category (external , internal, token transfers).

transfers
object
string

'external', 'internal', 'token', 'erc20', 'erc721', 'erc1155', 'specialnft' - label for the transfer.

string

The block where the transfer occurred (hex string).

string

From address of transfer (hex string).

string

To address of transfer (hex string). null if contract creation.

number | null

Converted asset transfer value as a number (raw value divided by contract decimal). null if ERC721 transfer or contract decimal not available.

string | null

(Deprecated) Legacy token ID field for ERC721 tokens (hex string). The tokenId field should be used instead.

array of objects | null

A list of objects containing the ERC1155 tokenId (hex string) and value (hex string). null if not an ERC1155 transfer.

erc1155Metadata
object
string
string
string

Token ID for ERC721 (or other NFT) tokens.

string | null

ETH or the token's symbol. null if not defined in the contract and not available from other sources.

string

A unique identifier for the transfer object.

string

Transaction hash (hex string).

rawContract
object
metadata
object

Updated about 2 months ago

Did this page help you?
Language
URL
Request
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 2 months ago

Did this page help you?
ReadMe
Support Hub