fetchTransfers
Query blockchain transfers by specifying block ranges, addresses, and filters to retrieve transaction details. Supports external, internal, and ERC20 transfers with pagination and metadata options.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | No | The category of transfers to query. e.g. "external" or "internal" | |
| contractAddresses | No | The contract addresses to query. e.g. ["0x1234567890123456789012345678901234567890"] | |
| excludeZeroValue | No | Whether to exclude zero value transfers. | |
| fromAddress | No | The wallet address to query the transfer was sent from. | |
| fromBlock | No | The block number to start the search from. e.g. "1234567890". Inclusive from block (hex string, int, latest, or indexed). | 0x0 |
| maxCount | No | The maximum number of results to return. e.g. "0x3E8". | 0xA |
| network | No | The blockchain network to query. e.g. "eth-mainnet" or "base-mainnet"). | eth-mainnet |
| order | No | The order of the results. e.g. "asc" or "desc". | asc |
| pageKey | No | The cursor to start the search from. Use this to paginate through the results. | |
| toAddress | No | The wallet address to query the transfer was sent to. | |
| toBlock | No | The block number to end the search at. e.g. "1234567890". Inclusive to block (hex string, int, latest, or indexed). | latest |
| withMetadata | No | Whether to include metadata in the results. |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"category": {
"default": [
"external",
"erc20"
],
"description": "The category of transfers to query. e.g. \"external\" or \"internal\"",
"items": {
"type": "string"
},
"type": "array"
},
"contractAddresses": {
"default": [],
"description": "The contract addresses to query. e.g. [\"0x1234567890123456789012345678901234567890\"]",
"items": {
"type": "string"
},
"type": "array"
},
"excludeZeroValue": {
"default": true,
"description": "Whether to exclude zero value transfers.",
"type": "boolean"
},
"fromAddress": {
"description": "The wallet address to query the transfer was sent from.",
"type": "string"
},
"fromBlock": {
"default": "0x0",
"description": "The block number to start the search from. e.g. \"1234567890\". Inclusive from block (hex string, int, latest, or indexed).",
"type": "string"
},
"maxCount": {
"default": "0xA",
"description": "The maximum number of results to return. e.g. \"0x3E8\".",
"type": "string"
},
"network": {
"default": "eth-mainnet",
"description": "The blockchain network to query. e.g. \"eth-mainnet\" or \"base-mainnet\").",
"type": "string"
},
"order": {
"default": "asc",
"description": "The order of the results. e.g. \"asc\" or \"desc\".",
"type": "string"
},
"pageKey": {
"description": "The cursor to start the search from. Use this to paginate through the results.",
"type": "string"
},
"toAddress": {
"description": "The wallet address to query the transfer was sent to.",
"type": "string"
},
"toBlock": {
"default": "latest",
"description": "The block number to end the search at. e.g. \"1234567890\". Inclusive to block (hex string, int, latest, or indexed).",
"type": "string"
},
"withMetadata": {
"default": false,
"description": "Whether to include metadata in the results.",
"type": "boolean"
}
},
"type": "object"
}