Execute a call and return requested traces

POST

https://eth-archive.nownodes.io/

Executes the given transaction call locally and returns the requested trace outputs. The transaction object omits nonce, the trace type array can include trace, vmTrace, and stateDiff, and optional block, state override, and block override parameters can be supplied.

Body

application/json

Request payload for trace_call.

jsonrpcstring2.0required

JSON-RPC protocol version.

methodstringtrace_callrequired

JSON-RPC method name.

idinteger | stringrequired

Client-provided JSON-RPC request identifier. The same value is returned in the response.

Parameters: transaction object, trace types, optional block identifier, optional state overrides, optional block overrides.

Show child attributes

trace_call positional parameter.

One of

fromstring

Optional sender address used as the caller for the traced transaction.

tostring

Optional recipient address or contract address. Omit for contract creation calls.

gasstring

Optional gas limit encoded as a hexadecimal quantity.

gasPricestring

Optional gas price encoded as a hexadecimal quantity.

valuestring

Optional amount of wei to transfer, encoded as a hexadecimal quantity.

datastring

Optional input data for the call, encoded as hex bytes.

inputstring

Optional alias for call data, encoded as hex bytes.

Array<TraceType>tracevmTracestateDiff

Ethereum block identifier accepted by the trace API.

One of

Block number encoded as a hexadecimal quantity, or a 32-byte block hash depending on method context.

string

Named Ethereum block tag.

stringlatestearliestpendingsafefinalized

Map of account addresses to temporary account-state overrides used for the trace.

StateOverrides

numberstring

Overridden block number encoded as a hexadecimal quantity.

timestampstring

Overridden block timestamp encoded as a hexadecimal quantity.

baseFeestring

Overridden base fee per gas encoded as a hexadecimal quantity.

gasLimitstring

Overridden block gas limit encoded as a hexadecimal quantity.

coinbasestring

Overridden block coinbase address.

Response

200OK

Successful JSON-RPC response or JSON-RPC method error.

400Bad Request

Invalid HTTP request body or malformed JSON-RPC payload.

401Unauthorized

Missing or invalid API key.

500Internal Server Error

Internal server error.

Execute a call and return requested traces

curl -X POST 'https://eth-archive.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "trace_call",
    "id": 1,
    "params": [
      {
        "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
        "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
        "value": "0x186a0"
      },
      [
        "trace"
      ],
      "latest"
    ]
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://eth-archive.nownodes.io/");
const result = await provider.send("trace_call", [
  {
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    "value": "0x186a0"
  },
  [
    "trace"
  ],
  "latest"
]);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://eth-archive.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "trace_call",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
      "value": "0x186a0"
    },
    [
      "trace"
    ],
    "latest"
  ],
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://eth-archive.nownodes.io/"))
response = w3.provider.make_request("trace_call", [
  {
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    "value": "0x186a0"
  },
  [
    "trace"
  ],
  "latest"
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://eth-archive.nownodes.io/"),
});

const result = await client.request({
  method: "trace_call",
  params: [
  {
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    "value": "0x186a0"
  },
  [
    "trace"
  ],
  "latest"
],
});

console.log(result);

const endpoint = "https://eth-archive.nownodes.io/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "trace_call", params: [
  {
    "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
    "value": "0x186a0"
  },
  [
    "trace"
  ],
  "latest"
], id: 1 });
console.log(result);

const response = await fetch('https://eth-archive.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "trace_call",
      "id": 1,
      "params": [
        {
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
          "value": "0x186a0"
        },
        [
          "trace"
        ],
        "latest"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "trace_call",
  "id": 1,
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
      "value": "0x186a0"
    },
    [
      "trace"
    ],
    "latest"
  ]
}

response = requests.post('https://eth-archive.nownodes.io/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://eth-archive.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "trace_call",
    "id": 1,
    "params": [
      {
        "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
        "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
        "value": "0x186a0"
      },
      [
        "trace"
      ],
      "latest"
    ]
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "trace_call",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
      "value": "0x186a0"
    },
    [
      "trace"
    ],
    "latest"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "output": "0x",
    "stateDiff": null,
    "trace": [
      {
        "action": {
          "callType": "call",
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0xa94f5374fce5edbc8e2a8697c15331677e6ebf0b",
          "gas": "0x1dcd12f8",
          "input": "0x",
          "value": "0x186a0"
        },
        "result": {
          "gasUsed": "0x0",
          "output": "0x"
        },
        "subtraces": 0,
        "traceAddress": [],
        "type": "call"
      }
    ],
    "vmTrace": null
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32600,
    "message": "Invalid Request"
  }
}

Documentation

How to migrate to NOWNodes

Execute a call and return requested traces

Body

Response