Staking

1. Stake API Returns an unsigned transaction to delegate SOL from your wallet to a validator.

2. Balance API Returns the current balance and status of a wallet or stake account.

API Reference

• Stake Request

  • Sample Request

  • Types

    • Stake Response Object

• Balance Request

  • Sample Request

    • Balance Response Object

Stake Request

POST /api/v1/stake

Submits a stake request to generate an unsigned transaction. This transaction needs to be signed by the private key of the wallet address and broadcasted to the network to trigger consolidation. This request also creates a stake account and user will have to pay one time rent fee for stake account creation.

Headers

Name	Type	Description
x-api-key*	String	API Key provided by Luganodes

Request Body

Name	Type	Description
validatorPubKey*	String	Public address of validator
walletPubKey*	String	Wallet address
amount*	Number	Stake amount in lamports. 1 SOL = 10^9 Lamports

200: OK Stake Response Object

{
    "success": true,
    "data": {
        "validatorPubkey": "6aow5rTURdbhbeMDrFrbP2GR5vZjMEhktEy87iH1VGPs",
        "walletPubkey": "2WeFEJbeXFrfm9v7zgF25bViroaHgLxX7imeMyLFzeBA",
        "stakeAccountPubkey": "6zvvTW6sNkuNtTfxZNZRtQrMVv1T6R3nT9E737v5Jizq",
        "stakeAmount": 1000000,
        "rentExemptAmount": 2282880,
        "totalAmount": 3282880,
        "unsignedTransactionBase64": "AgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACzdzie/leLci0dnkUHJcxfRxpuTLUHL4XTHaTzB+AjKR5l2J4UbR30Bf7RGUoFMpZC01H86zNYonRuPU/Xaz4HAgAHCRZzpNGTlwgo9JlR6hlKexfg+w05YkuOhVBPrAHlba4pWSGCmvVn+jv3z6eixWz1P5/QsY1UYpp74BX7xpFKhWYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFLzqwV3zcnF1DzQIFiTM4mDS8C6kifk5UY/cZ2Z/vLqBqHYF5E3VCqYNDe9/ip6slV/U1yKeHIraKSdwAAAAAAGodgXpQIFC2gHkebObbiOHltxUPYfxnkKTrTRAAAAAAan1RcYx3TJKFZjmGkdXraLXrijm0ttXHNVWyEAAAAABqfVFxksXFEhjMlMPUrxf1ja7gibof1E49vZigAAAAAGp9UXGTWE0P7tm7NDHRMga+VEKBtXuFZsxTdf9AAAAFhS3xilPpygxdfDGKQjwR5UVDEsMWT7s7DmfaNRxbs9AwICAAE0AAAAAMAXMgAAAAAAyAAAAAAAAAAGodgXkTdUKpg0N73+KnqyVX9TXIp4citopJ3AAAAAAAQCAQd0AAAAABZzpNGTlwgo9JlR6hlKexfg+w05YkuOhVBPrAHlba4pFnOk0ZOXCCj0mVHqGUp7F+D7DTliS46FUE+sAeVtrikAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAEBgEDBggFAAQCAAAA"
    }
}

Sample Request

curl --location '{{url}}/v1/stake' \
--header 'api-key: ee908371-d13b-43dd-ae33-b854dade5e9d' \
--data '{
    "validatorPubkey": "6aow5rTURdbhbeMDrFrbP2GR5vZjMEhktEy87iH1VGPs",
    "walletPubkey": "2WeFEJbeXFrfm9v7zgF25bViroaHgLxX7imeMyLFzeBA",
    "amount": 1000000
}'

Types

Stake Response Object

Property	Description	Type
validatorPubKey	Public address of validator	String
walletPubKey	Public address of user wallet	String
stakeAccountPubKey	Public address of stake account	String
unsignedTransactionBase64	Unsigned transaction which needs to be signed with the private key of the user wallet	String
stakeAmount	Amount of SOL to be staked	Number
rentAmount	Rent used for creation for stake account. Rent is required to be paid for creation of stake account and is a one time fee.	Number
totalAmount	Total SOL to be deducted from balance. It is the sum of stake amount and rent.	Number

Get Delegator Balance

POST api/v1/balance

Returns the list of stake accounts associated with a wallet address or for specified stake accounts. Each stake account now includes detailed balance, authorities, and epoch information.

Headers

Name	Type	Description
x-api-key*	String	API Key provided by Luganodes

Request Body

Name	Type	Description
walletPubKey	String (optional)	Public address of user wallet
stakeAccountPubKeys	Array<String> (optional)	List of stake account addresses to query
⚠️ Validation Rule		Exactly one of walletPubKey or stakeAccountPubKeys must be provided. If both are present, return 400 Bad Request.

200: OK — Balance Response Object

When queried by wallet

