---
title: "Get per-validator reward distribution for a finished round"
method: GET
path: "/v2/rewards/round-rewards"
tags: ["Rewards"]
---

# Get per-validator reward distribution for a finished round

`GET /v2/rewards/round-rewards`

## Request

- Base URL: `https://tonapi.io`
- URL: `https://tonapi.io/v2/rewards/round-rewards`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer/docs/v2/rewards/round-rewards/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Query parameters

- `election_id` integer
- `block` integer
- `unixtime` integer
- `shallow` boolean

## Response `200`

Successful response

- RoundRewardsResponse
  - `election_id` integer, required: Election ID (electAt timestamp).
  - `end_block` integer, required: Last masterchain block of the round.
  - `error` string
  - `next_election_id` integer: Election ID of the round immediately after this one.
  - `prev_election_id` integer: Election ID of the round immediately before this one.
  - `response_time_ms` integer, required: Server-side response time in milliseconds.
  - `round_end` string, date-time, required: Validation round end time.
  - `round_start` string, date-time, required: Validation round start time.
  - `start_block` integer, required: First masterchain block of the round.
  - `total_bonuses` integer, required: amount in nanograms
  - `total_stake` integer, required: amount in nanograms
  - `validators` ValidatorRewardEntry[], required
    - `effective_stake` integer, required: amount in nanograms
    - `nominators` NominatorRewardEntry[]
      - `address` string, required: Nominator's wallet address (bounceable, base64url).
      - `effective_stake` integer, required: amount in nanograms
      - `reward` integer, required: amount in nanograms
      - `stake` integer, required: amount in nanograms
      - `weight` number, double, required: Nominator's share of total nominators' deposit (0–1).
    - `nominators_count` integer
    - `nominators_stake` integer: amount in nanograms
    - `owner_address` string
    - `pool` string: Pool smart contract address (bounceable, base64url).
    - `pool_type` 'nominator-pool-v1.0' | 'single-nominator-pool-v1.0' | 'single-nominator-pool-v1.1' | 'other': Contract type detected by code hash.
    - `public_key` string, required: Validator's public key (hex-encoded Ed25519).
    - `rank` integer, required: Position sorted by effective stake (descending).
    - `reward` integer, required: amount in nanograms
    - `total_stake` integer: Total funds deposited by the pool: effective_stake + credit (leftover balance kept in the elector contract after election).
    - `validator_address` string
    - `validator_reward_share` number, double: Fraction of staking rewards kept by the validator (0.3 = 30%).
    - `validator_stake` integer: amount in nanograms
    - `weight` number, double, required: Fraction of total effective stake (0–1).

## Other responses

- `default`: Some error during request processing

---

[API](https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer.md) - [All operations](https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer/llms.txt) - [OpenAPI document](https://skmtc.dev/tonapi/apis/rest-api-to-ton-blockchain-explorer/revisions/fc4add7a71a0?raw)