evm_getswapsbytokenaddress
Retrieve all buy and sell swap transactions for a specific ERC20 token across multiple blockchains. Customize results by chain, block range, date, transaction type, and pagination for detailed analysis.
Instructions
Get all swap transactions (buy/sell) for a specific ERC20 token.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | The token address to get transaction 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. | |
| transactionTypes | No | Array of transaction types. Allowed values are 'buy', 'sell'. |
Input Schema (JSON Schema)
{
"properties": {
"address": {
"description": "The token address to get transaction 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"
},
"transactionTypes": {
"description": "Array of transaction types. Allowed values are 'buy', 'sell'.",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
}