Get transaction status

GET {{baseUrl}}/protocols/eth/transactions/:transaction

Fetch status for an Ethereum transaction hash.

A transaction is confirmed when the amount of confirmation blocks is equal to or greater than the setting in the header-tx-confirmations header. Existing transactions are pending until they are confirmed.

Reverted transactions that failed to succeed on-chain receive the error status.

Transactions that cannot be found on the chain are marked with the status unknown. Possibly these transactions were underpriced, dropped, or overridden via a new transaction.

HEADERS

KeyDatatypeRequiredDescription
tangany-networkstring(Optional header) Define an API-supported public Ethereum network or a custom external Ethereum RPC endpoint to operate in.

Accepts supported public network enums and custom Ethereum RPC URLs. Defaults to mainnet when omitted from the call.

Supported public networks: mainnet, goerli, sepolia, polygon, mumbai, bsc, bsc-testnet, gnosis, and chiado.

Examples for private Ethereum RPC: https://somenetwork.example.org:8540?mykey. External RPCs must be whitelisted by the Tangany support in order to be used in the API.

Example: sepolia | | tangany-tx-confirmations | number | | (Optional header) Defines a secure amount of block confirmations required to consider an Ethereum transaction as valid.

Accepts positive integers. Defaults to 1.

Ethereum transactions are usually considered final after 12 network confirmations. | | tangany-version | number | | (Required) Default header that directs the request towards desired Tangany Custody Api version (e.g 2 directs to Tangany Custody APi v2).

Supports only major versions. | | Accept | string | | |

RESPONSES

status: OK

{"blockNr":637013,"data":"0xf69507ab67368c3b2e43f5839f98c48b5e3b52713fcabfaa053bbadfa6f21b76c96b2111","status":"pending","confirmations":2,"from":"0xde0a21566919d193e6a28a9ac8534144cb697eee","to":"0xde0a21566919d193e6a28a9ac8534144cb697eee","contractCreation":"0xde0a21566919d193e6a28a9ac8534144cb697eee","gasPrice":"10000000000","gas":21128,"gasUsed":21128,"nonce":"auto","value":"12300000000","timestamp":1574417847,"transactionIndex":12}