---
title: "Get traces"
method: GET
path: "/traces"
tags: ["Chain Data"]
---

# Get traces

`GET /traces`

Retrieve traces for the given transaction(s). Corresponds to the <a href="/chifra/chaindata/#chifra-traces">chifra traces</a> command line.

## Query parameters

- `transactions` string[], required
- `articulate` boolean
- `filter` string
- `count` boolean
- `chain` string
- `noHeader` boolean
- `cache` boolean
- `decache` boolean
- `ether` boolean
- `fmt` string

## Response `200`

returns the requested data

- object
  - `data` union[] — Produces <a href="/data-model/other/#function">Function</a>, <a href="/data-model/other/#message">Message</a>, <a href="/data-model/other/#parameter">Parameter</a>, <a href="/data-model/chaindata/#trace">Trace</a>, <a href="/data-model/chaindata/#traceaction">TraceAction</a>, <a href="/data-model/chaindata/#tracecount">TraceCount</a>, <a href="/data-model/chaindata/#tracefilter">TraceFilter</a> or <a href="/data-model/chaindata/#traceresult">TraceResult</a> data. Corresponds to the <a href="/chifra/chaindata/#chifra-traces">chifra traces</a> command line.
    - union
      - Function — a human-readable representation of a Solidity function call or event
        - `name` string, string — the name of the interface
        - `type` string, string — the type of the interface, either 'event' or 'function'
        - `signature` string, string — the canonical signature of the interface
        - `encoding` string, string — the signature encoded with keccak
        - `inputs` Parameter[] — the input parameters to the function, if any
          - `type` string, string — the type of this parameter
          - `name` string, string — the name of this parameter
          - `strDefault` string, string — the default value of this parameter, if any
          - `indexed` boolean — `true` if this parameter is indexed
          - `internalType` string, string — for composite types, the internal type of the parameter
          - `components` Parameter[] — for composite types, the parameters making up the composite
        - `outputs` Parameter[] — the output parameters to the function, if any
          - `type` string, string — the type of this parameter
          - `name` string, string — the name of this parameter
          - `strDefault` string, string — the default value of this parameter, if any
          - `indexed` boolean — `true` if this parameter is indexed
          - `internalType` string, string — for composite types, the internal type of the parameter
          - `components` Parameter[] — for composite types, the parameters making up the composite
      - Message — used for various responses when no real data is generated
        - `msg` string, string — the message
        - `num` number — a number if needed
      - Parameter — an input or output parameter to a Solidity function or event
        - `type` string, string — the type of this parameter
        - `name` string, string — the name of this parameter
        - `strDefault` string, string — the default value of this parameter, if any
        - `indexed` boolean — `true` if this parameter is indexed
        - `internalType` string, string — for composite types, the internal type of the parameter
        - `components` Parameter[] — for composite types, the parameters making up the composite
      - Trace — trace data as returned from the RPC (with slight enhancements)
        - `blockHash` string, hash — the hash of the block containing this trace
        - `blockNumber` number — the number of the block
        - `timestamp` number — the timestamp of the block
        - `date` string, datetime — the timestamp as a date (calculated)
        - `transactionHash` string, hash — the transaction's hash containing this trace
        - `transactionIndex` number — the zero-indexed position of the transaction in the block
        - `traceAddress` Uint64[] — a particular trace's address in the trace tree
        - `subtraces` number — the number of children traces that the trace hash
        - `type` string, string — the type of the trace
        - `action` object — the trace action for this trace
        - `result` object — the trace result of this trace
        - `articulatedTrace` object — human readable version of the trace action input data
        - `compressedTrace` string, string — a compressed string version of the articulated trace (calculated)
      - TraceAction — trace action data as returned from the RPC (with slight enhancements)
        - `from` string, address — address from which the trace was sent
        - `to` string, address — address to which the trace was sent
        - `gas` number — the maximum number of gas allowed for this trace
        - `input` string, bytes — an encoded version of the function call
        - `callType` string, string — the type of call
        - `refundAddress` string, address — if the call type is self-destruct, the address to which the refund is sent
        - `rewardType` string, string — the type of reward
        - `value` string, wei — the value (in wei) of this trace action
        - `ether` string, ether — if --ether is specified, the value in ether (calculated)
        - `selfDestructed` string, address — `true` if the contract self-destructed, `false` otherwise
        - `balance` string, wei — if self-destructed, the balance of the contract at that time
        - `balanceEth` string, ether — if --ether is specified, the balance in ether (calculated)
      - TraceCount — counts the number of traces in a transaction
        - `blockNumber` number — the block number
        - `transactionIndex` number — the transaction index
        - `transactionHash` string, hash — the transaction's hash
        - `timestamp` number — the timestamp of the block
        - `date` string, datetime — the timestamp as a date (calculated)
        - `tracesCnt` number — the number of traces in the transaction
      - TraceFilter — used by chifra traces --filter option to query for traces
        - `fromBlock` number — the first block to include in the queried list of traces.
        - `toBlock` number — the last block to include in the queried list of traces.
        - `fromAddress` string, address — if included, only traces `from` this address will be included.
        - `toAddress` string, address — if included, only traces `to` this address will be included.
        - `after` number — only traces after this many traces are included.
        - `count` number — only this many traces are included.
      - TraceResult — trace result data as returned from the RPC (with slight enhancements)
        - `address` string, address — address of new contract, if any
        - `code` string, bytes — if this trace is creating a new smart contract, the byte code of that contract
        - `gasUsed` number — the amount of gas used by this trace
        - `output` string, bytes — the result of the call of this trace

## Other responses

- `400` — bad input parameter

---

[API](https://skmtc.net/trueblocks/apis/trueblocks-api.md) · [All operations](https://skmtc.net/trueblocks/apis/trueblocks-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trueblocks/trueblocks-api/versions/2a176f1485a9/schema)