Skip to main content
POST
https://api.blockdb.io
/
v1
/
evm
/
raw
/
internal-transactions
curl -X POST "https://api.blockdb.io/v1/evm/raw/internal-transactions" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "from_address": "0000000000000000000000000000000000000000",
  "to_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "call_types": ["CALL", "DELEGATECALL"],
  "tx_success": true,
  "limit": 250,
  "cursor": null
}'

{
  "meta": {
    "chain_id": 1,
    "request_window": {
      "from_block": 12345678,
      "to_block": 12345999,
      "from_timestamp": null,
      "to_timestamp": null
    },
    "filters": {
      "from_address": "0000000000000000000000000000000000000000",
      "to_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "call_types": ["CALL", "DELEGATECALL"],
      "tx_success": true,
      "limit": 250,
      "cursor": null
    }
  },
  "data": [
    {
      "block_number": 12345680,
      "block_time": "2025-10-29T00:01:23Z",
      "tx_index": 5,
      "trace_address": "0",
      "call_type": "CALL",
      "from_address": "0000000000000000000000000000000000000000",
      "to_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "value_wei": "1000000000000000000",
      "gas": "100000",
      "gas_used": "63546",
      "input": "a9059cbb000000000000000000000000...",
      "output": "0000000000000000000000000000000000000000000000000000000000000001",
      "error": null,
      "tx_success": true,
      "_tracing_id": "0111000000000000000000000000000000000001",
      "_created_at": "2025-11-11T18:42:15.123Z",
      "_updated_at": "2025-11-11T18:42:15.123Z"
    },
    {
      "block_number": 12345680,
      "block_time": "2025-10-29T00:01:23Z",
      "tx_index": 5,
      "trace_address": "0.1",
      "call_type": "DELEGATECALL",
      "from_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "to_address": "0000000000000000000000000000000000000001",
      "value_wei": "0",
      "gas": "72354",
      "gas_used": "23412",
      "input": "70a08231000000000000000000000000...",
      "output": "0000000000000000000000000000000000000000000000000de0b6b3a7640000",
      "error": null,
      "tx_success": true,
      "_tracing_id": "0111000000000000000000000000000000000002",
      "_created_at": "2025-11-11T18:42:15.123Z",
      "_updated_at": "2025-11-11T18:42:15.123Z"
    }
  ],
  "cursor": "next_page_cursor",
  "count": 2
}

​
Description

Retrieves internal transactions (call traces) produced by tracing executed transactions. Each record is one call frame: CALL, DELEGATECALL, STATICCALL, CREATE, or CREATE2, with value, gas, calldata, return data, and revert information. Use this endpoint for contract creation and factory flows, internal call graphs, value flow, debugging reverts, and MEV path reconstruction. Data corresponds to dataset 0111 and table blockdb_evm.b0111_internal_transactions_v1.

​
Parameters

​
chain_id
number
required
Target EVM network. See the Chain enumeration for supported values.

​
Range Filters (mutually exclusive)

​
from_block
number
Starting block number (inclusive) for the query. Use with to_block.
​
to_block
number
Ending block number (inclusive) for the query. Use with from_block.
​
from_timestamp
string
Starting timestamp (ISO-8601). If it falls between blocks, the next block after this timestamp is used. Use with to_timestamp.
​
to_timestamp
string
Ending timestamp (ISO-8601). If it falls between blocks, the last block before this timestamp is used. Use with from_timestamp.
Validation rule:
You must provide either a block range, a time range, or explicit selectors.
Providing more than one option (e.g., both ranges or ranges plus selectors) results in HTTP 400.
Providing none results in HTTP 400.

​
Direct Selectors

​
block_numbers
number[]
Explicit set of block numbers. Mutually exclusive with tx_hashes.
​
tx_hashes
string[]
Filter by parent transaction hash (hex string, 32 bytes, no 0x prefix). Returns all call traces for those transactions. Mutually exclusive with block_numbers.

​
Address & Type Filters

​
from_address
string
Filter by caller address (hex string, 20 bytes, no 0x prefix).
​
to_address
string
Filter by callee address (hex string, 20 bytes, no 0x prefix). Failed CREATE/CREATE2 may have null to_address and are excluded when this filter is present.
​
call_types
string[]
Filter by call type: CALL, DELEGATECALL, STATICCALL, CREATE, CREATE2. Omit to return all types.
​
tx_success
boolean
Filter by underlying transaction success (true = success, false = reverted). Omit to return traces for both.

