{"uid":"cap_nRykAXZ0Tj5xtn5T-PYxZ","slug":"api-seneschal-space-164a8893","name":"Seneschal Builder Bid Distribution Stats","description":"Per-builder bid distribution (p25/median/p75/p90/p99/max) and hourly slot activity histogram from the Seneschal shadow recorder. Answers \"what bid value do I need to land in builder X right now?\" for searchers tuning bundle pricing. Free redacted live preview: GET /v1/premium/builder-stats/sample (no payment).","url":"https://api.seneschal.space/v1/premium/builder-stats","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"as_of_ms":1765532000000,"builders":[{"bid_eth":{"max":1.9,"p25":0.012,"p90":0.22,"median":0.031},"builder":"titan","share_pct":28.6,"slots_won":412}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{}}},"response":{"_truncated":true,"_originalSize":10258}},"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","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.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NzspSOW1jFYBhGx_Bq0bu","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns per-builder MEV bid distribution percentiles (p25/median/p75/p90/p99/max) and hourly slot activity histogram so searchers can tune bundle pricing to land in a specific builder.","exampleAgentPrompt":"Pull the current bid distribution stats for all builders from Seneschal — I want to see the p25, median, p75, p90, p99, and max bid values along with the hourly slot activity histogram so I can figure out what bid price I need to land my bundle.","exampleUseCases":[{"title":"Beat 90% of competitors on builder","prompt":"I'm submitting MEV bundles to builder X and keep missing blocks — pull the bid distribution from Seneschal and tell me what the p90 bid threshold is right now so I know exactly what I need to bid to beat 90% of competitors without massively overbidding."},{"title":"Compare builder slot pricing competitiveness","prompt":"Can you grab the Seneschal bid stats for all available block builders and compare them side by side? I want to see which builder has the lowest median and p75 bids so I can route my bundles to the least competitive one and improve my inclusion rate."},{"title":"Tune bundle price for peak hours","prompt":"Use Seneschal to pull the hourly slot activity histogram for my target builder — I want to see when competition spikes during the day so I can time my bundle submissions and dial in my bid price to match the actual competition level at each hour."}],"resultDescription":"A JSON object containing per-builder bid distribution statistics (p25, median, p75, p90, p99, max) and an hourly slot activity histogram sourced from the Seneschal shadow recorder, enabling searchers to calibrate bundle bid prices for specific block builders.","failureModes":["Payment not provided or invalid x402 payment: 402 Payment Required","Builder data temporarily unavailable due to shadow recorder lag: 503 Service Unavailable","Rate limit exceeded: 429 Too Many Requests","Invalid query parameters: 400 Bad Request"],"whenToPreferThis":"Use this endpoint when you need precise, real-time bid pricing intelligence for MEV bundle submission targeting specific block builders. Prefer this over generic mempool endpoints when you need percentile-level granularity on builder bid competition, especially for tuning bundle pricing to maximize inclusion probability without overbidding.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-16T00:34:53.734Z","isFirstParty":false}