Internal Transactions API
Get Internal Transactions

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.

📘️

Multiple values can be set for the contract and sig_hash parameters, with a maximum of five items each.

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.

📘️

When using decoding, the output will include a decoded object with the function name, its parameters and values.

Usage

In this example, we receive all internal transactions on the contract 0xdAC17F958D2ee523a2206206994597C13D831ec7, triggered by the sender 0xc6cde7c39eb2f0f0095f41570af89efc2c1ea828, initiated by the EOA wallet's address 0x36928500bc1dcd7af6a2b4008875cc336b927d57 specified as origin. The internal transactions are filtered by the signature hash of the executeTransaction function 0xa9059cbb. The block range is set from block 1 to latest.

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);
}

Output:

{
  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'
}

Parameters

Path params
chainId
string
REQUIRED
version
string
REQUIRED
Query params
block_number_start
string
number
REQUIRED
block_number_end
string
number
REQUIRED
origin
string
OR
contract
string
array of strings
OR
sig_hash
string
array of strings
OR
sender
string
include_events
boolean
offset
string
limit
number
estimate_cu
boolean