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

# Get per-validator reward distribution for a finished round

> Computes per-validator and per-nominator reward distribution for a finished validation round using the elector's bonuses value.




## OpenAPI

````yaml GET /v2/rewards/round-rewards
openapi: 3.0.0
info:
  title: REST api to TON blockchain explorer
  version: 2.0.0
  description: Provide access to indexed TON blockchain
  contact:
    name: Support
    email: support@tonkeeper.com
servers:
  - url: https://tonapi.io
  - url: https://testnet.tonapi.io
  - url: http://localhost:8081
security: []
tags:
  - name: Accounts
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/accounts
  - name: Migration
  - name: NFT
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/nft
  - name: Jettons
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/jettons
  - name: DNS
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/dns
  - name: Wallet
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/wallet
  - name: Rates
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/rates
  - name: Staking
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/staking
  - name: Traces
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/traces
  - name: Events
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/events
  - name: Storage
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/storage
  - name: Connect
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/connect
  - name: Gasless
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/gasless
  - name: Multisig
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/multisig
  - name: Blockchain
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/blockchain
  - name: Lite Server
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/lite-server
  - name: Emulation
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/emulation
  - name: Utilities
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/utilities
  - name: ExtraCurrency
    externalDocs:
      description: Additional documentation
      url: https://docs.tonconsole.com/tonapi/rest-api/extra-currency
  - name: Purchases
paths:
  /v2/rewards/round-rewards:
    get:
      tags:
        - Rewards
      summary: Get per-validator reward distribution for a finished round
      description: >
        Computes per-validator and per-nominator reward distribution for a
        finished validation round using the elector's bonuses value.
      operationId: getRoundRewards
      parameters:
        - name: election_id
          in: query
          description: >
            Election ID of the finished round. Mutually exclusive with `block`
            and `unixtime`.
          required: false
          schema:
            type: integer
            format: int64
        - name: block
          in: query
          description: >
            Masterchain block seqno within the finished round. Mutually
            exclusive with `election_id` and `unixtime`.
          required: false
          schema:
            type: integer
            format: uint32
        - name: unixtime
          in: query
          description: >
            Unix timestamp (seconds). Looks up the masterchain block at this
            time and uses it as the anchor. Mutually exclusive with
            `election_id` and `block`.
          required: false
          schema:
            type: integer
            format: uint32
        - name: shallow
          in: query
          description: >
            Set to `1` to return only basic validator info (rank, pubkey,
            effective_stake, weight, reward, pool). Skips pool type detection,
            owner/validator addresses, nominator data, and returned-stake lookup
            — significantly faster.
          required: false
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoundRewardsResponse'
        default:
          $ref: '#/components/responses/Error'
components:
  schemas:
    RoundRewardsResponse:
      type: object
      required:
        - response_time_ms
        - election_id
        - round_start
        - round_end
        - start_block
        - end_block
        - total_bonuses
        - total_stake
        - validators
      properties:
        response_time_ms:
          type: integer
          format: int64
          description: Server-side response time in milliseconds.
          example: 5432
        election_id:
          type: integer
          format: int64
          description: Election ID (electAt timestamp).
          example: 1740053384
        prev_election_id:
          type: integer
          format: int64
          description: Election ID of the round immediately before this one.
          example: 1772486024
        next_election_id:
          type: integer
          format: int64
          description: Election ID of the round immediately after this one.
          example: 1772658824
        round_start:
          type: string
          format: date-time
          description: Validation round start time.
        round_end:
          type: string
          format: date-time
          description: Validation round end time.
        start_block:
          type: integer
          format: uint32
          description: First masterchain block of the round.
        end_block:
          type: integer
          format: uint32
          description: Last masterchain block of the round.
        total_bonuses:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        total_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        validators:
          type: array
          items:
            $ref: '#/components/schemas/ValidatorRewardEntry'
        error:
          type: string
    ValidatorRewardEntry:
      type: object
      required:
        - rank
        - public_key
        - effective_stake
        - weight
        - reward
      properties:
        rank:
          type: integer
          description: Position sorted by effective stake (descending).
          example: 1
        public_key:
          type: string
          description: Validator's public key (hex-encoded Ed25519).
          example: e33f0e53552f951e0a27c8e5a461a1bd65975af369a2c85a06e51f7fbb8ae667
        effective_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        weight:
          type: number
          format: double
          description: Fraction of total effective stake (0–1).
          example: 0.004648
        reward:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        pool:
          type: string
          description: Pool smart contract address (bounceable, base64url).
          example: Ef_bmCmMPsrHKOC4hV8foWBs2TEUAggQ1Wfe6EAqjrI3sGNI
        pool_type:
          type: string
          description: Contract type detected by code hash.
          enum:
            - nominator-pool-v1.0
            - single-nominator-pool-v1.0
            - single-nominator-pool-v1.1
            - other
        owner_address:
          type: string
        validator_address:
          type: string
        validator_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        nominators_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        total_stake:
          type: integer
          description: >
            Total funds deposited by the pool: effective_stake + credit
            (leftover balance kept in the elector contract after election).
          format: int64
          example: 123456789
          x-js-format: bigint
        validator_reward_share:
          type: number
          format: double
          description: Fraction of staking rewards kept by the validator (0.3 = 30%).
          example: 0.3
        nominators_count:
          type: integer
          format: uint32
        nominators:
          type: array
          items:
            $ref: '#/components/schemas/NominatorRewardEntry'
    InsufficientFunds:
      type: object
      description: >
        Present on an error when a request failed because the source wallet does
        not hold enough TON to cover the required gas (error_code 50000).
      required:
        - required
        - available
      properties:
        required:
          type: integer
          format: int64
          description: TON in nanotons required to cover transfer gas
          x-js-format: bigint
        available:
          type: integer
          format: int64
          description: TON in nanotons currently available on the source wallet
          x-js-format: bigint
    NominatorRewardEntry:
      type: object
      required:
        - address
        - weight
        - reward
        - effective_stake
        - stake
      properties:
        address:
          type: string
          description: Nominator's wallet address (bounceable, base64url).
          example: EQAqR4RYauq7p3jqKGnD-eSYVDoOCak9g8ZsSNVHI9fevCzB
        weight:
          type: number
          format: double
          description: Nominator's share of total nominators' deposit (0–1).
          example: 0.15
        reward:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        effective_stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
        stake:
          type: integer
          description: amount in nanograms
          format: int64
          example: 123456789
          x-js-format: bigint
  responses:
    Error:
      description: Some error during request processing
      content:
        application/json:
          schema:
            type: object
            required:
              - error
            properties:
              error:
                type: string
              error_code:
                type: integer
                format: int64
              details:
                $ref: '#/components/schemas/InsufficientFunds'

````

## Related topics

- [Get all current validators](/rest/get_validators_get.md)
- [Get validation round metadata](/rest/get_validation_rounds_get.md)
- [Overview](/rest/overview.md)
- [Get historical APY and stake statistics](/rest/get_rewards_stats_get.md)
- [Get current TON blockchain APY](/rest/get_rewards_apy_get.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.