{
  "success": true,
  "data": {
    "walletPubkey": "2WeFEJbeXFrfm9v7zgF25bViroaHgLxX7imeMyLFzeBA",
    "balance": 177596826,
    "stakeAccounts": [
      {
        "pubkey": "6ZuLUCwVTvuQJrN1HrpoHJheQUw9Zk8CtiD3CEpHiA9E",
        "status": "active",
        "balance": {
          "total_sol": "5.00228288",
          "active_sol": "5.0",
          "inactive_sol": "0.00228288",
          "rewards_sol": "0.00228288"
        },
        "authorities": {
          "stake_authority": "C83GxcNFTC2tK22rLCCrLKYRkckbNVGsjethN5iswgfC",
          "withdraw_authority": "C83GxcNFTC2tK22rLCCrLKYRkckbNVGsjethN5iswgfC"
        },
        "epochs": {
          "activation_epoch": 485,
          "deactivation_epoch": null,
          "current_epoch": 520
        },
        "voter": "6aow5rTURdbhbeMDrFrbP2GR5vZjMEhktEy87iH1VGPs",
        "created_at": "2024-08-15T10:30:00Z",
        "updated_at": "2025-11-03T08:15:32Z"
      }
    ]
  }
}

When queried by stake accounts

{
  "success": true,
  "data": {
    "stakeAccounts": [
      {
        "pubkey": "6ZuLUCwVTvuQJrN1HrpoHJheQUw9Zk8CtiD3CEpHiA9E",
        "status": "active",
        "balance": {
          "total_sol": "5.00228288",
          "active_sol": "5.0",
          "inactive_sol": "0.00228288",
          "rewards_sol": "0.00228288"
        },
        "authorities": {
          "stake_authority": "C83GxcNFTC2tK22rLCCrLKYRkckbNVGsjethN5iswgfC",
          "withdraw_authority": "C83GxcNFTC2tK22rLCCrLKYRkckbNVGsjethN5iswgfC"
        },
        "epochs": {
          "activation_epoch": 485,
          "deactivation_epoch": null,
          "current_epoch": 520
        },
        "voter": "6aow5rTURdbhbeMDrFrbP2GR5vZjMEhktEy87iH1VGPs",
        "created_at": "2024-08-15T10:30:00Z",
        "updated_at": "2025-11-03T08:15:32Z"
      }
    ]
  }
}

Sample Requests

By Wallet

curl --location '{{url}}/v1/balance' \
--header 'api-key: ee908371-d13b-43dd-ae33-b854dade5e9d' \
--data '{
    "walletPubKey": "2WeFEJbeXFrfm9v7zgF25bViroaHgLxX7imeMyLFzeBA"
}'

By Multiple Stake Accounts

curl --location '{{url}}/v1/balance' \
--header 'api-key: ee908371-d13b-43dd-ae33-b854dade5e9d' \
--data '{
    "stakeAccountPubKeys": [
        "6ZuLUCwVTvuQJrN1HrpoHJheQUw9Zk8CtiD3CEpHiA9E",
        "BW8yWJoNPBQfKLLN2oKh7FxQEGimXFDHfDgrADPxRnxj"
    ]
}'

Response Object Fields

Property	Description	Type
walletPubkey	Public address of the user wallet (present only for wallet queries)	String
balance	Wallet SOL balance (lamports)	Number
stakeAccounts	List of stake accounts with details	Array<Object>

Stake Account Object

Property	Description	Type
pubkey	Public address of stake account	String
status	"active" or "inactive"	String
balance	SOL balance details	Object
→ total_sol	Total SOL in stake account	String
→ active_sol	Active staked SOL	String
→ inactive_sol	Inactive SOL	String
→ rewards_sol	Earned rewards	String
authorities	Stake and withdraw authorities	Object
→ stake_authority	Stake authority address	String
→ withdraw_authority	Withdraw authority address	String
epochs	Epoch metadata	Object
→ activation_epoch	Epoch when stake became active	Number / null
→ deactivation_epoch	Epoch when stake will deactivate	Number / null
→ current_epoch	Current epoch	Number
voter	Validator vote account address	String
created_at	Stake account creation timestamp (UTC)	String
updated_at	Last update timestamp (UTC)	String

Get Delegator Rewards

GET /api/v1/rewards

Returns aggregated rewards for a delegator address or specific stake accounts over a given time range. Rewards are grouped by the specified aggregation period (epoch, weekly, or monthly).

---

Query Parameters

Name	Type	Description
start_time *	Number	Start of the query period (Unix timestamp)
end_time *	Number	End of the query period (Unix timestamp)
period	String	Aggregation period — defaults to epoch Enum: epoch, weekly, monthly
wallet_address	String	Delegator wallet address
stake_accounts	Array<String>	One or more stake account addresses

