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
Key | Datatype | Required | Description |
---|---|---|---|
tangany-network | string | (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}