- Category: analytics
- Auth: API_KEY
- Composio-managed OAuth available? N/A
- Tools: 37
- Triggers: 0
- Slug:
BEACONCHAIN - Version: 20261101_00
Tools
Get Chart
Get Chart
BEACONCHAIN_GET_CHARTRetrieve chart visualizations from beaconcha.in as PNG images. Use when you need visual representations of Ethereum Beacon Chain data like validator counts, staked ether, network liveness, or block statistics.Input Parameters
Output
Get Epoch
Get Epoch
BEACONCHAIN_GET_EPOCHRetrieve aggregate metrics and status for a beacon chain epoch. Use this tool to fetch epoch-level statistics including validator counts, balances, participation rates, block counts, and various operations (slashings, deposits, exits). Supports lookup by epoch number or keywords ‘latest’ or ‘finalized’.Input Parameters
latest or finalized.Output
Get ETH1 Deposits by Transaction Hash
Get ETH1 Deposits by Transaction Hash
BEACONCHAIN_GET_ETH1_DEPOSITS_BY_TX_HASHRetrieve all beacon chain validator deposit events associated with a specific execution-layer transaction hash. Use this tool to inspect deposit transactions and verify deposit parameters like amount, public key, and withdrawal credentials. Returns an empty array if the transaction contains no deposit events.Input Parameters
Output
Get ETH.Store Daily Aggregates
Get ETH.Store Daily Aggregates
BEACONCHAIN_GET_ETH_STORE_DAILYRetrieve ETH.Store daily aggregate metrics for Ethereum validators. Use this to analyze the average financial return validators achieved over a specific 24-hour period, including APR metrics, consensus/execution layer rewards, and balance aggregates.Input Parameters
Output
Get ERC-20 Token Balances
Get ERC-20 Token Balances
BEACONCHAIN_GET_EXECUTION_ADDRESS_ERC20_TOKENSRetrieve a paginated list of ERC-20 token balances for a specific Ethereum address. Use offset and limit query parameters for pagination. Returns token contract address, balance in token units, and token symbol for each ERC-20 token held by the address.Input Parameters
Output
Get Execution Block
Get Execution Block
BEACONCHAIN_GET_EXECUTION_BLOCKRetrieve one or more execution-layer blocks by block number from the Ethereum Beacon Chain. Use this tool to look up execution block details including block hash, timestamp, rewards, gas usage, transaction counts, and consensus information. Supports querying up to 100 blocks in a single request by providing block numbers as a comma-separated list. Returns an array of execution block data. If a requested block number is not found, it will be omitted from the results.Input Parameters
Output
Get Execution Produced Blocks
Get Execution Produced Blocks
BEACONCHAIN_GET_EXECUTION_PRODUCED_BLOCKSRetrieve execution-layer blocks attributed to one or more producers. Use this tool to query blocks produced by specific fee recipients, proposer indices, or validator public keys. Supports comma-separated lists to query multiple producers. Returns block details including gas usage, fees, transactions, and timestamps.Input Parameters
Output
Get Latest State
Get Latest State
BEACONCHAIN_GET_LATEST_STATERetrieve the latest known Ethereum Beacon Chain network state. Returns current slot, epoch numbers, finalized epoch, finality delay indicator, syncing status, and ETH/USD price along with multi-currency conversion rates. Use this to check current network status and get real-time ETH pricing data.Output
Get Network Performance
Get Network Performance
BEACONCHAIN_GET_NETWORK_PERFORMANCERetrieve aggregated network performance metrics for the Ethereum Beacon Chain. Use this to analyze validator performance across attestations, proposals, and sync committee duties over a specified time window. Returns beacon scores, duty statistics, and finality information.Input Parameters
Output
Get Explorer Health
Get Explorer Health
BEACONCHAIN_GET_NODE_HEALTHCheck the health status of the beaconcha.in explorer service. Returns status of monitoring modules including execution layer data, consensus layer data, services, Redis, app, and API modules. Use this to verify the beaconcha.in explorer is operational before making other API calls.Output
Get Validator Queues
Get Validator Queues
BEACONCHAIN_GET_QUEUESRetrieve current queue metrics for Ethereum Beacon Chain validators. Use this tool to check activation queue status, exit queue status, withdrawal sweep progress, and chain finality. Returns deposit queue count and balance, exit queue count and balance, estimated processing times, and churn limits.Input Parameters
Output
Get Rocket Pool Validator
Get Rocket Pool Validator
BEACONCHAIN_GET_ROCKETPOOL_VALIDATORRetrieve Rocket Pool-specific metadata for validators including minipool status, node fee, smoothing pool status, and RPL stake metrics. Use this to access Rocket Pool protocol data such as minipool addresses, node operator information, commission rates, and reward details. Returns empty data array if the validator is not a Rocket Pool validator.Input Parameters
Output
Get Slot
Get Slot
BEACONCHAIN_GET_SLOTRetrieve detailed information about an Ethereum Beacon Chain slot. Use this tool to look up slot details including attestations, slashing counts, block roots, execution payload data, validator proposer, graffiti, and sync aggregate information. Supports lookup by slot number, ‘latest’/‘head’ keywords, or block root hash. Returns comprehensive slot data including: attestation count, block roots, epoch info, execution layer details (gas, fees, transactions), proposer info, and withdrawal count.Input Parameters
Output
Get Slot Attestations
Get Slot Attestations
BEACONCHAIN_GET_SLOT_ATTESTATIONSRetrieve all attestations included in the beacon block for a specific slot. Use this tool to get detailed attestation data including committee participation, checkpoint information, and validator indices for attestations in a given slot.Input Parameters
Output
Get Slot Attester Slashings
Get Slot Attester Slashings
BEACONCHAIN_GET_SLOT_ATTESTER_SLASHINGSRetrieve all attester slashing operations included in the beacon block for a specific slot. Use this tool to check for attester slashings at a given slot number or the latest processed slot.Input Parameters
latest for the most recently processed slot.Output
Get Slot Proposer Slashings
Get Slot Proposer Slashings
BEACONCHAIN_GET_SLOT_PROPOSER_SLASHINGSRetrieve all proposer slashing operations included in the beacon block for a specific slot. Use this tool to check for proposer slashings at a given slot number or the latest processed slot.Input Parameters
latest for the most recently processed slot.Output
Get Slot Voluntary Exits
Get Slot Voluntary Exits
Get Sync Committee
Get Sync Committee
BEACONCHAIN_GET_SYNC_COMMITTEERetrieve sync committee membership for a given sync period. The result can include period boundaries and validator indices, or an empty list when no committee data is available.Input Parameters
Output
Get Validator
Get Validator
BEACONCHAIN_GET_VALIDATORRetrieve detailed information about an Ethereum Beacon Chain validator. Use this tool to look up validator status, balance, activation epochs, slashing status, and other details. Supports lookup by validator index or BLS public key. Returns validator data including: current status (active_online, active_offline, pending, exiting, slashed, exited), balance in Gwei, activation/exit epochs, and withdrawal credentials.Input Parameters
Output
Get Validator Attestation Efficiency
Get Validator Attestation Efficiency
BEACONCHAIN_GET_VALIDATOR_ATTESTATION_EFFICIENCYRetrieve normalized attestation inclusion effectiveness for one or more validators. Use this tool to measure how effectively validators are getting their attestations included in the Beacon Chain. A score of 1.0 indicates perfect effectiveness (100% inclusion), while higher scores indicate lower effectiveness (max 2.0 for 0% inclusion). Supports lookup by validator index, BLS public key, or a mix of both (comma-separated, maximum 100 validators per request by default).Input Parameters
Output
Get Validator Attestations
Get Validator Attestations
BEACONCHAIN_GET_VALIDATOR_ATTESTATIONSRetrieve attestations observed for one or more validators within a bounded epoch window. By default, returns data for the last 100 epochs. Use when you need to check validator attestation history, verify attestation performance, or analyze missed attestations.Input Parameters
week, week_start, week_end, and committeeindex fields from each item.latest. Must be within [startEpoch, latest] when provided.latest - 99. Must be within [latest-99, latest] and less than or equal to endEpoch when provided.Output
Get Validator Balance History
Get Validator Balance History
BEACONCHAIN_GET_VALIDATOR_BALANCE_HISTORYRetrieve per-epoch balance history for one or more Ethereum Beacon Chain validators. Use optional query parameters to control the time window (latest_epoch, offset, limit). Returns an array of balance snapshots showing how validator balances changed over time, including both total balance and effective balance. Useful for tracking validator performance and generating historical balance charts.Input Parameters
latest_epoch before starting the window. Must be non-negative and not exceed latest_epoch. Defaults to 0.Output
Get Validator BLS Changes
Get Validator BLS Changes
BEACONCHAIN_GET_VALIDATOR_BLS_CHANGESRetrieve on-chain BLS-to-execution credential change messages (EIP-4881) for validators. Use this tool to check if validators have changed their withdrawal credentials from BLS (0x00) to execution-layer addresses (0x01).Input Parameters
Output
Get Validator Consensus Rewards
Get Validator Consensus Rewards
BEACONCHAIN_GET_VALIDATOR_CONSENSUS_REWARDSRetrieve consensus-layer rewards for one or more validators over multiple lookback windows. Returns reward totals for the last 1, 7, 31, and 365 days, plus cumulative totals when available. All amounts are returned in gwei. Supports lookup by validator index or BLS public key.Input Parameters
Output
Get Validator Daily Stats
Get Validator Daily Stats
BEACONCHAIN_GET_VALIDATOR_DAILY_STATSRetrieve per-day statistics for a single Ethereum Beacon Chain validator by index. Returns daily balance snapshots (start/end/min/max), duty counts (proposed/missed blocks, attestations), and deposit/withdrawal activity. Use this tool to analyze validator performance over time, track balance changes, and identify issues like missed duties or slashing events. Supports filtering by day range using start_day and end_day parameters.Input Parameters
end_day. When omitted, the API returns all days up to end_day.Output
Get Validator Deposits
Get Validator Deposits
BEACONCHAIN_GET_VALIDATOR_DEPOSITSRetrieve execution-layer deposit events for one or more validators. Use when you need to check deposit history, verify deposit amounts, or audit withdrawal credentials for validators.Input Parameters
Output
Get Validator Execution Rewards
Get Validator Execution Rewards
BEACONCHAIN_GET_VALIDATOR_EXECUTION_REWARDSRetrieve execution-layer rewards (priority fees and MEV payments) for one or more validators. Values are reported in wei and include reward totals for the last 1, 7, 31, and 365 days, plus cumulative rewards since genesis when available. Accepts up to 100 validator identifiers.Input Parameters
Output
Get Validator Income History
Get Validator Income History
BEACONCHAIN_GET_VALIDATOR_INCOME_HISTORYRetrieve a per-epoch income breakdown for one or more validators. Returns consensus-layer rewards/penalties in gwei and execution-layer tips in wei. Use this to analyze validator earnings over time, including attestation rewards, proposer rewards, penalties, and MEV/tips.Input Parameters
latest_epoch before starting the window. Must be non-negative and not exceed latest_epoch. Default is 0.Output
Get Validator Leaderboard
Get Validator Leaderboard
BEACONCHAIN_GET_VALIDATOR_LEADERBOARDRetrieve the current top 100 validators ranked by 7-day consensus-layer rewards. Returns performance metrics including 1-day, 7-day, 31-day, 365-day, and total rewards in Gwei for each validator. Use this to identify the highest-performing validators on the Ethereum Beacon Chain over the past week.Output
Get Validator Proposals
Get Validator Proposals
BEACONCHAIN_GET_VALIDATOR_PROPOSALSRetrieve beacon chain blocks proposed by one or more validators within a bounded epoch window. By default, returns proposals from the last 100 epochs. Use this to get proposal history for validators by their indices or public keys.Input Parameters
Output
Get Validators by Deposit Address
Get Validators by Deposit Address
BEACONCHAIN_GET_VALIDATORS_BY_DEPOSIT_ADDRESSRetrieve validators that have made deposits from a specific execution-layer address, with limit and offset pagination; ENS names are resolved server-side. Returns validator public keys, signature validity, and validator indices for the returned deposits.Input Parameters
Output
Get Validators by Withdrawal Credentials
Get Validators by Withdrawal Credentials
BEACONCHAIN_GET_VALIDATORS_BY_WITHDRAWAL_CREDENTIALSRetrieve validators whose withdrawal credentials match the provided value or execution-layer address. Use this tool to find all validators associated with a specific withdrawal credential (32-byte hex) or Ethereum address (20-byte hex). ENS names are supported for address lookups. Results are paginated using limit and offset parameters.Input Parameters
Output
Get Validators Proposal Luck
Get Validators Proposal Luck
BEACONCHAIN_GET_VALIDATORS_PROPOSAL_LUCKRetrieve proposal luck statistics for one or more Ethereum Beacon Chain validators. Use this to analyze how lucky validators have been with block proposals compared to expected rates.Input Parameters
Output
Get Validators Queue
Get Validators Queue
BEACONCHAIN_GET_VALIDATORS_QUEUERetrieve current queue metrics for validators on the Ethereum Beacon Chain. Returns counts and total effective balances for validators awaiting activation and validators scheduled to exit. Use this to monitor validator queue status and network entry/exit activity.Output
Get Validator Withdrawals
Get Validator Withdrawals
BEACONCHAIN_GET_VALIDATOR_WITHDRAWALSRetrieve withdrawal operations attributed to one or more validators within a bounded epoch window. Use this tool to fetch historical withdrawal data for validators on the Ethereum Beacon Chain. The API returns withdrawals from up to 100 epochs (defaulting to the most recent 100 epochs if no epoch is specified).Input Parameters
Output
Post Validators
Post Validators
BEACONCHAIN_POST_VALIDATORSRetrieve validator information using a JSON request body for multiple validators. Use this when the list of identifiers is too long for the GET path parameter (up to 100 identifiers). Supports lookup by validator indices or BLS public keys. Returns validator data including status, balance, activation/exit epochs, slashing status, and withdrawal credentials.Input Parameters
Output
Resolve ENS Name or Address
Resolve ENS Name or Address
BEACONCHAIN_RESOLVE_ENSResolve ENS (Ethereum Name Service) names to addresses and vice versa. Use this tool to perform bidirectional lookups between ENS domain names and Ethereum addresses. Accepts either an ENS name (e.g., ‘vitalik.eth’) or an Ethereum address and returns the corresponding mapping.