kmd_rewards_info
kmd_rewards_info
The kmd_rewards_info
method returns information about the active user rewards that can be claimed by an address's unspent outputs.
This method only works when the KMD coin is activated.
Structure | Type | Description |
---|---|---|
(none) |
Structure | Type | Description |
---|---|---|
result | array of objects | the rewards info; each element corresponds to an unspent output and contains detailed information about the active user rewards corresponding to it |
tx_hash | string | the hash of the transaction |
height | number (integer, optional) | the height of the block in which the transaction was included (empty if the tx is not mined yet) |
output_index | number (integer) | the zero-based index of the output in the transaction’s list of outputs |
amount | string (numeric) | the transaction output’s value |
locktime | number (integer) | the transaction output's locktime |
accrued_rewards | object | either a NotAccruedReason or AccruedRewards object, showing the amount of accrued rewards, or the reason why rewards are not accrued. |
accrue_start_at | number (integer, optional) | the rewards start to accrue at this time for the given transaction (empty if the rewards will never accrue to it) |
accrue_stop_at | number (integer, optional) | the rewards stop to accrue at this time for the given transaction (empty if the tx is not mined yet or if rewards will never accrue to it) |
Where the accrued_rewards
has either
Structure | Type | Description |
---|---|---|
Accrued | string (numeric) | the amount of accrued rewards |
or
Structure | Type | Description |
---|---|---|
NotAccruedReason | string | the reason why rewards are not accrued |
POST
kmd_rewards_info{
"userpass": "RPC_UserP@SSW0RD",
"method": "kmd_rewards_info"
}
{
"result": [
{
"accrue_stop_at": 1596144028,
"accrued_rewards": {
"Accrued": "0.00450984"
},
"amount": "47.99897112",
"height": 1986467,
"input_index": 1,
"locktime": 1596099388,
"tx_hash": "016bfb8fcf8704a30b5daf6b4bcce9d7e848141b53df44a5eae3db4279227401"
},
{
"accrue_stop_at": 1596142801,
"accrued_rewards": {
"NotAccruedReason": "UtxoAmountLessThanTen"
},
"amount": "0.5",
"height": 1986481,
"input_index": 0,
"locktime": 1596098161,
"tx_hash": "762d02d9d52faf365b55375da5e61ce34bb0ea391fbcb23e74b2adf8165f1bbb"
}
]
}