Transaction status

We offer an API to keep track of transactions and their attached auctions. Note that transaction status can also be fetched via eth_getTransactionByHash.

Get the status of a transaction

GET https://mempool.merkle.io/transaction/<hash>

Query Parameters

Name	Type	Description
hash*	String	The hash of the transaction

200: OK Transaction status.

{
  "chain_id": 1,
  "id": "128d741e-3584-490e-8209-18260d77723e",
  "pending": false,
  "mined_at":0,
  "mined_at_block_number": 17337054,
  "received_at": 1685028550472473,
  "status": "mined",
  "transaction": {
    "data": "",
    "from": "0x65D072964AF7DdBC25cDb726A97B4d1a04A32242",
    "gas": 21000,
    "hash": "0x3fbec2aa8b367d42e76030d12095a3c60cbaa57a408cd793f33e8a7abc179663",
    "nonce": 2,
    "to": "0x505ea9aC45A7D7919C12BA3eb47887dfE8D18604",
    "value": "200000000000000000"
  }
}

404: Not Found Transaction not found.

Possible values for the status field of the transaction are:

• mined: Transaction has been included in the blockchain

• pending: Transaction is valid and could potentially be included in the next block

• nonce_too_low: Transaction can never be mined because its nonce is too low, effectively dropped.

• nonce_gapped: The transaction nonce is too high

• not_enough_funds: The transaction sender does not have a balance high enough to pay for the transaction

• base_fee_low: The base fee of the transaction is too low to be included in the next block

• low_priority_fee: The transaction's priority fee is zero

• not_enough_gas: The intrinsic gas of the transaction is too low.
• unknown: There was an issue determining the status of this transaction, check again later

• sanctioned: The sender or receiver is sanctioned by OFAC

• gas_limit_too_high: The gas limit for this transaction is higher than the block gas limit

• invalid_signature: The signature is invalid

• underpriced: There is a transaction with the same nonce that has a higher gas fee.

• expired: The transaction could not get mined in time and was discarded.

• reverting: Transaction is reverting and revert protection is enabled.