---
updatedAt: 2025-09-18T22:05:49.000Z
agentTools:
  projectIndex: https://docs.nodereal.io/llms.txt
---

# debug_traceTransaction

Attempts to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it and will then attempt to execute the transaction that corresponds to the given hash.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "debug_traceTransaction",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://bsc-mainnet.nodereal.io/v1"
    }
  ],
  "paths": {
    "/{apiKey}": {
      "post": {
        "summary": "debug_traceTransaction",
        "description": "Attempts to run the transaction in the exact same manner as it was executed on the network. It will replay any transaction that may have been executed prior to this one before it and will then attempt to execute the transaction that corresponds to the given hash.",
        "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_traceTransaction",
                        "enum": [
                          "debug_traceTransaction"
                        ]
                      },
                      "params": {
                        "type": "array",
                        "minItems": 2,
                        "maxItems": 2,
                        "description": "1. String - Transaction hash\n2. Object - options for call, can be any of the following options:\n  - `tracer`: Object - Currently only supports `callTracer` (see above for definition).\n  - `timeout`: STRING - A duration string of decimal numbers that overrides the default timeout of 5 seconds for JavaScript-based tracing calls. Max timeout is \"10s\". Valid time units are \"ns\", \"us\", \"ms\", \"s\" each with optional fraction, such as \"300ms\" or \"2s45ms\". \n",
                        "items": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "Transaction hash",
                              "example": "0x8fc90a6c3ee3001cdcbbb685b4fbe67b1fa2bec575b15b0395fea5540d0901ae"
                            },
                            {
                              "type": "object",
                              "description": "options for call",
                              "properties": {
                                "tracer": {
                                  "type": "string",
                                  "default": "callTracer",
                                  "enum": [
                                    "callTracer"
                                  ]
                                },
                                "timeout": {
                                  "type": "string",
                                  "description": "A duration string of decimal numbers that overrides the default timeout of 5 seconds for JavaScript-based tracing calls. Max timeout is \"10s\". Valid time units are \"ns\", \"us\", \"ms\", \"s\" each with optional fraction, such as \"300ms\" or \"2s45ms\".",
                                  "example": "5s"
                                }
                              }
                            }
                          ]
                        }
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Returns - transaction trace",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "integer"
                        },
                        "jsonrpc": {
                          "type": "string"
                        }
                      }
                    },
                    {
                      "type": "object",
                      "properties": {
                        "result": {
                          "description": "trace for the transaction",
                          "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-tracetransaction"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```