{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Knowledge Base","colors":{"primary":"#2f6bff","light":"#2f6bff","dark":"#4d87ff"},"logo":{"light":"https://mintcdn.com/bitflyexplorergmbh/mis7Gg5q4_j4hzka/images/logo_light.transparent.png?fit=max\u0026auto=format\u0026n=mis7Gg5q4_j4hzka\u0026q=85\u0026s=f4937b576e7c0255ffe22197eafc93e9","dark":"https://mintcdn.com/bitflyexplorergmbh/mis7Gg5q4_j4hzka/images/logo_dark.transparent.png?fit=max\u0026auto=format\u0026n=mis7Gg5q4_j4hzka\u0026q=85\u0026s=4fd81d79d3d1a307cbe621f7a728c0b7","href":"https://docs.beaconcha.in"},"favicon":"https://mintcdn.com/bitflyexplorergmbh/ai7I6vS_c5RPp4wC/images/favicon.ico?fit=max\u0026auto=format\u0026n=ai7I6vS_c5RPp4wC\u0026q=85\u0026s=15681e9562ed19ba657cee264d79970b","background":{"color":{"light":"#f5f7fb","dark":"#0c1018"}},"navbar":{"links":[{"icon":"discord","href":"https://dsc.gg/beaconchain","label":"Discord"}],"primary":{"type":"button","label":"Get API Key","href":"https://beaconcha.in/user/settings"}},"footer":{"socials":{"x":"https://x.com/beaconcha_in","github":"https://github.com/gobitfly","discord":"https://dsc.gg/beaconchain"},"links":[{"header":"General","items":[{"label":"API Pricing","href":"https://beaconcha.in/pricing"},{"label":"API Status","href":"https://status.beaconcha.in/"}]},{"header":"Legal","items":[{"label":"Imprint","href":"https://docs.beaconcha.in/legal/imprint"},{"label":"Terms","href":"https://docs.beaconcha.in/legal/terms"},{"label":"Privacy","href":"https://docs.beaconcha.in/legal/privacy"}]}]},"fonts":{"heading":{"family":"Urbanist","weight":600},"body":{"family":"Urbanist","weight":400}},"integrations":{"ga4":{"measurementId":"G-FG07H4ST8Q"},"cookies":{"key":"bc-analytics-consent","value":"granted"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bitflyexplorergmbh","hasAudioNarration":false,"actualSubdomain":"bitflyexplorergmbh","customDomains":["docs.beaconcha.in"],"gitSource":{"type":"github","owner":"gobitfly","repo":"beaconchain-monorepo","deployBranch":"docs-deploy","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aea04aa8c693588234f6500","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Docs","count":93},{"language":"default","tag":"V2 API Docs","count":82},{"language":"default","tag":"Network","count":28},{"language":"default","tag":"Documentation","count":21},{"language":"default","tag":"Use Cases","count":20},{"language":"default","tag":"Beaconcha.in Features","count":15},{"language":"default","tag":"V1 API Docs","count":10},{"language":"default","tag":"Validator Duties","count":10},{"language":"default","tag":"Guides","count":8},{"language":"default","tag":"Validator Metrics","count":8}]},"assistantConfig":{"enableAskAiButton":true,"enableAskAiSearchBar":false,"deflection":{"enabled":false,"email":"support@beaconcha.in","showHelpButton":true}},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--primary: 47 107 255;--primary-light: 91 140 255;--primary-dark: 31 76 190;--background-light: 245 247 251;--background-dark: 12 16 24;--bc-border-light: 214 221 234;--bc-border-dark: 54 63 78;--bc-surface-light: 255 255 255;--bc-surface-dark: 20 25 35}html,body{text-rendering:optimizeLegibility;-webkit-font-smoothing:antialiased}body{background:radial-gradient(circle at 5% 10%, rgba(47, 107, 255, 0.08), transparent 30%),\n radial-gradient(circle at 92% 14%, rgba(0, 188, 212, 0.08), transparent 28%)}.dark body{background:radial-gradient(circle at 8% 8%, rgba(47, 107, 255, 0.22), transparent 34%),\n radial-gradient(circle at 96% 16%, rgba(9, 16, 31, 0.78), transparent 32%),\n linear-gradient(180deg, #0c1018 0%, #090d14 100%)}a{text-underline-offset:0.2em}.prose code,pre{border:1px solid rgba(var(--bc-border-light), 0.8)}.dark .prose code,.dark pre{border-color:rgba(var(--bc-border-dark), 0.85)}nav,aside,header,main [class*=\"card\"],main [class*=\"panel\"]{border-color:rgba(var(--bc-border-light), 0.65)}.dark nav,.dark aside,.dark header,.dark main [class*=\"card\"],.dark main [class*=\"panel\"]{border-color:rgba(var(--bc-border-dark), 0.75)}tbody tr:hover{background:rgba(47, 107, 255, 0.07)}.dark tbody tr:hover{background:rgba(47, 107, 255, 0.14)}[data-testid=\"optional-fields-group\"]{display:block!important;content-visibility:visible!important}[data-testid=\"optional-fields-row\"],[data-testid=\"optional-fields-toggle\"]{display:none!important}"}],"page":{"pagePath":"api-reference/ethereum/block/rewards","slug":"/api-reference/ethereum/block/rewards","pageMetadata":{"title":"Details","description":"Offers detailed insights into the execution layer rewards for a specific block, including transaction fees and MEV (Maximal Extractable Value). \n\nYou can query using a block number or the keywords \"latest\" / \"finalized\".\n","deprecated":null,"version":null,"sidebarTitle":"Rewards","openapi":"/v3/bundled.yaml post /api/v2/ethereum/block/rewards","href":"/api-reference/ethereum/block/rewards","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Offers detailed insights into the execution layer rewards for a specific block, including transaction fees and MEV (Maximal Extractable Value).\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"You can query using a block number or the keywords “latest” / “finalized”.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Details","description":"Offers detailed insights into the execution layer rewards for a specific block, including transaction fees and MEV (Maximal Extractable Value). \n\nYou can query using a block number or the keywords \"latest\" / \"finalized\".\n","deprecated":null,"version":null,"sidebarTitle":"Rewards","openapi":"/v3/bundled.yaml post /api/v2/ethereum/block/rewards","href":"/api-reference/ethereum/block/rewards","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/bitflyexplorergmbh/0accca00cdc5cb9a/support-widget.js","/_mintlify/custom/bitflyexplorergmbh/f7c459cc7b5d3b45/ga-page-views.js","/_mintlify/custom/bitflyexplorergmbh/ce23a3e5e6eeb907/analytics-consent.js"],"openApiReferenceData":{"operation":{"operationId":"GetBlockRewards","tags":["Block"],"summary":"Details","x-mint":{"href":"/api-reference/ethereum/block/rewards"},"description":"Offers detailed insights into the execution layer rewards for a specific block, including transaction fees and MEV (Maximal Extractable Value). \n\nYou can query using a block number or the keywords \"latest\" / \"finalized\".\n","requestBody":"20a72666-e291-4090-9eae-ea1cc5abd8e6","responses":{"200":"e3b7e0ed-c26b-4521-9b1b-1810882766db","400":"0b913b1c-ddf5-4eeb-8ae4-ff8676685cde","401":"de5423a9-7a28-40c2-8ab9-4ecb217ced52","403":"8715469f-c0e6-4b72-a2c5-a17494a65577","404":"92afe993-379e-4289-8589-76404f3535af","405":"75fdc378-2006-42b9-97f2-3756d54bc79b","429":"8a4acd35-3f36-4881-a7e4-4593adc137dc","500":"e498f906-48ea-48bc-bcec-f1b62cf64c25","default":"be34f272-cdd9-46a5-9ec2-69a6234fb772"},"method":"post","type":"path","servers":["68600598-006f-4d78-a840-93daacf4d3c9"],"security":["e0f71b8f-ce4e-47ec-a449-3f4991045d07"],"path":"/api/v2/ethereum/block/rewards","baseUrlOptions":["https://beaconcha.in"],"title":"Details","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["block"],"properties":{"block":{"oneOf":[{"type":"object","title":"Number","description":"Specify a block using one of the following methods.\n- Block number\n- View: \"latest\" or \"finalized\" \n","default":"latest","required":["number"],"properties":{"number":{"type":"integer","minimum":0,"description":"Block by number.","isRequired":true,"uniqueKey":"block.oneOf.0.number","typeLabel":"integer"}},"isRequired":true,"uniqueKey":"block.oneOf.0","typeLabel":"Number · object"},{"type":"object","title":"View","description":"Specify a block using one of the following methods.\n- Block number\n- View: \"latest\" or \"finalized\" \n","default":"latest","required":["view"],"properties":{"view":{"type":"string","enum":["latest","finalized"],"description":"- \"latest\": Refers to the most recent block, which may be subject to reorganization.\n- \"finalized\": Refers to the latest block that has been finalized and is not subject to change.\n","isRequired":true,"uniqueKey":"block.oneOf.1.view","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"block.oneOf.1","typeLabel":"View · object"}],"isRequired":true,"uniqueKey":"block","typeLabel":"Number · object | View · object"},"chain":{"type":"string","enum":["mainnet","hoodi"],"default":"mainnet","description":"The Ethereum chain to query.","uniqueKey":"chain","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"example":{"block":{"view":"latest"},"chain":"mainnet"},"examples":{"Example":{"title":"Example","value":{"block":{"view":"latest"},"chain":"mainnet"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"e3b7e0ed-c26b-4521-9b1b-1810882766db":{"description":"Successful response.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"total_reward":{"type":"object","properties":{"amount":{"type":"string","description":"Amount in wei (1 ETH = 10^18 wei)","pattern":"^(0|-?[1-9][0-9]*)$","isRequired":true,"uniqueKey":"data.total_reward.amount","typeLabel":"string"},"recipient":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"A standard Ethereum address (20-byte hex string with 0x prefix).","isRequired":true,"uniqueKey":"data.total_reward.recipient.address","typeLabel":"string"},"is_contract":{"type":"boolean","isRequired":true,"uniqueKey":"data.total_reward.recipient.is_contract","typeLabel":"boolean"}},"required":["address","is_contract"],"isRequired":true,"uniqueKey":"data.total_reward.recipient","typeLabel":"object"}},"required":["amount","recipient"],"description":"Total execution layer reward earned by the block proposer or miner for this block. Use this field to determine the total earnings for the proposer or miner of the block.\n\nBefore the Glamsterdam (Gloas) fork this is the complete amount the proposer or miner received, including priority fees and MEV (Maximal Extractable Value). The sum of the individual components can differ from this value, because MEV rewards already include priority fees.\n\nFrom the Glamsterdam (Gloas) fork on, when an external builder built the payload, this is the proposer's payment from the builder's bid, paid to the bid's fee recipient: the bid value, unless the settlement shows the chain did not pay it, plus the part of the builder's trusted execution payment that was found in this payload. For a recent block the amount can change later, as described for `mev`. For a self-built payload it is the priority fees.\n\nExperimental: this post-fork meaning may change before the mainnet release. See [Glamsterdam API](/api/glamsterdam).\n","isRequired":true,"uniqueKey":"data.total_reward","typeLabel":"object"},"priority_fees":{"type":"object","properties":{"amount":{"type":"string","description":"Amount in wei (1 ETH = 10^18 wei)","pattern":"^(0|-?[1-9][0-9]*)$","isRequired":true,"uniqueKey":"data.priority_fees.amount","typeLabel":"string"},"recipient":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"A standard Ethereum address (20-byte hex string with 0x prefix).","isRequired":true,"uniqueKey":"data.priority_fees.recipient.address","typeLabel":"string"},"is_contract":{"type":"boolean","isRequired":true,"uniqueKey":"data.priority_fees.recipient.is_contract","typeLabel":"boolean"}},"required":["address","is_contract"],"isRequired":true,"uniqueKey":"data.priority_fees.recipient","typeLabel":"object"}},"required":["amount","recipient"],"description":"Details about transaction priority fees for both PoW and PoS blocks.\n\nPrior to EIP-1559 (introduced in the London hardfork in August 2021), priority fees were equivalent to gas tips paid by users to incentivize miners/validators to include their transactions in blocks. Post EIP-1559, priority fees represent the total tips above the base fee that users pay to miners/validators.\n\nSince EIP-4844 (introduced in the Dencun hardfork), priority fees also include fees from blob transactions.\n\nNote: Whenever MEV rewards are present, it is likely that the recipient of priority fees is the block builder rather than the proposer or miner. From the Glamsterdam (Gloas) fork on, priority fees go to the payload's fee recipient, which is normally the builder.\n","isRequired":true,"uniqueKey":"data.priority_fees","typeLabel":"object"},"execution_reference":{"type":"object","description":"Reference to an execution layer block if one exists for the given slot.\nThis will be null for missed slots.\n","properties":{"block":{"type":"integer","minimum":0,"description":"Block by number.","isRequired":true,"uniqueKey":"data.execution_reference.block","typeLabel":"integer"},"hash":{"type":"string","pattern":"^0x[a-fA-F0-9]{64}$","description":"A 32-byte block hash represented as a hex string with 0x prefix.","isRequired":true,"uniqueKey":"data.execution_reference.hash","typeLabel":"string"}},"required":["block","hash"],"isRequired":true,"uniqueKey":"data.execution_reference","typeLabel":"object"},"mev":{"oneOf":[{"type":"object","description":"Information about the Maximal Extractable Value (MEV) rewards for blocks after the Merge. If present, it equals `total_reward`.\n\nBefore the Glamsterdam (Gloas) fork, present when a relay delivered the block, and it includes the priority fees already. For non-finalized blocks the relay data can arrive later, so a null value means either no MEV was present or the data is not yet available. For finalized blocks, null indicates that no MEV was present.\n\nFrom the Glamsterdam (Gloas) fork on, present when an external builder built the payload: the bid value, unless the settlement shows the chain did not pay it, plus the trusted execution payment found in the payload, paid to the bid's fee recipient. For a recent block the amount can change later: the trusted payment is added once it is measured, and the bid value drops to 0 if the settlement shows the chain did not pay it. Null for a self-built payload. A slot whose payload was withheld has no execution block and is not served by this endpoint.\n\nExperimental: this post-fork meaning may change before the mainnet release. See [Glamsterdam API](/api/glamsterdam).\n","required":["amount","recipient"],"properties":{"amount":{"type":"string","description":"Amount in wei (1 ETH = 10^18 wei)","pattern":"^(0|-?[1-9][0-9]*)$","isRequired":true,"uniqueKey":"data.mev.oneOf.0.amount","typeLabel":"string"},"recipient":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"A standard Ethereum address (20-byte hex string with 0x prefix).","isRequired":true,"uniqueKey":"data.mev.oneOf.0.recipient.address","typeLabel":"string"},"is_contract":{"type":"boolean","isRequired":true,"uniqueKey":"data.mev.oneOf.0.recipient.is_contract","typeLabel":"boolean"}},"required":["address","is_contract"],"isRequired":true,"uniqueKey":"data.mev.oneOf.0.recipient","typeLabel":"object"}},"uniqueKey":"data.mev.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.mev.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.mev","typeLabel":"object | null"},"mining":{"oneOf":[{"type":"object","description":"Information about the mining rewards for proof-of-work era blocks prior to the Merge.\n","properties":{"recipient":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"A standard Ethereum address (20-byte hex string with 0x prefix).","isRequired":true,"uniqueKey":"data.mining.oneOf.0.recipient.address","typeLabel":"string"},"is_contract":{"type":"boolean","isRequired":true,"uniqueKey":"data.mining.oneOf.0.recipient.is_contract","typeLabel":"boolean"}},"required":["address","is_contract"],"isRequired":true,"uniqueKey":"data.mining.oneOf.0.recipient","typeLabel":"object"},"static_block_reward":{"type":"string","description":"The flat reward for mining a block in the PoW era","pattern":"^(0|-?[1-9][0-9]*)$","isRequired":true,"uniqueKey":"data.mining.oneOf.0.static_block_reward","typeLabel":"string"},"uncle_inclusion_reward":{"type":"string","description":"The reward for including uncle blocks in the PoW era","pattern":"^(0|-?[1-9][0-9]*)$","isRequired":true,"uniqueKey":"data.mining.oneOf.0.uncle_inclusion_reward","typeLabel":"string"}},"required":["recipient","static_block_reward","uncle_inclusion_reward"],"uniqueKey":"data.mining.oneOf.0","typeLabel":"object"},{"type":"null","description":"Information about the mining rewards for proof-of-work era blocks prior to the Merge.\n","properties":{"recipient":{"type":"object","properties":{"address":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"A standard Ethereum address (20-byte hex string with 0x prefix)."},"is_contract":{"type":"boolean"}},"required":["address","is_contract"]},"static_block_reward":{"type":"string","description":"The flat reward for mining a block in the PoW era","pattern":"^(0|-?[1-9][0-9]*)$"},"uncle_inclusion_reward":{"type":"string","description":"The reward for including uncle blocks in the PoW era","pattern":"^(0|-?[1-9][0-9]*)$"}},"required":["recipient","static_block_reward","uncle_inclusion_reward"],"uniqueKey":"data.mining.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.mining","typeLabel":"object | null"},"consensus_reference":{"oneOf":[{"type":"object","description":"Reference to a consensus layer block if one exists for the given slot.\nThis will be null for the PoW era.\n","properties":{"slot":{"type":"integer","minimum":0,"description":"Slot by number.","isRequired":true,"uniqueKey":"data.consensus_reference.oneOf.0.slot","typeLabel":"integer"},"epoch":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"data.consensus_reference.oneOf.0.epoch","typeLabel":"integer"},"block_root":{"oneOf":[{"type":"string","description":"A 32-byte block root represented as a hex string with 0x prefix.","pattern":"^0x[a-fA-F0-9]{64}$","uniqueKey":"data.consensus_reference.oneOf.0.block_root.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.consensus_reference.oneOf.0.block_root.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.consensus_reference.oneOf.0.block_root","typeLabel":"string | null"}},"required":["slot","epoch"],"uniqueKey":"data.consensus_reference.oneOf.0","typeLabel":"object"},{"type":"null","description":"Reference to a consensus layer block if one exists for the given slot.\nThis will be null for the PoW era.\n","properties":{"slot":{"type":"integer","minimum":0,"description":"Slot by number."},"block_root":{"oneOf":[{"type":"string","description":"A 32-byte block root represented as a hex string with 0x prefix.","pattern":"^0x[a-fA-F0-9]{64}$"},{"type":"null"}]},"epoch":{"type":"integer","minimum":0}},"required":["slot","epoch"],"uniqueKey":"data.consensus_reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.consensus_reference","typeLabel":"object | null"},"finality":{"type":"string","description":"From the Glamsterdam hard fork on, a block whose payload inclusion the chain has not decided yet is `not_finalized`, even when its consensus block is finalized, because finalizing a checkpoint does not finalize the checkpoint block's own payload, which the next block includes or skips.","enum":["not_finalized","finalized"],"example":"finalized","uniqueKey":"data.finality","typeLabel":"enum\u003cstring>"}},"required":["total_reward","execution_reference","priority_fees"],"isRequired":true,"uniqueKey":"data","typeLabel":"object"}},"description":"Response containing basic information about the block reward.","required":["data"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"total_reward":{"amount":"\u003cstring>","recipient":{"address":"\u003cstring>","is_contract":true}},"priority_fees":{"amount":"\u003cstring>","recipient":{"address":"\u003cstring>","is_contract":true}},"execution_reference":{"block":1,"hash":"\u003cstring>"},"mev":{"amount":"\u003cstring>","recipient":{"address":"\u003cstring>","is_contract":true}},"mining":{"recipient":{"address":"\u003cstring>","is_contract":true},"static_block_reward":"\u003cstring>","uncle_inclusion_reward":"\u003cstring>"},"consensus_reference":{"slot":1,"epoch":1,"block_root":"\u003cstring>"},"finality":"finalized"}}}},"exampleType":"generated"}},"exampleType":"generated"},"0b913b1c-ddf5-4eeb-8ae4-ff8676685cde":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Bad request. Please check your input and try again."},"examples":{"Example":{"title":"Example","value":{"error":"Bad request. Please check your input and try again."}}},"exampleType":"examples"}},"exampleType":"examples"},"de5423a9-7a28-40c2-8ab9-4ecb217ced52":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Unauthorized. Please provide a valid API key."},"examples":{"Example":{"title":"Example","value":{"error":"Unauthorized. Please provide a valid API key."}}},"exampleType":"examples"}},"exampleType":"examples"},"8715469f-c0e6-4b72-a2c5-a17494a65577":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"endpoint not allowed for your subscription tier. upgrade your subscription at https://beaconcha.in/pricing."},"examples":{"Example":{"title":"Example","value":{"error":"endpoint not allowed for your subscription tier. upgrade your subscription at https://beaconcha.in/pricing."}}},"exampleType":"examples"}},"exampleType":"examples"},"92afe993-379e-4289-8589-76404f3535af":{"description":"Not Found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"The requested resource was not found."},"examples":{"Example":{"title":"Example","value":{"error":"The requested resource was not found."}}},"exampleType":"examples"}},"exampleType":"examples"},"75fdc378-2006-42b9-97f2-3756d54bc79b":{"description":"Method Not Allowed","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"method not allowed: GET. all public API endpoints use POST."},"examples":{"Example":{"title":"Example","value":{"error":"method not allowed: GET. all public API endpoints use POST."}}},"exampleType":"examples"}},"exampleType":"examples"},"8a4acd35-3f36-4881-a7e4-4593adc137dc":{"description":"Rate Limit Exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Rate limit exceeded. Please try again later."},"examples":{"Example":{"title":"Example","value":{"error":"Rate limit exceeded. Please try again later."}}},"exampleType":"examples"}},"exampleType":"examples"},"e498f906-48ea-48bc-bcec-f1b62cf64c25":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"internal server error. please try again later."},"examples":{"Example":{"title":"Example","value":{"error":"internal server error. please try again later."}}},"exampleType":"examples"}},"exampleType":"examples"},"be34f272-cdd9-46a5-9ec2-69a6234fb772":{"description":"An unexpected error response.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"An unexpected error occurred."},"examples":{"Example":{"title":"Example","value":{"error":"An unexpected error occurred."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"e0f71b8f-ce4e-47ec-a449-3f4991045d07":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"Authorization header with value: Bearer YOUR_TOKEN. Refer to the [API Keys](/api/overview#api-keys) section to create your API key.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"68600598-006f-4d78-a840-93daacf4d3c9":{"url":"https://beaconcha.in","description":"Production API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Authorization header with value: Bearer YOUR_TOKEN. Refer to the [API Keys](/api/overview#api-keys) section to create your API key.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Authorization header with value: Bearer YOUR_TOKEN. Refer to the [API Keys](/api/overview#api-keys) section to create your API key.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"v3/bundled.yaml"},"subdomain":"bitflyexplorergmbh","siteName":"Knowledge Base","title":"Details - Knowledge Base","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T15:58:46.569Z","originalFileLocation":"api-reference/ethereum/block/rewards.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Offers detailed insights into the execution layer rewards for a specific block, including transaction fees and MEV (Maximal Extractable Value). You can query using a block number or the keywords \u0026quot;latest\u0026quot; / \u0026quot;finalized\u0026quot;.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Knowledge Base\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bitflyexplorergmbh/ql_f-FKhQdaMtpRp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bitflyexplorergmbh/ql_f-FKhQdaMtpRp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bitflyexplorergmbh/ql_f-FKhQdaMtpRp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bitflyexplorergmbh/ql_f-FKhQdaMtpRp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bitflyexplorergmbh/ql_f-FKhQdaMtpRp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bitflyexplorergmbh/ql_f-FKhQdaMtpRp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bitflyexplorergmbh/ql_f-FKhQdaMtpRp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bitflyexplorergmbh/ql_f-FKhQdaMtpRp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bitflyexplorergmbh/ql_f-FKhQdaMtpRp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Details - Knowledge Base\">\u003cmeta data-mint-head property=\"og:description\" content=\"Offers detailed insights into the execution layer rewards for a specific block, including transaction fees and MEV (Maximal Extractable Value). You can query using a block number or the keywords \u0026quot;latest\u0026quot; / \u0026quot;finalized\u0026quot;.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Knowledge Base\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.beaconcha.in/api-reference/ethereum/block/rewards\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bitflyexplorergmbh.mintlify.site/_mintlify/api/og/v2?division=Block+Duties\u0026amp;title=Details\u0026amp;description=Offers+detailed+insights+into+the+execution+layer+rewards+for+a+specific+block%2C+including+transaction+fees+and+MEV+%28Maximal+Extractable+Value%29.+%0A%0AYou+can+query+\u0026amp;theme=c14562316d6a3e9c72fac136\u0026amp;signature=9aad7aee28df14e1b7d04b754897e1fe8a4af6d2e27e0bf32f4e3f4037607a37\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Details - Knowledge Base\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Offers detailed insights into the execution layer rewards for a specific block, including transaction fees and MEV (Maximal Extractable Value). You can query using a block number or the keywords \u0026quot;latest\u0026quot; / \u0026quot;finalized\u0026quot;.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bitflyexplorergmbh.mintlify.site/_mintlify/api/og/v2?division=Block+Duties\u0026amp;title=Details\u0026amp;description=Offers+detailed+insights+into+the+execution+layer+rewards+for+a+specific+block%2C+including+transaction+fees+and+MEV+%28Maximal+Extractable+Value%29.+%0A%0AYou+can+query+\u0026amp;theme=c14562316d6a3e9c72fac136\u0026amp;signature=9aad7aee28df14e1b7d04b754897e1fe8a4af6d2e27e0bf32f4e3f4037607a37\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bitflyexplorergmbh/ql_f-FKhQdaMtpRp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Knowledge Base\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2f6bff\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.beaconcha.in/api-reference/ethereum/block/rewards\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/ethereum/block/rewards.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.beaconcha.in/#organization\",\"name\":\"Knowledge Base\",\"url\":\"https://docs.beaconcha.in\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bitflyexplorergmbh/mis7Gg5q4_j4hzka/images/logo_light.transparent.png?fit=max\u0026auto=format\u0026n=mis7Gg5q4_j4hzka\u0026q=85\u0026s=f4937b576e7c0255ffe22197eafc93e9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.beaconcha.in#website\",\"name\":\"Knowledge Base\",\"url\":\"https://docs.beaconcha.in\",\"publisher\":{\"@id\":\"https://docs.beaconcha.in/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.beaconcha.in/api-reference/ethereum/block/rewards#webpage\",\"url\":\"https://docs.beaconcha.in/api-reference/ethereum/block/rewards\",\"name\":\"Details\",\"description\":\"Offers detailed insights into the execution layer rewards for a specific block, including transaction fees and MEV (Maximal Extractable Value). You can query using a block number or the keywords \\\"latest\\\" / \\\"finalized\\\".\",\"dateModified\":\"2026-11-03T15:58:46.569Z\",\"isPartOf\":{\"@id\":\"https://docs.beaconcha.in#website\"},\"breadcrumb\":{\"@id\":\"https://docs.beaconcha.in/api-reference/ethereum/block/rewards#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.beaconcha.in/api-reference/ethereum/block/rewards#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"V2 API Docs\",\"item\":\"https://docs.beaconcha.in/api/ai-integration\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Validator Duties\",\"item\":\"https://docs.beaconcha.in/api-reference/ethereum/validators/attestation-slots\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Block Duties\",\"item\":\"https://docs.beaconcha.in/api-reference/ethereum/validators/proposal-slots\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Details\",\"item\":\"https://docs.beaconcha.in/api-reference/ethereum/block/rewards\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.beaconcha.in/api-reference/ethereum/block/rewards#apireference\",\"headline\":\"Details\",\"name\":\"Details\",\"description\":\"Offers detailed insights into the execution layer rewards for a specific block, including transaction fees and MEV (Maximal Extractable Value). You can query using a block number or the keywords \\\"latest\\\" / \\\"finalized\\\".\",\"url\":\"https://docs.beaconcha.in/api-reference/ethereum/block/rewards\",\"mainEntityOfPage\":{\"@id\":\"https://docs.beaconcha.in/api-reference/ethereum/block/rewards#webpage\"},\"dateModified\":\"2026-11-03T15:58:46.569Z\",\"publisher\":{\"@id\":\"https://docs.beaconcha.in/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.beaconcha.in#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Knowledge Base\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Knowledge Base","nav":{"global":null,"tabs":[{"tab":"API Docs","icon":"code","groups":[{"group":"Introduction","pages":[{"title":"Getting Started","href":"/api/overview"}]},{"group":"V2 API Docs","pages":[{"group":"Guides","expanded":true,"pages":[{"title":"AI Integration","href":"/api/ai-integration"},{"title":"Migrating from V1 to V2 API","href":"/api/v1-to-v2-migration"},{"title":"Glamsterdam API (experimental)","href":"/api/glamsterdam"},{"title":"Pagination","href":"/api/pagination"},{"title":"Understanding Rate Limits","href":"/api/rate-limits"},{"title":"API Error Messages","href":"/api/error-handling"},{"title":"Account Management FAQ","href":"/api/account-management"},{"title":"Dashboard management and data API","href":"/api/dashboard"}]},{"group":"Use Cases","expanded":true,"pages":[{"title":"Overview","href":"/use-cases/introduction"},{"group":"Calculate Validator Rewards","expanded":false,"pages":[{"title":"Introduction","href":"/use-cases/rewards-introduction"},{"title":"Custom Range Rewards","href":"/use-cases/rewards-custom-range"},{"title":"Tax Year Calculations","href":"/use-cases/rewards-tax-calculations"},{"title":"Dashboard as Private Sets","href":"/use-cases/rewards-dashboard-private-sets"},{"title":"Epoch \u0026 Time Zone Conversion","href":"/use-cases/rewards-epoch-conversion"}]},{"group":"Entity benchmarking","expanded":false,"pages":[{"title":"Introduction","href":"/use-cases/entity-benchmarking-overview"},{"title":"Rank and Compare Entities","href":"/use-cases/rank-and-compare-entities"},{"title":"Benchmark Entity vs Network","href":"/use-cases/benchmark-entity-vs-network"},{"title":"Private Entity Benchmarking with Dashboards","href":"/use-cases/private-entity-benchmarking-with-dashboard"}]},{"group":"Monitor Validator Performance","expanded":false,"pages":[{"title":"Introduction","href":"/use-cases/performance-introduction"},{"title":"Embed BeaconScore® in Your Product","href":"/use-cases/embed-beaconscore"},{"title":"Analyze Missed Rewards","href":"/use-cases/missed-rewards"},{"title":"APY \u0026 ROI Metrics","href":"/use-cases/apy-roi"}]},{"group":"MEV analysis","expanded":false,"pages":[{"title":"Introduction","href":"/use-cases/mev-analysis-introduction"},{"title":"Compare MEV Timing","href":"/use-cases/compare-mev-timing"},{"title":"Investigate a Block","href":"/use-cases/investigate-mev-block"}]},{"group":"Track Queues \u0026 Operations","expanded":false,"pages":[{"title":"Introduction","href":"/use-cases/queue-tracking"},{"title":"Estimate Queue Wait Times","href":"/use-cases/queue-wait-times"},{"title":"Track Staking Inflows \u0026 Outflows","href":"/use-cases/staking-inflows-outflows"}]}]},{"group":"Network","expanded":true,"pages":[{"group":"Staking Entities","expanded":true,"pages":[{"title":"💎 Overview","deprecated":null,"version":null,"sidebarTitle":"Overview","openapi":"/v3/bundled.yaml post /api/v2/ethereum/entities","href":"/api-reference/ethereum/entities/overview"},{"title":"💎 Sub Entities","deprecated":null,"version":null,"sidebarTitle":"Sub entities","openapi":"/v3/bundled.yaml post /api/v2/ethereum/entity/sub-entities","href":"/api-reference/ethereum/entity/sub-entities"},{"title":"💎 MEV Timing","deprecated":null,"version":null,"sidebarTitle":"Mev timing","openapi":"/v3/bundled.yaml post /api/v2/ethereum/entity/mev-timing","href":"/api-reference/ethereum/entity/mev-timing"},{"title":"💎 Proposal Timing","deprecated":null,"version":null,"sidebarTitle":"Proposal Timing","tag":"Experimental","openapi":"/v3/bundled.yaml post /api/v2/ethereum/entity/proposal-timing","href":"/api-reference/ethereum/entity/proposal-timing"}]},{"group":"Overviews","expanded":true,"pages":[{"title":"Explorer State","deprecated":null,"version":null,"sidebarTitle":"State","openapi":"/v3/bundled.yaml post /api/v2/ethereum/state","href":"/api-reference/ethereum/state"},{"title":"Validator","deprecated":null,"version":null,"sidebarTitle":"Validators","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators","href":"/api-reference/ethereum/validators"},{"title":"💎 Validator Metadata","deprecated":null,"version":null,"sidebarTitle":"💎 Validator Metadata","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/metadata","href":"/api-reference/ethereum/validators/metadata"},{"title":"Validator Statuses","deprecated":null,"version":null,"sidebarTitle":"Validator statuses","openapi":"/v3/bundled.yaml post /api/v2/ethereum/state/validator-statuses","href":"/api-reference/ethereum/state/validator-statuses"},{"title":"Epoch","deprecated":null,"version":null,"sidebarTitle":"Epoch","openapi":"/v3/bundled.yaml post /api/v2/ethereum/epoch","href":"/api-reference/ethereum/epoch/overview"},{"title":"Slot","deprecated":null,"version":null,"sidebarTitle":"Slot","openapi":"/v3/bundled.yaml post /api/v2/ethereum/slot","href":"/api-reference/ethereum/slot/overview"},{"title":"Block","deprecated":null,"version":null,"sidebarTitle":"Block","openapi":"/v3/bundled.yaml post /api/v2/ethereum/block","href":"/api-reference/ethereum/block/overview"}]},{"group":"Deposits","expanded":true,"pages":[{"title":"Deposits","deprecated":null,"version":null,"sidebarTitle":"Slot Deposits","openapi":"/v3/bundled.yaml post /api/v2/ethereum/slot/deposits","href":"/api-reference/ethereum/deposits"},{"title":"Deposit Slots","deprecated":null,"version":null,"sidebarTitle":"Validator Deposit Slots","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/deposit-slots","href":"/api-reference/ethereum/validators/deposit-slots"}]},{"group":"Withdrawals","expanded":true,"pages":[{"title":"Withdrawals","deprecated":null,"version":null,"sidebarTitle":"Slot Withdrawals","openapi":"/v3/bundled.yaml post /api/v2/ethereum/slot/withdrawals","href":"/api-reference/ethereum/withdrawals"},{"title":"Withdrawal Slots","deprecated":null,"version":null,"sidebarTitle":"Validator Withdrawal Slots","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/withdrawal-slots","href":"/api-reference/ethereum/validators/withdrawal-slots"}]},{"group":"Consolidations","expanded":true,"pages":[{"title":"Consolidations","deprecated":null,"version":null,"sidebarTitle":"Slot Consolidations","openapi":"/v3/bundled.yaml post /api/v2/ethereum/slot/consolidations","href":"/api-reference/ethereum/consolidations"},{"title":"Validator Queue Consolidation Details","deprecated":null,"version":null,"sidebarTitle":"Validator Queue Consolidation Details","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/queues/consolidations","href":"/api-reference/ethereum/validators/queues/consolidations"},{"title":"Validator Queue Compounding Switch Details","deprecated":null,"version":null,"sidebarTitle":"Validator Queue Compounding Switch Details","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/queues/compounding-switches","href":"/api-reference/ethereum/validators/queues/compounding-switches"}]},{"group":"Sync Committee","expanded":true,"pages":[{"title":"Sync Committee Periods","deprecated":null,"version":null,"sidebarTitle":"Sync Committee Periods","openapi":"/v3/bundled.yaml post /api/v2/ethereum/sync-committee","href":"/api-reference/ethereum/sync-committee/overview"},{"title":"Validators","deprecated":null,"version":null,"sidebarTitle":"Validators","openapi":"/v3/bundled.yaml post /api/v2/ethereum/sync-committee/validators","href":"/api-reference/ethereum/sync-committee/validators"}]},{"group":"Queues","expanded":true,"pages":[{"title":"Network Queue Overview","deprecated":null,"version":null,"sidebarTitle":"Network Queue Overview","openapi":"/v3/bundled.yaml post /api/v2/ethereum/queues","href":"/api-reference/ethereum/queues"},{"title":"Staking Queues History","deprecated":null,"version":null,"sidebarTitle":"Staking Queues History","openapi":"/v3/bundled.yaml post /api/v2/ethereum/queues/history","href":"/api-reference/ethereum/queues/history"},{"title":"Validator Queue ETA","deprecated":null,"version":null,"sidebarTitle":"Validator Queue ETA","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/queues","href":"/api-reference/ethereum/validators/queues"},{"title":"Withdrawal \u0026 Consolidation Request Fees","deprecated":null,"version":null,"sidebarTitle":"Withdrawal \u0026 Consolidation Fees","openapi":"/v3/bundled.yaml post /api/v2/ethereum/queues/request-fees","href":"/api-reference/ethereum/queues/request-fees"},{"title":"Withdrawal \u0026 Consolidation Request Fees (Current)","deprecated":null,"version":null,"sidebarTitle":"Withdrawal \u0026 Consolidation Fees (Current)","openapi":"/v3/bundled.yaml post /api/v2/ethereum/queues/request-fees/current","href":"/api-reference/ethereum/queues/request-fees/current"}]},{"group":"Statistics","expanded":true,"pages":[{"title":"Network Performance","deprecated":null,"version":null,"sidebarTitle":"Performance aggregate","openapi":"/v3/bundled.yaml post /api/v2/ethereum/performance-aggregate","href":"/api-reference/ethereum/performance-aggregate"},{"title":"Network MEV Timing","deprecated":null,"version":null,"sidebarTitle":"Mev timing","openapi":"/v3/bundled.yaml post /api/v2/ethereum/mev-timing","href":"/api-reference/ethereum/mev-timing"},{"title":"ETH.STORE®","deprecated":null,"version":null,"sidebarTitle":"ETH.STORE®","openapi":"/v3/bundled.yaml post /api/v2/ethereum/eth-store","href":"/api-reference/ethereum/eth-store"}]}]},{"group":"Validator Metrics","expanded":true,"pages":[{"group":"BeaconScore® \u0026 Performance","expanded":true,"pages":[{"title":"Performance Aggregated","deprecated":null,"version":null,"sidebarTitle":"Performance aggregate","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/performance-aggregate","href":"/api-reference/ethereum/validators/performance-aggregate"},{"title":"Performance","deprecated":null,"version":null,"sidebarTitle":"Performance list","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/performance-list","href":"/api-reference/ethereum/validators/performance-list"},{"title":"APY \u0026 ROI","deprecated":null,"version":null,"sidebarTitle":"APY \u0026 ROI","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/apy-roi","href":"/api-reference/ethereum/validators/apy-roi"}]},{"group":"Rewards \u0026 Balances","expanded":true,"pages":[{"title":"Rewards Aggregated","deprecated":null,"version":null,"sidebarTitle":"Rewards aggregate","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/rewards-aggregate","href":"/api-reference/ethereum/validators/rewards-aggregate"},{"title":"Rewards","deprecated":null,"version":null,"sidebarTitle":"Rewards list","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/rewards-list","href":"/api-reference/ethereum/validators/rewards-list"},{"title":"Validator Balance","deprecated":null,"version":null,"sidebarTitle":"Balances","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/balances","href":"/api-reference/ethereum/validators/balances"}]},{"group":"MEV \u0026 Proposal Timing","expanded":true,"pages":[{"title":"MEV Timing Aggregate","deprecated":null,"version":null,"sidebarTitle":"Mev timing aggregate","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/mev-timing-aggregate","href":"/api-reference/ethereum/validators/mev-timing-aggregate"},{"title":"Proposal Timing Aggregate","deprecated":null,"version":null,"sidebarTitle":"Proposal Timing Aggregate","tag":"Experimental","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/proposal-timing-aggregate","href":"/api-reference/ethereum/validators/proposal-timing-aggregate"}]}]},{"group":"Validator Duties","expanded":true,"pages":[{"group":"Attestation Duties","expanded":true,"pages":[{"title":"Attestation Slots","deprecated":null,"version":null,"sidebarTitle":"Attestation slots","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/attestation-slots","href":"/api-reference/ethereum/validators/attestation-slots"},{"title":"Rewards","deprecated":null,"version":null,"sidebarTitle":"Rewards","openapi":"/v3/bundled.yaml post /api/v2/ethereum/slot/attestation-duties","href":"/api-reference/ethereum/slot/attestation-duties"}]},{"group":"Block Duties","expanded":true,"pages":[{"title":"Proposal Slots","description":"Returns a list of block proposal slots during which one or more of your selected validators were assigned a proposal duty.\n\nUse this endpoint to quickly identify all relevant proposals for your validator set, making it easier to explore proposal performance and related activity.\n\nYou can combine this endpoint with:\n\n- Reward: \n [v2/ethereum/block/rewards](/api-reference/ethereum/block/rewards)\n- Consensus slot information: \n [v2/ethereum/slot](/api-reference/ethereum/slot/overview)\n- Execution block information: \n [v2/ethereum/block](/api-reference/ethereum/block/overview)\n\n\nor use it alongside reward and performance endpoints for deeper analysis, depending on your needs.\n\nResults can be filtered by a time range.\n\nNote: This endpoint supports **only finalized** data at this time.\n","deprecated":null,"version":null,"sidebarTitle":"Proposal slots","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/proposal-slots","href":"/api-reference/ethereum/validators/proposal-slots"},{"title":"Details","deprecated":null,"version":null,"sidebarTitle":"Rewards","openapi":"/v3/bundled.yaml post /api/v2/ethereum/block/rewards","href":"/api-reference/ethereum/block/rewards"},{"title":"MEV Timing","description":"Returns the MEV timing-game outcome for a single block: the winning relay bid, the earliest later bid that would have beaten it (`first_better_bid`), the highest-value later bid (`best_later_bid`), the value left on the table, and the winning relay and builder.\n\n**Use case guide:** [Investigate a Block](/use-cases/investigate-mev-block) shows how to interpret the winning bid, later alternatives, and missed value.\n\n**Protocol caveat:** The 1200 ms and 2600 ms timing bands apply to pre-Glamsterdam slots only. [Glamsterdam](https://ethereum.org/roadmap/glamsterdam/) introduces ePBS, and from its Gloas fork epoch on the arrival time of the winning relay bid no longer measures proposer timing. A block at or after the fork epoch returns status `not_applicable` with every other field `null`. For those slots, `publish_time` on [v2/ethereum/slot](/api-reference/ethereum/slot/overview) gives when one beaconcha.in node received the block; that measure is not comparable with relay timing.\n\n**Data provenance:** Timing and bid fields are derived from offchain relay APIs and streams. Relay-reported timestamps, identities, and bid coverage are not independently verifiable from onchain data; verify included block fields separately.\n\nResolve a block by number or the keywords \"latest\" / \"finalized\". Pair this with [/api/v2/ethereum/validators/proposal-slots](/api-reference/ethereum/validators/proposal-slots) to drill into a specific proposal.\n\n**Note:** MEV relay and timing data is only available on mainnet at this time.\n\n**History:** Relay bid collection began on 2024-06-03 (UTC). Blocks before that date — including all pre-Merge blocks — return status `unknown`, since the absence of relay data means the timing outcome is not known rather than that no MEV occurred. The same holds for later gaps in our bid collection: a block without a winning bid returns `no_mev` only when no relay reports delivering it and at most 32 consecutive slots around it have no recorded bids; otherwise it returns `unknown`.\n\nData freshness: per-slot relay statistics lag the chain head by roughly 4 hours. A block the per-slot aggregation has not reached yet returns status `pending` until the data catches up.\n","deprecated":null,"version":null,"sidebarTitle":"Mev timing","openapi":"/v3/bundled.yaml post /api/v2/ethereum/block/mev-timing","href":"/api-reference/ethereum/block/mev-timing"},{"title":"💎 MEV Bids","deprecated":null,"version":null,"sidebarTitle":"Mev bids","openapi":"/v3/bundled.yaml post /api/v2/ethereum/block/mev-bids","href":"/api-reference/ethereum/block/mev-bids"}]},{"group":"Sync Committee Duties","expanded":true,"pages":[{"title":"Sync Committee Periods","deprecated":null,"version":null,"sidebarTitle":"Sync committee periods","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/sync-committee-periods","href":"/api-reference/ethereum/validators/sync-committee-periods"},{"title":"Rewards","deprecated":null,"version":null,"sidebarTitle":"Rewards","openapi":"/v3/bundled.yaml post /api/v2/ethereum/slot/sync-committee-duties","href":"/api-reference/ethereum/slot/sync-committee-duties"}]},{"group":"Payload Timeliness Duties","expanded":true,"pages":[{"title":"PTC Slots","deprecated":null,"version":null,"sidebarTitle":"PTC Slots","tag":"Experimental","openapi":"/v3/bundled.yaml post /api/v2/ethereum/validators/ptc-slots","href":"/api-reference/ethereum/validators/ptc-slots"},{"title":"PTC Duties","deprecated":null,"version":null,"sidebarTitle":"PTC Duties","tag":"Experimental","openapi":"/v3/bundled.yaml post /api/v2/ethereum/slot/ptc-duties","href":"/api-reference/ethereum/slot/ptc-duties"}]}]},{"group":"Validator Dashboard Management","expanded":false,"pages":[{"title":"Introduction","href":"/validator-dashboard/manage-validators-api"},{"title":"Manage dashboard validators","openapi":".gitbook/assets/API_spec.json POST /api/v2/validator-dashboards/{dashboard_id}/validators","deprecated":false,"version":"1.0","href":"/validator-dashboard/manage-validators-api-endpoints/validators_post"},{"title":"Delete validators from groups","openapi":".gitbook/assets/API_spec.json DELETE /api/v2/validator-dashboards/{dashboard_id}/groups/{group_id}/validators","deprecated":false,"version":"1.0","href":"/validator-dashboard/manage-validators-api-endpoints/groups_delete"},{"title":"Bulk delete validators from a dashboard","openapi":".gitbook/assets/API_spec.json POST /api/v2/validator-dashboards/{dashboard_id}/validators/bulk-deletions","deprecated":false,"version":"1.0","href":"/validator-dashboard/manage-validators-api-endpoints/validators_bulk_delete_post"}]},{"group":"Machine Metrics","expanded":true,"pages":[{"title":"Machine Metrics","sidebarTitle":"Overview","href":"/api/machine-metrics-overview"},{"title":"Submit Machine Metrics","sidebarTitle":"Submit Machine Metrics","openapi":"api/v1/bundled.yaml POST /api/v1/client/metrics","href":"/api-reference/v1/client/metrics"},{"title":"Machine Metrics","deprecated":null,"version":null,"sidebarTitle":"Machine Metrics","openapi":"/v3/bundled.yaml post /api/v2/machine-metrics","href":"/api-reference/machine-metrics"},{"title":"Machine Names","deprecated":null,"version":null,"sidebarTitle":"Machine Names","openapi":"/v3/bundled.yaml post /api/v2/machine-metrics/machine-names","href":"/api-reference/machine-metrics/machine-names"}]}]},{"group":"V1 API Docs","tag":"Legacy","pages":[{"title":"V1 API Overview","href":"/api/v1-overview"},{"group":"Consensus Layer","expanded":true,"pages":[{"group":"Slots","pages":[{"title":"Attestations for a slot","deprecated":null,"version":null,"openapi":"/api/v1/bundled.yaml get /api/v1/slot/{slot}/attestations","href":"/api-reference/slots/attestations-for-a-slot"},{"title":"Attester slashings for a slot","deprecated":null,"version":null,"openapi":"/api/v1/bundled.yaml get /api/v1/slot/{slot}/attesterslashings","href":"/api-reference/slots/attester-slashings-for-a-slot"},{"title":"Proposer slashings","deprecated":null,"version":null,"openapi":"/api/v1/bundled.yaml get /api/v1/slot/{slot}/proposerslashings","href":"/api-reference/slots/proposer-slashings"},{"title":"Voluntary exits for a slot","deprecated":null,"version":null,"openapi":"/api/v1/bundled.yaml get /api/v1/slot/{slot}/voluntaryexits","href":"/api-reference/slots/voluntary-exits-for-a-slot"}]},{"group":"Validators","pages":[{"title":"BLS-to-execution credential changes","deprecated":null,"version":null,"openapi":"/api/v1/bundled.yaml get /api/v1/validator/{indexOrPubkey}/blsChange","href":"/api-reference/validators/bls-to-execution-credential-changes"},{"title":"Validator deposits (execution layer)","deprecated":null,"version":null,"openapi":"/api/v1/bundled.yaml get /api/v1/validator/{indexOrPubkey}/deposits","href":"/api-reference/validators/validator-deposits-execution-layer"},{"title":"Proposal luck","deprecated":null,"version":null,"openapi":"/api/v1/bundled.yaml get /api/v1/validators/proposalLuck","href":"/api-reference/validators/proposal-luck"},{"title":"Deposits by execution transaction hash","deprecated":null,"version":null,"openapi":"/api/v1/bundled.yaml get /api/v1/eth1deposit/{txhash}","href":"/api-reference/validator-deposits/deposits-by-execution-transaction-hash"}]}]},{"group":"Execution Layer","expanded":true,"pages":[{"group":"Blocks \u0026 MEV Rewards","pages":[{"title":"Execution blocks produced by fee recipient, proposer index, or pubkey","deprecated":null,"version":null,"openapi":"/api/v1/bundled.yaml get /api/v1/execution/{addressIndexOrPubkey}/produced","href":"/api-reference/blocks/execution-blocks-produced-by-fee-recipient-proposer-index-or-pubkey"}]}]}]}],"global":{"anchors":[{"anchor":"API Pricing","icon":"gem","color":{"light":"#2f6bff","dark":"#4d87ff"},"href":"https://beaconcha.in/pricing"}]}},{"tab":"Documentation","icon":"book","pages":[{"title":"Documentation","href":"/welcome"}]},{"tab":"Changelog","icon":"clock-rotate-left","pages":[{"title":"Changelog","href":"/changelog/product-updates"}]},{"tab":"Legal","icon":"file-text","pages":[{"title":"Legal","href":"/legal/terms"}]}]},"basePath":"","title":"Details - Knowledge Base","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}