Create a Vault

const curator = client.vaults.curator;

// Snapshot the vaults you already curate, to diff against below.
const before = new Set((await curator.getCuratedVaults()).subaccount_ids);

await curator.createVault({
  subaccountId: 1234, // funding subaccount — the seed deposit leaves here
  managerId: 1,
  depositSpotAsset: '0x…', // your environment's USDC spot-asset address
  initialDeposit: '15000',
  initialSharePriceUsd: '1',
  managementFeeBps: 100, // 1% p.a.
  performanceFeeBps: 1000, // 10% of gains above the high-water mark (the global cap)
  maxSlippageBps: 50,
  cooldownSec: 86400, // 24h between a holder's deposit and their withdrawal
  maxFeeUsd: '1000', // must cover the deployment-set creation fee
  // benchmarkAsset: '0x…', // optional: denominate the HWM in a spot asset
});

let vaultId: number | undefined;
while (vaultId === undefined) {
  await new Promise((resolve) => setTimeout(resolve, 500));
  const { subaccount_ids } = await curator.getCuratedVaults();
  vaultId = subaccount_ids.find((id) => !before.has(id));
}

# Coming soon.

// Coming soon.

# Body nonce/signature: EIP-712 action signing (see /action-signing).
# X-Derive* headers: session auth (see /json-rpc).
curl -X POST https://api.derive.xyz/v3/private/create_vault \
  -H "Content-Type: application/json" \
  -H "X-DeriveWallet: $WALLET_ADDRESS" \
  -H "X-DeriveTimestamp: $TS" \
  -H "X-DeriveSignature: $SIG" \
  -d '{
    "subaccount_id": 1234,
    "nonce": "1751558400000123000",
    "signature_expiry_sec": 1751558700,
    "signer": "0xCURATOR…",
    "signature": "0x…",
    "manager_id": 1,
    "deposit_spot_asset": "0xUSDC…",
    "initial_deposit": "15000",
    "initial_share_price_usd": "1",
    "management_fee_bps": 100,
    "performance_fee_bps": 1000,
    "max_slippage_bps": 50,
    "cooldown_sec": 86400,
    "benchmark_asset": null,
    "max_fee_usd": "1000"
  }'

# Then resolve the new vault's subaccount id once the op lands:
curl -X POST https://api.derive.xyz/v3/private/get_curated_vaults \
  -H "Content-Type: application/json" \
  -H "X-DeriveWallet: $WALLET_ADDRESS" \
  -H "X-DeriveTimestamp: $TS" \
  -H "X-DeriveSignature: $SIG" \
  -d '{ "wallet": "0xCURATOR…" }'

const vault = await client.vaults.getVault(vaultId);

console.log(vault.protocol.config); // the immutable economics you set above
// nav_usd / simulated_share_price_usd are null when the vault cannot be
// priced right now, so never assume they are set.
console.log(
  `NAV $${vault.nav_usd ?? '?'}, share price $${
    vault.simulated_share_price_usd ?? '?'
  }`
);

# Coming soon.

// Coming soon.

curl -X POST https://api.derive.xyz/v3/public/get_vault \
  -H "Content-Type: application/json" \
  -d '{ "subaccount_id": 42 }'

await client.vaults.curator.updateInfo({
  vaultSubaccountId: vaultId,
  name: 'Delta-Neutral ETH',
  description: 'Short vol, delta-hedged hourly.',
  mtmCap: '1000000', // advisory NAV soft-cap in USD — a signal to shareholders
  whitelistOnly: false, // restrict who may deposit
});

# Coming soon.

// Coming soon.

# Unsigned (ownership-checked); X-Derive* headers: session auth (see /json-rpc).
curl -X POST https://api.derive.xyz/v3/private/update_vault_info \
  -H "Content-Type: application/json" \
  -H "X-DeriveWallet: $WALLET_ADDRESS" \
  -H "X-DeriveTimestamp: $TS" \
  -H "X-DeriveSignature: $SIG" \
  -d '{
    "subaccount_id": 42,
    "name": "Delta-Neutral ETH",
    "description": "Short vol, delta-hedged hourly.",
    "mtm_cap": "1000000",
    "whitelist_only": false
  }'