Vault Curators

private/burn_vault_shares

Curator-only endpoint that settles a pending withdraw request by signing a burn approval at a quoted share price (USD per share). Takes the request id and the user's withdraw-action hash, burns the shares, and returns the settlement result. Requires the curator mint-and-burn permission.

post/private/burn_vault_shares

Request

  • Base URL: https://api.derive.xyz/v3
  • URL: https://api.derive.xyz/v3/private/burn_vault_shares
  • Auth: none declared

Request body

noncestring required
share_pricestring decimal required

Quoted share price in USD per share, as a decimal string (e.g. "1").

signaturestring required

0x-prefixed hex of the 65-byte EOA signature.

signature_expiry_secinteger required
signerstring required

20-byte Ethereum address as a 0x-prefixed lowercase hex string.

subaccount_idinteger required

The subaccount the action is signed on; which subaccount applies depends on the specific method — see that method's reference.

withdraw_hashstring required

0x-prefixed hex of the 32-byte user withdraw-action hash.

Response

Success

op_uuidstring required
operation_idinteger required

Changes

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