Endpoints
API Usage
Once you already have access to the Staking API with a validated user and existing apikeys you can start using this service.
API Reference docs
You can check the Staking API Reference here:
- Rendered doc page.
- Staking OpenApi
Authentication
In order to use staking api related endpoints you need to include your API KEY
Header:
| Name | Description | Example value | Required |
|---|---|---|---|
X-API-KEY | Your api key value | <API_KEY_VALUE> | ✅ |
X-NETWORK | Blockchain network/cluster identifier | mainnet-beta | ⚪ |
X-NETWORK header
Use the X-NETWORK header to select the Solana cluster to operate on (e.g., mainnet-beta, devnet).
Supported values match the RPC cluster identifier that Solana exposes (the cluster argument in web3). If you omit the header the API falls back to the default Solana network configured for your account.
Currently supported values: mainnet-beta and devnet. Contact [email protected] if you need another cluster enabled.
List available networks
Need to know which Solana clusters are enabled for your API key? Ask the API directly.
- Endpoint:
/api/v1/solana/native/networks
Each item in the response includes:
| Field | Description |
|---|---|
name | Internal descriptor for the Solana blockchain entry |
type | Blockchain type string (always SOLANA) |
chain_id | Cluster identifier such as mainnet-beta or devnet |
is_default | true when the cluster is used as fallback |
Create nonce account action
Craft a create nonce account transaction:
Description
This endpoint will craft a create nonce account transaction ready to be signed. Creating a nonce account is an important step for durable transactions in Solana, especially useful for complex operations like staking.
Request body parameters
Returned
SolanaStakingActionResponseDto
Stake action
Craft a stake transaction:
- Endpoint:
/api/v1/solana/native/action/stake
Description
This endpoint will craft a stake transaction ready to be signed.
The stake action combines these steps into a single transaction, simplifying the process for users. When you initiate a stake action through the Staking API, it will craft a transaction that creates the stake account, funds it, and delegates to our validator in one go.
Request body parameters
Returned
SolanaStakingActionResponseDto
Unstake action (deactivate)
Craft an unstake transaction:
- Endpoint:
/api/v1/solana/native/action/unstake
Description
This endpoint will craft an unstake transaction ready to be signed.
The unstake action through the Staking API initiates this process by creating a transaction that deactivates your stake account. It's important to note that this doesn't immediately return your tokens - you'll need to wait for the cooldown period and then perform a separate withdrawal action.
Request body parameters
Returned
SolanaStakingActionResponseDto
Withdraw deactivated stake action
Craft a claim rewards transaction:
- Endpoint:
/api/v1/solana/native/action/withdraw
Description
This endpoint will craft a withdraw deactivated stake transaction ready to be signed.
After your stake has been fully deactivated, you can withdraw the tokens back to your main wallet. This process is called withdrawing deactivated stake. Here's an overview of the withdraw action.
The withdraw action through the Staking API creates a transaction that performs this withdrawal. While it's possible to partially withdraw funds in multiple transactions, the most common approach is to fully withdraw the entire balance in a single transaction.
Request body parameters
Returned
SolanaStakingActionResponseDto
Prepare action
Gathers signature and unsigned tx:
- Endpoint:
/api/v1/solana/native/action/prepare
Description
Prepare a signed transaction by gathering the provided signatures with the unsigned transaction hex string:
Request body parameters
Returned
SolanaPrepareActionResponseDto
Broadcast action
Broadcast a signed transaction
- Endpoint:
/api/v1/solana/native/action/broadcast
Description
Broadcast a signed transaction. Usually you will brodcast the signed transaction returned in prepare previous step: