--- title: "Export details" method: GET path: "/export" tags: ["Accounts"] --- # Export details `GET /export` Export full details of transactions for one or more addresses. Corresponds to the chifra export command line. ## Query parameters - `addrs` string[], required - `topics` string[] - `fourbytes` string[] - `appearances` boolean - `receipts` boolean - `logs` boolean - `approvals` boolean - `traces` boolean - `neighbors` boolean - `statements` boolean - `transfers` boolean - `assets` boolean - `balances` boolean - `withdrawals` boolean - `articulate` boolean - `cacheTraces` boolean - `count` boolean - `firstRecord` number - `maxRecords` number - `relevant` boolean - `emitter` string[] - `topic` string[] - `nfts` boolean - `reverted` boolean - `asset` string[] - `flow` 'in' | 'out' | 'zero' - `factory` boolean - `unripe` boolean - `reversed` boolean - `noZero` boolean - `firstBlock` number - `lastBlock` number - `accounting` boolean - `chain` string - `noHeader` boolean - `cache` boolean - `decache` boolean - `ether` boolean - `fmt` string ## Response `200` returns the requested data - object - `data` union[] — Produces Appearance, Function, Log, Message, Monitor, Parameter, Receipt, Statement, Token, Trace, TraceAction, TraceResult, Transaction, Transfer or Withdrawal data. Corresponds to the chifra export command line. - union - Appearance — an appearance (``) 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 - Monitor — a local file indicating a user's interest in an address. Includes caches for reconicilations, transactions, and appearances as well as an optional association to named account - `address` string, address — the address of this monitor - `name` string, string — the name of this monitor (if any) - `nRecords` number — the number of appearances for this monitor - `fileSize` number — the size of this monitor on disc - `lastScanned` number — the last scanned block number - `isEmpty` boolean — `true` if the monitor has no appearances, `false` otherwise - `isStaged` boolean — `true` if the monitor file in on the stage, `false` otherwise - `deleted` boolean — `true` if this monitor has been deleted, `false` otherwise - 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 - Receipt — receipt data as returned from the RPC (with slight enhancements) - `blockHash` string, hash - `blockNumber` number - `contractAddress` string, address — the address of the newly created contract, if any - `gasUsed` number — the amount of gas actually used by the transaction - `isError` boolean - `logs` Log[] — a possibly empty array of logs - `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) - `status` number — `1` on transaction suceess, `null` if tx precedes Byzantium, `0` otherwise - `transactionHash` string, hash - `transactionIndex` number - Statement — a statement, including all inflows and outflows, for a single transfer of an asset (including ETH) to or from a given address - `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 - Token — on-chain token-related data such as totalSupply, symbol, decimals, and individual balances for a given address at a given block - `blockNumber` number — the block at which the report is made - `transactionIndex` number — the transaction index (if applicable) at which the report is made - `timestamp` number — the timestamp of the block - `date` string, datetime — the timestamp as a date (calculated) - `totalSupply` string, int256 — the total supply of the token contract - `address` string, address — the address of the token contract - `holder` string, address — the holder address for which we are reporting - `priorBalance` string, int256 — the holder's asset balance at its prior appearance - `balance` string, int256 — the holder's asset balance at the given block height - `balanceDec` number, float — the holder's asset balance (in Ether) at the given block height (calculated) - `diff` string, int256 — the difference, if any, between the prior and current balance (calculated) - `name` string, string — the name of the token contract, if available - `symbol` string, string — the symbol of the token contract - `decimals` number — the number of decimals for the token contract - `type` object — the type of token (ERC20 or ERC721) or none - 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) - 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 - 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) - Transfer — a movement of an asset from one address to another (derived from a transaction or a log) - `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 - `holder` string, address — the address of the holder of the asset - `asset` string, address — 0xeeee...eeee for ETH transfers, the token address otherwise - `decimals` number — the number of decimal places in the asset units - `sender` string, address — the initiator of the transfer (the sender) - `recipient` string, address — the receiver of the transfer (the recipient) - `amountIn` string, int256 — the top-level value of the incoming transfer for the holder address - `internalIn` string, int256 — the internal value of the incoming transfer for the holder address - `minerBaseRewardIn` string, int256 — the base fee reward if the miner is the holder address - `minerNephewRewardIn` string, int256 — the nephew reward if the miner is the holder address - `minerTxFeeIn` string, int256 — the transaction fee reward if the miner is the holder address - `minerUncleRewardIn` string, int256 — the uncle reward if the miner who won the uncle block is the holder address - `prefundIn` string, int256 — at block zero (0) only, the amount of genesis income for the holder address - `selfDestructIn` string, int256 — the incoming value of a self-destruct if recipient is the holder address - `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 holder account - `gasOut` string, int256 — if the transaction's original sender is the holder address, the amount of gas expended - `selfDestructOut` string, int256 — the outgoing value of a self-destruct if sender is the holder address - `transaction` object — the transaction that triggered the transfer (calculated) - `log` object — if a token transfer, the log that triggered the transfer (calculated) - Withdrawal — withdrawal record for post-Shanghai withdrawals from the consensus layer - `address` string, address — the recipient for the withdrawn ether - `amount` string, wei — a nonzero amount of ether given in gwei (1e9 wei) - `ether` string, ether — if --ether is specified, the amount in ether (calculated) - `blockNumber` number — the number of this block - `index` number — a monotonically increasing zero-based index that increments by 1 per withdrawal to uniquely identify each withdrawal - `timestamp` number — the timestamp for this block - `date` string, datetime — the timestamp as a date (calculated) - `validatorIndex` number — the validator_index of the validator on the consensus layer the withdrawal corresponds to ## Other responses - `400` — bad input parameter ## Changes - **2025-09-26** `bfab37f3cd3f` — 1 info - added the new optional `query` request parameter `approvals` - **2025-03-28** `7841b9d1acc5` — 21 warning, 30 info - removed the optional property `data/items/oneOf[#/components/schemas/statement]/assetAddr` from the response with the `200` status - removed the optional property `data/items/oneOf[#/components/schemas/statement]/assetSymbol` from the response with the `200` status - removed the optional property `data/items/oneOf[#/components/schemas/statement]/correctingIn` from the response with the `200` status - removed the optional property `data/items/oneOf[#/components/schemas/statement]/correctingOut` from the response with the `200` status - …47 more - **2025-03-27** `2f9b4968d332` — 2 breaking, 3 info - added `#/components/schemas/transfer` to the `data/items/` response property `oneOf` list for the response status `200` - the `data/items/oneOf[#/components/schemas/token]/balanceDec` response's property type/format changed from `number`/`float64` to `number`/`float` for status `200` - added the optional property `data/items/oneOf[#/components/schemas/log]/isNFT` to the response with the `200` status - added the optional property `data/items/oneOf[#/components/schemas/receipt]/logs/items/isNFT` to the response with the `200` status - …1 more - …earlier changes not shown [Full history](https://skmtc.dev/trueblocks/apis/trueblocks-api/changes/export/get.md) --- [API](https://skmtc.dev/trueblocks/apis/trueblocks-api.md) · [All operations](https://skmtc.dev/trueblocks/apis/trueblocks-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trueblocks/trueblocks-api/revisions/2a176f1485a9/schema)