Trader

🚧 Work in Progress Section

  1. send transactions using eth_sendRawTransactions, the response will include a bundle ID

  2. use the bundle ID to regularly query the status of the bundle using eth_getBundleStatusById

  3. the status can be either

    • PENDING_BUNDLE: the bundle is in progess, being sent to miners via flashbots for inclusion

    • FAILED_BUNDLE: the bundle has not been included. The reason will be shown in the response error message

    • SUCCESSFUL_BUNDLE: the bundle has been included by a miner

  1. send a single transaction using eth_sendRawTransaction, the response will include the transaction hash

  2. use the transaction hash to regularly query the status using eth_getTransactionStatusByHash

  3. the status can be either

    • PENDING_BUNDLE: the bundle is in progess, being sent to miners via flashbots for inclusion

    • FAILED_BUNDLE: the bundle has not been included. The reason will be shown in the response error message

    • SUCCESSFUL_BUNDLE: the bundle has been included by a miner

  1. send a bundle of transactions using eth_sendRawTransactions, the response will include a bundle ID

  2. use the bundle ID to regularly cancel the bundle using eth_cancelBundleById

  3. use the bundle ID to regularly query the status of the bundle using eth_getBundleStatusById

  4. the status can be either

    • any of the above statuses

    • CANCEL_BUNDLE_SUCCESSFUL: the bundle was canceled successfully

  1. send a transaction using eth_sendRawTransaction, the response will include the transaction hash

  2. use the hash to regularly cancel the bundle using eth_cancelBundleByTransactionHash

  3. use the transaction hash to regularly query the status of the bundle using eth_getTransactionStatusByHash

  4. the status can be either

    • any of the above statuses

    • CANCEL_BUNDLE_SUCCESSFUL: the bundle was canceled successfully

To build a successful transaction, it is important to include enough fees to cover both the Ethereum baseFee as well as the miner tip (incentive for a miner to include your transaction in a block). It may be complex to estimate what the fees should be, especially when the network is heavily used and more transactions are competing with each other.

To help on that matter, the API provides a method that will send back mistX recommended fees. Those have been adjusted to ensure a good chance of inclusion while minimizing the miner payment to avoid overpayment. The method eth_gasFees will send back fees organized in three tiers, so you can choose which one fits best your use case

  • low: lowest chance of inclusion, it will take more time to get included. Higher risk of not covering the baseFee in times of heavy traffic

  • medium: good chance of inclusion, it will be faster to get included. Medium risk of not covering the baseFee in times of heavy traffic

  • high: highest chance and fastest inclusion. Lowest risk of not covering the baseFee in times of heavy traffic