{"uid":"cap_bwsMvrvATHpzoEVN6rBV0","slug":"seneschal-builder-bids-proposer-payment-export-f1b14229","name":"Seneschal Builder Bids & Proposer Payment Export","description":"Per-slot builder bids + realised proposer payment from the Seneschal shadow recorder, as CSV or JSON lines (?format=csv|jsonl). Range: ?from_block=&to_block= (max 100000 blocks) or ?window_ms= (max 30d). Columns: block, ts_ms, iso_time, miner, builder, actual_total_eth (= what the proposer actually got: priority + coinbase), actual_priority_eth, actual_coinbase_eth, shadow_bid_eth, would_have_won, tx_count. Live tail: GET /v1/q/proposer-payment ($0.001).","url":"https://api.seneschal.space/v1/premium/builder-bids.csv","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":{"to_block":{"type":"integer","description":"End block (inclusive); required with from_block; span ≤ 100000."},"window_ms":{"type":"integer","description":"Trailing window in ms (used when no block range given; ≤ 30d)."},"from_block":{"type":"integer","description":"Start block (inclusive)."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"string","description":"text/csv; one header row + one row per slot."}}}}},"responseSchema":{"type":"json","example":"block,ts_ms,iso_time,miner,builder,actual_total_eth,actual_priority_eth,actual_coinbase_eth,shadow_bid_eth,would_have_won,tx_count\n25009771,1777754812618,2026-05-02T...,0x4838...,beaverbuild,0.066254941,0.066254941,0.000000000,0.072000000,true,343\n"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/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_E5nB5N6CkEQ9EX72vRTGC","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-slot Ethereum block builder bids and realised proposer payments (priority + coinbase fees) as CSV or JSON lines over a specified block range or rolling time window","exampleAgentPrompt":"Pull me the Seneschal builder bids and actual proposer payment data for blocks 19000000 to 19010000 as a CSV — I want to see who won each slot, the shadow bid, and what the proposer actually got in priority fees and coinbase transfers.","exampleUseCases":[{"title":"Audit MEV payments last 30 days","prompt":"Grab me all the Seneschal proposer payment data for the last 30 days as JSONL — I want to compare what builders actually bid in the shadow recorder versus what proposers really received in priority fees and coinbase transfers, so I can audit whether any slots look suspicious."},{"title":"Backtest builder competition strategy","prompt":"Download the per-slot builder bid and proposer payment history from Seneschal for blocks 20500000 to 20600000 as a CSV — I need the winning builder address, the shadow bid, and the actual ETH paid each slot so I can backtest a strategy around builder competition patterns."},{"title":"Identify top-earning proposer slots","prompt":"Fetch me the Seneschal block builder data for the past week in JSONL format — I want to rank slots by total ETH earned by the proposer and see which builders won the most competitive slots during that period."}],"resultDescription":"A CSV (or JSONL) file with one row per slot containing: block number, timestamp (ms and ISO), miner address, winning builder address, actual total ETH paid to proposer (priority + coinbase), priority ETH, coinbase ETH, the shadow bid in ETH, a boolean indicating whether the shadow bid would have won, and transaction count per block.","failureModes":["Block range exceeds 100,000 blocks — returns error requiring narrower range","window_ms exceeds 30 days (2,592,000,000 ms) — returns error","Missing both from_block/to_block and window_ms — ambiguous query","from_block greater than to_block — invalid range error","Payment not included or insufficient — 402 Payment Required","Data not yet available for very recent blocks — empty or partial result"],"whenToPreferThis":"Use this endpoint when you need bulk historical or recent Ethereum builder bid and proposer payment data across many slots for analysis, backtesting, or audit. For a single live slot or real-time tail, prefer the cheaper /v1/q/proposer-payment endpoint. Choose CSV output for spreadsheet import or JSONL for streaming pipelines.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:35:03.025Z","isFirstParty":false}