evm_getswapsbywalletaddress
Retrieve all buy/sell swap transactions for a specific wallet address. Filter by token address, block range, or date for precise results.
Instructions
List all swap transactions (buy/sell) for a specific wallet. Optionally filter by tokenAddress for specific token swaps.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | The wallet address token-transactions are to be retrieved for. | |
| chain | No | The chain to query | eth |
| cursor | No | The cursor returned in the previous response (used for getting the next page). | |
| fromBlock | No | The minimum block number from which to get the token transactions * Provide the param 'from_block' or 'from_date' * If 'from_date' and 'from_block' are provided, 'from_block' will be used. | |
| fromDate | No | The start date from which to get the token transactions (format in seconds or datestring accepted by momentjs) * Provide the param 'from_block' or 'from_date' * If 'from_date' and 'from_block' are provided, 'from_block' will be used. | |
| limit | No | The desired page size of the result. | |
| order | No | The order of the result, in ascending (ASC) or descending (DESC) | DESC |
| toBlock | No | The block number to get the token transactions from | |
| toDate | No | The end date from which to get the token transactions (format in seconds or datestring accepted by momentjs) * Provide the param 'to_block' or 'to_date' * If 'to_date' and 'to_block' are provided, 'to_block' will be used. | |
| tokenAddress | No | The token address to get transaction for (optional) | |
| transactionTypes | No | Array of transaction types. Allowed values are 'buy', 'sell'. |
Input Schema (JSON Schema)
{
"properties": {
"address": {
"description": "The wallet address token-transactions are to be retrieved for.",
"type": "string"
},
"chain": {
"default": "eth",
"description": "The chain to query",
"enum": [
"eth",
"0x1",
"sepolia",
"0xaa36a7",
"polygon",
"0x89",
"bsc",
"0x38",
"bsc testnet",
"0x61",
"avalanche",
"0xa86a",
"fantom",
"0xfa",
"cronos",
"0x19",
"arbitrum",
"0xa4b1",
"chiliz",
"0x15b38",
"chiliz testnet",
"0x15b32",
"gnosis",
"0x64",
"gnosis testnet",
"0x27d8",
"base",
"0x2105",
"base sepolia",
"0x14a34",
"optimism",
"0xa",
"holesky",
"0x4268",
"polygon amoy",
"0x13882",
"linea",
"0xe708",
"moonbeam",
"0x504",
"moonriver",
"0x505",
"moonbase",
"0x507",
"linea sepolia",
"0xe705",
"flow",
"0x2eb",
"flow-testnet",
"0x221",
"ronin",
"0x7e4",
"ronin-testnet",
"0x7e5",
"lisk",
"0x46f",
"lisk-sepolia",
"0x106a",
"pulse",
"0x171"
],
"type": "string"
},
"cursor": {
"description": "The cursor returned in the previous response (used for getting the next page).",
"type": "string"
},
"fromBlock": {
"description": "The minimum block number from which to get the token transactions\n* Provide the param 'from_block' or 'from_date'\n* If 'from_date' and 'from_block' are provided, 'from_block' will be used.\n",
"minimum": 0,
"type": "number"
},
"fromDate": {
"description": "The start date from which to get the token transactions (format in seconds or datestring accepted by momentjs)\n* Provide the param 'from_block' or 'from_date'\n* If 'from_date' and 'from_block' are provided, 'from_block' will be used.\n",
"type": "string"
},
"limit": {
"description": "The desired page size of the result.",
"minimum": 0,
"type": "number"
},
"order": {
"default": "DESC",
"description": "The order of the result, in ascending (ASC) or descending (DESC)",
"enum": [
"ASC",
"DESC"
],
"type": "string"
},
"toBlock": {
"description": "The block number to get the token transactions from",
"type": "string"
},
"toDate": {
"description": "The end date from which to get the token transactions (format in seconds or datestring accepted by momentjs)\n* Provide the param 'to_block' or 'to_date'\n* If 'to_date' and 'to_block' are provided, 'to_block' will be used.\n",
"type": "string"
},
"tokenAddress": {
"description": "The token address to get transaction for (optional)",
"type": "string"
},
"transactionTypes": {
"description": "Array of transaction types. Allowed values are 'buy', 'sell'.",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
}