v1
latestOpenAPI 3.0.42026-07-2233241175.9 KB๐ 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.
Request body
Response
Successful response.
Example response
{
"data": [
{
"source": "get_header"
}
]
}