Trace API Quickstart

This quickstart shows how to make a first Trace API request over HTTPS using an Ethereum JSON-RPC method as a general example. Node API endpoints are chain-specific, so production requests must use a chain endpoint that supports Trace API.

Prerequisites

Before you start, make sure you have:

• A W3api account with access to public Node API endpoints.
• A Node API HTTPS endpoint copied from the Web3 API platform for the selected chain.
• A terminal with curl.

Copy Your HTTPS Endpoint

1. Open the Web3 API platform.
2. Select the project and blockchain network you want to use.
3. Copy the network’s HTTPS endpoint.
4. Store it as YOUR_HTTPS_ENDPOINT in the examples below.

Make a Request with curl

Use trace_transaction to request execution trace data for a transaction:

$
curl -X POST YOUR_HTTPS_ENDPOINT \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "jsonrpc": "2.0",
>
    "method": "trace_transaction",
>
    "params": ["YOUR_TRANSACTION_HASH"],
>
    "id": 1
>
  }'

A successful response returns trace entries for the transaction:

1
{
2
  "jsonrpc": "2.0",
3
  "id": 1,
4
  "result": [
5
    {
6
      "action": {
7
        "callType": "call",
8
        "from": "0x0000000000000000000000000000000000000000",
9
        "to": "0x0000000000000000000000000000000000000000",
10
        "value": "0x0"
11
      },
12
      "result": {
13
        "gasUsed": "0x5208"
14
      },
15
      "type": "call"
16
    }
17
  ]
18
}

Trace response fields vary by network and client implementation. Use the returned trace entries to inspect internal calls, execution paths, and value movement.

Next Steps

The Trace API references are chain-specific. Select the one you’d like to interact with to view its method details: