> ## Documentation Index > Fetch the complete documentation index at: https://docs.beaconcha.in/llms.txt > Use this file to discover all available pages before exploring further. # Validators by deposit address > Retrieve validators that have made deposits from a specific execution-layer address. The service inspects DepositContract events where the `from_address` equals the provided address and groups results by validator public key. Use this endpoint to identify validators funded by an address. ENS names are supported for the path parameter when they resolve to a 0x-prefixed address at request time. ## OpenAPI ````yaml /api/v1/bundled.yaml get /api/v1/validator/eth1/{eth1address} openapi: 3.0.4 info: title: beaconcha.in API Documentation license: name: GPL-3.0 url: https://www.gnu.org/licenses/gpl-3.0.en.html description: >- > ⚠️ No new features or endpoints will be added to V1. We recommend the [V2 API](/api/overview) for all new projects. See the [migration guide](/api/v1-to-v2-migration). ## Introduction **Advanced and reliable API for accessing comprehensive Ethereum blockchain data.** - **Free Usage Policy:** The API is free to use under a fair use policy, with rate limits of 10 requests per minute per IP. - **Caching:** All responses are cached for 1 minute. - **Higher Usage Plans:** For higher usage plans, visit: [https://beaconcha.in/pricing](https://beaconcha.in/pricing). An API key is required to use these plans. ### API Key Usage API keys can be obtained at [/user/settings](https://beaconcha.in/user/settings) and must be included in requests either as a query string parameter or in the request header. #### Example: Query String Parameter ```bash curl https://beaconcha.in/api/v1/slot/1?apikey= ``` #### Example: Request Header ```bash curl -H 'apikey: ' https://beaconcha.in/api/v1/slot/1 ``` contact: {} version: '1.1' servers: - url: https://beaconcha.in description: Ethereum mainnet - url: https://hoodi.beaconcha.in description: Hoodi Ethereum testnet security: - ApiKeyAuthQuery: [] - ApiKeyAuthHeader: [] tags: - name: Epoch description: Data related to consensus layer epochs - name: Slots description: Data related to consensus layer slots - name: Validators description: Data related to consensus layer validators - name: Rewards description: Data related to validator rewards - name: Sync Committees description: Data related to sync committees - name: Rocketpool description: Data related to the rocketpool protocol - name: ETH.Store® description: Data related to the ETH.Store® metric - name: Validator deposits description: Data related to execution layer validator deposits - name: Blocks description: Data related to execution layer blocks - name: Gas description: Data related to gas prices - name: Address description: Data related to ethereum addresses - name: Network description: Network data - name: Misc description: Miscellaneous data - name: User description: User data - name: Machine Metrics description: Submit machine, beacon-node, and validator-client monitoring metrics paths: /api/v1/validator/eth1/{eth1address}: get: tags: - Validators summary: Validators by deposit address description: >- Retrieve validators that have made deposits from a specific execution-layer address. The service inspects DepositContract events where the `from_address` equals the provided address and groups results by validator public key. Use this endpoint to identify validators funded by an address. ENS names are supported for the path parameter when they resolve to a 0x-prefixed address at request time. operationId: getValidatorsByEth1Address parameters: - name: eth1address in: path description: >- Execution-layer address whose deposit transactions you want to inspect. Provide a 0x-prefixed, 20-byte hex string (40 hex characters after 0x). ENS names are accepted and resolved server-side when provided. required: true style: simple explode: false schema: $ref: '#/components/schemas/primitives.EthAddress' - name: limit in: query description: >- Maximum number of records to return. Allowed range is 1 to 2000. Defaults to 2000. required: false style: form explode: true schema: type: integer minimum: 1 maximum: 2000 default: 2000 example: 100 - name: offset in: query description: >- Number of items to skip from the start of the result set. Use 0 for the first page. required: false style: form explode: true schema: type: integer minimum: 0 example: 0 default: 0 responses: '200': description: >- Matching validators were found. The `data` array contains one entry per unique validator public key that deposited from the specified address. content: application/json: schema: allOf: - $ref: '#/components/schemas/types.ApiResponse' - type: object properties: data: type: array items: $ref: '#/components/schemas/types.ApiValidatorEth1Response' '400': description: >- The request is invalid (for example, a malformed address or out-of-range pagination parameters). content: application/json: schema: $ref: '#/components/schemas/types.ApiErrorResponse' examples: invalidAddress: summary: Invalid address parameter value: status: 'ERROR: invalid eth1 address provided' data: null invalidPagination: summary: Invalid pagination parameters value: status: 'ERROR: invalid pagination parameters' data: null '500': description: An unexpected server error occurred while processing your request. content: application/json: schema: $ref: '#/components/schemas/types.ApiErrorResponse' examples: serverError: summary: Internal error value: status: 'ERROR: internal server error' data: null components: schemas: primitives.EthAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ example: '0xdAC17F958D2ee523a2206206994597C13D831ec7' types.ApiResponse: type: object description: Standard success envelope used by all API endpoints. properties: status: type: string description: >- HTTP-independent status of the API operation. For successful responses this is always "OK". enum: - OK data: description: Response payload specific to the endpoint. nullable: true x-omitempty: true types.ApiValidatorEth1Response: type: object description: >- Validator derived from deposit events funded by a specific execution-layer address. properties: public_key: type: string description: >- BLS12-381 validator public key (48 bytes; 0x-prefixed hex with 96 hex characters). example: >- 0xb73ecd964c9779506a3209ec40dd40d765b0464fef281d77ac8a559fa9e2a9cff8b6b2e09b8f6360b119ba7a963c5b81 valid_signature: type: boolean description: >- True when the deposit signature validates against the public key and deposit message. example: true validator_index: type: integer description: >- Validator index (>= 0) resolved from the public key; null when the public key has no assigned index. minimum: 0 nullable: true example: 1071937 types.ApiErrorResponse: type: object description: Standard error envelope returned when a request fails. properties: status: type: string description: >- Human-readable error indicator and message. The value begins with "ERROR:" followed by details. example: 'ERROR: ' data: type: string description: Optional additional context for the error. Null in most cases. nullable: true default: null securitySchemes: ApiKeyAuthQuery: type: apiKey in: query name: apikey description: '' ApiKeyAuthHeader: type: apiKey in: header name: apikey description: '' ````