---
updatedAt: 2025-09-18T22:05:49.000Z
agentTools:
projectIndex: https://docs.nodereal.io/llms.txt
---
# debug_traceCall
Runs an eth_call within the context of the given block execution using the final state of parent block as the base.
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "debug_traceCall",
"version": "1.0"
},
"servers": [
{
"url": "https://bsc-mainnet.nodereal.io/v1"
}
],
"paths": {
"/{apiKey}": {
"post": {
"summary": "debug_traceCall",
"description": "Runs an eth_call within the context of the given block execution using the final state of parent block as the base.",
"tags": [],
"parameters": [
{
"name": "apiKey",
"in": "path",
"schema": {
"type": "string",
"default": "64a9df0874fb4a93b9d0a3849de012d3"
},
"required": true
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"default": 1
},
"jsonrpc": {
"type": "string",
"default": "2.0"
}
}
},
{
"type": "object",
"properties": {
"method": {
"type": "string",
"default": "debug_traceCall",
"enum": [
"debug_traceCall"
]
},
"params": {
"type": "array",
"minItems": 3,
"maxItems": 3,
"description": "1. Object - Transaction object\n2. String - Block hash, block number (in hex), or block tag \n3. `tracer` Object - Currently only supports `callTracer` (see above for definition).\n",
"items": {
"anyOf": [
{
"type": "object",
"description": "The transaction call object",
"properties": {
"from": {
"type": "string",
"description": "20 Bytes - The address the transaction is sent from."
},
"to": {
"type": "string",
"description": "20 Bytes - The address the transaction is directed to",
"example": "0xd46e8dd67c5d32be8058bb8eb970870f07244567"
},
"gasPrice": {
"type": "string",
"description": "Integer of the gasPrice used for each paid gas.\n
NOTE: most of our users (95%+) never set the gasPrice on eth_call.\n"
},
"value": {
"type": "string",
"description": "Integer of the value sent with this transaction"
},
"data": {
"type": "string",
"description": "Hash of the method signature and encoded parameters"
}
},
"required": [
"to"
]
},
{
"type": "string",
"description": "String - One of the following options:\n 1. **block hash** \n 2. **block number** (in hex)\n 3. **block tag** (one of the following): \n * `pending` - A sample next block built by the client on top of latest and containing the set of transactions usually taken from local mempool. Intuitively, you can think of these as blocks that have not been mined yet.\n * `latest` - The most recent block in the canonical chain observed by the client, this block may be re-orged out of the canonical chain even under healthy/normal conditions.\n * `safe` - The most recent crypto-economically secure block, cannot be re-orged outside of manual intervention driven by community coordination. Intuitively, this block is “unlikely” to be re-orged. **Only available on Ethereum Mainnet and Goerli**.\n * `finalized` - The most recent crypto-economically secure block, that has been accepted by >2/3 of validators. Cannot be re-orged outside of manual intervention driven by community coordination. Intuitively, this block is very unlikely to be re-orged. **Only available on Ethereum Mainnet and Goerli**.\n * `earliest` - The lowest numbered block the client has available. Intuitively, you can think of this as the first block created.\n",
"example": "finalized"
},
{
"type": "object",
"properties": {
"tracer": {
"type": "string",
"default": "callTracer",
"enum": [
"callTracer"
]
}
}
}
]
}
}
}
}
]
}
}
}
},
"responses": {
"200": {
"description": "Returns - Array of block traces",
"content": {
"application/json": {
"schema": {
"allOf": [
{
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"jsonrpc": {
"type": "string"
}
}
},
{
"type": "object",
"properties": {
"result": {
"type": "array",
"description": "Array of block traces",
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"description": "CALL or CREATE"
},
"from": {
"type": "string",
"description": "20 Bytes - address of the sender"
},
"to": {
"type": "string",
"description": "20 Bytes - address of the receiver. null when its a contract creation transaction"
},
"value": {
"type": "string",
"description": "amount of value for transfer (in hex)"
},
"gas": {
"type": "string",
"description": "amount of gas provided for the call (in hex)"
},
"gasUsed": {
"type": "string",
"description": "amount of gsa used during the call (in hex)"
},
"input": {
"type": "string",
"description": "call data"
},
"output": {
"type": "string",
"description": "return data"
},
"error": {
"type": "string",
"description": "error, if any"
},
"revertReason": {
"type": "string",
"description": "solidity revert reason, if any"
},
"calls": {
"type": "array",
"description": "list of sub-calls"
}
}
}
}
}
}
]
}
}
}
}
},
"operationId": "debug-tracecall"
}
}
},
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
}
}
```