--- updatedAt: 2026-05-27T08:58:24.000Z agentTools: projectIndex: https://docs.tatum.io/llms.txt --- # trace_block - Kaia The **trace_block** is a JSON-RPC method that allows you to fetch the trace details for a given block based on the block height. This method can be useful when you need detailed trace information for a specific block. Use cases for this method may include: - Analyzing the internal operations of transactions within a block - Debugging smart contract interactions - Collecting data for in-depth blockchain analytics # OpenAPI definition ```json { "openapi": "3.1.0", "info": { "title": "trace_block - Kaia", "version": "1.0" }, "servers": [ { "url": "https://{kaia-network}.gateway.tatum.io", "description": "RPC Gateway - Recommended", "variables": { "kaia-network": { "enum": [ "kaia-mainnet", "kaia-kairos", "klaytn-cypress", "klaytn-baobab" ], "default": "kaia-mainnet" } } }, { "url": "https://api.tatum.io/v3/blockchain/node/{kaia-network}", "description": "Deprecated", "variables": { "kaia-network": { "enum": [ "kaia-mainnet", "kaia-kairos", "klaytn-cypress", "klaytn-baobab" ], "default": "kaia-mainnet" } } } ], "x-sandbox": { "category": { "type": { "name": "category", "type": "string", "enum": [ "core", "bundler", "nft", "token", "transfers", "transaction-receipts", "gas-manager", "trace", "debug", "gas-optimized-transactions", "private-transactions", "notify", "transaction-simulation" ] }, "value": "core" } }, "paths": { "/": { "post": { "x-readme": { "samples-languages": [ "shell", "javascript", "python", "java", "php" ] }, "summary": "trace_block - Kaia", "description": "The **trace_block** is a JSON-RPC method that allows you to fetch the trace details for a given block based on the block height.\nThis method can be useful when you need detailed trace information for a specific block.\n\nUse cases for this method may include:\n\n- Analyzing the internal operations of transactions within a block\n- Debugging smart contract interactions\n- Collecting data for in-depth blockchain analytics\n", "tags": [], "requestBody": { "content": { "application/json": { "schema": { "allOf": [ { "type": "object", "properties": { "id": { "type": "integer", "default": 1 }, "jsonrpc": { "type": "string", "default": "2.0" } } }, { "type": "object", "properties": { "method": { "default": "trace_block", "type": "string" }, "params": { "type": "array", "minItems": 1, "maxItems": 1, "description": "Array of HEX String.\n
The following options are possible for the defaultBlock parameter.\n- An integer block number (in hex)\n- String 'earliest' for the earliest/genesis block. String 'latest' - for the latest mined block. String 'pending' - for the pending state/transactions.\n", "items": { "type": "string", "title": "Block Number or Tag", "description": "String - Either the hex value of a **block number** OR **block tags**:\n 1. **block number** (in hex) OR\n 2. **block tag** (one of the following):\n * `pending` (Not available on Ethereum) - 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.\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.\n * `earliest` - The lowest numbered block the client has available. Intuitively, you can think of this as the first block created.\n", "default": "finalized" }, "default": [ "latest" ] } } } ] } } } }, "responses": { "200": { "description": "Returns the trace details for the given block.", "content": { "application/json": { "schema": { "type": "object", "properties": { "output": { "type": "string" }, "stateDiff": { "type": "string" }, "trace": { "type": "array", "items": { "type": "object", "properties": { "action": { "type": "object", "properties": { "callType": { "type": "string" }, "from": { "type": "string" }, "gas": { "type": "string" }, "input": { "type": "string" }, "to": { "type": "string" }, "value": { "type": "string" } } }, "error": { "type": "string" }, "subtraces": { "type": "string" }, "traceAddress": { "type": "array", "items": { "type": "string" } }, "type": { "type": "string" } } } }, "vmTrace": { "type": "string" } }, "example": { "jsonrpc": "2.0", "result": [ { "action": { "callType": "call", "from": "0xaa7b131dc60b80d3cf5e59b5a21a666aa039c951", "gas": "0x0", "input": "0x", "to": "0xd40aba8166a212d6892125f079c33e6f5ca19814", "value": "0x4768d7effc3fbe" }, "blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add", "blockNumber": 3068185, "result": { "gasUsed": "0x0", "output": "0x" }, "subtraces": 0, "traceAddress": [], "transactionHash": "0x07da28d752aba3b9dd7060005e554719c6205c8a3aea358599fc9b245c52f1f6", "transactionPosition": 0, "type": "call" }, { "action": { "callType": "call", "from": "0x4f11ba23bb526c0486d83c6a8f18f632f3fc172a", "gas": "0x0", "input": "0x", "to": "0x7ed1e469fcb3ee19c0366d829e291451be638e59", "value": "0x446cde325fbfbe" }, "blockHash": "0x7eb25504e4c202cf3d62fd585d3e238f592c780cca82dacb2ed3cb5b38883add", "blockNumber": 3068185, "result": { "gasUsed": "0x0", "output": "0x" }, "subtraces": 0, "traceAddress": [], "transactionHash": "0x056f11efb5da4ff7cf8523cfcef08393e5dd2ff3ab3223e4324426d285d7ae92", "transactionPosition": 1, "type": "call" }, { "...": null } ], "id": 0 } } } } } }, "security": [ { "X-API-Key": [] } ], "operationId": "rpc-kaia-trace_block" } } }, "components": { "securitySchemes": { "X-API-Key": { "type": "apiKey", "name": "x-api-key", "in": "header", "description": "Your **API key** is used to identify your account & your plan, including the number of API calls per second and total monthly calls you have.\n\nEach key is for individual use only.\n\nIf you don't have a key already you can [Sign up for a Free Tatum account](https://co.tatum.io/signup) to get two keys (testnet and mainnet), allowing up to 5 API calls per second and 1,000,000 Credits.\n\nFor testing purposes, you can use the following key which only works inside docs and has limited functionality (e.g. you cannot create virtual accounts or notification subscriptions with it):\n* t-66a730ccccfd17001c479705-2f597d14ad7543f289a03418\n\nFor more details on limits and plans, [click here](https://docs.tatum.io/docs/plans-limits).\n" } } } } ```