Skip to main content
Retrieve all transactions sent to a specific address to track wallet activity, exchange flows, or smart contract interactions.

Use Case

Transaction queries help you:
  • Track incoming transactions to wallets or exchanges
  • Monitor smart contract interactions
  • Analyze transaction patterns
  • Build transaction history feeds

Code Example

curl --compressed -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "evm",
    "fromBlock": 18000000,
    "toBlock": 18010000,
    "fields": {
      "block": {
        "number": true,
        "timestamp": true
      },
      "transaction": {
        "hash": true,
        "from": true,
        "to": true,
        "value": true,
        "input": true,
        "gasUsed": true,
        "status": true
      }
    },
    "transactions": [{
      "to": ["0xdAC17F958D2ee523a2206206994597C13D831ec7"]
    }]
  }'
Try it yourself with the interactive query interface below:

Key Parameters

ParameterDescription
fromFilter transactions by sender address
toFilter transactions by recipient address
sighashFilter by function signature (first 4 bytes of input data)
statusTransaction status: 1 = success, 0 = failure
valueETH amount transferred (in wei)
inputTransaction calldata
gasUsedActual gas consumed

Expected Output

{
  "header": {
    "number": 18000123,
    "timestamp": 1697544779
  },
  "transactions": [
    {
      "hash": "0x123...",
      "from": "0xa9d1e08c7793af67e9d92fe308d5697fb81d3e43",
      "to": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "value": "0",
      "input": "0xa9059cbb000000000000000000000000...",
      "gasUsed": "54234",
      "status": 1
    }
  ]
}

Filter by Function Signature

Query only specific function calls (e.g., ERC-20 transfer function):
curl --compressed -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "evm",
    "fromBlock": 18000000,
    "toBlock": 18010000,
    "fields": {
      "transaction": {
        "hash": true,
        "from": true,
        "to": true,
        "input": true
      }
    },
    "transactions": [{
      "to": ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"],
      "sighash": ["0xa9059cbb"]
    }]
  }'
Function signature is computed as keccak256("transfer(address,uint256)")[0:4]. The result is 0xa9059cbb.

Monitor Outgoing Transactions

Track transactions from a specific wallet:
curl --compressed -X POST 'https://portal.sqd.dev/datasets/ethereum-mainnet/stream' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "evm",
    "fromBlock": 18000000,
    "toBlock": 18010000,
    "fields": {
      "transaction": {
        "hash": true,
        "from": true,
        "to": true,
        "value": true
      }
    },
    "transactions": [{
      "from": ["0x28C6c06298d514Db089934071355E5743bf21d60"]
    }]
  }'

Performance Tips

  1. Combine filters: Use both from and to for bidirectional tracking
  2. Filter by sighash: Reduces results to specific function calls
  3. Request minimal fields: Omit input if you don’t need calldata
  4. Check status: Filter failed transactions in post-processing if needed
Last modified on November 18, 2025