⚠️ Validation Rules

• Exactly one of wallet_address or stake_accounts must be provided.

• If both are provided → return 400 Bad Request.

• The difference between end_time and start_time must not exceed the selected period.

---

200: OK — Rewards Response Object

{
  "status": "success",
  "data": {
    "delegator_address": "6ZuLUCwVTvuQJrN1HrpoHJheQUw9Zk8CtiD3CEpHiA9E",
    "period": "epoch",
    "total_rewards": {
      "sol": "0.00228288"
    },
    "rewards": [
      {
        "epoch": 485,
        "time_start": "2024-10-01T00:00:00Z",
        "time_end": "2024-10-03T12:30:00Z",
        "rewards_earned": {
          "sol": "0.00084592"
        },
        "reward_types": {
          "inflation_rewards": {
            "sol": "0.00074592"
          },
          "mev_rewards": {
            "sol": "0.0001"
          }
        },
        "starting_balance_sol": "5.0",
        "ending_balance_sol": "5.00084592"
      },
      {
        "epoch": 486,
        "time_start": "2024-10-03T12:30:00Z",
        "time_end": "2024-10-06T01:00:00Z",
        "rewards_earned": {
          "sol": "0.00085648"
        },
        "reward_types": {
          "inflation_rewards": {
            "sol": "0.00075648"
          },
          "mev_rewards": {
            "sol": "0.0001"
          }
        },
        "starting_balance_sol": "5.00084592",
        "ending_balance_sol": "5.00170240"
      },
      {
        "epoch": 487,
        "time_start": "2024-10-06T01:00:00Z",
        "time_end": "2024-10-08T13:30:00Z",
        "rewards_earned": {
          "sol": "0.00058048"
        },
        "reward_types": {
          "inflation_rewards": {
            "sol": "0.00048048"
          },
          "mev_rewards": {
            "sol": "0.0001"
          }
        },
        "starting_balance_sol": "5.00170240",
        "ending_balance_sol": "5.00228288"
      }
    ]
  },
  "metadata": {
    "query_time": "2025-11-03T10:25:30Z",
    "epochs_included": 3
  }
}

---

Response Object

Property	Description	Type
delegator_address	Delegator wallet or stake account queried	String
period	Aggregation interval	String
total_rewards	Total rewards during the requested range	Object
→ sol	Total rewards in SOL	String
rewards	List of reward entries for each period (epoch/day/week/month)	Array<Object>

Reward Entry Object

Property	Description	Type
epoch	Epoch number (for period=epoch)	Number
time_start	Start timestamp of the interval (UTC)	String
time_end	End timestamp of the interval (UTC)	String
rewards_earned	Total rewards earned in the period	Object
→ sol	Amount in SOL	String
reward_types	Breakdown of reward categories	Object
→ inflation_rewards.sol	Rewards from inflation	String
→ mev_rewards.sol	Rewards from MEV (if applicable)	String
starting_balance_sol	Balance at start of period	String
ending_balance_sol	Balance at end of period	String

Metadata Object

Property	Description	Type
query_time	ISO timestamp when query was executed	String
epochs_included	Number of epochs included in results	Number

---

Sample Request

By Wallet

curl --location '{{url}}/v1/history?wallet_address=6ZuLUCwVTvuQJrN1HrpoHJheQUw9Zk8CtiD3CEpHiA9E&start_time=1727740800&end_time=1728163200&period=epoch' \
--header 'api-key: ee908371-d13b-43dd-ae33-b854dade5e9d'

By Multiple Stake Accounts

curl --location '{{url}}/v1/history?stake_accounts=6ZuLUCwVTvuQJrN1HrpoHJheQUw9Zk8CtiD3CEpHiA9E,7aNyy5FLrikPoTWcn5iGT4DUPsWqEk6v6pPNKWjDZyoG&start_time=1727740800&end_time=1728163200&period=daily' \
--header 'api-key: ee908371-d13b-43dd-ae33-b854dade5e9d'

Get Delegator History

GET /api/v1/history/events

Returns a detailed chronological log of all staking-related events for a delegator wallet or specific stake accounts within a given time range. Includes summary statistics, validator participation, and pagination support.

---

Query Parameters

Name	Type	Description
start_time *	Number	Start of the query period (Unix timestamp)
end_time *	Number	End of the query period (Unix timestamp)
wallet_address	String	Delegator wallet address (use either this or stake_accounts)
stake_accounts	Array<String>	One or more stake account addresses (use either this or wallet_address)
page	Number	Page number for pagination. Default: 1
page_size	Number	Number of events per page. Default: 50
excluded_event_type	Array<String>	Event types to exclude from results (can take multiple values)

⚠️ Validation

• Provide exactly one of wallet_address or stake_accounts. If both are present → 400 Bad Request.

