Skip to main content
POST
/
v1
/
portfolios
/
{portfolio_id}
/
wallets
/
{wallet_id}
/
staking
/
initiate
Request to stake or delegate a wallet
curl --request POST \
  --url https://api.prime.coinbase.com/v1/portfolios/{portfolio_id}/wallets/{wallet_id}/staking/initiate \
  --header 'Content-Type: application/json' \
  --data '
{
  "idempotency_key": "<string>",
  "inputs": {
    "amount": "<string>",
    "validator_address": "<string>"
  }
}
'
{
  "wallet_id": "<string>",
  "transaction_id": "<string>",
  "activity_id": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.cloud.coinbase.com/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

​
portfolio_id
string
required

The portfolio ID

​
wallet_id
string
required

The wallet ID

Body

application/json

StakingInitiateRequest represents a request to initiate a staking operation.

​
idempotency_key
string
required

The client generated idempotency key for requested execution. Subsequent requests using the same key will fail

​
inputs
object

WalletStakeInputs contains the custom inputs for staking operations on a wallet. Requirements and supported fields vary by asset type.

Response

200 - application/json

A successful response.

StakingInitiateResponse contains the response data from initiating a staking operation.

​
wallet_id
string
required

The wallet ID

​
transaction_id
string
required

ID of the newly created transaction, can be used to fetch details of the current state of execution

​
activity_id
string
required

The ID for the activity generated for this request