{"uid":"cap_VhSzsaNuIk3gesOi8uhqN","slug":"seneschal-ethereum-block-builder-share-query-95a6dab3","name":"Seneschal Ethereum Block Builder Share Query","description":"Single-fact: what share of slots in the window did `builder` win? Substring match.","url":"https://api.seneschal.space/v1/q/builder-share","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","required":["builder"],"properties":{"window":{"type":"string","description":"Lookback window: 24h, 7d or 30d (default 24h)."},"builder":{"type":"string","description":"Builder name (substring match)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"window":{"type":"string"},"builder":{"type":"string"},"as_of_ms":{"type":"integer"},"share_pct":{"type":"number"},"slots_won":{"type":"integer"},"total_slots":{"type":"integer"}}}}}}},"responseSchema":{"type":"json","example":{"window":"24h","builder":"titan","as_of_ms":1765532000000,"share_pct":28.6,"slots_won":412,"total_slots":1440}},"example":{"request":{"builder":"default","properties":"builder_share,mev_telemetry"},"response":{"window":"24h","builder":"default","as_of_ms":1781764435571,"share_pct":0,"slots_won":0,"total_slots":7183}},"exampleRequest":{"builder":"default","properties":"builder_share,mev_telemetry"},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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_tVWbskiM27-V9k1o4czJx","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":"Retrieves current builder share and MEV telemetry data from Seneschal's Ethereum mainnet block builder.","exampleAgentPrompt":"Can you pull the current builder share stats from Seneschal's Ethereum mainnet block builder so I can see the latest MEV and liquidation telemetry?","exampleUseCases":[{"title":"Monitor MEV builder performance","prompt":"Hey, can you grab the latest builder share stats from Seneschal so I can see how their Ethereum mainnet block builder is performing compared to last week in terms of MEV metrics?"},{"title":"Track Ethereum liquidation events","prompt":"Pull the current liquidation telemetry from Seneschal's block builder for me — I want to see what liquidation activity has been happening on Ethereum mainnet recently."},{"title":"Compare block builder share data","prompt":"Can you fetch the Seneschal builder share statistics right now? I'm trying to benchmark their block share against other builders and need the latest numbers."}],"resultDescription":"Returns current builder share statistics and liquidation telemetry data from the Seneschal Ethereum mainnet block builder, including MEV-related metrics.","failureModes":["Payment required (402) if USDC balance insufficient on Base","Invalid or missing x402 payment header returns auth error","Rate limiting if query frequency exceeds plan","Network timeout if Ethereum mainnet data unavailable","Malformed request returns 400 with schema error"],"whenToPreferThis":"Use this endpoint when you need real-time Ethereum block builder share data or free liquidation telemetry from a specialized MEV-aware builder service. Prefer over generic block explorers when you need builder-specific MEV metrics and liquidation event data with x402 micropayment access.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:42:59.653Z","isFirstParty":false}