Links

eth_getBundleStat

Get bundle stats from flashbots relay.
Through eth_getBundleStat, you can fetch bundle stats, bundleHash is necessary. After sending bundleHash to the flashbots relay, you can get bundle stats without dealing with flashbots, reducing technical costs.
Supported on Ethereum.

Parameters

Object - An object with the following fields (required):
  • bundleHash(hex string, required) - the hash value of the bundle.
  • blockNumber(integer number, optional, default latest) - the blockNumber that the bundle should be included.

Returns

Object - An object with the following fields:
  • id(integer number) - json-rpc id.
  • jsonrpc(string) - json-rpc version.
  • result(object) - an object with the following fields:
    • isSimulated(boolean) - indicating whether the bundle has been simulated.
    • isSendToMiners(boolean) - indicating whether the bundle has been sent to the miners.
    • isHighPriority(boolean) - indicating whether the bundle has high priority in relay process.
    • simulatedAt(time string) - the time when the bundle had been simulated.
    • submittedAt(time string) - the time when the bundle had been submitted to flahbots relay.
    • sendToMinersAt(time string) - the time when the bundle had been sent to the miner.

Example

Request

curl
TypeScript
curl --location --request POST 'https://apis.blockvision.org/v1/<api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"jsonrpc": "2.0",
"method": "eth_getBundleStat",
"params": {
"bundleHash": "0x161a90b226ba43b0e283d9fda02e801a3685fd4f550f55226016e5c4a8ab3428",
"blockNumber": 7626710
},
"id": 1
}'
import { BlockVisionProvider, BvNetwork } from 'blockvision.js'
// Optional parameters, but default to eth-mainnet and default api-key.
const bv = new BlockVisionProvider(BvNetwork.ETH_MAINNET)
// Access the BlockVision Mempool API
bv.getBundleStat({
bundleHash: '0xf1542f44cc02fc2a2aa592bc7e7ea57d1d0d72abb8287ceb5d5b011f4e780158'
}).then(console.log)

Result

{
"jsonrpc": "2.0",
"id": 1,
"result": {
"isSimulated": true,
"isSentToMiners": false,
"isHighPriority": false,
"simulatedAt": "2022-09-20T09:51:52.436Z",
"submittedAt": "2022-09-20T09:51:52.43Z",
"sentToMinersAt": "0001-01-01T00:00:00Z"
}
}