Rewards

Track historical staking rewards

Supported Environments

Luganodes supports the following environments on SUI, as defined below

https://staking-apis-staging.tail22959.ts.net	Sui Mainnet - Staging

Rewards

POST /sui/rewards/daily?page={{page}}?limit={{limit}}

Track historical rewards of a stake account on per epoch basis.

Header

Name	Type	Description
x-api-key*	String	API key

Request Body

Name	Type	Description
stake_account_address*	String	Address of stake account (Delegator Address)
start_date*	String	Start of date range (YYYY-MM-DD)
end_date*	String	End of date range (YYYY-MM-DD)

200: OK

{
    "rewards": [
        {
            "epochReward": 104045285435,
            "principal": "1506659480391677",
            "totalRewards": "208226541922",
            "date": "2025-01-01",
            "epoch": 630
        },
        {
            "epochReward": 104161073304,
            "principal": "1506659480391677",
            "totalRewards": "312387615226",
            "date": "2025-01-02",
            "epoch": 631
        },
        {
            "epochReward": 104131768377,
            "principal": "1506659480391677",
            "totalRewards": "416519383603",
            "date": "2025-01-03",
            "epoch": 632
        },
        {
            "epochReward": 104976598494,
            "principal": "1506659480391677",
            "totalRewards": "521495982097",
            "date": "2025-01-04",
            "epoch": 633
        },
        {
            "epochReward": 104744478405,
            "principal": "1506659480391677",
            "totalRewards": "626240460502",
            "date": "2025-01-05",
            "epoch": 634
        },
        {
            "epochReward": 104778355837,
            "principal": "1506659480391677",
            "totalRewards": "731018816339",
            "date": "2025-01-06",
            "epoch": 635
        },
        {
            "epochReward": 104842351572,
            "principal": "1506659480391677",
            "totalRewards": "835861167911",
            "date": "2025-01-07",
            "epoch": 636
        },
        {
            "epochReward": 105011074824,
            "principal": "1506659480391677",
            "totalRewards": "940872242735",
            "date": "2025-01-08",
            "epoch": 637
        },
        {
            "epochReward": 104974570037,
            "principal": "1506659480391677",
            "totalRewards": "1045846812772",
            "date": "2025-01-09",
            "epoch": 638
        },
        {
            "epochReward": 105493055170,
            "principal": "1506659480391677",
            "totalRewards": "1151339867942",
            "date": "2025-01-10",
            "epoch": 639
        }
    ],
    "pagination": {
        "currentPage": 1,
        "totalPages": 3,
        "totalRewards": 30,
        "hasNextPage": true,
        "hasPrevPage": false
    }
}

400: Bad Request

401: Unauthorized

403: Forbidden

Sample Request

curl --location '{{URL}}/sui/rewards/daily?page=1&limit=10' \
--header 'Content-Type: application/json' \
--data '{
  "stake_account_address": "0xefaefaesfsf.....",
  "start_date": "2025-01-01",
  "end_date": "2025-01-31"
}'

Rewards Response Object

Property	Description	Type
epochReward	Reward earned at end of epoch	Number
principal	Initial stake amount	Number
totalRewards	Total rewards since time of stake	Number
date	Epoh date	String
epoch	Epoch number	Number