Main Menu

<< APIs

GlobalStake API Documentation

Base URL and Authentication

All GlobalStake API requests must be sent to the following base URL:

https://stakepad-api.globalstake.io

Authentication

Every request must include an API key provided by the GlobalStake team. This key is unique to your team and must be passed in the Authorization header as a Bearer token:

Authorization: Bearer YOUR_API_KEY_HERE

If the Authorization header is missing or the token is invalid, the request will be rejected with a 401 Unauthorized error.

General Response Format

  • Each API call is expected to return an unsigned raw transaction JSON.
  • Any response that does not conform to this format is considered an error.

Lukso API Endpoints

1. Get Lukso Deposit Transaction

Endpoint: /lukso/get_deposit_data

Method: POST

Description: Generates an unsigned Lukso deposit transaction.

Request Parameters:

  • withdrawal_address (string) – Lukso address where the deposit withdrawal is directed.
  • num_of_validators (number) – Number of validators being deposited.
  • amount (number) – amount of LYX to deposit per validator. Must be set at 32 LYX until the Lukso network adopts the Pectra upgrade.
  • chain (string) – Lukso network type Lukso).
  • regular_withdrawal (bool) – if set to true, enables 0x01 withdrawal credentials for deposits of 32 LYX. As a default, this optional parameter is set to false.

Success Response: Unsigned raw transaction JSON.

Error cases:

  • Invalid withdrawal address format.
  • num_of_validators is not a positive integer.
  • Unsupported chain value.

Endpoint: /lukso/get_validators

Method: POST

Description: Fetches validator details for a given address.

Request Parameters:

  • address (string) – Lukso address associated with the validators.
  • chain (string) – Lukso network type Lukso).

Success Response: Returns validator metadata and associated deposit information

Error cases:

  • Invalid wallet public key.
  • Input wallet has no associated validators.

Endpoint: /lukso/withdrawal

Method: POST

Description: Generates an unsigned transaction to initiate withdrawals for one or more validators.

Request Parameters:

  • validator_pubkeys (array of strings) – one or more BLS public keys associated with validators eligible for withdrawal.
  • chain (string) – Must be Lukso.

Success Response: Returns an unsigned raw transaction JSON that can be submitted to initiate the withdrawal(s).

Error cases:

  • validator_pubkeys is not a non-empty array of valid hex strings.
  • One or more validator pubkeys are not eligible for withdrawal (e.g., not yet withdrawable).
  • chain is not “Lukso”.

Endpoint: /lukso/validator_status

Method: POST

Description: Fetches validator status and activation / exit epochs for a given validator.

Request Parameters:

  • index (string) – Validator index or validator public key.
  • chain (string) – Must be Lukso.

Success Response: API response including status, index, activation epoch, exit epoch, etc.

Error cases:

  • Invalid validator index