MicroVault quickstart

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

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

Find the provisionings entry whose id matches task.id. Save its chainId, customerId, and customerVaultNonce. Match the active item by the same chainId and customerVaultNonce, with onchainCustomerId equal to that provisioning customerId. Verify the vault address against the confirmed creation receipt. If provisioning completes before you capture its entry, use the creation transaction’s confirmed vault address to identify the item. Follow nextCursor when the matching vault is on a later page; do not select by share name alone. Once active, save id as VAULT_ID for Ground API paths and address for the onchain vault and ERC-20 share token. If the provisioning entry reports failed, retain its task ID and error before starting another creation attempt.

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.

Getting Started

Vault Lifecycle

Operations

Resources

API Reference

MicroVault quickstart

Prerequisites

1. Check creation readiness

2. Create a vault

3. Wait for the vault

4. Inspect performance and positions

Confirm the quickstart

​Prerequisites

​1. Check creation readiness

​2. Create a vault

​3. Wait for the vault

​4. Inspect performance and positions

​Confirm the quickstart

Prerequisites

1. Check creation readiness

2. Create a vault

3. Wait for the vault

4. Inspect performance and positions

Confirm the quickstart