{"uid":"cap_psIXWKkJRRMigDEVLAFj2","slug":"seneschal-builder-bid-query-53979979","name":"Seneschal Builder Bid Query","description":"Single-fact: percentile bid value (in ETH) for `builder` over the window. Returns {value_eth, samples}.","url":"https://api.seneschal.space/v1/q/builder-bid","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":{"pct":{"type":"string","description":"Percentile 0-100 (default 50)."},"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":{"samples":{"type":"integer"},"value_eth":{"type":"number"}}}}}}},"responseSchema":{"type":"json","example":{"samples":412,"value_eth":0.22}},"example":null,"exampleRequest":null,"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_0DURVg0IxC2885nDyysPn","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 the current Ethereum mainnet block builder bid from Seneschal's MEV-boost compatible block builder","exampleAgentPrompt":"What is the current block builder bid from Seneschal's Ethereum mainnet block builder right now?","exampleUseCases":[{"title":"Monitor MEV boost builder bids","prompt":"Can you check what the current block builder bid is from Seneschal's Ethereum mainnet block builder and let me know if it looks competitive?"},{"title":"Evaluate validator block proposal","prompt":"I'm running a validator and need to decide whether to accept a builder bid — pull the latest bid from Seneschal's block builder so I can see the bid value and payload details."},{"title":"Track block building activity","prompt":"Keep an eye on Seneschal's Ethereum block builder for me and tell me whenever the current builder bid changes significantly in value."}],"resultDescription":"Returns the current builder bid from Seneschal's Ethereum mainnet block builder, including the bid value, block payload metadata, and related MEV data useful for validators or block proposers evaluating builder bids.","failureModes":["No current bid available if no block is being actively built","Payment required (402) if USDC x402 balance is insufficient","Invalid or malformed query parameters return 400 error","Builder temporarily offline or between slots returns empty response","Rate limiting if too many requests in short succession"],"whenToPreferThis":"Use this endpoint when you need to query a live Ethereum mainnet block builder bid, particularly in MEV-boost validator setups or when monitoring block building activity. Prefer Seneschal's builder if you also use their private payment watch service and want a unified payment model via x402 USDC on Base.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:17.828Z","isFirstParty":false}