v1

latestOpenAPI 3.0.42026-07-2233241175.9 KB
Block

๐Ÿ’Ž MEV Bids

Returns the full per-relay bid ladder for a single block's slot โ€” every recorded relay bid with its value, arrival time, relay, builder, and source. Intended for research and auditing.

Use case guide: Investigate a Block shows how to filter, paginate, and audit the relay bid ladder.

Data provenance: The bid ladder is collected from offchain relay APIs and streams. Relay-reported timestamps, identities, and bids are not independently verifiable from onchain data, and coverage gaps or inconsistent reporting can make the recorded ladder incomplete. Verify included block fields separately.

Results are ordered by arrival time and paginated. An optional slot_offset_ms_range filters bids by their slot offset.

Note: MEV relay and timing data is only available on mainnet at this time.

History: Relay bid collection began on 2024-06-03 (UTC). No bids are recorded for slots before that date โ€” including all pre-Merge blocks โ€” so the bid ladder is empty for them.

Data freshness: per-slot relay statistics lag the chain head by roughly 4 hours.

Premium Endpoint: This endpoint requires a Scale or Enterprise plan.

post/api/v2/ethereum/block/mev-bids

Request body

chain'mainnet' | 'hoodi'

The Ethereum chain to query.

cursorstring

Cursor value for pagination. See our pagination guide for more details.

page_sizeinteger

The number of bids to return per page.

Response

Successful response.

readyboolean required

true when the underlying data pipeline has fully processed this slot and the result is definitive. false when the slot falls within the pipeline lag window (roughly 4 hours behind the chain head) โ€” the empty response reflects current pipeline state and may change when the exporter catches up.

Example response

{
  "data": [
    {
      "source": "get_header"
    }
  ]
}
All 33 operations