Query Parameters

election_id

integer

Election ID of the finished round

block

integer

Masterchain block seqno within the finished round

Returns

response_time_ms

integer

Server-side response time in milliseconds

election_id

integer

The election ID of the finished round

prev_election_id

integer

The election ID of the previous validation round

next_election_id

integer

The election ID of the next validation round

round_start

string

The start time of the validation round (UTC, RFC 3339)

round_end

string

The end time of the validation round (UTC, RFC 3339)

start_block

integer

The masterchain block seqno at the start of the round

end_block

integer

The masterchain block seqno at the end of the round

total_bonuses

string

The total bonuses distributed in the round (nanoTON)

total_stake

string

The sum of all active validators' effective stakes (nanoTON)

validators

array

An array of validator objects with reward details

rank

integer

Position in the validator list, sorted by effective stake (descending)

pubkey

string

Validator's public key (hex-encoded Ed25519)

effective_stake

string

Validator's true stake locked in the Elector contract (nanoTON)

weight

number

Fraction of the total effective stake held by this validator (0-1)

reward

string

Total reward earned by this validator for the round (nanoTON)

pool

string

Pool smart contract address (bounceable, base64url). Only present when a pool is associated

owner_address

string

The single owner who deposited funds (bounceable, base64url). Only present for single-nominator pools

validator_address

string

Validator's wallet address that controls the node (bounceable, base64url). Only present for nominator and single-nominator pools

pool_type

string

Contract type: nominator-pool-v1.0, single-nominator-pool-v1.1, or other

validator_stake

string

Validator's own funds deposited into the pool (nanoTON). Only present for nominator pools

nominators_stake

string

Sum of all nominator deposits in the pool (nanoTON). Only present for nominator pools

total_stake

string

Total funds deposited by the pool (nanoTON)

validator_reward_share

number

Fraction of staking rewards kept by the validator (e.g., 0.3 = 30%). Only present for nominator pools

nominators_count

integer

Number of nominators in the pool. Only present for nominator pools

nominators

array

List of individual nominators. Only present for nominator pools

address

string

Nominator's wallet address (bounceable, base64url)

weight

number

Nominator's share of the total nominators' deposit (0-1)

reward

string

Nominator's reward after the validator's cut (nanoTON)

effective_stake

string

Nominator's proportional share of the effective stake locked in the Elector (nanoTON)

stake

string

Nominator's raw deposit in the pool contract (nanoTON)

Request

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/round-rewards?election_id=1740053384' \
2
--header 'accept: application/json'
3

1
curl --location 'https://docs-demo.ton-mainnet.quiknode.pro/api/round-rewards?election_id=1740053384' \
2
--header 'accept: application/json'
3

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
  method: "GET",
6
  headers: myHeaders,
7
  redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/api/round-rewards?election_id=1740053384", requestOptions)
11
  .then((response) => response.text())
12
  .then((result) => console.log(result))
13
  .catch((error) => console.error(error));
14

1
const myHeaders = new Headers();
2
myHeaders.append("accept", "application/json");
3

4
const requestOptions = {
5
  method: "GET",
6
  headers: myHeaders,
7
  redirect: "follow"
8
};
9

10
fetch("https://docs-demo.ton-mainnet.quiknode.pro/api/round-rewards?election_id=1740053384", requestOptions)
11
  .then((response) => response.text())
12
  .then((result) => console.log(result))
13
  .catch((error) => console.error(error));
14

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/round-rewards?election_id=1740053384"
4

5
payload = {}
6
headers = {
7
  'accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)
11

12
print(response.text)
13

1
import requests
2

3
url = "https://docs-demo.ton-mainnet.quiknode.pro/api/round-rewards?election_id=1740053384"
4

5
payload = {}
6
headers = {
7
  'accept': 'application/json'
8
}
9

10
response = requests.request("GET", url, headers=headers, data=payload)
11

12
print(response.text)
13

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/round-rewards?election_id=1740053384")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)
11
puts response.read_body
12

1
require "uri"
2
require "net/http"
3

4
url = URI("https://docs-demo.ton-mainnet.quiknode.pro/api/round-rewards?election_id=1740053384")
5

6
http = Net::HTTP.new(url.host, url.port);
7
request = Net::HTTP::Get.new(url)
8
request["accept"] = "application/json"
9

10
response = http.request(request)
11
puts response.read_body
12

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free