MicroVault quickstart

Create and inspect a sandbox MicroVault.

MicroVaults are available to enabled sandbox organizations on Ethereum Sepolia.

​

Prerequisites

• A sandbox organization with MicroVaults enabled
• A Ground sandbox API key
• curl, jq, and uuidgen

export GROUND_API="https://sandbox.groundtech.co"
export GROUND_API_KEY="..."
export AUTH="Authorization: Bearer $GROUND_API_KEY"

​

1. Check creation readiness

curl -sS "$GROUND_API/v2/microvaults/vaults" -H "$AUTH" | jq '.creation'

Continue when creation.status is accepted. Ground completes account setup before enabling MicroVaults for your organization.

​

2. Create a vault

curl -sS -X POST "$GROUND_API/v2/microvaults/vaults" \
  -H "$AUTH" -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "baseAsset":"0x1c7d4b196cb0c7b01d743fbc6116a902379c7238",
    "name":"Acme Treasury MicroVault",
    "symbol":"acmeUSDC",
    "feeRecipient":"0x76f8fc6667e239f83a547d4e16225d6a34f6fa22",
    "managementFeeBps":0,
    "performanceFeeBps":0
  }' | jq

The response is a creation task. Keep task.id; it identifies this operation while the vault is being provisioned.

​

3. Wait for the vault

Follow Track provisioning to match the saved task to the created vault and verify its address against the creation receipt. Save the active vault’s id as VAULT_ID for the following requests.

​

4. Inspect performance and positions

curl -sS "$GROUND_API/v2/microvaults/vaults/$VAULT_ID" -H "$AUTH" | jq
curl -sS "$GROUND_API/v2/microvaults/vaults/$VAULT_ID/sources" -H "$AUTH" | jq
curl -sS "$GROUND_API/v2/microvaults/vaults/$VAULT_ID/activity" -H "$AUTH" | jq

​

Confirm the quickstart

The vault is ready when it appears in items with status: "active". Continue with shareholder access, strategy configuration, and subscription.