> ## Documentation Index
> Fetch the complete documentation index at: https://docs.groundtech.co/llms.txt
> Use this file to discover all available pages before exploring further.

# MicroVault quickstart

> Create and inspect a sandbox MicroVault.

<Note>MicroVaults are available to enabled sandbox organizations on Ethereum Sepolia.</Note>

## Prerequisites

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

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export GROUND_API="https://sandbox.groundtech.co"
export GROUND_API_KEY="..."
export AUTH="Authorization: Bearer $GROUND_API_KEY"
```

## 1. Check creation readiness

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
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](/docs/microvaults/shareholders), [strategy configuration](/docs/microvaults/strategy), and [subscription](/docs/microvaults/subscribe).