Get a transaction

Commonly used to fetch and render a single transaction including its decoded log events.

^{Credit Cost: 0.1 per call.
Processing: Realtime}

Requests that return status 200 and no data cost 0.1 credits.

Enabling no-logs reduces request cost to 0.05 per item.

Related guides

How to Get the Latest Axie Spawns

Comparing GoldRush’s Transactions API to RPC Providers

How to Get Transaction History for an Address on Ethereum

How to Fetch User Operations (UserOps) for a Specific Wallet Address

A Guide to DeFi Taxes

Understanding Different Types of Blockchain Transactions with Covalent

Path Parameters

chainName

string

required

The chain name eg: eth-mainnet.

txHash

string

required

The transaction hash.

Query Parameters

quote-currency

string

The currency to convert. Supports USD, CAD, EUR, SGD, INR, JPY, VND, CNY, KRW, RUB, TRY, NGN, ARS, AUD, CHF, and GBP.

no-logs

boolean

Omit log events.

Response

200 - application/json

chain_id

integer

The requested chain ID eg: 1.

chain_name

string

The requested chain name eg: eth-mainnet.

items

object[]

List of response items.

Show child attributes

items.block_hash

string

The hash of the block. Use it to remove transactions from re-org-ed blocks.

items.block_height

integer

The height of the block.

items.block_signed_at

string

The block signed timestamp in UTC.

items.explorers

object[]

The explorer links for this transaction.

Show child attributes

items.explorers.label

string

The name of the explorer.

items.explorers.url

string

The URL of the explorer.

items.fees_paid

string

b;The total transaction fees (gas_price * gas_spent) paid for this tx, denoted in wei.

items.from_address

string

The sender's wallet address.

items.from_address_label

string

The label of from address.

items.gas_metadata

object

The requested chain native gas token metadata.

Show child attributes

items.gas_metadata.contract_address

string

Use the relevant contract_address to lookup prices, logos, token transfers, etc.

items.gas_metadata.contract_decimals

integer

Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.

items.gas_metadata.contract_name

string

The string returned by the name() method.

items.gas_metadata.contract_ticker_symbol

string

The ticker symbol for this contract. This field is set by a developer and non-unique across a network.

items.gas_metadata.logo_url

string

The contract logo URL.

items.gas_metadata.supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

items.gas_offered

integer

items.gas_price

integer

The gas price at the time of this tx.

items.gas_quote

number

The gas spent in quote-currency denomination.

items.gas_quote_rate

number

The native gas exchange rate for the requested quote-currency.

items.gas_spent

integer

The gas spent for this tx.

items.log_events

object[]

The log events.

Show child attributes

items.log_events.block_height

integer

The height of the block.

items.log_events.block_signed_at

string

The block signed timestamp in UTC.

items.log_events.decoded

object

The decoded item.

Show child attributes

items.log_events.decoded.name

string

items.log_events.decoded.params

object[]

Show child attributes

items.log_events.decoded.params.decoded

boolean

items.log_events.decoded.params.indexed

boolean

items.log_events.decoded.params.name

string

items.log_events.decoded.params.type

string

items.log_events.decoded.params.value

string

items.log_events.decoded.signature

string

items.log_events.log_offset

integer

The offset is the position of the log entry within an event log.

items.log_events.raw_log_data

string

The log events in raw.

items.log_events.raw_log_topics

string[]

The log topics in raw data.

items.log_events.sender_address

string

The address of the sender.

items.log_events.sender_address_label

string

The label of the sender address.

items.log_events.sender_contract_decimals

integer

Use contract decimals to format the token balance for display purposes - divide the balance by 10^{contract_decimals}.

items.log_events.sender_contract_ticker_symbol

string

items.log_events.sender_factory_address

string

The address of the deployed UniswapV2 like factory contract for this DEX.

items.log_events.sender_logo_url

string

The contract logo URL.

items.log_events.sender_name

string

The name of the sender.

items.log_events.supports_erc

string[]

A list of supported standard ERC interfaces, eg: ERC20 and ERC721.

items.log_events.tx_hash

string

The requested transaction hash.

items.log_events.tx_offset

integer

The offset is the position of the tx in the block.

items.miner_address

string

The address of the miner.

items.pretty_gas_quote

string

A prettier version of the quote for rendering purposes.

items.pretty_value_quote

string

A prettier version of the quote for rendering purposes.

items.safe_details

object[]

The details related to the safe transaction.

Show child attributes

items.safe_details.owner_address

string

The address that signed the safe transaction.

items.safe_details.signature

string

The signature of the owner for the safe transaction.

items.safe_details.signature_type

string

The type of safe signature used.

items.successful

boolean

Indicates whether a transaction failed or succeeded.

items.to_address

string

The receiver's wallet address.

items.to_address_label

string

The label of to address.

items.tx_hash

string

The requested transaction hash.

items.tx_offset

integer

The offset is the position of the tx in the block.

items.value

string

b;The value attached to this tx.

items.value_quote

number

The value attached in quote-currency to this tx.

updated_at

string

The timestamp when the response was generated. Useful to show data staleness to users.