{"uid":"cap_21AfRxeMtlhy0A_lazrBw","slug":"seneschal-block-value-api-ce9e7fc9","name":"Seneschal Block Value API","description":"Single-fact: network-wide percentile block value (proposer payment, ETH) across ALL winning slots in the window — the \"is it worth bundling?\" number, independent of builder. Returns {value_eth, median_eth, max_eth, samples}.","url":"https://api.seneschal.space/v1/q/block-value","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"pct":{"type":"string","description":"Percentile 1-99 (default 50)."},"window":{"type":"string","description":"Lookback window: 24h, 7d or 30d (default 24h)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"pct":{"type":"integer"},"window":{"type":"string"},"max_eth":{"type":"number"},"samples":{"type":"integer"},"as_of_ms":{"type":"integer"},"value_eth":{"type":"number"},"median_eth":{"type":"number"},"total_slots":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"pct":50,"window":"24h","max_eth":1.92,"samples":7180,"as_of_ms":1765532000000,"value_eth":0.031,"median_eth":0.031,"total_slots":7180}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_R3phmbGe2HxSnEFI7A4u8","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a statistical snapshot of Ethereum block value (MEV + fees) over a recent time window at a given percentile.","exampleAgentPrompt":"What's the 90th percentile Ethereum block value over the last 7 days — I want to know how much ETH top block proposers are capturing?","exampleUseCases":[{"title":"Validator revenue benchmarking","prompt":"What's the median Ethereum block value over the last 24 hours? I want to benchmark how my validator's recent rewards compare to the typical block."},{"title":"MEV opportunity sizing over 30 days","prompt":"Can you tell me the 75th percentile block value over the past 30 days? I'm trying to size how large MEV opportunities have been lately."},{"title":"Real-time block reward sanity check","prompt":"Give me the current 50th percentile Ethereum block value for the last 24 hours — I need a quick sanity check on what a normal block is worth right now."}],"resultDescription":"A JSON object containing the requested percentile block value in ETH, the median block value in ETH, the maximum block value in ETH, the number of samples analyzed, total slots counted, the lookback window used, and the timestamp of the data snapshot.","failureModes":["Invalid percentile value outside 1-99 range returns an error","Unrecognized window string (not 24h, 7d, or 30d) returns an error","Insufficient payment or missing x402 payment header returns HTTP 402","Temporary data unavailability may return a 503 or stale timestamp"],"whenToPreferThis":"Choose this endpoint when you need a quick statistical summary of Ethereum block proposer revenue (MEV + fees) without setting up an Ethereum node or connecting to a heavy indexer. It is especially useful for agents doing validator economics analysis, MEV benchmarking, or fee market research that need a single data point priced at fractions of a cent, with no API key or account required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:46:00.543Z","isFirstParty":false}