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

# Get transactions

`GET /transactions`

Retrieve one or more transactions from the chain or local cache. Corresponds to the <a href="/chifra/chaindata/#chifra-transactions">chifra transactions</a> command line.

## Query parameters

- `transactions` string[], required
- `articulate` boolean
- `traces` boolean
- `uniq` boolean
- `flow` 'from' | 'to'
- `logs` boolean
- `emitter` string[]
- `topic` string[]
- `cacheTraces` 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/accounts/#appearance">Appearance</a>, <a href="/data-model/other/#function">Function</a>, <a href="/data-model/chaindata/#log">Log</a>, <a href="/data-model/other/#message">Message</a>, <a href="/data-model/other/#parameter">Parameter</a> or <a href="/data-model/chaindata/#transaction">Transaction</a> data. Corresponds to the <a href="/chifra/chaindata/#chifra-transactions">chifra transactions</a> command line.
    - union
      - Appearance — an appearance (`<blockNumber,transactionIndex>`) of an address anywhere on the chain (note that in some cases, not all fields will appear depending on the command)
        - `address` string, address — the address of the appearance
        - `blockNumber` number — the number of the block
        - `transactionIndex` number — the index of the transaction in the block
        - `traceIndex` number — the zero-based index of the trace in the transaction
        - `reason` string, string — the location in the data where the appearance was found
        - `timestamp` number — the timestamp for this appearance
        - `date` string, datetime — the timestamp as a date (calculated)
      - 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
      - Log — log data as returned from the RPC (with slight enhancements)
        - `blockNumber` number — the number of the block
        - `transactionIndex` number — the zero-indexed position of the transaction in the block
        - `logIndex` number — the zero-indexed position of this log relative to the block
        - `timestamp` number — the timestamp of the block this log appears in
        - `date` string, datetime — the timestamp as a date (calculated)
        - `address` string, address — the smart contract that emitted this log
        - `topics` Topic[] — first topic event signature up to 3 additional index parameters may appear
        - `data` string, bytes — any remaining un-indexed parameters to the event
        - `transactionHash` string, hash — the hash of the transction
        - `blockHash` string, hash — the hash of the block
        - `articulatedLog` object — a human-readable version of the topic and data fields
        - `compressedLog` string, string — a truncated, more readable version of the articulation (calculated)
        - `isNFT` boolean — true if the log is an NFT transfer (calculated)
      - 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
      - Transaction — transaction data as returned from the RPC (with slight enhancements)
        - `hash` string, hash — the hash of the transaction
        - `blockHash` string, hash — the hash of the block containing this transaction
        - `blockNumber` number — the number of the block
        - `transactionIndex` number — the zero-indexed position of the transaction in the block
        - `nonce` number — sequence number of the transactions sent by the sender
        - `timestamp` number — the Unix timestamp of the object
        - `date` string, datetime — the timestamp as a date (calculated)
        - `from` string, address — address from which the transaction was sent
        - `to` string, address — address to which the transaction was sent
        - `value` string, wei — the amount of wei sent with this transactions
        - `ether` string, ether — if --ether is specified, the value in ether (calculated)
        - `gasPrice` number — the number of wei per unit of gas the sender is willing to spend
        - `gas` number — the maximum number of gas allowed for this transaction
        - `input` string, bytes — byte data either containing a message or funcational data for a smart contracts. See the --articulate
        - `receipt` object
        - `statements` Statement[] — array of reconciliation statements (calculated)
          - `blockNumber` number — the number of the block
          - `transactionIndex` number — the zero-indexed position of the transaction in the block
          - `logIndex` number — the zero-indexed position the log in the block, if applicable
          - `transactionHash` string, hash — the hash of the transaction that triggered this reconciliation
          - `timestamp` number — the Unix timestamp of the object
          - `date` string, datetime — the timestamp as a date (calculated)
          - `asset` string, address — 0xeeee...eeee for ETH reconciliations, the token address otherwise
          - `symbol` string, string — either ETH, WEI, or the symbol of the asset being reconciled as extracted from the chain
          - `decimals` number — the value of `decimals` from an ERC20 contract or, if ETH or WEI, then 18
          - `spotPrice` number, float — the on-chain price in USD (or if a token in ETH, or zero) at the time of the transaction
          - `priceSource` string, string — the on-chain source from which the spot price was taken
          - `accountedFor` string, address — the address being accounted for in this reconciliation
          - `sender` string, address — the initiator of the transfer (the sender)
          - `recipient` string, address — the receiver of the transfer (the recipient)
          - `begBal` string, int256 — the on-chain or running beginning balance prior to the transaction (see notes about intra-block reconciliations)
          - `amountNet` string, int256 — totalIn - totalOut (calculated)
          - `endBal` string, int256 — the on-chain or running balance after the transaction (see notes about intra-block reconciliations)
          - `reconciled` boolean — true if `endBal === endBalCalc` and `begBal === prevBal`. `false` otherwise. (calculated)
          - `totalIn` string, int256 — the sum of the following `In` fields (calculated)
          - `amountIn` string, int256 — the top-level value of the incoming transfer for the accountedFor address
          - `internalIn` string, int256 — the internal value of the incoming transfer for the accountedFor address
          - `selfDestructIn` string, int256 — the incoming value of a self-destruct if recipient is the accountedFor address
          - `minerBaseRewardIn` string, int256 — the base fee reward if the miner is the accountedFor address
          - `minerNephewRewardIn` string, int256 — the nephew reward if the miner is the accountedFor address
          - `minerTxFeeIn` string, int256 — the transaction fee reward if the miner is the accountedFor address
          - `minerUncleRewardIn` string, int256 — the uncle reward if the miner who won the uncle block is the accountedFor address
          - `correctBegBalIn` string, int256 — for unreconciled transfers, increase in beginning balance need to match previous balance
          - `correctAmountIn` string, int256 — for unreconciled transfers, increase in the amount of a transfer
          - `correctEndBalIn` string, int256 — for unreconciled transfers, increase in ending balance need to match running balance or block balance
          - `prefundIn` string, int256 — at block zero (0) only, the amount of genesis income for the accountedFor address
          - `totalOut` string, int256 — the sum of the following `Out` fields (calculated)
          - `amountOut` string, int256 — the amount (in units of the asset) of regular outflow during this transaction
          - `internalOut` string, int256 — the value of any internal value transfers out of the accountedFor account
          - `correctBegBalOut` string, int256 — for unreconciled transfers, decrease in beginning balance need to match previous balance
          - `correctAmountOut` string, int256 — for unreconciled transfers, decrease in the amount of a transfer
          - `correctEndBalOut` string, int256 — for unreconciled transfers, decrease in ending balance need to match running balance or block balance
          - `selfDestructOut` string, int256 — the value of the self-destructed value out if the accountedFor address was self-destructed
          - `gasOut` string, int256 — if the transaction's original sender is the accountedFor address, the amount of gas expended
          - `prevBal` string, int256 — the account balance for the given asset for the previous reconciliation
          - `begBalDiff` string, int256 — difference between expected beginning balance and balance at last reconciliation, if non-zero, the reconciliation failed (calculated)
          - `endBalDiff` string, int256 — endBal - endBalCalc, if non-zero, the reconciliation failed (calculated)
          - `endBalCalc` string, int256 — begBal + amountNet (calculated)
          - `correctingReasons` string, string — for unreconciled transfers, the reasons for the correcting entries, if any
        - `articulatedTx` object
        - `hasToken` boolean — `true` if the transaction is token related, `false` otherwise
        - `isError` boolean — `true` if the transaction ended in error, `false` otherwise
        - `compressedTx` string, string — truncated, more readable version of the articulation (calculated)

## 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)