Status
Status confirms whether a transaction was included in a block and whether it executed successfully, using queries, subscriptions, or Webhook. You can retrieve a receipt by transaction hash, query multiple transactions at once by block, and trace the execution path of failed transactions.
A transaction included in a block can still revert during execution. In that case no assets move and only gas is consumed. Distinguishing block inclusion from execution success with the receipt status field lets you decide accurately whether to mark a withdrawal as completed or failed.
Use Cases
- Withdrawal OpsComplete withdrawals
Confirm execution success with the receipt `status` field, then mark the withdrawal as completed. This prevents reverted withdrawals from being recorded as successful when you rely on block inclusion alone.
- Service OpsExplain failure causes
Trace the execution path of a failed transaction to find where the revert occurred. Use the cause to respond accurately to customer inquiries.
- EngineeringBulk withdrawal status checks
Check the status of many withdrawals at once with multi-transaction queries, block-level queries, or Webhook instead of per-transaction lookups. This significantly reduces call volume compared with per-transaction queries.
Available APIs
Transaction Queries — RPC
- RPC
eth_getTransactionReceiptRetrieves the receipt of a transaction16 CU - RPC
eth_getTransactionByHashRetrieves transaction information by transaction hash15 CU - RPC
eth_getTransactionByBlockNumberAndIndexRetrieves a transaction by block number and index13 CU - RPC
eth_getTransactionByBlockHashAndIndexRetrieves a transaction by block hash and index15 CU - RPC
eth_getBlockReceiptsRetrieves the receipts of all transactions in a block at once28 CU
Transaction Queries — Data API
- Data API
Get Transaction by HashRetrieves a single transaction by transaction hash80 CU - Data API
Get Transactions by HashesRetrieves transactions for multiple transaction hashes at once500 CU - Data API
Get Transaction by Transaction IDRetrieves a transaction by transaction ID on UTXO-based chains80 CU - Data API
Get Transactions by Transaction IDsRetrieves transactions for multiple transaction IDs at once on UTXO-based chains500 CU - Data API
Get Transaction by Version · Get Transactions by VersionsRetrieves transactions by version on Aptos30 CU - Data API
Get Transactions in BlockRetrieves the list of transactions included in a block150 CU - Data API
Get Transactions in LedgerRetrieves the list of transactions included in an XRPL ledger150 CU - Data API
Get Transactions in Slot · Get Transaction Summaries in SlotRetrieves the transactions and summaries included in a Solana slotComing soon