naftiko: 1.0.0-alpha2
info:
  label: Blockdaemon Staking Reporting API — Reports
  description: Historical and current stake, reward, validator status, and yield reports for audit and accounting
    use across all PoS networks supported by Blockdaemon.
  tags:
  - Blockdaemon
  - Staking
  - Reporting
  - Rewards
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
- namespace: env
  keys:
    BLOCKDAEMON_API_KEY: BLOCKDAEMON_API_KEY
capability:
  consumes:
  - type: http
    namespace: staking-reporting
    baseUri: https://svc.blockdaemon.com
    description: Staking reporting endpoints.
    resources:
    - name: rewards
      path: /staking-reporting/v1/rewards
      operations:
      - name: getrewards
        method: GET
        description: List staking rewards for given addresses or validators over a time range.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: address
          in: query
          type: string
          required: false
        - name: validator
          in: query
          type: string
          required: false
        - name: from
          in: query
          type: string
          required: false
        - name: to
          in: query
          type: string
          required: false
    - name: validator-status
      path: /staking-reporting/v1/validators
      operations:
      - name: getvalidatorstatus
        method: GET
        description: Current validator status, including active set, exit queue, and slashing flags.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: protocol
          in: query
          type: string
          required: false
        - name: network
          in: query
          type: string
          required: false
    authentication:
      type: apikey
      key: X-API-Key
      value: '{{env.BLOCKDAEMON_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: staking-reporting-rest
    port: 8080
    description: REST adapter for staking reports.
    resources:
    - path: /v1/staking-reporting/rewards
      name: rewards
      description: REST surface for rewards reports.
      operations:
      - method: GET
        name: getrewards
        description: Get rewards over a time range.
        call: staking-reporting.getrewards
        with:
          address: rest.query.address
          validator: rest.query.validator
          from: rest.query.from
          to: rest.query.to
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: staking-reporting-mcp
    port: 9090
    transport: http
    description: MCP adapter for staking reports.
    tools:
    - name: blockdaemon-get-staking-rewards
      description: Get staking rewards for an address/validator over a time range.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: staking-reporting.getrewards
      with:
        address: tools.address
        validator: tools.validator
        from: tools.from
        to: tools.to
      outputParameters:
      - type: object
        mapping: $.
    - name: blockdaemon-get-validator-status
      description: Get current validator status across the active set/exit queue.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: staking-reporting.getvalidatorstatus
      with:
        protocol: tools.protocol
        network: tools.network
      outputParameters:
      - type: object
        mapping: $.