TOP Group (The Open Platform) Rewards API is one of 23 APIs that TOP Group (The Open Platform) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Rewards. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes
5 operations
across 5 paths,
and defines 10 schemas.
It is described by OpenAPI 3.0.0, at version 2.0.0.
Requests are made against 3 base URLs: https://tonapi.io, https://testnet.tonapi.io, http://localhost:8081.
5 operations5 paths10 schemas5 GET
Metadata
The identity and technical contract details declared by the specification.
Across 5 paths, the API surfaces 5 operations — 5 GET. Each is listed below with its method, path, parameters, and response codes.
Rewards 5
GET
/v2/rewards/validators
Get all current validators
getValidators3 params→ 200default
GET
/v2/rewards/validation-rounds
Get validation round metadata
getValidationRounds3 params→ 200default
GET
/v2/rewards/round-rewards
Get per-validator reward distribution for a finished round
getRoundRewards4 params→ 200default
GET
/v2/rewards/stats
Get historical APY and stake statistics
getRewardsStats→ 200default
GET
/v2/rewards/apy
Get current TON blockchain APY
getRewardsApy→ 200default
Schemas 10
The contract defines 10 schemas that model the data the API accepts and returns. The most detailed are ValidatorRewardEntry (15 properties), RoundRewardsResponse (12 properties), ValidationRound (10 properties), ValidatorsResponse (10 properties). Each schema is shown below with its type and property counts.
ValidatorsResponse
object
10 properties8 required
RoundInfo
object
4 properties4 required
NominatorRewardEntry
object
5 properties5 required
ValidationRoundsResponse
object
2 properties2 required
BlockInfo
object
2 properties2 required
InsufficientFunds
object
Present on an error when a request failed because the source wallet does not hold enough TON to cover the required gas (errorcode 50000).
2 properties2 required
ValidationRound
object
10 properties5 required
RewardsStats
object
2 properties2 required
ValidatorRewardEntry
object
15 properties5 required
RoundRewardsResponse
object
12 properties9 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
