Get Internal Transactions

Overview

The Get Internal Transactions endpoint obtains data on interactions with smart contracts by analyzing their internal transactions. At least one of the following parameters must be specified: contract, origin, sender, or sig_hash. The range should be defined by either block_number, timestamp, or block_hash. Internal transactions can be decoded and converted into a human-readable format when a smart contract's ABI is provided.

Use Cases

Several possible combinations of parameters should be considered, where origin refers to the address of an EOA wallet, contract is a smart contract's address, and sender represents either an EOA wallet's address or a smart contract's address. To retrieve specific details about internal transactions and their function calls, follow the guidelines below.

1. For calls of a particular function within a smart contract, specify both sig_hash and contract.

2. For calls of a particular function within multiple smart contracts triggered by another smart contract, specify both sig_hash and sender as a contract's address.

3. For calls of a particular function initiated by an EOA wallet, specify sig_hash and origin. Include contract to narrow your query to a specific smart contract.

4. For calls of a particular function within a smart contract triggered by another smart contract, specify sig_hash, contract, and sender.

5. For calls of a particular function on a smart contract triggered by another contract but initiated by an EOA wallet, specify sig_hash, contract, sender, and origin.

Usage

import * as Parsiq from '@parsiq/parsiq.js';
 
const client = Parsiq.createClient(process.env.API_KEY, Parsiq.ChainId.ETH_MAINNET);
 
const calls = client.internalTransactions.getByBlockRange(1, 'latest', {
    contract: ['0xdAC17F958D2ee523a2206206994597C13D831ec7'],
    sig_hash: ['0xa9059cbb'],
    sender: '0xc6cde7c39eb2f0f0095f41570af89efc2c1ea828',
    origin: '0x36928500bc1dcd7af6a2b4008875cc336b927d57'
});
 
for await (const call of calls) {
    console.log(call);
}

{
  id: '000000000046c771-0085-00000001',
  sender: '0xc6cde7c39eb2f0f0095f41570af89efc2c1ea828',
  sig_hash: '0xa9059cbb',
  tx_hash: '0x2c22ad3e367ee78da808ffec1e03a677ebb30703ce6c4a72eaf7a6c529580d93',
  block_hash: '0x25e8d1f5952a8387430629a5c94325749aacbd32f40061ab21b687300c3bf9d4',
  block_number: 4638577,
  timestamp: 1511883650,
  origin: '0x36928500bc1dcd7af6a2b4008875cc336b927d57',
  contract: '0xdac17f958d2ee523a2206206994597c13d831ec7',
  value: '0',
  input_data: '0xa9059cbb0000000000000000000000002b2c9153acc4021676c165dc3e3b1c7ad1c7849d000000000000000000000000000000000000000000000000000000000098968000000000000000000000000000000000000000000000000000000000'
}