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"
}

Alchemy MCP Server

fetchTransfers

Input Schema

Input Schema (JSON Schema)

Other Tools from Alchemy MCP Server

Related Tools

MCP directory API