{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ground","description":"Ground developer documentation for Portfolio Wallets, gtokens, MicroVaults, and webhooks.","colors":{"primary":"#0F172A","light":"#334155","dark":"#0F172A"},"logo":{"light":"https://mintcdn.com/braid-4d08f2b7/T2beshx6Z6tR-K1c/docs/assets/ground-logo-mark-white-on-black.svg?fit=max\u0026auto=format\u0026n=T2beshx6Z6tR-K1c\u0026q=85\u0026s=2b62d5630a4091f5e3fa3291cf94e7cc","dark":"https://mintcdn.com/braid-4d08f2b7/T2beshx6Z6tR-K1c/docs/assets/ground-logo-mark-white-on-black.svg?fit=max\u0026auto=format\u0026n=T2beshx6Z6tR-K1c\u0026q=85\u0026s=2b62d5630a4091f5e3fa3291cf94e7cc","href":"https://groundtech.co"},"favicon":{"light":"https://mintcdn.com/braid-4d08f2b7/T2beshx6Z6tR-K1c/docs/assets/favicon.svg?fit=max\u0026auto=format\u0026n=T2beshx6Z6tR-K1c\u0026q=85\u0026s=b4171decaf67f0eb8c4959bbf7e273bc","dark":"https://mintcdn.com/braid-4d08f2b7/T2beshx6Z6tR-K1c/docs/assets/favicon.svg?fit=max\u0026auto=format\u0026n=T2beshx6Z6tR-K1c\u0026q=85\u0026s=b4171decaf67f0eb8c4959bbf7e273bc"},"api":{"playground":{"proxy":true}},"footer":{"links":[{"header":"Docs","items":[{"label":"Introduction","href":"/docs/introduction"},{"label":"Quickstart","href":"/docs/portfolio-wallets/quickstart"},{"label":"API Conventions","href":"/docs/portfolio-wallets/api-conventions"},{"label":"Portfolio Wallets","href":"/docs/portfolio-wallets/create-wallet"},{"label":"MicroVaults","href":"/docs/microvaults/introduction"}]},{"header":"Reference","items":[{"label":"Portfolio Wallet API","href":"/api-reference/list-portfolio-wallet-yield-sources"},{"label":"gtoken API","href":"/api-reference/list-gtoken-yield-sources"},{"label":"MicroVault API","href":"/api-reference/list-microvaults"}]}]},"fonts":{"heading":{"family":"Inter","weight":600},"body":{"family":"Inter","weight":400}},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":true},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"interaction":{"drilldown":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"braid-4d08f2b7","hasAudioNarration":false,"actualSubdomain":"braid-4d08f2b7","customDomains":["docs.groundtech.co"],"gitSource":{"type":"github","owner":"ground-technology","repo":"ground-monorepo","deployBranch":"mintlify-deployment","contentDirectory":"apps/api/mintlify","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae093912ea1296893ea475d","collectionId":"4bf83740-bbc8-4929-b645-69361c59b906","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae093912ea1296893ea475d"},"entitlements":{},"buildId":"6ae093912ea1296893ea475d","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"Portfolio Wallets","count":60},{"language":"default","tag":"MicroVaults","count":36},{"language":"default","tag":"gtokens","count":33},{"language":"default","tag":"Getting Started","count":15},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"Vaults and Sources","count":10},{"language":"default","tag":"Wallet Lifecycle","count":9},{"language":"default","tag":"Wallets","count":8},{"language":"default","tag":"Integration Guides","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"#navigation-items .nav-anchor[href^=\"/docs/introduction#\"]{margin-left:2rem;margin-bottom:.5rem;font-weight:400}#navigation-items .nav-anchor[href^=\"/docs/introduction#\"]>div{display:none}#navigation-items:has(.nav-anchor[href^=\"/docs/introduction#\"]){display:flex;flex-direction:column}#navigation-items:has(.nav-anchor[href^=\"/docs/introduction#\"])>ul{order:1}#navigation-items:has(.nav-anchor[href^=\"/docs/introduction#\"])>div:has(a[href=\"/docs/introduction\"]){order:0;margin-top:0;margin-bottom:.5rem}"}],"page":{"pagePath":"api-reference/create-microvault","slug":"/api-reference/create-microvault","pageMetadata":{"title":"Create a MicroVault","openapi":"swagger/swagger-combined.yaml POST /v2/microvaults/vaults","description":"Deploys a MicroVault and ERC-20 share token with the selected base asset, token metadata, and fee policy. Returns a task while provisioning.","href":"/api-reference/create-microvault"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Deploys a MicroVault and ERC-20 share token with the selected base asset, token metadata, and fee policy. Returns a task while provisioning.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsx(_components.p,{children:`Create a vault and its ERC-20 share token. The response contains a task that tracks deployment.`})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Create a MicroVault","openapi":"swagger/swagger-combined.yaml POST /v2/microvaults/vaults","description":"Deploys a MicroVault and ERC-20 share token with the selected base asset, token metadata, and fee policy. Returns a task while provisioning.","href":"/api-reference/create-microvault"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["MicroVaults"],"operationId":"createMicrovault","summary":"Create a MicroVault","description":"Deploys a MicroVault and ERC-20 share token with the selected base asset, token metadata, and fee policy. Returns a task while provisioning.","parameters":["74ef560b-96ac-4da0-bd32-8c69b5603185"],"requestBody":"b1ab1468-576b-458b-83c4-94101ff9fe1f","responses":{"202":"99a80b40-2f68-4929-ae32-884f0d6d7b97","400":"646678ed-9cd2-4a11-9876-59c8eb6a7abf","401":"6d79fe14-22f9-44ba-951a-6c7e03028dcd","409":"cbc218fa-a03d-40f5-85e9-7c38b09d6bd6"},"method":"post","type":"path","servers":["4c1e0bd9-0228-4e96-b858-9f5ad19f1386","eab9aa06-a1ca-4f31-a8ca-cbf3e6fb205f"],"security":["5da4b017-3eca-46bb-b879-e68ce4273d94"],"path":"/v2/microvaults/vaults","baseUrlOptions":["https://sandbox.groundtech.co","https://production.groundtech.co"],"title":"Create a MicroVault","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"74ef560b-96ac-4da0-bd32-8c69b5603185":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"isRequired":true,"description":"Unique key for this intended change. Reuse it only when retrying the identical request.","uniqueKey":"","typeLabel":"string"},"description":"Unique key for this intended change. Reuse it only when retrying the identical request."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["baseAsset","name","symbol","feeRecipient","managementFeeBps","performanceFeeBps"],"properties":{"baseAsset":{"type":"string","description":"Token accepted for subscriptions and paid out on redemptions. Use the base-asset address from an available yield source on the vault's chain.","maxLength":42,"minLength":42,"pattern":"^0x(?!0{40}$)[0-9a-fA-F]{40}$","example":"0x3bf25a73a1f1033c2d50ac65f3c9d6a44123db81","isRequired":true,"uniqueKey":"baseAsset","typeLabel":"string"},"name":{"type":"string","minLength":1,"maxLength":64,"description":"Full ERC-20 share-token name shown in wallets and block explorers.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"symbol":{"type":"string","minLength":1,"maxLength":16,"description":"Short ERC-20 ticker for the MicroVault shares, such as `acmeUSDC`.","isRequired":true,"uniqueKey":"symbol","typeLabel":"string"},"feeRecipient":{"type":"string","description":"Wallet or contract that receives newly minted shares when management or performance fees accrue.","maxLength":42,"minLength":42,"pattern":"^0x(?!0{40}$)[0-9a-fA-F]{40}$","example":"0x3bf25a73a1f1033c2d50ac65f3c9d6a44123db81","isRequired":true,"uniqueKey":"feeRecipient","typeLabel":"string"},"managementFeeBps":{"type":"integer","minimum":0,"maximum":9999,"description":"Annual management fee in basis points. `100` means 1%; use `0` for no management fee.","isRequired":true,"uniqueKey":"managementFeeBps","typeLabel":"integer"},"performanceFeeBps":{"type":"integer","minimum":0,"maximum":9999,"description":"Fee on gains above the vault's high-water NAV in basis points. `1000` means 10%; use `0` for no performance fee.","isRequired":true,"uniqueKey":"performanceFeeBps","typeLabel":"integer"}},"example":{"baseAsset":"0x1c7d4b196cb0c7b01d743fbc6116a902379c7238","name":"Acme Treasury MicroVault","symbol":"acmeUSDC","feeRecipient":"0x76f8fc6667e239f83a547d4e16225d6a34f6fa22","managementFeeBps":0,"performanceFeeBps":0},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"baseAsset":"0x1c7d4b196cb0c7b01d743fbc6116a902379c7238","name":"Acme Treasury MicroVault","symbol":"acmeUSDC","feeRecipient":"0x76f8fc6667e239f83a547d4e16225d6a34f6fa22","managementFeeBps":0,"performanceFeeBps":0}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"99a80b40-2f68-4929-ae32-884f0d6d7b97":{"description":"The operation was accepted.","content":{"application/json":{"schema":{"type":"object","required":["task"],"properties":{"task":{"type":"object","description":"Asynchronous change accepted for submission and onchain confirmation.","required":["id","kind","status","vaultId","txHashes","error","createdAt","updatedAt"],"example":{"id":"924c9b2d-3a9c-4b1a-b470-c73fc9b97c06","kind":"update_strategy","status":"submitted","vaultId":"d9902b20-6499-4465-a4c3-5d2208182f79","txHashes":["0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"],"error":null,"createdAt":"2026-09-10T18:42:10.000Z","updatedAt":"2026-09-10T18:42:12.000Z"},"properties":{"id":{"type":"string","description":"Identifier for tracking this requested MicroVault change.","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","example":"8f4c52d7-62ab-4db9-a964-92f481f6b851","isRequired":true,"uniqueKey":"task.id","typeLabel":"string\u003cuuid>"},"kind":{"type":"string","enum":["provision_vault","update_strategy","update_source_mode","update_fees","update_pause","add_shareholder","remove_shareholder","rebalance"],"description":"Change being performed by this public API task.","isRequired":true,"uniqueKey":"task.kind","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["queued","submitting","submitted","confirmed","failed"],"description":"Current submission and onchain-confirmation state of the change.","isRequired":true,"uniqueKey":"task.status","typeLabel":"enum\u003cstring>"},"vaultId":{"oneOf":[{"type":"string","description":"Ground MicroVault identifier affected by the task, or `null` until a new vault record exists.","format":"uuid","pattern":"^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-4[0-9a-fA-F]{3}-[89aAbB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$","example":"8f4c52d7-62ab-4db9-a964-92f481f6b851","isRequired":true,"uniqueKey":"task.vaultId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","isRequired":true,"uniqueKey":"task.vaultId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"task.vaultId","typeLabel":"string\u003cuuid> | null"},"txHashes":{"type":"array","items":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$","uniqueKey":"task.txHashes.items.[INDEX]","typeLabel":"string"},"description":"Onchain transaction hashes submitted for this task.","isRequired":true,"uniqueKey":"task.txHashes","typeLabel":"string[]"},"error":{"oneOf":[{"type":"string","description":"Failure reason when `status` is `failed`; otherwise `null`.","isRequired":true,"uniqueKey":"task.error.oneOf.0","typeLabel":"string"},{"type":"null","description":"Failure reason when `status` is `failed`; otherwise `null`.","isRequired":true,"uniqueKey":"task.error.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"task.error","typeLabel":"string | null"},"createdAt":{"type":"string","format":"date-time","description":"Time when Ground accepted the change.","isRequired":true,"uniqueKey":"task.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","description":"Time when the task status last changed.","isRequired":true,"uniqueKey":"task.updatedAt","typeLabel":"string\u003cdate-time>"}},"additionalProperties":false,"isRequired":true,"uniqueKey":"task","typeLabel":"object"}},"example":{"task":{"id":"924c9b2d-3a9c-4b1a-b470-c73fc9b97c06","kind":"update_strategy","status":"submitted","vaultId":"d9902b20-6499-4465-a4c3-5d2208182f79","txHashes":["0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"],"error":null,"createdAt":"2026-09-10T18:42:10.000Z","updatedAt":"2026-09-10T18:42:12.000Z"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"task":{"id":"924c9b2d-3a9c-4b1a-b470-c73fc9b97c06","kind":"update_strategy","status":"submitted","vaultId":"d9902b20-6499-4465-a4c3-5d2208182f79","txHashes":["0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"],"error":null,"createdAt":"2026-09-10T18:42:10.000Z","updatedAt":"2026-09-10T18:42:12.000Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"646678ed-9cd2-4a11-9876-59c8eb6a7abf":{"description":"Invalid request.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"invalid_request","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"oneOf":[{"type":"string","example":"allocation targets and idleTargetBps must total 10000","description":"Human-readable explanation of why the request failed, when available.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","example":"allocation targets and idleTargetBps must total 10000","description":"Human-readable explanation of why the request failed, when available.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"},"details":{"oneOf":[{"description":"Structured context for the error, when available.","uniqueKey":"details.oneOf.0","typeLabel":"any"},{"description":"Structured context for the error, when available.","type":"null","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"any | null"}},"example":{"error":"invalid_request","message":"allocation targets and idleTargetBps must total 10000"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid_request","message":"allocation targets and idleTargetBps must total 10000"}}},"exampleType":"generated"}},"exampleType":"generated"},"6d79fe14-22f9-44ba-951a-6c7e03028dcd":{"description":"The request is missing a valid bearer token, or the token is invalid or expired.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Authentication or authorization error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"oneOf":[{"type":"string","description":"Additional auth middleware detail, when present.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","description":"Additional auth middleware detail, when present.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"},"code":{"oneOf":[{"type":"string","enum":["unauthenticated","forbidden"],"description":"Some auth and scope failures include a stable code; middleware errors may omit it.","uniqueKey":"code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["unauthenticated","forbidden"],"description":"Some auth and scope failures include a stable code; middleware errors may omit it.","uniqueKey":"code.oneOf.1","typeLabel":"null"}],"uniqueKey":"code","typeLabel":"enum\u003cstring> | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Unauthenticated request","message":"Missing or invalid bearer token"},"examples":{"Example":{"title":"Example","value":{"error":"Unauthenticated request","message":"Missing or invalid bearer token"}}},"exampleType":"examples"}},"exampleType":"examples"},"cbc218fa-a03d-40f5-85e9-7c38b09d6bd6":{"description":"Conflicting request.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"invalid_request","description":"Stable machine-readable error code.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"message":{"oneOf":[{"type":"string","example":"allocation targets and idleTargetBps must total 10000","description":"Human-readable explanation of why the request failed, when available.","uniqueKey":"message.oneOf.0","typeLabel":"string"},{"type":"null","example":"allocation targets and idleTargetBps must total 10000","description":"Human-readable explanation of why the request failed, when available.","uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"},"details":{"oneOf":[{"description":"Structured context for the error, when available.","uniqueKey":"details.oneOf.0","typeLabel":"any"},{"description":"Structured context for the error, when available.","type":"null","uniqueKey":"details.oneOf.1","typeLabel":"null"}],"uniqueKey":"details","typeLabel":"any | null"}},"example":{"error":"invalid_request","message":"allocation targets and idleTargetBps must total 10000"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid_request","message":"allocation targets and idleTargetBps must total 10000"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"5da4b017-3eca-46bb-b879-e68ce4273d94":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"4c1e0bd9-0228-4e96-b858-9f5ad19f1386":{"url":"https://sandbox.groundtech.co"},"eab9aa06-a1ca-4f31-a8ca-cbf3e6fb205f":{"url":"https://production.groundtech.co"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"swagger/swagger-combined.yaml"},"subdomain":"braid-4d08f2b7","siteName":"Ground","title":"Create a MicroVault - Ground","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-14T16:02:06.366Z","originalFileLocation":"api-reference/create-microvault.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Deploys a MicroVault and ERC-20 share token with the selected base asset, token metadata, and fee policy. Returns a task while provisioning.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ground\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a MicroVault - Ground\">\u003cmeta data-mint-head property=\"og:description\" content=\"Deploys a MicroVault and ERC-20 share token with the selected base asset, token metadata, and fee policy. Returns a task while provisioning.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ground\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.groundtech.co/api-reference/create-microvault\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://braid-4d08f2b7.mintlify.app/_mintlify/api/og/v2?division=Vaults+and+Sources\u0026amp;title=Create+a+MicroVault\u0026amp;description=Deploys+a+MicroVault+and+ERC-20+share+token+with+the+selected+base+asset%2C+token+metadata%2C+and+fee+policy.+Returns+a+task+while+provisioning.\u0026amp;theme=a63f7a1c49707387ffb29914\u0026amp;signature=c46d6ca750e8e85996d903124fd117f62cbb196256d6e6d8b619cfa2159b3a08\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a MicroVault - Ground\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Deploys a MicroVault and ERC-20 share token with the selected base asset, token metadata, and fee policy. Returns a task while provisioning.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://braid-4d08f2b7.mintlify.app/_mintlify/api/og/v2?division=Vaults+and+Sources\u0026amp;title=Create+a+MicroVault\u0026amp;description=Deploys+a+MicroVault+and+ERC-20+share+token+with+the+selected+base+asset%2C+token+metadata%2C+and+fee+policy.+Returns+a+task+while+provisioning.\u0026amp;theme=a63f7a1c49707387ffb29914\u0026amp;signature=c46d6ca750e8e85996d903124fd117f62cbb196256d6e6d8b619cfa2159b3a08\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/braid-4d08f2b7/aZx8N-g1imgxwXxV/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ground\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F172A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.groundtech.co/api-reference/create-microvault\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/create-microvault.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.groundtech.co/#organization\",\"name\":\"Ground\",\"url\":\"https://docs.groundtech.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/braid-4d08f2b7/T2beshx6Z6tR-K1c/docs/assets/ground-logo-mark-white-on-black.svg?fit=max\u0026auto=format\u0026n=T2beshx6Z6tR-K1c\u0026q=85\u0026s=2b62d5630a4091f5e3fa3291cf94e7cc\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.groundtech.co#website\",\"name\":\"Ground\",\"url\":\"https://docs.groundtech.co\",\"publisher\":{\"@id\":\"https://docs.groundtech.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.groundtech.co/api-reference/create-microvault#webpage\",\"url\":\"https://docs.groundtech.co/api-reference/create-microvault\",\"name\":\"Create a MicroVault\",\"description\":\"Deploys a MicroVault and ERC-20 share token with the selected base asset, token metadata, and fee policy. Returns a task while provisioning.\",\"dateModified\":\"2026-09-14T16:02:06.366Z\",\"isPartOf\":{\"@id\":\"https://docs.groundtech.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.groundtech.co/api-reference/create-microvault#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.groundtech.co/api-reference/create-microvault#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.groundtech.co/api-reference/list-microvaults\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Vaults and Sources\",\"item\":\"https://docs.groundtech.co/api-reference/list-microvaults\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a MicroVault\",\"item\":\"https://docs.groundtech.co/api-reference/create-microvault\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.groundtech.co/api-reference/create-microvault#apireference\",\"headline\":\"Create a MicroVault\",\"name\":\"Create a MicroVault\",\"description\":\"Deploys a MicroVault and ERC-20 share token with the selected base asset, token metadata, and fee policy. Returns a task while provisioning.\",\"url\":\"https://docs.groundtech.co/api-reference/create-microvault\",\"mainEntityOfPage\":{\"@id\":\"https://docs.groundtech.co/api-reference/create-microvault#webpage\"},\"dateModified\":\"2026-09-14T16:02:06.366Z\",\"publisher\":{\"@id\":\"https://docs.groundtech.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.groundtech.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ground\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ground","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/docs/introduction"}]},{"tab":"Portfolio Wallets","pages":[{"title":"Portfolio Wallets","href":"/docs/portfolio-wallets/introduction"}]},{"tab":"gtokens","pages":[{"title":"gtokens","href":"/docs/gtokens/introduction"}]},{"tab":"MicroVaults","groups":[{"group":"Getting Started","pages":[{"title":"MicroVaults","href":"/docs/microvaults/introduction"},{"title":"MicroVault quickstart","href":"/docs/microvaults/quickstart"},{"title":"Concepts and control model","href":"/docs/microvaults/concepts"},{"title":"Supported chains and yield sources","href":"/docs/microvaults/supported-chains-and-sources"}]},{"group":"Vault Lifecycle","pages":[{"title":"Create a MicroVault","href":"/docs/microvaults/create-vault"},{"title":"Manage shareholders","href":"/docs/microvaults/shareholders"},{"title":"Configure strategy and source modes","href":"/docs/microvaults/strategy"},{"title":"Configure fees","href":"/docs/microvaults/fees"},{"title":"Subscribe from an external wallet","href":"/docs/microvaults/subscribe"},{"title":"Redeem MicroVault shares","href":"/docs/microvaults/redeem"},{"title":"Export vault authority","href":"/docs/microvaults/export-authority"}]},{"group":"Operations","pages":[{"title":"Use emergency controls","href":"/docs/microvaults/emergency-controls"},{"title":"Synchronous and asynchronous operations","href":"/docs/microvaults/async-operations"},{"title":"Statuses, activity, and performance","href":"/docs/microvaults/status-and-performance"},{"title":"Sandbox testing","href":"/docs/microvaults/sandbox-testing"}]},{"group":"Resources","pages":[{"title":"MicroVault contracts","href":"/docs/microvaults/contracts"},{"title":"Security and trust model","href":"/docs/microvaults/security"}]},{"group":"API Reference","pages":[{"group":"Vaults and Sources","pages":[{"title":"List MicroVaults","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults","description":"Returns active MicroVaults and creations still provisioning. Use each active vault's `id` in API paths and its `address` for onchain share-token interactions.","href":"/api-reference/list-microvaults"},{"title":"Create a MicroVault","openapi":"swagger/swagger-combined.yaml POST /v2/microvaults/vaults","href":"/api-reference/create-microvault"},{"title":"Get a MicroVault","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}","description":"Returns the vault's identity, share-token metadata, current state, asset balances, and latest NAV observation.","href":"/api-reference/get-microvault"},{"title":"List MicroVault yield sources","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/yield-sources","href":"/api-reference/list-microvault-yield-sources"},{"title":"List MicroVault source positions","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/sources","href":"/api-reference/list-microvault-sources"},{"title":"Update MicroVault strategy","openapi":"swagger/swagger-combined.yaml PUT /v2/microvaults/vaults/{vaultId}/strategy","href":"/api-reference/update-microvault-strategy"},{"title":"Update MicroVault source mode","openapi":"swagger/swagger-combined.yaml PUT /v2/microvaults/vaults/{vaultId}/sources/{sourceId}/mode","href":"/api-reference/update-microvault-source-mode"},{"title":"Update MicroVault fees","openapi":"swagger/swagger-combined.yaml PUT /v2/microvaults/vaults/{vaultId}/fees","href":"/api-reference/update-microvault-fees"},{"title":"Update MicroVault pause controls","openapi":"swagger/swagger-combined.yaml PUT /v2/microvaults/vaults/{vaultId}/pause","href":"/api-reference/update-microvault-pause"},{"title":"Get MicroVault pause status","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/pause-status","href":"/api-reference/get-microvault-pause-status"}]},{"group":"Performance and Activity","pages":[{"title":"Get MicroVault performance summary","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/performance-summary","href":"/api-reference/get-microvault-performance-summary"},{"title":"Get MicroVault performance series","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/performance-series","href":"/api-reference/get-microvault-performance-series"},{"title":"List MicroVault activity","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/activity","href":"/api-reference/list-microvault-activity"}]},{"group":"Shareholders","pages":[{"title":"Get MicroVault shareholders","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/shareholders","href":"/api-reference/get-microvault-shareholders"},{"title":"Add a MicroVault shareholder","openapi":"swagger/swagger-combined.yaml PUT /v2/microvaults/vaults/{vaultId}/shareholders/{walletAddress}","href":"/api-reference/add-microvault-shareholder"},{"title":"Remove a MicroVault shareholder","openapi":"swagger/swagger-combined.yaml DELETE /v2/microvaults/vaults/{vaultId}/shareholders/{walletAddress}","href":"/api-reference/remove-microvault-shareholder"},{"title":"Get shareholder proof","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/shareholders/{walletAddress}/proof","href":"/api-reference/get-microvault-shareholder-proof"}]},{"group":"Redemptions","pages":[{"title":"Preview a MicroVault redemption","openapi":"swagger/swagger-combined.yaml POST /v2/microvaults/vaults/{vaultId}/redemptions/preview","href":"/api-reference/preview-microvault-redemption"},{"title":"Get a requested redemption","openapi":"swagger/swagger-combined.yaml GET /v2/microvaults/vaults/{vaultId}/redemptions/{requestId}","href":"/api-reference/get-microvault-redemption"}]}]}]}]},"title":"Create a MicroVault - Ground","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}