> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octav.fi/llms.txt
> Use this file to discover all available pages before exploring further.

# Validator Deposits by Pubkey

> Paginated list of deposits made to a validator by BLS pubkey.

**Cost:** 1 credit per call. Automatically refunded on 4xx/5xx responses.

**Access:** Requires portfolio entitlement.

**Rate limit:** 360 req/min (shared with portfolio bucket)

**Get your API key:** [Dev Portal](https://data.octav.fi)



## OpenAPI

````yaml /openapi.json get /beacon/validators/deposits/pubkey/{pubkey}
openapi: 3.0.0
info:
  title: Octav API
  description: >-
    Comprehensive blockchain data API for portfolio management, transactions,
    and DeFi analytics
  version: 1.0.0
  contact:
    name: Octav Support
    url: https://octav.fi
    email: info@octav.fi
servers:
  - url: https://api.octav.fi/v1
    description: Production API
security:
  - bearerAuth: []
tags:
  - name: Portfolio
    description: Portfolio and holdings endpoints
  - name: Virtual Users
    description: Virtual user management and portfolio endpoints (Pro only)
  - name: Nav
    description: Net Asset Value endpoints
  - name: Wallet
    description: Wallet information endpoints
  - name: Transactions
    description: Transaction history endpoints
  - name: Approvals
    description: Token approval endpoints
  - name: Tokens
    description: Token data endpoints
  - name: Airdrops
    description: Airdrop eligibility endpoints
  - name: Sync
    description: Data synchronization endpoints
  - name: Status
    description: Status check endpoints
  - name: Credits
    description: Credit balance endpoints
  - name: Chains
    description: Blockchain network and protocol endpoints
  - name: Contract Protocol
    description: Resolve a contract address to its DeFi protocol
  - name: Beacon Validators
    description: >-
      Ethereum beacon chain validator endpoints — details, rewards, withdrawals,
      and deposits (mainnet only)
paths:
  /beacon/validators/deposits/pubkey/{pubkey}:
    get:
      tags:
        - Beacon Validators
      summary: Validator Deposits by Pubkey
      description: >-
        Paginated list of deposits made to a validator by BLS pubkey.


        **Cost:** 1 credit per call. Automatically refunded on 4xx/5xx
        responses.


        **Access:** Requires portfolio entitlement.


        **Rate limit:** 360 req/min (shared with portfolio bucket)


        **Get your API key:** [Dev Portal](https://data.octav.fi)
      operationId: getValidatorDepositsByPubkey
      parameters:
        - name: pubkey
          in: path
          required: true
          description: >-
            48-byte BLS pubkey, hex-encoded with `0x` prefix (96 hex
            characters). Case-insensitive.
          schema:
            type: string
            pattern: ^0x[a-fA-F0-9]{96}$
          example: >-
            0xb03d97937ae39b38a44f90141dcf7f0420c3b9b21caee1a7603046bc9237f5c96b61714474249dafe0a20af583a4fc07
        - name: offset
          in: query
          required: false
          description: Pagination offset.
          schema:
            type: number
            default: 0
        - name: limit
          in: query
          required: false
          description: Number of records to return. Max 10.
          schema:
            type: number
            default: 10
            maximum: 10
      responses:
        '200':
          description: Paginated validator deposits
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaginatedValidatorDeposits'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/BeaconForbidden'
        '404':
          $ref: '#/components/responses/ValidatorNotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
      security:
        - bearerAuth: []
components:
  schemas:
    PaginatedValidatorDeposits:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/ValidatorDeposit'
        offset:
          type: number
          description: Current pagination offset
        limit:
          type: number
          description: Records per page
        totalRows:
          type: number
          description: Total number of deposits
        pages:
          type: number
          description: Total number of pages
    ValidatorDeposit:
      type: object
      properties:
        slot:
          type: number
          description: Slot in which the deposit was included
        epoch:
          type: number
          description: Epoch containing the slot
        timestamp:
          type: number
          description: Unix timestamp of the deposit
        amount:
          type: string
          description: Deposited amount in wei
        depositIndex:
          type: number
          description: Global deposit contract index
        withdrawalCredentials:
          type: string
          description: Full withdrawal credential hex string
        withdrawalAddress:
          type: string
          nullable: true
          description: EVM withdrawal address (0x01 prefix only, otherwise null)
  responses:
    BadRequest:
      description: Input validation failed
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
    Unauthorized:
      description: Missing or invalid Bearer token
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthorized
    BeaconForbidden:
      description: >-
        Forbidden — beacon access requires enterprise subscription. Contact
        sales.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Beacon access requires enterprise subscription. Contact sales.
    ValidatorNotFound:
      description: Validator does not exist on mainnet.
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
                example: Validator not found for index 99999999
    InternalServerError:
      description: Upstream beacon data error.
      content:
        text/plain:
          schema:
            type: string
            example: Error fetching validator details
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````