Staking API Usage

​

Authentication

​

Making an API request

1. Click through any API in the reference here to learn more about its parameters and usage.
2. Fill in the parameters. For APIs like BuildStakingOperation and GetStakingContext that require custom options, refer to the staking options section below for available options.
   
3. Select your preferred language on the right to generate a sample request code. Use this as a reference to make a staking API request. For example, for the BuildStakingOperation API, the generated code for a Partial ETH stake of 0.1 ETH will look like this in some of the common languages:
   Bash

   NodeJs

   Go

   curl -s -L 'https://api.cdp.coinbase.com/platform/v1/stake/build' \
   -H 'Content-Type: application/json' \
   -H 'Accept: application/json' \
   -d '{
       "network_id": "ethereum-hoodi",
       "asset_id": "ETH",
       "address_id": "0xabcd",
       "action": "stake",
       "options": {
           "mode": "partial",
           "amount": "100000000000000000"
       }
   }'
   

   const axios = require('axios');
   
   let data = JSON.stringify({
       "network_id": "ethereum-hoodi",
       "asset_id": "ETH",
       "address_id": "0xabcd",
       "action": "stake",
       "options": {
           "mode": "partial",
           "amount": "100000000000000000"
       }
   });
   
   let config = {
       method: 'post',
       maxBodyLength: Infinity,
       url: 'https://api.cdp.coinbase.com/platform/v1/stake/build',
       headers: {
           'Content-Type': 'application/json',
           'Accept': 'application/json'
       },
       data : data
   };
   
   axios.request(config)
   .then((response) => {
       console.log(JSON.stringify(response.data));
   })
   .catch((error) => {
       console.log(error);
   });
   

   package main
   
   import (
   "fmt"
   "net/http"
   "io/ioutil"
   "strings"
   )
   
   func main() {
   url := "https://api.cdp.coinbase.com/platform/v1/stake/build"
   method := "POST"
   payload := strings.NewReader(`{"network_id":"ethereum-hoodi","asset_id":"ETH","address_id":"0xabcd","action":"stake","options":{"mode":"partial","amount":"100000000000000000"}}`)
   
   client := &http.Client {}
   req, err := http.NewRequest(method, url, payload)
   
   if err != nil {
       fmt.Println(err)
       return
   }
   
   req.Header.Add("Content-Type", "application/json")
   req.Header.Add("Accept", "application/json")
   
   res, err := client.Do(req)
   if err != nil {
       fmt.Println(err)
       return
   }
   defer res.Body.Close()
   
   body, err := ioutil.ReadAll(res.Body)
   if err != nil {
       fmt.Println(err)
       return
   }
   fmt.Println(string(body))
   }
   
4. Finally, add the JWT token, obtained from the authentication section above, as a Bearer header in your request. The code will look like this:
   cURL

   NodeJs

   Go

   export JWT="generated-jwt-token" # Replace with your JWT token
   
   curl -s -L 'https://api.cdp.coinbase.com/platform/v1/stake/build' \
   -H 'Content-Type: application/json' \
   -H 'Accept: application/json' \
   -H "Authorization: Bearer ${JWT}" \
   -d '{
       "network_id": "ethereum-hoodi",
       "asset_id": "ETH",
       "address_id": "0xabcd",
       "action": "stake",
       "options": {
           "mode": "partial",
           "amount": "100000000000000000"
       }
   }'
   

   const axios = require('axios');
   
   let data = JSON.stringify({
       "network_id": "ethereum-hoodi",
       "asset_id": "ETH",
       "address_id": "0xabcd",
       "action": "stake",
       "options": {
           "mode": "partial",
           "amount": "100000000000000000"
       }
   });
   
   let JWT = 'generated-jwt-token'; // Replace with your JWT token
   
   let config = {
       method: 'post',
       maxBodyLength: Infinity,
       url: 'https://api.cdp.coinbase.com/platform/v1/stake/build',
       headers: {
           'Content-Type': 'application/json',
           'Accept': 'application/json',
           'Authorization': `Bearer ${JWT}`
       },
       data : data
   };
   
   axios.request(config)
   .then((response) => {
       console.log(JSON.stringify(response.data));
   })
   .catch((error) => {
       console.log(error);
   });
   

   package main
   
   import (
   "fmt"
   "net/http"
   "io/ioutil"
   "strings"
   )
   
   func main() {
   url := "https://api.cdp.coinbase.com/platform/v1/stake/build"
   method := "POST"
   payload := strings.NewReader(`{"network_id":"ethereum-hoodi","asset_id":"ETH","address_id":"0xabcd","action":"stake","options":{"mode":"partial","amount":"100000000000000000"}}`)
   jwt := "generated-jwt-token" // Replace with your JWT token
   
   client := &http.Client {}
   req, err := http.NewRequest(method, url, payload)
   
   if err != nil {
       fmt.Println(err)
       return
   }
   
   req.Header.Add("Content-Type", "application/json")
   req.Header.Add("Accept", "application/json")
   req.Header.Add("Authorization", fmt.Sprintf("Bearer %s", jwt))
   
   res, err := client.Do(req)
   if err != nil {
       fmt.Println(err)
       return
   }
   defer res.Body.Close()
   
   body, err := ioutil.ReadAll(res.Body)
   if err != nil {
       fmt.Println(err)
       return
   }
   fmt.Println(string(body))
   }
   

​

Staking Options

{
  ...
  "options": {
    "mode": "partial",
    "amount": "100000000000000000",
    "integrator_contract_address": "custom-integrator-address"
  }
}

​

Shared ETH Staking

​

Dedicated ETH Staking

​

SOL Staking