{"uid":"cap_OKUFiwuvkHto1yUTQAywG","slug":"seneschal-proposer-payment-query-41563f54","name":"Seneschal Proposer Payment Query","description":"Single-fact: what did the proposer of the latest block ACTUALLY get paid (priority fees + direct coinbase transfers — the value that reaches the validator, not the noisy block-value proxy)? Returns {block, proposer_payment_eth, builder, tx_count} plus a 1h aggregate {samples, mean_eth, median_eth, p90_eth, max_eth}. Per-block history export: /v1/premium/builder-bids.csv ($0.05, CSV or JSONL).","url":"https://api.seneschal.space/v1/q/proposer-payment","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"type":"json","example":{"hour":{"max_eth":0.41,"p90_eth":0.0388,"samples":291,"mean_eth":0.0182,"median_eth":0.0121},"block":23012001,"ts_ms":1765531988000,"builder":"titan","as_of_ms":1765532000000,"tx_count":309,"history_endpoint":"/v1/premium/builder-bids.csv","source_freshness_s":9,"proposer_payment_eth":0.010354286,"proposer_payment_wei":"10354286568285197"}},"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_iwzf158WksQSgkNQtA6SO","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 the actual ETH payment received by the latest Ethereum block proposer (priority fees + direct coinbase transfers) along with 1-hour aggregate statistics","exampleAgentPrompt":"What did the proposer of the latest Ethereum block actually get paid — including priority fees and direct coinbase transfers — and what does the 1-hour aggregate look like for mean, median, and p90 proposer payments?","exampleUseCases":null,"resultDescription":"Returns a JSON object with: block number, proposer_payment_eth (actual ETH paid), proposer_payment_wei, builder identity, tx_count, timestamp fields (ts_ms, as_of_ms, source_freshness_s), a history_endpoint link, and a 1h aggregate object containing samples count, mean_eth, median_eth, p90_eth, and max_eth.","failureModes":["No recent block data available — returns stale or empty result if chain is not synced","Rate limiting or payment failure via x402 protocol returns 402 Payment Required","Missing or malformed query parameters return 400 Bad Request","Service unavailable returns 503 if the underlying block data feed is down"],"whenToPreferThis":"Use this endpoint when you need the true validator/proposer payment (priority fees plus direct coinbase transfers) rather than the commonly used but noisy block-value proxy. Ideal for MEV research, validator yield analytics, block builder competitive analysis, or any application requiring accurate on-chain proposer economics rather than estimates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:44:38.027Z","isFirstParty":false}