Links

eth_getBundleStat

Get bundle stats from flashbots relay via this api.
You can get transactions bundle stat via this api after send them to the flashbots relay 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-sdk'
// 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"
}
}