MicroVault quickstart - Ground

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 its id; it identifies this operation while the vault is being provisioned.

3. Wait for the vault

until VAULT_ID=$(curl -sS "$GROUND_API/v2/microvaults/vaults" -H "$AUTH" \
  | jq -r '.items[] | select(.shareName == "Acme Treasury MicroVault") | .id' | head -1) \
  && test -n "$VAULT_ID"; do sleep 3; done
echo "$VAULT_ID"

While deployment is in progress, the list response includes it in provisionings. Once active, the new item contains two identifiers: id is used in Ground API paths, while address is the onchain vault and ERC-20 share-token address.

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.