Skip to main content

private transaction status API

Transactions that you submit to Flashbots Protect won't be observable in the public mempool. However, you can use our status API to check the status of your transactions. The URL for doing so is: https://protect.flashbots.net/tx/YOUR_TX_HASH_HERE, and you can also use Etherscan as you normally would for transactions. They will show the status of your transaction from the status API as well.

In turn you will receive a JSON response that looks like the following:

{    "status": "PENDING",    "hash": "YOUR_TX_HASH",    "maxBlockNumber": 13543898,    "transaction": {        "from": "0xEA674fdDe714fd979de3EdF0F56AA9716B898ec8",        "to": "0xac03bb73b6a9e108530aff4df5077c2b3d481e5a",        "gasLimit": "21000",        "maxFeePerGas": "300",        "maxPriorityFeePerGas": "10",        "nonce": "41",        "value": "10000000000",    }}

Potential statuses#

  • PENDING - The transaction was received and is currently being submitted to miners
  • INCLUDED - The transaction was included on-chain
  • FAILED - The transaction was submitted for 25 blocks and failed to be included on-chain
  • CANCELLED - The transaction was cancelled by the user and not included on-chain
  • UNKNOWN - The transaction was not received

Privacy#

In order to receive a response from the status API you must know and provide a transaction hash to look up. As a result, you are only able to look up transactions which you know about.