{"openapi":"3.1.0","info":{"title":"StakePad x402 Ethereum Data API","description":"Agent-focused x402 V2 access to StakePad Ethereum and Beacon Chain data.\n\n**How to pay on Base:** Call the route with its normal JSON body and no payment header. The `402 Payment Required` response contains an exact USDC quote in the Base64URL `PAYMENT-REQUIRED` header, including the configured Base network, USDC asset, payee, and timeout. Sign that exact quote with a wallet funded on the quoted Base network, then resend the identical request and body with its Base64/Base64URL payment payload in `PAYMENT-SIGNATURE`.\n\n**How data is served:** The API verifies the signature with the facilitator before it calls the underlying Beacon Chain data handler. On a successful data response, it settles the payment and includes settlement metadata in `PAYMENT-RESPONSE`. Invalid or missing payments receive another `402`; no data is returned before verification.\n\nPrices are deterministic per route and published in `https://stakepad-api.globalstake.io/ethereum/.well-known/x402`; amounts are USDC atomic units (1,000,000 = 1 USDC). `https://stakepad-api.globalstake.io/ethereum/llms.txt` provides a concise agent guide.","license":{"name":""},"version":"1.4.1"},"servers":[{"url":"/ethereum"},{"url":"/"}],"paths":{"/globalstake/ethereum-data/v1/availability":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_availability","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainRequest"}}},"required":true},"responses":{"200":{"description":"Explorer availability returned as text"}}}},"/globalstake/ethereum-data/v1/chart":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_chart","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChartRequest"}}},"required":true},"responses":{"200":{"description":"Chart returned as PNG","content":{"image/png":{}}}}}},"/globalstake/ethereum-data/v1/ens":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_ens","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnsRequest"}}},"required":true},"responses":{"200":{"description":"ENS result fetched successfully"}}}},"/globalstake/ethereum-data/v1/epoch":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches an epoch overview.","operationId":"beaconchain_epoch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpochRequest"}}},"required":true},"responses":{"200":{"description":"Epoch fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/epoch_slots":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches all slots in an epoch.","operationId":"beaconchain_epoch_slots","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EpochRequest"}}},"required":true},"responses":{"200":{"description":"Epoch slots fetched successfully"}}}},"/globalstake/ethereum-data/v1/eth_store":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_eth_store","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EthStoreRequest"}}},"required":true},"responses":{"200":{"description":"ETH.Store data fetched successfully"}}}},"/globalstake/ethereum-data/v1/execution/address":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_execution_address","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionAddressRequest"}}},"required":true},"responses":{"200":{"description":"Execution address balances fetched successfully"}}}},"/globalstake/ethereum-data/v1/execution/address/erc20_tokens":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_execution_address_tokens","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionAddressTokensRequest"}}},"required":true},"responses":{"200":{"description":"ERC-20 balances fetched successfully"}}}},"/globalstake/ethereum-data/v1/execution/blocks":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_execution_blocks","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionBlocksRequest"}}},"required":true},"responses":{"200":{"description":"Execution blocks fetched successfully"}}}},"/globalstake/ethereum-data/v1/execution/gas_now":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches current gas-price recommendations.","operationId":"beaconchain_gas_now","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainRequest"}}},"required":true},"responses":{"200":{"description":"Beaconcha.in data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/execution/produced":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_execution_produced","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionProducedRequest"}}},"required":true},"responses":{"200":{"description":"Produced blocks fetched successfully"}}}},"/globalstake/ethereum-data/v1/get_validators":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches validator indices based on withdrawal credentials.","operationId":"beaconchain_get_validators","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EthValidatorInfo"}}},"required":true},"responses":{"200":{"description":"Validators fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/get_validators_from_eth1":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches validators associated with an ETH1 address.","operationId":"beaconchain_get_validators_from_eth1","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Eth1ValidatorRequest"}}},"required":true},"responses":{"200":{"description":"Validators fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/graffiti_wall":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_graffiti_wall","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GraffitiWallRequest"}}},"required":true},"responses":{"200":{"description":"Graffiti wall pixels fetched successfully"}}}},"/globalstake/ethereum-data/v1/health":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_health","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainRequest"}}},"required":true},"responses":{"200":{"description":"Explorer module health returned as text"}}}},"/globalstake/ethereum-data/v1/latest_state":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches the latest consensus and execution state.","operationId":"beaconchain_latest_state","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainRequest"}}},"required":true},"responses":{"200":{"description":"Beaconcha.in data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/rewards/consensus":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches consensus-layer validator rewards.","operationId":"beaconchain_consensus_rewards","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorListRequest"}}},"required":true},"responses":{"200":{"description":"Validator data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/rewards/execution":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches execution-layer validator rewards.","operationId":"beaconchain_execution_rewards","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorListRequest"}}},"required":true},"responses":{"200":{"description":"Validator data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/rocketpool":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches Rocket Pool network statistics.","operationId":"beaconchain_rocket_pool_network","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainRequest"}}},"required":true},"responses":{"200":{"description":"Beaconcha.in data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/rocketpool/validators":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches Rocket Pool validator metadata.","operationId":"beaconchain_rocket_pool_validators","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorListRequest"}}},"required":true},"responses":{"200":{"description":"Validator data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/slot":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches a slot by number, tag, or block root.","operationId":"beaconchain_slot","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotOrHashRequest"}}},"required":true},"responses":{"200":{"description":"Slot fetched successfully"}}}},"/globalstake/ethereum-data/v1/slot/attestations":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches attestations included in a slot.","operationId":"beaconchain_slot_attestations","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotRequest"}}},"required":true},"responses":{"200":{"description":"Slot data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/slot/attester_slashings":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches attester slashings included in a slot.","operationId":"beaconchain_slot_attester_slashings","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotRequest"}}},"required":true},"responses":{"200":{"description":"Slot data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/slot/deposits":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches deposits included in a slot.","operationId":"beaconchain_slot_deposits","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotRequest"}}},"required":true},"responses":{"200":{"description":"Slot data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/slot/proposer_slashings":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches proposer slashings included in a slot.","operationId":"beaconchain_slot_proposer_slashings","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotRequest"}}},"required":true},"responses":{"200":{"description":"Slot data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/slot/voluntary_exits":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches voluntary exits included in a slot.","operationId":"beaconchain_slot_voluntary_exits","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotRequest"}}},"required":true},"responses":{"200":{"description":"Slot data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/slot/withdrawals":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches withdrawals included in a slot.","operationId":"beaconchain_slot_withdrawals","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotRequest"}}},"required":true},"responses":{"200":{"description":"Slot data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/sync_committee":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_sync_committee","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SyncCommitteeRequest"}}},"required":true},"responses":{"200":{"description":"Sync committee fetched successfully"}}}},"/globalstake/ethereum-data/v1/validator_deposits/transaction":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_deposits_by_transaction","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionHashRequest"}}},"required":true},"responses":{"200":{"description":"Deposits fetched successfully"}}}},"/globalstake/ethereum-data/v1/validator_status":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches the lifecycle status of a validator by its index or public key.","operationId":"beaconchain_validator_status","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StatsQuery"}}},"required":true},"responses":{"200":{"description":"Validator status fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/validators":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches validator overviews using the GET-style upstream route.","operationId":"beaconchain_validators","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorListRequest"}}},"required":true},"responses":{"200":{"description":"Validator data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/validators/attestation_efficiency":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches validator attestation efficiency.","operationId":"beaconchain_validator_attestation_efficiency","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorListRequest"}}},"required":true},"responses":{"200":{"description":"Validator data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/validators/attestations":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_validator_attestations","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorAttestationsRequest"}}},"required":true},"responses":{"200":{"description":"Validator attestations fetched successfully"}}}},"/globalstake/ethereum-data/v1/validators/balance_history":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_validator_balance_history","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorHistoryRequest"}}},"required":true},"responses":{"200":{"description":"Validator balance history fetched successfully"}}}},"/globalstake/ethereum-data/v1/validators/bls_changes":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches BLS-to-execution credential changes.","operationId":"beaconchain_validator_bls_changes","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorListRequest"}}},"required":true},"responses":{"200":{"description":"Validator data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/validators/daily_stats":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches daily validator statistics for one or more validator indices.","operationId":"beaconchain_validator_daily_stats","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorListRequest"}}},"required":true},"responses":{"200":{"description":"Daily validator statistics fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/validators/deposits":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches execution-layer validator deposits.","operationId":"beaconchain_validator_deposits","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorListRequest"}}},"required":true},"responses":{"200":{"description":"Validator data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/validators/income_detail_history":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_validator_income_detail_history","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorHistoryRequest"}}},"required":true},"responses":{"200":{"description":"Validator income history fetched successfully"}}}},"/globalstake/ethereum-data/v1/validators/leaderboard":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches the validator performance leaderboard.","operationId":"beaconchain_validator_leaderboard","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainRequest"}}},"required":true},"responses":{"200":{"description":"Beaconcha.in data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/validators/proposal_luck":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches validator proposal luck.","operationId":"beaconchain_validator_proposal_luck","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorListRequest"}}},"required":true},"responses":{"200":{"description":"Validator data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/validators/proposals":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_validator_proposals","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorEpochWindowRequest"}}},"required":true},"responses":{"200":{"description":"Validator proposals fetched successfully"}}}},"/globalstake/ethereum-data/v1/validators/queue":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches the activation and exit queue.","operationId":"beaconchain_validator_queue","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChainRequest"}}},"required":true},"responses":{"200":{"description":"Beaconcha.in data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}},"/globalstake/ethereum-data/v1/validators/withdrawals":{"post":{"tags":["Beacon Chain V1"],"operationId":"beaconchain_validator_withdrawals","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorEpochWindowRequest"}}},"required":true},"responses":{"200":{"description":"Validator withdrawals fetched successfully"}}}},"/globalstake/ethereum-data/v1/validators_post":{"post":{"tags":["Beacon Chain V1"],"description":"Fetches validator overviews using the body-based upstream route.","operationId":"beaconchain_validators_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidatorListRequest"}}},"required":true},"responses":{"200":{"description":"Validator data fetched successfully"},"400":{"description":"Invalid request"},"401":{"description":"Unauthorized"},"429":{"description":"Rate limit exceeded"},"500":{"description":"Server error"}}}}},"components":{"schemas":{"BalanceRequest":{"type":"object","required":["user_address","vault_address"],"properties":{"user_address":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"},"vault_address":{"type":"string","example":"0xcf8357e5d8d90aa3c86eeba3c494947dab28bfaf"}}},"Chain":{"type":"string","enum":["MainnetEth","TestnetEth","Lukso","TestnetLukso"]},"ChainRequest":{"type":"object","required":["chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"}}},"ChartRequest":{"type":"object","required":["chart","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"chart":{"type":"string","example":"validators"}}},"ClaimExitQueueRequest":{"type":"object","required":["user_address","vault_address","positions"],"properties":{"positions":{"type":"array","items":{},"example":[{"positionId":"0x2a31...9b1c","shares":"1.2345"},{"positionId":"0x91ff...0abc","shares":"0.8000"}]},"user_address":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"},"vault_address":{"type":"string","example":"0xcf8357e5d8d90aa3c86eeba3c494947dab28bfaf"}}},"DepositEntry":{"type":"object","required":["pubkey","withdrawal_credentials","signature","deposit_data_root"],"properties":{"amount_gwei":{"type":["string","null"]},"deposit_data_root":{"type":"string"},"deposit_value_wei":{"type":["string","null"]},"pubkey":{"type":"string"},"signature":{"type":"string"},"withdrawal_credentials":{"type":"string"}}},"DepositInfo":{"type":"object","required":["amount","num_of_validators","withdrawal_address"],"properties":{"amount":{"type":"number","format":"double","example":32},"chain":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Chain"}]},"location":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Location"}]},"num_of_validators":{"type":"integer","format":"int32","example":1,"minimum":0},"regular_withdrawal":{"type":["boolean","null"]},"withdrawal_address":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"}},"additionalProperties":false},"Eip7002Withdrawal":{"type":"object","required":["validator_pubkey","withdrawal_from"],"properties":{"amount_eth":{"type":["number","null"],"format":"double","example":32},"amount_gwei":{"type":["integer","null"],"format":"int64","minimum":0},"chain":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Chain"}]},"request_fee_limit_wei":{"type":["string","null"],"example":100000},"validator_pubkey":{"type":"string","example":"0x917eb85f48353ea76800b9c7f62ed5fefe711689cc892ac6434ad89588cb8aa3ca9b47f2c3f6d22393bbf2236c16e78e"},"withdrawal_from":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"}},"additionalProperties":false},"EnsRequest":{"type":"object","required":["name_or_address","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"name_or_address":{"type":"string","example":"vitalik.eth"}}},"EpochRequest":{"type":"object","required":["epoch","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"epoch":{"type":"string","example":"latest"}}},"Eth1ValidatorRequest":{"type":"object","required":["address","chain"],"properties":{"address":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"},"chain":{"$ref":"#/components/schemas/Chain"}}},"EthStoreRequest":{"type":"object","required":["day","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"day":{"type":"string","example":"latest"}}},"EthValidatorInfo":{"type":"object","required":["address"],"properties":{"address":{"type":"string","example":"0x917eb85f48353ea76800b9c7f62ed5fefe711689cc892ac6434ad89588cb8aa3ca9b47f2c3f6d22393bbf2236c16e78e"},"chain":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Chain"}]}}},"EthWithdrawal":{"type":"object","required":["address"],"properties":{"address":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"},"amount":{"type":["number","null"],"format":"double","example":32},"chain":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Chain"}]},"current_balance":{"type":["number","null"],"format":"double","example":32},"fee_splitter_address":{"type":["string","null"]},"location":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Location"}]},"num_of_validators":{"type":["integer","null"],"example":2,"minimum":0},"validator_addresses":{"type":["array","null"],"items":{"type":"string"},"example":["0xb73eae1a077807086dcc520a385f7878630719f306fc1ca10a274531e7567fffb8ccbf21b64327292ff98f83ffc020ed","0xb6a97b260edc54d21bd550a8daa0f7e8abed372289379261647d0b78b61d2351e4295bae5c10b448e5f813d12ebde2a9"]}},"additionalProperties":false},"EthereumApiErrorBody":{"type":"object","required":["status","error"],"properties":{"error":{"$ref":"#/components/schemas/EthereumApiErrorDetails"},"status":{"type":"boolean","description":"Always false for error responses."}}},"EthereumApiErrorDetails":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable error code."},"message":{"type":"string","description":"Human-readable safe error message."},"retry_after_seconds":{"type":["integer","null"],"format":"int64","description":"Suggested retry delay for rate-limited requests.","minimum":0},"service":{"type":["string","null"],"description":"Logical upstream service name when relevant."}}},"ExecutionAddressRequest":{"type":"object","required":["address","chain"],"properties":{"address":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"},"chain":{"$ref":"#/components/schemas/Chain"}}},"ExecutionAddressTokensRequest":{"type":"object","required":["address","chain"],"properties":{"address":{"type":"string"},"chain":{"$ref":"#/components/schemas/Chain"},"limit":{"type":["integer","null"],"format":"int64","minimum":0},"offset":{"type":["integer","null"],"format":"int64","minimum":0}}},"ExecutionBlocksRequest":{"type":"object","required":["block_numbers","chain"],"properties":{"block_numbers":{"type":"string","example":"20000000,20000001"},"chain":{"$ref":"#/components/schemas/Chain"}}},"ExecutionProducedRequest":{"type":"object","required":["address_index_or_pubkey","chain"],"properties":{"address_index_or_pubkey":{"type":"string"},"chain":{"$ref":"#/components/schemas/Chain"},"limit":{"type":["integer","null"],"format":"int64","minimum":0},"offset":{"type":["integer","null"],"format":"int64","minimum":0}}},"FundValidatorsReq":{"type":"object","required":["chain","factory","deposits"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"deposits":{"type":"array","items":{"$ref":"#/components/schemas/DepositEntry"}},"factory":{"type":"string"},"fee_splitter_address":{"type":["string","null"],"description":"Optional fee splitter contract address. If provided, deposit withdrawal credentials are validated against it."}}},"GraffitiWallRequest":{"type":"object","required":["chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"end_x":{"type":["integer","null"],"format":"int64","minimum":0},"end_y":{"type":["integer","null"],"format":"int64","minimum":0},"slot":{"type":["integer","null"],"format":"int64","minimum":0},"start_slot":{"type":["integer","null"],"format":"int64","minimum":0},"start_x":{"type":["integer","null"],"format":"int64","minimum":0},"start_y":{"type":["integer","null"],"format":"int64","minimum":0},"summarize":{"type":["boolean","null"]}}},"Location":{"type":"string","enum":["Virginia","Amsterdam","Tokyo"]},"RewardRequest":{"type":"object","required":["vault_address","user_address","date_from"],"properties":{"date_from":{"type":"integer","format":"int64","example":1717046400},"date_to":{"type":["integer","null"],"format":"int64","example":1719638400},"fill_gaps":{"type":["boolean","null"],"example":true},"user_address":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"},"vault_address":{"type":"string","example":"0xcf8357e5d8d90aa3c86eeba3c494947dab28bfaf"}}},"SlotOrHashRequest":{"type":"object","required":["slot_or_hash","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"slot_or_hash":{"type":"string","example":"latest"}}},"SlotRequest":{"type":"object","required":["slot","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"slot":{"type":"string","example":"latest"}}},"StakeRequest":{"type":"object","required":["amount","vault_address","wallet_address"],"properties":{"amount":{"type":"number","format":"double","example":1.4},"vault_address":{"type":"string","example":"0xcf8357e5d8d90aa3c86eeba3c494947dab28bfaf"},"wallet_address":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"}}},"StakerActionsRequest":{"type":"object","required":["user_address","vault_address","limit","skip"],"properties":{"limit":{"type":"integer","format":"int32","example":25,"minimum":0},"skip":{"type":"integer","format":"int32","example":0,"minimum":0},"user_address":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"},"vault_address":{"type":"string","example":"0xcf8357e5d8d90aa3c86eeba3c494947dab28bfaf"}}},"StatsQuery":{"type":"object","required":["index","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"index":{"type":"string","example":1199816}}},"SyncCommitteeRequest":{"type":"object","required":["period","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"period":{"type":"integer","format":"int64","minimum":0}}},"TransactionHashRequest":{"type":"object","required":["transaction_hash","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"transaction_hash":{"type":"string","example":"0x9e58e87e8beaf576eeb2c5e541fe4f5c1f51f7b69aeacfc46fbd5731180c9a8f"}}},"ValidatorAttestationsRequest":{"type":"object","required":["validators","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"end_epoch":{"type":["integer","null"],"format":"int64","minimum":0},"start_epoch":{"type":["integer","null"],"format":"int64","minimum":0},"validators":{"type":"string"}}},"ValidatorEpochWindowRequest":{"type":"object","required":["validators","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"epoch":{"type":["integer","null"],"format":"int64","minimum":0},"validators":{"type":"string"}}},"ValidatorHistoryRequest":{"type":"object","required":["validators","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"latest_epoch":{"type":["integer","null"],"format":"int64","minimum":0},"limit":{"type":["integer","null"],"format":"int64","minimum":0},"offset":{"type":["integer","null"],"format":"int64","minimum":0},"validators":{"type":"string"}}},"ValidatorListRequest":{"type":"object","required":["validators","chain"],"properties":{"chain":{"$ref":"#/components/schemas/Chain"},"validators":{"type":"string","example":"1,2,0xb73ecd964c9779506a3209ec40dd40d765b0464fef281d77ac8a559fa9e2a9cff8b6b2e09b8f6360b119ba7a963c5b81"}}},"VaultRequest":{"type":"object","required":["vault_address"],"properties":{"vault_address":{"type":"string","example":"0xcf8357e5d8d90aa3c86eeba3c494947dab28bfaf"}}},"VaultStatsRequest":{"type":"object","required":["days_count","vault_address"],"properties":{"days_count":{"type":"integer","format":"int32","example":30,"minimum":0},"vault_address":{"type":"string","example":"0xcf8357e5d8d90aa3c86eeba3c494947dab28bfaf"}}},"WithdrawRequest":{"type":"object","required":["amount","vault_address","wallet_address"],"properties":{"amount":{"type":"number","format":"double","example":1.4},"vault_address":{"type":"string","example":"0xcf8357e5d8d90aa3c86eeba3c494947dab28bfaf"},"wallet_address":{"type":"string","example":"0xD60CA38884509c7b296da19A44C71C61D9e78EFf"}}}}},"tags":[{"name":"Beacon Chain V1","description":"GlobalStake indexed Beacon Chain data, served in the beaconcha.in V1 response format."}]}