Bid status

The following API endpoint allows searcher to check the status of their bids in real time.

Get bid status

GET https://mempool.merkle.io/bid/:id

Returns a full breakdown of the bid status, the opportunity and the bundle status if any.

Path Parameters

Name	Type	Description
	String	The bid uuid

200: OK Bid found

404: Not Found Bid not found

Example of a succesfuly received and simulated bid, but not included on-chain:

// GET https://mempool.merkle.io/bid/272f3b07-b40e-48b5-b8e0-58c3496d3c73

{
  "amount": "9578453449950000",
  "auction": {
    "chain_id": 1,
    "closes_at": "2024-01-16T07:56:15.044137Z",
    "created_at": "2024-01-16T07:56:13.544137Z",
    "fee_recipient": "0x1E8e81dC3B221885b386e3d1c9efe93fc2863B24",
    "id": "5143d92e-fdce-4a01-94c6-3d9110c9e69a",
    "transaction": {
      "hash": "0x8196f6bcc9e24a966adcbe2d63c2447c5432858682500b2c01d9473b6171e230",
      "from": "0xAE6Bd62943Ad4e696540124F5BFEd241733ee7Ed",
      "to": "0x3fC91A3afd70395Cd496C647d5a6CC9D4B2b7FAD",
      "data": "3593564c000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000065a638db00000000000000000000000000000000000000000000000000000000000000040a00000c0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000003400000000000000000000000000000000000000000000000000000000000000460000000000000000000000000000000000000000000000000000000000000016000000000000000000000000066761fa41377003622aee3c7675fc7b5c1c2fac5000000000000000000000000ffffffffffffffffffffffffffffffffffffffff0000000000000000000000000000000000000000000000000000000065cdc37600000000000000000000000000000000000000000000000000000000000000000000000000000000000000003fc91a3afd70395cd496c647d5a6cc9d4b2b7fad0000000000000000000000000000000000000000000000000000000065a63d7e00000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000041d89cd526be211708e8d00f6fd8b225309bd335fbe2d5a021f6d559781d93558a06f173852aa3bfcb838436996bbe3bbe312ea2b031d3df51942b4dac8c3ca4251c0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001200000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000cce0b80923d7cb1a15d00000000000000000000000000000000000000000000000019b3ff9d0ae5c65c00000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000004266761fa41377003622aee3c7675fc7b5c1c2fac5002710a0b86991c6218b36c1d19d4a2e9eb0ce3606eb480001f4c02aaa39b223fe8d0a0e5c4f27ead9083c756cc200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000cce0b80923d7cb1a15d00000000000000000000000000000000000000000000000019f51628d811ed8a00000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000002b66761fa41377003622aee3c7675fc7b5c1c2fac5000bb8c02aaa39b223fe8d0a0e5c4f27ead9083c756cc20000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000033a915c5e2f7b3e6",
      "value": "0",
      "gas_price": "",
      "gas_fee_cap": "",
      "gas_tip_cap": "",
      "gas": 554780,
      "nonce": 573,
      "logs": [],
      "function_selector": "0x3593564c"
    }
  },
  "bundle": {
    "block_target": 19018097,
    "id": "ed4e7dd5-c744-4095-9ec4-4694e4fd8d91",
    "sent_at": "2024-01-16T07:56:22Z",
    "status": "inclusion_failed" // can also be "inclusion_success" or "sent"
  },
  "chain_id": 1,
  "created_at": "2024-01-16T07:56:13.864662Z",
  "id": "272f3b07-b40e-48b5-b8e0-58c3496d3c73",
  "minimum_bid": 0.0005525412879,
  "simulation": {
    "error": "",
    "gas_used": 154044,
    "simulated_at": "2024-01-16T07:56:21Z"
  },
  "transaction": {
    "hash": "0x8196f6bcc9e24a966adcbe2d63c2447c5432858682500b2c01d9473b6171e230",
    "id": "cac21eb0-1ea2-4ca8-92b7-be953b22ef75"
  },
  "winner": true // whether or not the bid won the auction
}