liquidstaking

Burn

Execute a burn transaction that permanently removes a specified amount of osETH tokens from circulation. This operation adjusts the circulating supply in accordance with the protocol’s tokenomics and can affect the overall staking balance.

💡 Compute Unit Value: 20 (Fixed)

post/defi/v1/liquidstaking/burn

Request

Base URL
https://svc.blockdaemon.com
URL
https://svc.blockdaemon.com/defi/v1/liquidstaking/burn
Auth
API key in header X-API-Key

Request body

liquidStakingId'200' | '201'

The unique ID to specify the liquid staking protocol for routing staking-related queries or transactions.

fromstring required

Blockchain address of the sender. For EVM chains, use a checksummed hex address (e.g., 0xABCDEF...). This address must hold sufficient balance and will sign the transaction.

amountstring required

Number of tokens, specified in the token's smallest denomination (base units). Do not send human-readable decimal values. Examples: 1 WETH (18 decimals) = "1000000000000000000"; 1 USDC (6 decimals) = "1000000".

gasstring

Maximum number of gas units to allocate for the transaction, as an integer string (e.g., '200000'). If omitted, gas is estimated automatically. Note: this is gas units, not wei or gwei.

gasPrioritystring

Specifies the priority level for gas fees (e.g., 'low', 'medium', or 'high'), which influences the transaction speed and cost.

enableFeeboolean

Flag to include a basis points fee transaction alongside the main transaction when set to true.

Example request

{
  "liquidStakingId": "200",
  "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "amount": "1000000000000000000",
  "gas": "100000",
  "gasPriority": "low",
  "enableFee": false
}

Response

Successful response

statusinteger

msgstring

dataobject

Example response

{
  "status": 200,
  "msg": "success",
  "data": {
    "chainId": "1",
    "from": "0x02Fd5aBb1f77841827Bfb7cB19608Ec6488BEd08",
    "to": "0xe6d8d8aC54461b1C5eD15740EEe322043F696C08",
    "value": "0",
    "gas": "12212",
    "data": "0x066055e00000000000000000000000000000000000000000000000000000000000000142",
    "referenceId": "a3ff2853fb204693bcba1d1a478e9164"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.