Create an ETH unstake request

POST

https://your-protect-instance.example.com/api/rest/v1/requests/staking/eth_unstake

POST

/api/rest/v1/requests/staking/eth_unstake

curl -X POST https://your-protect-instance.example.com/api/rest/v1/requests/staking/eth_unstake \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "fromAddressId": "string",
  "amount": "string"
}'

{
  "result": {
    "id": "442",
    "tenantId": "1",
    "currency": "BTC",
    "envelope": "CgM0NDIQmfGjk6Ops/oVGAEqmgUSrAEKPwoPbS80NCcvMCcvMCcvMC8wGiAeyruP7CoNYcGISzRo8iZmuVnV6M9gLiZuShy7aDtKKiABKNHEFDD/////DxIoCiIxQ3Zoeml0ZFZMUGhOVGZ3NU5rUm9YWHZveldacGZhWXQ2EJ/nBRoVCg9tLzQ0Jy8wJy8wJy8wLzAYsbcOMig0NDI6NDY5ZTMxOGUtYjcxZC00MGUwLTg0ZjctNzVlOGQwOWE3Yzg2IhMKCnJlcXVlc3RfaWQQARoDNDQyIhIKCXJ1bGVzX2tleRABGgNCVEMiEQoIY3VycmVuY3kQARoDQlRDIlsKBnNvdXJjZRAEGkcIARJDCAESIjFKTUJZTU1pOWlqSlJlVFlxdEZUU2RlVkJ6azhOSGRzVHUaCm5vc3RybyBCVEMiD20vNDQnLzAnLzAnLzAvMCIGc291cmNlImIKC2Rlc3RpbmF0aW9uEAUaRBJCCMwBEiIxQ3Zoeml0ZFZMUGhOVGZ3NU5rUm9YWHZveldacGZhWXQ2GghteSBsYWJlbCIPbS80NCcvMCcvMCcvMC84IgtkZXN0aW5hdGlvbiKeAQoGYW1vdW50EAoaiQEKAwGGoBIHMTAuMDQzMBoKMTAwNDIuOTcwMCAIKgNCVEMyA0NIRjphCh12YWxpZGF0b3ItY29yZUB0YXVydXNncm91cC5jaBJAffe4nBGVSajYYQxxzEZbQuj0snr8WOC1P506eXRn2EUsDrAnkWvNW9wfU+pwUoBVUaXl/veYW/6m/DJsEKijLCIGYW1vdW50Ih4KEXRvdGFsX2ZpYXRfYW1vdW50EAEaBzEwLjA0MzAiCwoDZmVlEAIaAhMBIh4KFGZlZV9wYWlkX2J5X3JlY2VpdmVyEAEaBHRydWU=",
    "status": "CREATED",
    "trails": [
      {
        "userId": "11",
        "externalUserId": "team1@bank.com",
        "action": "created",
        "comment": "Ich bin eine flying Roasted Butternut Squash Boodles",
        "requestStatus": "CREATED"
      },
      {
        "userId": "1",
        "externalUserId": "validator-core@taurusgroup.ch",
        "action": "approvers_assigned",
        "comment": "rule = [source: any, destination: any, amount: 10.0000], approvals = ['team1': 1 sig, 'team2': 1 sig]",
        "requestStatus": "CREATED"
      }
    ],
    "rule": "rule = [source: any, destination: any, amount: 10.0000], approvals = ['team1': 1 sig, 'team2': 1 sig]",
    "approvers": {
      "parallel": [
        {
          "sequential": [
            {
              "externalGroupID": "team1",
              "minimumSignatures": 1
            },
            {
              "externalGroupID": "team2",
              "minimumSignatures": 1
            }
          ]
        }
      ]
    }
  }
}

This endpoint will create an ETH unstake request

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

fromAddressIdstringRequiredformat: "uint64"

the ID of the address to unstake

amountstringRequired

Amount to unstake in wei. For EIP-7002 withdrawals, must be a multiple of 1 Gwei (1e9 wei). For legacy withdrawals, must be a multiple of 32 ETH (32e18 wei). In both cases leave empty or set to 0 to withdraw the full balance and trigger a full validator exit

ethValidatorIDslist of stringsOptional

List of ETH validator internal IDs to unstake. For legacy withdrawals, optional — multiple validators can be specified. For EIP-7002 withdrawals, exactly one validator ID must be provided.

commentstringOptional

A reconciliation notes can be given when initiating a request and this will be included in transaction history.

externalRequestIdstringOptional

Identifier for the request in the user's system. This must be unique.

gasLimitstringOptional

A target gas limit for the request. If not provided, one will be automatically computed. Only applies to 'EIP7002' unstake method.

gasPriceLimitstringOptional

A hard limit for the gas price for the request. If not provided, one will be automatically computed. Only applies to 'EIP7002' unstake method.

contractFeeLimitstringOptional

Max fee in wei paid to the EIP-7002 withdrawal contract's dynamic anti-spam mechanism. Leave empty to use the default fee, which is sufficient in almost all cases. Only increase if a withdrawal is stuck due to contract congestion and must execute urgently. Ignored for legacy withdrawals.

unstakeMethodstringOptional

Withdrawal method to use. 'EIP7002' uses the Pectra on-chain withdrawal contract triggered from the execution layer and is the recommended method. 'LEGACY' uses pre-Pectra signed exit messages and is deprecated. Defaults to LEGACY if not specified.

Response

A successful response.

resultobjectOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

503

Service Unavailable Error