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/chain identifier | cosmoshub-4 | ⚪ |
X-NETWORK header
Use the X-NETWORK header to tell the API which Cosmos network should process the request (e.g., cosmoshub-4, juno-1).
X-NETWORK accepts the same identifier exposed as chain_id in the Cosmos Chain Registry. When the header is omitted the default Cosmos network configured for your account will be used.
Need support for another network? Reach out at [email protected].
List available networks
If you are unsure which Cosmos networks are enabled for your account you can ask the API directly.
- Endpoint:
/api/v1/cosmos/native/networks
Each object in the response includes:
| Field | Description |
|---|---|
name | Internal name of the blockchain entry |
type | Blockchain type string (always COSMOS) |
chain_id | Chain identifier, same as the Cosmos Chain Registry chain_id |
is_default | true when this network is used as fallback |
Stake action
Craft a stake transaction:
- Endpoint:
/api/v1/cosmos/native/action/stake
Description
This endpoint will craft a stake transaction ready to be signed.
Request body parameters
Returned
Unstake action
Craft an unstake transaction:
- Endpoint:
/api/v1/cosmos/native/action/unstake
Description
This endpoint will craft an unstake transaction ready to be signed.
Request body parameters
Returned
Claim rewards action
Craft a claim rewards transaction:
Description
This endpoint will craft a claim rewards transaction ready to be signed.
Request body parameters
Returned
Prepare action
Gathers signature and unsigned tx:
- Endpoint:
/api/v1/cosmos/native/action/prepare
Description
Prepare a signed transaction by gathering the provided signatures with the unsigned transaction hex string:
Request body parameters
Returned
Broadcast action
Broadcast a signed transaction
- Endpoint:
/api/v1/cosmos/native/action/broadcast
Description
Broadcast a signed transaction. Usually you will brodcast the signed transaction returned in prepare previous step: