> ## Documentation Index > Fetch the complete documentation index at: https://docs.eigenexplorer.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a staker by address > Returns a staker record by address. ## OpenAPI ````yaml get /stakers/{address} openapi: 3.0.3 info: title: EigenExplorer API description: EigenExplorer is a community-driven data platform for EigenLayer AVS. version: 0.0.1 license: name: MIT url: https://spdx.org/licenses/MIT.html servers: - url: https://api.eigenexplorer.com description: EigenExplorer Production API - url: https://api-holesky.eigenexplorer.com description: EigenExplorer Holesky Testnet API security: [] paths: /stakers/{address}: get: tags: - Stakers summary: Retrieve a staker by address description: Returns a staker record by address. operationId: getStakerByAddress parameters: - in: path name: address description: The address of the staker schema: type: string pattern: ^0x[a-fA-F0-9]{40}$ description: The address of the staker example: '0x9791fdb4e9c0495efc5a1f3f9271ef226251eb34' required: true - in: query name: withTvl description: Toggle whether the route should calculate the TVL from shares schema: type: string enum: - 'true' - 'false' default: 'false' description: Toggle whether the route should calculate the TVL from shares example: 'false' - in: query name: withRewards description: Toggle whether the route should return Avs/Operator rewards APY data schema: type: string enum: - 'true' - 'false' default: 'false' description: >- Toggle whether the route should return Avs/Operator rewards APY data example: 'false' - in: header name: X-API-Token description: API Token for authentication schema: type: string description: API Token for authentication required: true responses: '200': description: The record of the requested operator. content: application/json: schema: type: object properties: address: type: string pattern: ^0x[a-fA-F0-9]{40}$ description: The contract address of the staker example: '0x0000006c21964af0d420af8992851a30fa13a68b' operatorAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ description: The address of the operator example: '0x71c6f7ed8c2d4925d0baf16f6a85bb1736d412eb' createdAtBlock: type: string description: The block number at which the Staker made first delegation example: '19631203' updatedAtBlock: type: string description: The block number at which the Staker made last delegation example: '19631203' createdAt: type: string description: The time stamp at which the Staker made first delegation example: '2024-04-11T08:31:11.000Z' updatedAt: type: string description: The time stamp at which the Staker made last delegation example: '2024-04-11T08:31:11.000Z' shares: type: array items: type: object properties: strategyAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ description: The contract address of the restaking strategy example: '0x93c4b944d05dfe6df7645a86cd2206016c51564a' shares: type: string description: The amount of shares held in the strategy example: '40000000000000000' required: - strategyAddress - shares tvl: type: object properties: tvl: type: number description: The combined TVL of all restaking strategies in ETH example: 1000000 tvlBeaconChain: type: number description: The TVL of Beacon Chain restaking strategy in ETH example: 1000000 tvlRestaking: type: number description: >- The combined TVL of all liquid restaking strategies in ETH example: 1000000 tvlWETH: type: number description: The TVL of WETH restaking strategy in ETH example: 1000000 tvlStrategies: type: object additionalProperties: type: number description: >- The total value locked (TVL) in the strategy, denominated in the strategy's native token example: 1000000 description: >- The TVL of each individual restaking strategy in its native token example: Eigen: 1000000 cbETH: 2000000 tvlStrategiesEth: type: object additionalProperties: type: number description: >- The total value locked (TVL) in the strategy, denominated in ETH example: 1000000 description: The TVL of each individual restaking strategy in ETH example: Eigen: 1000000 cbETH: 2000000 required: - tvl - tvlBeaconChain - tvlRestaking - tvlWETH - tvlStrategies - tvlStrategiesEth description: The total value locked (TVL) in the AVS staker example: tvl: 1000000 tvlBeaconChain: 1000000 tvlWETH: 1000000 tvlRestaking: 1000000 tvlStrategies: Eigen: 1000000 cbETH: 2000000 tvlStrategiesEth: stETH: 1000000 cbETH: 2000000 rewards: type: object properties: aggregateApy: type: number description: >- The sum of amount staked per strategy multiplied by the strategy apy for this staker example: 0.1 tokenAmounts: type: array items: type: object properties: tokenAddress: type: string description: The contract address of the token involved example: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2' cumulativeAmount: type: string description: >- The staker’s cumulative amount earned amount of this particular token example: '1.4e-8' required: - tokenAddress - cumulativeAmount strategyApys: type: array items: type: object properties: strategyAddress: type: string description: The contract address of the restaking strategy example: '0xbeac0eeeeeeeeeeeeeeeeeeeeeeeeeeeeeebeac0' apy: type: number description: >- The cumulative APY for this strategy summed across all AVSs example: 0.1 tokens: type: array items: type: object properties: tokenAddress: type: string description: >- The contract address of the token involved in the strategy example: '0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2' apy: type: number description: >- The APY contributed by this individual token example: 0.1 required: - tokenAddress - apy required: - strategyAddress - apy - tokens avsApys: type: array items: type: object properties: avsAddress: type: string description: The AVS service manager contract address example: '0x1de75eaab2df55d467494a172652579e6fa4540e' apy: type: number description: The total APY calculated for this AVS example: 0.1 strategies: type: array items: type: object properties: strategyAddress: type: string description: >- The contract address of the restaking strategy example: '0xbeac0eeeeeeeeeeeeeeeeeeeeeeeeeeeeeebeac0' apy: type: number description: >- The cumulative APY from all tokens in this strategy example: 0.1 tokens: type: array items: type: object properties: tokenAddress: type: string description: >- The contract address of the token involved in the strategy example: >- 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 apy: type: number description: >- The APY contributed by this individual token example: 0.1 required: - tokenAddress - apy required: - strategyAddress - apy - tokens required: - avsAddress - apy - strategies required: - aggregateApy - tokenAmounts - strategyApys - avsApys description: The reward details for the Staker required: - address - operatorAddress - createdAtBlock - updatedAtBlock - createdAt - updatedAt - shares - rewards '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' '422': $ref: '#/components/responses/422' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' components: responses: '400': description: >- The server cannot or will not process the request due to something that is perceived to be a client error (e.g., malformed request syntax, invalid request message framing, or deceptive request routing). content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - bad_request description: A short code indicating the error code returned. example: bad_request message: type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: >- https://docs.eigenexplorer.com/api-reference/errors#bad_request required: - code - message required: - error '401': description: >- Although the HTTP standard specifies "unauthorized", semantically this response means "unauthenticated". That is, the client must authenticate itself to get the requested response. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized description: A short code indicating the error code returned. example: unauthorized message: type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: >- https://docs.eigenexplorer.com/api-reference/errors#unauthorized required: - code - message required: - error '403': description: >- The client does not have access rights to the content; that is, it is unauthorized, so the server is refusing to give the requested resource. Unlike 401 Unauthorized, the client's identity is known to the server. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - forbidden description: A short code indicating the error code returned. example: forbidden message: type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: >- https://docs.eigenexplorer.com/api-reference/errors#forbidden required: - code - message required: - error '404': description: The server cannot find the requested resource. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - not_found description: A short code indicating the error code returned. example: not_found message: type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: >- https://docs.eigenexplorer.com/api-reference/errors#not_found required: - code - message required: - error '422': description: >- The request was well-formed but was unable to be followed due to semantic errors. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unprocessable_entity description: A short code indicating the error code returned. example: unprocessable_entity message: type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: >- https://docs.eigenexplorer.com/api-reference/errors#unprocessable_entity required: - code - message required: - error '429': description: >- The user has sent too many requests in a given amount of time ("rate limiting") content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - rate_limit_exceeded description: A short code indicating the error code returned. example: rate_limit_exceeded message: type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: >- https://docs.eigenexplorer.com/api-reference/errors#rate_limit_exceeded required: - code - message required: - error '500': description: The server has encountered a situation it does not know how to handle. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - internal_server_error description: A short code indicating the error code returned. example: internal_server_error message: type: string description: A human readable explanation of what went wrong. example: The requested resource was not found. doc_url: type: string description: >- A link to our documentation with more details about this error code example: >- https://docs.eigenexplorer.com/api-reference/errors#internal_server_error required: - code - message required: - error ````