Ctrl+K

Redistribute a SUI reward lump-sum across missing epochs

post/api/staking/v1/admin/{coin}/delegations/{delegationId}/redistribute-rewards

Splits a lump-sum REWARD entry at lumpSumEpoch evenly across all epochs in [firstMissingEpoch, lumpSumEpoch]. Restricted to SUI and TSUI coins. Use dryRun: true (default) to preview changes before committing.

Path Parameters

  • coinstringRequired
    The staking asset.
    Enum: ADA APT ASI KAVACOSMOS ATOM AVAXC AVAXP BABY BERA BLD BSC BTC COREDAO COREUM CRONOS CSPR DOT EIGEN ETH FLRP HASH INJECTIVE MATIC NEAR OSMO POL POLYX RETH-ROCKET SEI SOMI SOL STORY STX SUI SUI:WAL TAO TIA TON TRX WETH WCT WFLR XDC ZETA
  • delegationIdstring<uuid>Required
    The delegation ID of the rewards to redistribute.

Request Body

firstMissingEpoch string required
The first epoch in the missing range (must be positive and less than lumpSumEpoch)
Example: 1052
lumpSumEpoch string required
The epoch of the lump-sum REWARD entry to be split
Example: 1056
dryRun boolean
If true (default), previews the redistribution without persisting changes
Default: true
Example: true

200 Response

delegationId string <uuid>
The delegation ID
Example: 123e4567-e89b-12d3-a456-426614174000
firstMissingEpoch string
First epoch in the redistributed range
Example: 1052
lumpSumEpoch string
The lump-sum epoch
Example: 1056
dryRun boolean
Whether this was a dry run
Example: true
totalEpochs integer
Total number of epochs in the range (n)
Example: 5
baseAmount string
Base amount per epoch (floor of lumpSum / n)
Example: 100000000
remainder integer
Number of epochs receiving base + 1
Example: 2
entries array[object]
A single redistributed reward entry
epoch string
The epoch number
Example: 1052
amount string
Amount assigned to this epoch
Example: 100000001
totalReward string
Running cumulative total reward after this epoch
Example: 5100000001
createdDate string <date-time>
Historical timestamp for this entry
Example: 2024-10-01T12:00:00.000Z
isNewEntry boolean
true for newly created entries (missing epochs), false for the lump-sum epoch update
Example: true

400 Response

error string
errorName string
reqId string
context object

401 Response

error string
errorName string
reqId string
context object

403 Response

error string
errorName string
reqId string
context object

404 Response

error string
errorName string
reqId string
context object

500 Response

error string
errorName string
reqId string
context object