evm_getswapsbypairaddress
Retrieve swap transactions (buy, sell, add/remove liquidity) for a specific token pair by providing the pair address. Filter by chain, block range, date, transaction type, and paginate results for detailed analysis.
Instructions
Fetch swap transactions (buy, sell, add/remove liquidity) for a specific token pair.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | The pair 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 'fromBlock' or 'fromDate' * If 'fromDate' and 'fromBlock' are provided, 'fromBlock' 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 'fromBlock' or 'fromDate' * If 'fromDate' and 'fromBlock' are provided, 'fromBlock' 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 'toBlock' or 'toDate' * If 'toDate' and 'toBlock' are provided, 'toBlock' will be used. | |
| transactionTypes | No | Array of transaction types. Allowed values are 'buy', 'sell', 'addLiquidity', 'removeLiquidity'. |
Input Schema (JSON Schema)
{
"properties": {
"address": {
"description": "The pair 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 'fromBlock' or 'fromDate'\n* If 'fromDate' and 'fromBlock' are provided, 'fromBlock' 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 'fromBlock' or 'fromDate'\n* If 'fromDate' and 'fromBlock' are provided, 'fromBlock' 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 'toBlock' or 'toDate'\n* If 'toDate' and 'toBlock' are provided, 'toBlock' will be used.\n",
"type": "string"
},
"transactionTypes": {
"description": "Array of transaction types. Allowed values are 'buy', 'sell', 'addLiquidity', 'removeLiquidity'.",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
}