• Ensure end_time ≥ start_time (difference not excessively large to avoid truncation).

---

200: OK — Response

{
  "status": "success",
  "data": {
    "address": "6ZuLUCwVTvuQJrN1HrpoHJheQUw9Zk8CtiD3CEpHiA9E",
    "time_range": {
      "start": "2024-10-01T00:00:00Z",
      "end": "2024-10-31T23:59:59Z"
    },
    "summary": {
      "total_rewards_earned": { "sol": "0.00228288" },
      "starting_balance": { "sol": "5.0" },
      "ending_balance": { "sol": "5.00228288" },
      "epochs_active": 13,
      "status_changes": 1
    },
    "history": [
      {
        "event_type": "account_created",
        "timestamp": "2024-10-01T00:00:00Z",
        "epoch": 485,
        "details": {
          "initial_stake_sol": "5.0",
          "validator_vote_key": "FKsC411dik9ktS6xPADxs4Fk2SCENvAiuccQHLAPndvk",
          "stake_authority": "C83GxcNFTC2tK22rLCCrLKYRkckbNVGsjethN5iswgfC",
          "withdraw_authority": "C83GxcNFTC2tK22rLCCrLKYRkckbNVGsjethN5iswgfC"
        }
      },
      {
        "event_type": "delegation_activated",
        "timestamp": "2024-10-03T12:30:00Z",
        "epoch": 486,
        "details": {
          "status_changed_from": "activating",
          "status_changed_to": "active",
          "active_stake_sol": "5.0"
        }
      },
      {
        "event_type": "rewards_earned",
        "timestamp": "2024-10-03T12:30:00Z",
        "epoch": 486,
        "details": {
          "rewards_sol": "0.00084592",
          "inflation_rewards_sol": "0.00074592",
          "mev_rewards_sol": "0.0001",
          "new_balance_sol": "5.00084592"
        }
      }
    ],
    "validators": [
      {
        "vote_account": "FKsC411dik9ktS6xPADxs4Fk2SCENvAiuccQHLAPndvk",
        "identity": "7cVfgArCheMR6Cs4t6vz5rfnqd56vZq4ndaBrY5xkxXy",
        "name": "Luganodes Validator",
        "epochs_delegated": 13,
        "total_rewards_from_validator": { "sol": "0.00228288" }
      }
    ]
  },
  "pagination": {
    "page": 1,
    "page_size": 50,
    "total_events": 5,
    "has_more": false
  },
  "metadata": {
    "query_time": "2025-11-03T10:40:22Z"
  }
}

---

Response Object

Property	Description	Type
address	Wallet or stake account address queried	String
time_range.start	Start timestamp (UTC)	String
time_range.end	End timestamp (UTC)	String
summary	Aggregated statistics over range	Object
→ total_rewards_earned.sol	Total rewards (SOL)	String
→ starting_balance.sol	Starting SOL balance	String
→ ending_balance.sol	Ending SOL balance	String
→ epochs_active	Number of epochs stake was active	Number
→ status_changes	Number of status transitions	Number
history	Chronological list of staking events	Array<Object>
validators	Validators interacted with during the period	Array<Object>

History Event Object

Property	Description	Type
event_type	Event type (account_created, delegation_activated, rewards_earned, etc.)	String
timestamp	UTC time of event	String
epoch	Epoch when event occurred	Number
details	Contextual event details	Object

Validator Object

Property	Description	Type
vote_account	Validator vote account address	String
identity	Validator identity address	String
name	Validator name (if known)	String
epochs_delegated	Number of epochs delegated to this validator	Number
total_rewards_from_validator.sol	Rewards earned from this validator (SOL)	String

Pagination Object

Property	Description	Type
page	Current page number	Number
page_size	Items per page	Number
total_events	Total number of events found	Number
has_more	Whether more pages exist	Boolean

Metadata Object

Property	Description	Type
query_time	API query timestamp (UTC)	String

---

Sample Requests

By Wallet

curl --location '{{url}}/v1/history/events?wallet_address=6ZuLUCwVTvuQJrN1HrpoHJheQUw9Zk8CtiD3CEpHiA9E&start_time=1727740800&end_time=1730332799&page=1&page_size=50' \
--header 'api-key: ee908371-d13b-43dd-ae33-b854dade5e9d'

By Multiple Stake Accounts

curl --location '{{url}}/v1/history/events?stake_accounts=6ZuLUCwVTvuQJrN1HrpoHJheQUw9Zk8CtiD3CEpHiA9E,7aNyy5FLrikPoTWcn5iGT4DUPsWqEk6v6pPNKWjDZyoG&start_time=1727740800&end_time=1730332799&page=1&page_size=50&excluded_event_type=rewards_earned,delegation_deactivated' \
--header 'api-key: ee908371-d13b-43dd-ae33-b854dade5e9d'

---