Skip to main content
POST
/
evm
debug_traceBlockByNumber
curl --request POST \
  --url https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm \
  --header 'Content-Type: application/json' \
  --data '
{
  "jsonrpc": "2.0",
  "method": "debug_traceBlockByNumber",
  "params": [
    "0x1",
    {
      "tracer": "callTracer"
    }
  ],
  "id": 1
}
'
import requests

url = "https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm"

payload = {
    "jsonrpc": "2.0",
    "method": "debug_traceBlockByNumber",
    "params": ["0x1", { "tracer": "callTracer" }],
    "id": 1
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    jsonrpc: '2.0',
    method: 'debug_traceBlockByNumber',
    params: ['0x1', {tracer: 'callTracer'}],
    id: 1
  })
};

fetch('https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'jsonrpc' => '2.0',
    'method' => 'debug_traceBlockByNumber',
    'params' => [
        '0x1',
        [
                'tracer' => 'callTracer'
        ]
    ],
    'id' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm"

	payload := strings.NewReader("{\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"debug_traceBlockByNumber\",\n  \"params\": [\n    \"0x1\",\n    {\n      \"tracer\": \"callTracer\"\n    }\n  ],\n  \"id\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm")
  .header("Content-Type", "application/json")
  .body("{\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"debug_traceBlockByNumber\",\n  \"params\": [\n    \"0x1\",\n    {\n      \"tracer\": \"callTracer\"\n    }\n  ],\n  \"id\": 1\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"jsonrpc\": \"2.0\",\n  \"method\": \"debug_traceBlockByNumber\",\n  \"params\": [\n    \"0x1\",\n    {\n      \"tracer\": \"callTracer\"\n    }\n  ],\n  \"id\": 1\n}"

response = http.request(request)
puts response.read_body
{
  "jsonrpc": "<string>",
  "id": 123,
  "result": "<array>"
}
This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see Hyperliquid methods for the full availability breakdown.
The debug_traceBlockByNumber method returns detailed trace information for all transactions in a specific block identified by block number. This method provides comprehensive debugging information including call traces, gas usage, and execution details for each transaction.
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.

​
Parameters

  • blockNumber (string, required) — The block number in hexadecimal format (e.g., "0x1"), or one of the tags: "latest", "earliest", "pending".
  • tracerConfig (object, optional) — Tracer configuration:
    • tracer (string) — Tracer type ("callTracer" or "prestateTracer").

​
Response

The response is an array of trace objects, one per transaction in the block. With callTracer, each trace contains:
  • type (string) — Call type (e.g., "CALL", "DELEGATECALL").
  • from (string) — Sender address.
  • to (string) — Recipient address.
  • value (string) — Value transferred in wei (hex).
  • gas (string) — Gas provided (hex).
  • gasUsed (string) — Gas used (hex).
  • input (string) — Call input data.
  • output (string) — Call output data.

​
Example request

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "debug_traceBlockByNumber", "params": ["0x1", {"tracer": "callTracer"}], "id": 1}' \
  https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/evm

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("YOUR_CHAINSTACK_ENDPOINT"))

traces = w3.manager.request_blocking(
    "debug_traceBlockByNumber",
    ["0x1", {"tracer": "callTracer"}],
)

print(traces)

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("YOUR_CHAINSTACK_ENDPOINT");

const traces = await provider.send("debug_traceBlockByNumber", [
  "0x1",
  { tracer: "callTracer" },
]);

console.log(traces);

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("YOUR_CHAINSTACK_ENDPOINT"),
});

const traces = await client.request({
  method: "debug_traceBlockByNumber",
  params: ["0x1", { tracer: "callTracer" }],
});

console.log(traces);
Use your own endpoint in your code. The code examples use a placeholder Chainstack endpoint (YOUR_CHAINSTACK_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the Chainstack console. The curl above uses a shared public endpoint for quick checks only; do not use it in production.

​
Example response

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

​
Use case

The debug_traceBlockByNumber method is useful for:
  • Debugging all transactions in a specific block by number
  • Analyzing gas usage patterns across block transactions
  • Tracing internal calls and value transfers within a block
  • Building block explorers with detailed execution traces

Body

application/json
​
jsonrpc
enum<string>
default:2.0
required

JSON-RPC version

Available options:
2.0
​
method
enum<string>
default:debug_traceBlockByNumber
required

The RPC method name

Available options:
debug_traceBlockByNumber
​
params
array
required

Method parameters

​
id
integer
default:1
required

Request identifier

Response

200 - application/json

Successful response

​
jsonrpc
string
​
id
integer
​
result
array

Trace results

Last modified on June 24, 2026