​
Pagination Controls

​
limit
number
default:"250"
Recommended default 250; maximum 1000 to stay under ~10 MB responses.
​
cursor
string
Pagination cursor from a prior call.

​
Response Fields

​
Meta

​
meta
object
Echo of request metadata applied to the response.
​
meta.chain_id
number
EVM chain ID echoed from the request.
​
meta.request_window
object
Normalized block/timestamp bounds derived from the request.
​
meta.filters
object
Filter parameters echoed from the request (addresses, call_types, tx_success, pagination state, etc.).

​
Data

​
data
object[]
Array of internal transaction (call trace) records, ordered by block, tx index, and trace address.
​
data.block_number
number
Block number of the parent transaction.
​
data.block_time
string
UTC timestamp of the block (ISO-8601).
​
data.tx_index
number
Zero-based index of the parent transaction within the block.
​
data.trace_address
string
Position in the call tree (e.g. "0", "0.0", "0.1").
​
data.call_type
string
One of: CALL, DELEGATECALL, STATICCALL, CREATE, CREATE2.
​
data.from_address
string
Caller address (hex string, 20 bytes, no 0x prefix).
​
data.to_address
string | null
Callee address (hex string, 20 bytes); null for failed CREATE/CREATE2.
​
data.value_wei
string
Native value transferred in this call, in wei (string to preserve precision).
​
data.gas
string
Gas allocated for this call (string to preserve precision).
​
data.gas_used
string
Gas consumed by this call (string to preserve precision).
​
data.input
string | null
Calldata for this call (hex string, no 0x prefix); null when not applicable.
​
data.output
string | null
Return data from the call (hex string); null if the call reverted.
​
data.error
string | null
Error message if the call reverted; null otherwise.
​
data.tx_success
boolean
Whether the underlying transaction succeeded.
​
data._tracing_id
string
BlockDB lineage identifier (hex string, no 0x prefix).
​
data._created_at
string
Record creation timestamp, e.g. "2025-11-11T18:42:15.123Z".
​
data._updated_at
string
Last update timestamp in the same format.

​
Envelope Fields

​
cursor
string | null
Cursor token for pagination.
​
count
number
Number of records returned in data.
curl -X POST "https://api.blockdb.io/v1/evm/raw/internal-transactions" \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "from_address": "0000000000000000000000000000000000000000",
  "to_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "call_types": ["CALL", "DELEGATECALL"],
  "tx_success": true,
  "limit": 250,
  "cursor": null
}'

{
  "meta": {
    "chain_id": 1,
    "request_window": {
      "from_block": 12345678,
      "to_block": 12345999,
      "from_timestamp": null,
      "to_timestamp": null
    },
    "filters": {
      "from_address": "0000000000000000000000000000000000000000",
      "to_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "call_types": ["CALL", "DELEGATECALL"],
      "tx_success": true,
      "limit": 250,
      "cursor": null
    }
  },
  "data": [
    {
      "block_number": 12345680,
      "block_time": "2025-10-29T00:01:23Z",
      "tx_index": 5,
      "trace_address": "0",
      "call_type": "CALL",
      "from_address": "0000000000000000000000000000000000000000",
      "to_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "value_wei": "1000000000000000000",
      "gas": "100000",
      "gas_used": "63546",
      "input": "a9059cbb000000000000000000000000...",
      "output": "0000000000000000000000000000000000000000000000000000000000000001",
      "error": null,
      "tx_success": true,
      "_tracing_id": "0111000000000000000000000000000000000001",
      "_created_at": "2025-11-11T18:42:15.123Z",
      "_updated_at": "2025-11-11T18:42:15.123Z"
    },
    {
      "block_number": 12345680,
      "block_time": "2025-10-29T00:01:23Z",
      "tx_index": 5,
      "trace_address": "0.1",
      "call_type": "DELEGATECALL",
      "from_address": "c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "to_address": "0000000000000000000000000000000000000001",
      "value_wei": "0",
      "gas": "72354",
      "gas_used": "23412",
      "input": "70a08231000000000000000000000000...",
      "output": "0000000000000000000000000000000000000000000000000de0b6b3a7640000",
      "error": null,
      "tx_success": true,
      "_tracing_id": "0111000000000000000000000000000000000002",
      "_created_at": "2025-11-11T18:42:15.123Z",
      "_updated_at": "2025-11-11T18:42:15.123Z"
    }
  ],
  "cursor": "next_page_cursor",
  "count": 2
}