Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.
An oversized plan returns 400 tempo_beta_transfer_limit_exceeded.
Ground does not split or reduce the plan to fit.
Cash-to-cash movements are not supported.
Indicative quotes for stock conversions in the requested paths, in path order. Intermediate fees and later execution prices can change the result.
Show child attributes
{"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-assets"},{"label":"gtoken API","href":"/api-reference/list-gtoken-yield-sources"},{"label":"MicroVault API","href":"/api-reference/list-microvaults"}]}]},"seo":{"metatags":{"og:type":"website","og:site_name":"Ground","og:image":"https://docs.groundtech.co/docs/assets/og/og-default.png","og:image:width":"1200","og:image:height":"630","og:image:alt":"Ground developer documentation","twitter:card":"summary_large_image","twitter:site":"@ground_onchain","twitter:image":"https://docs.groundtech.co/docs/assets/og/og-default.png"},"paths":[{"path":"docs/portfolio-wallets","metatags":{"og:image":"https://docs.groundtech.co/docs/assets/og/og-portfolio-wallets.png","og:image:alt":"Ground Portfolio Wallets","twitter:image":"https://docs.groundtech.co/docs/assets/og/og-portfolio-wallets.png"}},{"path":"docs/gtokens","metatags":{"og:image":"https://docs.groundtech.co/docs/assets/og/og-gtokens.png","og:image:alt":"Ground gtokens","twitter:image":"https://docs.groundtech.co/docs/assets/og/og-gtokens.png"}},{"path":"docs/microvaults","metatags":{"og:image":"https://docs.groundtech.co/docs/assets/og/og-microvaults.png","og:image:alt":"Ground MicroVaults","twitter:image":"https://docs.groundtech.co/docs/assets/og/og-microvaults.png"}}]},"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":""},"entitlements":{},"buildId":"6af55d235cb7f3a63d47f112","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API Reference","count":70},{"language":"default","tag":"Portfolio Wallets","count":61},{"language":"default","tag":"MicroVaults","count":36},{"language":"default","tag":"gtokens","count":32},{"language":"default","tag":"Overview","count":18},{"language":"default","tag":"Getting Started","count":16},{"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}]},"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":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/preview-allocation","slug":"/api-reference/preview-allocation","pageMetadata":{"title":"Preview wallet allocation","openapi":"swagger/swagger-combined.yaml POST /v2/wallets/{id}/allocate-preview","description":"Checks movements between cash, yield, and stock positions. Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.","href":"/api-reference/preview-allocation"},"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: \"Checks movements between cash, yield, and stock positions. Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.\nAn oversized plan returns `,_jsx(_components.code,{children:`400 tempo_beta_transfer_limit_exceeded`}),`.\nGround does not split or reduce the plan to fit.\nCash-to-cash movements are not supported.`]})}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":"Preview wallet allocation","openapi":"swagger/swagger-combined.yaml POST /v2/wallets/{id}/allocate-preview","description":"Checks movements between cash, yield, and stock positions. Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.","href":"/api-reference/preview-allocation"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Portfolio Wallets"],"operationId":"previewWalletAllocationV2","summary":"Preview an allocation for a wallet without automatic rebalancing","description":"Checks movements between cash, yield, and stock positions. Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.","parameters":["d08390e1-1425-4199-86c2-c08497069235"],"requestBody":"2f4107f0-099d-4d1c-9725-b8ec5958b859","responses":{"200":"265e395a-610a-4115-ab9b-d2b16c5bd36c","400":"2e8c76e4-c34a-44fb-ab86-83d18304f257","401":"f98d6023-a835-42be-86f5-6ade7d61cb0f","403":"4b675c90-ef9d-4ae2-87e6-8c8b5ba8c0c2","404":"65e2b92d-8878-4082-96c4-6b40bd4c1255","409":"29df72bb-b79b-44ee-a481-249351e0edd3","429":"ec20b0f9-cdcd-49d6-a434-a92e15b08f48","500":"05899c8a-099a-40e2-adf4-2462c802444d"},"method":"post","type":"path","servers":["8b1c8a51-3a5f-4cb0-b89b-8a58f169e0d2","367d05dc-323c-4f09-afbf-0536f782b8f7"],"security":["4920c8f5-ff86-49f7-8dfd-de68658dc1d8"],"path":"/v2/wallets/{id}/allocate-preview","baseUrlOptions":["https://sandbox.groundtech.co","https://production.groundtech.co"],"title":"Preview an allocation for a wallet without automatic rebalancing","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"d08390e1-1425-4199-86c2-c08497069235":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"Wallet ID","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Wallet ID"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["allocations"],"additionalProperties":false,"properties":{"allocations":{"type":"array","minItems":1,"maxItems":100,"description":"Explicit dollar movements between cash and yield positions or between yield positions. Cash-to-cash movements are not supported.","items":{"type":"object","required":["from","to","amountUsd"],"additionalProperties":false,"properties":{"from":{"type":"string","description":"Source position ID from the wallet response.","isRequired":true,"uniqueKey":"allocations.items.[INDEX].from","typeLabel":"string"},"to":{"type":"string","description":"Destination ID from the wallet response or portfolio asset catalog.","isRequired":true,"uniqueKey":"allocations.items.[INDEX].to","typeLabel":"string"},"amountUsd":{"type":"string","pattern":"^(0|[1-9]\\d*)(\\.\\d{1,6})?$","description":"Positive dollar amount to move, with at most six decimal places.","isRequired":true,"uniqueKey":"allocations.items.[INDEX].amountUsd","typeLabel":"string"},"stockPriceToleranceBps":{"type":"integer","minimum":0,"maximum":500,"default":100,"description":"Optional maximum difference between an Ondo stock executable quote and its reference price for this movement. Used for each stock conversion in its route. A preview that needs a higher limit returns 400 with requiredStockPriceToleranceBps; review that value before retrying with a selected higher limit. This is a price bound, not a fee or a guaranteed execution price.","uniqueKey":"allocations.items.[INDEX].stockPriceToleranceBps","typeLabel":"integer"}},"uniqueKey":"allocations.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"allocations","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"allocations":[{"from":"cash:base:usdc","to":"morpho-gauntlet-usdc","amountUsd":"1000.000000"}]},"examples":{"Example":{"title":"Example","value":{"allocations":[{"from":"cash:base:usdc","to":"morpho-gauntlet-usdc","amountUsd":"1000.000000"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"265e395a-610a-4115-ab9b-d2b16c5bd36c":{"description":"Allocation preview","content":{"application/json":{"schema":{"type":"object","required":["positions"],"properties":{"positions":{"type":"array","minItems":2,"items":{"type":"object","required":["id","label","beforeUsd","afterUsd","deltaUsd"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"positions.items.[INDEX].id","typeLabel":"string"},"label":{"type":"string","isRequired":true,"uniqueKey":"positions.items.[INDEX].label","typeLabel":"string"},"beforeUsd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.\\d{6}$","description":"Position value before the allocation, with exactly six decimal places.","isRequired":true,"uniqueKey":"positions.items.[INDEX].beforeUsd","typeLabel":"string"},"afterUsd":{"type":"string","pattern":"^(0|[1-9]\\d*)\\.\\d{6}$","description":"Requested position value after the allocation, with exactly six decimal places. Indicative stock quotes are reported separately; execution prices and fees can change the settled value.","isRequired":true,"uniqueKey":"positions.items.[INDEX].afterUsd","typeLabel":"string"},"deltaUsd":{"type":"string","pattern":"^-?(0|[1-9]\\d*)\\.\\d{6}$","description":"Signed position value change, with exactly six decimal places.","isRequired":true,"uniqueKey":"positions.items.[INDEX].deltaUsd","typeLabel":"string"}},"uniqueKey":"positions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"positions","typeLabel":"object[]"},"assetQuotes":{"type":"array","description":"Indicative quotes for stock conversions in the requested paths, in path order. Intermediate fees and later execution prices can change the result.","items":{"type":"object","required":["from","to","assetId","side","indicative","quotedAt","stockNativeUnits","stockTokenDecimals","cashAsset","cashNativeUnits"],"properties":{"from":{"type":"string","isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].from","typeLabel":"string"},"to":{"type":"string","isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].to","typeLabel":"string"},"assetId":{"type":"string","isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].assetId","typeLabel":"string"},"side":{"type":"string","enum":["buy","sell"],"isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].side","typeLabel":"enum\u003cstring>"},"indicative":{"type":"boolean","enum":[true],"description":"Execution obtains a fresh quote. This preview does not authorize a trade or guarantee a fill.","isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].indicative","typeLabel":"enum\u003cboolean>"},"quotedAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].quotedAt","typeLabel":"string\u003cdate-time>"},"stockNativeUnits":{"type":"string","pattern":"^[1-9]\\d*$","isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].stockNativeUnits","typeLabel":"string"},"stockTokenDecimals":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].stockTokenDecimals","typeLabel":"integer"},"cashAsset":{"type":"object","required":["kind"],"properties":{"kind":{"type":"string","enum":["cash","yield_source","stock"],"isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].cashAsset.kind","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","description":"Network of a cash asset.","uniqueKey":"assetQuotes.items.[INDEX].cashAsset.chain","typeLabel":"string"},"token":{"type":"string","enum":["usdc","usdt","ousd"],"uniqueKey":"assetQuotes.items.[INDEX].cashAsset.token","typeLabel":"enum\u003cstring>"},"yieldSourceId":{"type":"string","description":"Stable noncash asset ID from `GET /v2/wallets/assets` (including yield sources and stock tokens), or the special `cash` id for cash held in the selected allocation group. The live yield source catalog is environment-specific; fetch it before creating or updating a yield allocation.","uniqueKey":"assetQuotes.items.[INDEX].cashAsset.yieldSourceId","typeLabel":"string"},"assetId":{"type":"string","description":"Public stock ID when kind is stock.","uniqueKey":"assetQuotes.items.[INDEX].cashAsset.assetId","typeLabel":"string"}},"description":"A cash chain/token pair or a noncash catalog ID. These identify assets, independently of how they are bought or sold.","isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].cashAsset","typeLabel":"object"},"cashNativeUnits":{"type":"string","pattern":"^[1-9]\\d*$","description":"Estimated USDC spend for a buy or receive amount for a sell, in native units.","isRequired":true,"uniqueKey":"assetQuotes.items.[INDEX].cashNativeUnits","typeLabel":"string"},"cashBudgetNativeUnits":{"type":"string","pattern":"^[1-9]\\d*$","description":"Buy budget at this operation. Earlier bridge or redemption fees can reduce the budget available at execution.","uniqueKey":"assetQuotes.items.[INDEX].cashBudgetNativeUnits","typeLabel":"string"},"unspentCashNativeUnits":{"type":"string","pattern":"^(0|[1-9]\\d*)$","description":"Buy budget remaining after the indicative quoted spend.","uniqueKey":"assetQuotes.items.[INDEX].unspentCashNativeUnits","typeLabel":"string"},"minimumCashNativeUnits":{"type":"string","pattern":"^[1-9]\\d*$","description":"Minimum cash receive derived from this sell preview and the current route price bounds. A fresh boundary is established at execution.","uniqueKey":"assetQuotes.items.[INDEX].minimumCashNativeUnits","typeLabel":"string"}},"uniqueKey":"assetQuotes.items.[INDEX]","typeLabel":"object"},"uniqueKey":"assetQuotes","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"positions":[{"id":"cash:base:usdc","label":"USDC Cash","beforeUsd":"2500.000000","afterUsd":"1500.000000","deltaUsd":"-1000.000000"},{"id":"morpho-gauntlet-usdc","label":"Morpho Gauntlet USDC Prime","beforeUsd":"0.000000","afterUsd":"1000.000000","deltaUsd":"1000.000000"}]},"examples":{"Example":{"title":"Example","value":{"positions":[{"id":"cash:base:usdc","label":"USDC Cash","beforeUsd":"2500.000000","afterUsd":"1500.000000","deltaUsd":"-1000.000000"},{"id":"morpho-gauntlet-usdc","label":"Morpho Gauntlet USDC Prime","beforeUsd":"0.000000","afterUsd":"1000.000000","deltaUsd":"1000.000000"}]}}},"exampleType":"examples"}},"exampleType":"examples"},"2e8c76e4-c34a-44fb-ab86-83d18304f257":{"description":"Invalid or unbalanced allocation changes, a stock quote above the selected price limit, or Tempo beta limit exceeded","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"additionalProperties":false,"properties":{"error":{"type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"requiredStockPriceToleranceBps":{"type":"integer","minimum":0,"maximum":500,"description":"Minimum max slippage for the current indicative stock quote, present only when the quote exceeds the selected limit and is still within the route ceiling. Confirm with the customer before retrying preview.","uniqueKey":"requiredStockPriceToleranceBps","typeLabel":"integer"},"assetId":{"type":"string","description":"Stock position whose quote needs the higher limit.","uniqueKey":"assetId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"stock_price_tolerance_confirmation_required":{"title":"stock_price_tolerance_confirmation_required","value":{"error":"The current stock quote exceeds your max slippage. Review the higher limit before continuing.","code":"validation_error","requiredStockPriceToleranceBps":150,"assetId":"qqqon"}},"tempo_beta_transfer_limit_exceeded":{"title":"tempo_beta_transfer_limit_exceeded","value":{"error":"Tempo beta allocations and rebalances may move at most 100.000000 USDC.e out of Tempo per plan","code":"tempo_beta_transfer_limit_exceeded"}}},"exampleType":"examples"}},"exampleType":"examples"},"f98d6023-a835-42be-86f5-6ade7d61cb0f":{"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"},"4b675c90-ef9d-4ae2-87e6-8c8b5ba8c0c2":{"description":"A new Ondo stock or Etherfuse bond purchase is not enabled for this organization.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Human-readable error message. May change without notice; do not parse programmatically.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Stable across API versions — safe to switch on in client code.","enum":["validation_error","unknown_parameters","payload_too_large","unsupported_media_type","submission_id_conflict","feedback_unavailable","unsupported_chain","unsupported_token","invalid_destination_address","stellar_destination_account_not_active","stellar_destination_usdc_not_enabled","precision_overflow","invalid_cursor","unauthenticated","forbidden","wallet_not_found","wallet_limit_reached","withdrawal_not_found","deposit_not_found","yield_source_not_found","wallet_projection_unavailable","insufficient_funds","duplicate_request_id","request_id_conflict","invalid_position_weight","invalid_withdrawal_plan","payout_not_found","webhook_not_found","webhook_duplicate_url","withdrawal_not_cancellable","withdrawal_already_cancelled","withdrawal_payout_in_progress","withdrawal_policy_required","workflow_conflict","stale_rebalance_plan","stale_wallet_strategy","payout_already_terminal","payout_in_progress","payout_not_retryable","address_book_entry_not_found","address_book_duplicate_entry","address_book_whitelist_violation","rate_limited","rate_limit_exceeded","internal_error","wallet_creation_failed","service_temporarily_unavailable","operation_not_supported","wallet_withdrawal_active","stellar_customer_approval_unavailable","withdrawal_signing_required","wallet_performance_unavailable","tempo_beta_transfer_limit_exceeded","product_not_enabled"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Ondo stock purchases are not enabled for your organization. Contact Ground to request access.","code":"product_not_enabled"},"examples":{"Example":{"title":"Example","value":{"error":"Ondo stock purchases are not enabled for your organization. Contact Ground to request access.","code":"product_not_enabled"}}},"exampleType":"examples"}},"exampleType":"examples"},"65e2b92d-8878-4082-96c4-6b40bd4c1255":{"description":"The requested resource does not exist or is not visible to the authenticated organization.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Human-readable error message. May change without notice; do not parse programmatically.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Stable across API versions — safe to switch on in client code.","enum":["validation_error","unknown_parameters","payload_too_large","unsupported_media_type","submission_id_conflict","feedback_unavailable","unsupported_chain","unsupported_token","invalid_destination_address","stellar_destination_account_not_active","stellar_destination_usdc_not_enabled","precision_overflow","invalid_cursor","unauthenticated","forbidden","wallet_not_found","wallet_limit_reached","withdrawal_not_found","deposit_not_found","yield_source_not_found","wallet_projection_unavailable","insufficient_funds","duplicate_request_id","request_id_conflict","invalid_position_weight","invalid_withdrawal_plan","payout_not_found","webhook_not_found","webhook_duplicate_url","withdrawal_not_cancellable","withdrawal_already_cancelled","withdrawal_payout_in_progress","withdrawal_policy_required","workflow_conflict","stale_rebalance_plan","stale_wallet_strategy","payout_already_terminal","payout_in_progress","payout_not_retryable","address_book_entry_not_found","address_book_duplicate_entry","address_book_whitelist_violation","rate_limited","rate_limit_exceeded","internal_error","wallet_creation_failed","service_temporarily_unavailable","operation_not_supported","wallet_withdrawal_active","stellar_customer_approval_unavailable","withdrawal_signing_required","wallet_performance_unavailable","tempo_beta_transfer_limit_exceeded","product_not_enabled"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Portfolio wallet not found","code":"wallet_not_found"},"examples":{"Example":{"title":"Example","value":{"error":"Portfolio wallet not found","code":"wallet_not_found"}}},"exampleType":"examples"}},"exampleType":"examples"},"29df72bb-b79b-44ee-a481-249351e0edd3":{"description":"The wallet settings, balance, route, or current workflow prevent this allocation","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Human-readable error message. May change without notice; do not parse programmatically.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Stable across API versions — safe to switch on in client code.","enum":["validation_error","unknown_parameters","payload_too_large","unsupported_media_type","submission_id_conflict","feedback_unavailable","unsupported_chain","unsupported_token","invalid_destination_address","stellar_destination_account_not_active","stellar_destination_usdc_not_enabled","precision_overflow","invalid_cursor","unauthenticated","forbidden","wallet_not_found","wallet_limit_reached","withdrawal_not_found","deposit_not_found","yield_source_not_found","wallet_projection_unavailable","insufficient_funds","duplicate_request_id","request_id_conflict","invalid_position_weight","invalid_withdrawal_plan","payout_not_found","webhook_not_found","webhook_duplicate_url","withdrawal_not_cancellable","withdrawal_already_cancelled","withdrawal_payout_in_progress","withdrawal_policy_required","workflow_conflict","stale_rebalance_plan","stale_wallet_strategy","payout_already_terminal","payout_in_progress","payout_not_retryable","address_book_entry_not_found","address_book_duplicate_entry","address_book_whitelist_violation","rate_limited","rate_limit_exceeded","internal_error","wallet_creation_failed","service_temporarily_unavailable","operation_not_supported","wallet_withdrawal_active","stellar_customer_approval_unavailable","withdrawal_signing_required","wallet_performance_unavailable","tempo_beta_transfer_limit_exceeded","product_not_enabled"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"operation_not_supported":{"title":"operation_not_supported","value":{"error":"This wallet has autoRebalance set to true. Use PATCH /v2/wallets/{id}/strategy instead.","code":"operation_not_supported"}}},"exampleType":"examples"}},"exampleType":"examples"},"ec20b0f9-cdcd-49d6-a434-a92e15b08f48":{"description":"Rate limit exceeded. Limits are enforced by API key/customer identity and by endpoint class. Wait for the number of seconds in Retry-After, add a small random delay, then retry.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Human-readable error message. May change without notice; do not parse programmatically.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Stable across API versions — safe to switch on in client code.","enum":["validation_error","unknown_parameters","payload_too_large","unsupported_media_type","submission_id_conflict","feedback_unavailable","unsupported_chain","unsupported_token","invalid_destination_address","stellar_destination_account_not_active","stellar_destination_usdc_not_enabled","precision_overflow","invalid_cursor","unauthenticated","forbidden","wallet_not_found","wallet_limit_reached","withdrawal_not_found","deposit_not_found","yield_source_not_found","wallet_projection_unavailable","insufficient_funds","duplicate_request_id","request_id_conflict","invalid_position_weight","invalid_withdrawal_plan","payout_not_found","webhook_not_found","webhook_duplicate_url","withdrawal_not_cancellable","withdrawal_already_cancelled","withdrawal_payout_in_progress","withdrawal_policy_required","workflow_conflict","stale_rebalance_plan","stale_wallet_strategy","payout_already_terminal","payout_in_progress","payout_not_retryable","address_book_entry_not_found","address_book_duplicate_entry","address_book_whitelist_violation","rate_limited","rate_limit_exceeded","internal_error","wallet_creation_failed","service_temporarily_unavailable","operation_not_supported","wallet_withdrawal_active","stellar_customer_approval_unavailable","withdrawal_signing_required","wallet_performance_unavailable","tempo_beta_transfer_limit_exceeded","product_not_enabled"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Rate limit exceeded","code":"rate_limited"},"examples":{"Example":{"title":"Example","value":{"error":"Rate limit exceeded","code":"rate_limited"}}},"exampleType":"examples"}},"exampleType":"examples"},"05899c8a-099a-40e2-adf4-2462c802444d":{"description":"An unexpected error occurred while processing the request. The request can be safely retried with the same `requestId`.","content":{"application/json":{"schema":{"type":"object","required":["error","code"],"properties":{"error":{"type":"string","description":"Human-readable error message. May change without notice; do not parse programmatically.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code. Stable across API versions — safe to switch on in client code.","enum":["validation_error","unknown_parameters","payload_too_large","unsupported_media_type","submission_id_conflict","feedback_unavailable","unsupported_chain","unsupported_token","invalid_destination_address","stellar_destination_account_not_active","stellar_destination_usdc_not_enabled","precision_overflow","invalid_cursor","unauthenticated","forbidden","wallet_not_found","wallet_limit_reached","withdrawal_not_found","deposit_not_found","yield_source_not_found","wallet_projection_unavailable","insufficient_funds","duplicate_request_id","request_id_conflict","invalid_position_weight","invalid_withdrawal_plan","payout_not_found","webhook_not_found","webhook_duplicate_url","withdrawal_not_cancellable","withdrawal_already_cancelled","withdrawal_payout_in_progress","withdrawal_policy_required","workflow_conflict","stale_rebalance_plan","stale_wallet_strategy","payout_already_terminal","payout_in_progress","payout_not_retryable","address_book_entry_not_found","address_book_duplicate_entry","address_book_whitelist_violation","rate_limited","rate_limit_exceeded","internal_error","wallet_creation_failed","service_temporarily_unavailable","operation_not_supported","wallet_withdrawal_active","stellar_customer_approval_unavailable","withdrawal_signing_required","wallet_performance_unavailable","tempo_beta_transfer_limit_exceeded","product_not_enabled"],"isRequired":true,"uniqueKey":"code","typeLabel":"enum\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Internal server error","code":"internal_error"},"examples":{"Example":{"title":"Example","value":{"error":"Internal server error","code":"internal_error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"4920c8f5-ff86-49f7-8dfd-de68658dc1d8":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"8b1c8a51-3a5f-4cb0-b89b-8a58f169e0d2":{"url":"https://sandbox.groundtech.co"},"367d05dc-323c-4f09-afbf-0536f782b8f7":{"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":"Preview wallet allocation - Ground","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T20:54:55.989Z","originalFileLocation":"api-reference/preview-allocation.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=\"Checks movements between cash, yield, and stock positions. Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.\">\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=\"Preview wallet allocation - Ground\">\u003cmeta data-mint-head property=\"og:description\" content=\"Checks movements between cash, yield, and stock positions. Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ground\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.groundtech.co/api-reference/preview-allocation\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://docs.groundtech.co/docs/assets/og/og-default.png\">\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=\"Preview wallet allocation - Ground\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Checks movements between cash, yield, and stock positions. Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://docs.groundtech.co/docs/assets/og/og-default.png\">\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\">\u003cmeta data-mint-head name=\"og:image:alt\" content=\"Ground developer documentation\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.groundtech.co/api-reference/preview-allocation\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/preview-allocation.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/preview-allocation#webpage\",\"url\":\"https://docs.groundtech.co/api-reference/preview-allocation\",\"name\":\"Preview wallet allocation\",\"description\":\"Checks movements between cash, yield, and stock positions. Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.\",\"dateModified\":\"2026-10-30T20:54:55.989Z\",\"isPartOf\":{\"@id\":\"https://docs.groundtech.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.groundtech.co/api-reference/preview-allocation#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.groundtech.co/api-reference/preview-allocation#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.groundtech.co/api-reference/list-portfolio-assets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Wallets\",\"item\":\"https://docs.groundtech.co/api-reference/create-wallet\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Preview wallet allocation\",\"item\":\"https://docs.groundtech.co/api-reference/preview-allocation\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.groundtech.co/api-reference/preview-allocation#apireference\",\"headline\":\"Preview wallet allocation\",\"name\":\"Preview wallet allocation\",\"description\":\"Checks movements between cash, yield, and stock positions. Tempo beta plans may spend at most 100 USDC.e of Tempo cash across all legs.\",\"url\":\"https://docs.groundtech.co/api-reference/preview-allocation\",\"mainEntityOfPage\":{\"@id\":\"https://docs.groundtech.co/api-reference/preview-allocation#webpage\"},\"image\":\"https://docs.groundtech.co/docs/assets/og/og-default.png\",\"dateModified\":\"2026-10-30T20:54:55.989Z\",\"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\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Ground\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/preview-allocation.md","siteName":"Ground","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/docs/introduction"}]},{"tab":"Portfolio Wallets","groups":[{"group":"Getting Started","pages":[{"title":"Portfolio Wallets Overview","href":"/docs/portfolio-wallets/introduction"},{"group":"Quickstart","root":{"title":"Quickstart","href":"/docs/portfolio-wallets/quickstart"},"expanded":true,"pages":[{"title":"Example: Treasury Portfolio","sidebarTitle":"Example: Treasury Portfolio","href":"/docs/portfolio-wallets/integration-guides/treasury-portfolio-wallet"},{"title":"Example: Neobank/Exchanges","sidebarTitle":"Example: Neobank/Exchanges","href":"/docs/portfolio-wallets/integration-guides/neobank-customer-portfolio-wallet"},{"title":"Power Yield for Stellar Balances","sidebarTitle":"Example: Stellar integration","href":"/docs/portfolio-wallets/integration-guides/stellar"}]},{"title":"Yield Sources","href":"/docs/portfolio-wallets/yield-sources"},{"title":"Stock Tokens","href":"/docs/portfolio-wallets/stocks"},{"title":"Supported Chains","href":"/docs/portfolio-wallets/supported-chains"},{"title":"API Conventions","href":"/docs/portfolio-wallets/api-conventions"},{"title":"Onchain Architecture","href":"/docs/portfolio-wallets/flow-of-funds"}]},{"group":"Wallet Lifecycle","pages":[{"title":"Create a Wallet","href":"/docs/portfolio-wallets/create-wallet"},{"title":"Update a Wallet","href":"/docs/portfolio-wallets/update-wallet"},{"title":"Deposits","href":"/docs/portfolio-wallets/deposits"},{"title":"Balances and Yield","href":"/docs/portfolio-wallets/balances-and-yield"},{"title":"Calculating Yield Accrual","href":"/docs/portfolio-wallets/calculating-yield-accrual"},{"title":"Update Strategy","href":"/docs/portfolio-wallets/update-strategy"},{"title":"How Auto Rebalancing Works","href":"/docs/portfolio-wallets/auto-rebalancing"},{"title":"Withdraw Funds","href":"/docs/portfolio-wallets/withdraw-funds"},{"title":"Address Book","href":"/docs/portfolio-wallets/address-book"}]},{"group":"Fees","pages":[{"title":"Fee Wrappers","href":"/docs/portfolio-wallets/fee-wrappers"}]},{"group":"Approvals","pages":[{"title":"Transaction Approvals","href":"/docs/portfolio-wallets/transaction-approvals"}]},{"group":"Monitoring \u0026 Webhooks","pages":[{"title":"Polling","href":"/docs/portfolio-wallets/polling"},{"title":"Webhooks","href":"/docs/portfolio-wallets/webhooks"},{"title":"Webhook payload examples","href":"/docs/portfolio-wallets/webhook-payload-examples"},{"title":"Webhook signature verification","href":"/docs/portfolio-wallets/webhook-signature-verification"}]},{"group":"Security","pages":[{"title":"Security","href":"/docs/security/custody-model"}]},{"group":"Resources","pages":[{"title":"API Changelog","href":"/docs/changelog"},{"title":"Contract Addresses","href":"/docs/resources/addresses"}]},{"group":"API Reference","pages":[{"group":"Portfolio Assets","pages":[{"title":"List portfolio assets","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/assets","href":"/api-reference/list-portfolio-assets"}]},{"group":"Wallets","pages":[{"title":"Create a portfolio wallet","openapi":"swagger/swagger-combined.yaml POST /v2/wallets","href":"/api-reference/create-wallet"},{"title":"List portfolio wallets","openapi":"swagger/swagger-combined.yaml GET /v2/wallets","href":"/api-reference/list-wallets"},{"title":"Get wallets overview","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/overview","href":"/api-reference/get-wallets-overview"},{"title":"Get a portfolio wallet","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/{id}","href":"/api-reference/get-wallet"},{"title":"Update a portfolio wallet","openapi":"swagger/swagger-combined.yaml PATCH /v2/wallets/{id}","href":"/api-reference/update-wallet"},{"title":"Update wallet strategy","openapi":"swagger/swagger-combined.yaml PATCH /v2/wallets/{id}/strategy","description":"Updates selected token strategies. Open rebalances keep their reservations; new plans use unreserved funds. Open withdrawals block edits.","href":"/api-reference/update-strategy"},{"title":"Preview wallet allocation","openapi":"swagger/swagger-combined.yaml POST /v2/wallets/{id}/allocate-preview","href":"/api-reference/preview-allocation"},{"title":"Allocate wallet funds","openapi":"swagger/swagger-combined.yaml POST /v2/wallets/{id}/allocate","description":"Moves settled funds between positions. Tempo beta caps plans at 100 USDC.e. Ground retries expired, unsubmitted stock quotes; uncertain sends need review.","href":"/api-reference/allocate"}]},{"group":"Deposits","pages":[{"title":"List deposits","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/{id}/deposits","href":"/api-reference/list-deposits"},{"title":"Get a deposit","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/{id}/deposits/{depositId}","href":"/api-reference/get-deposit"},{"title":"Lookup a wallet deposit by tx hash","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/{id}/deposits/lookup","href":"/api-reference/lookup-deposit"}]},{"group":"Sandbox","pages":[{"title":"Request sandbox mock USDT","openapi":"swagger/swagger-combined.yaml POST /v2/sandbox/faucets/usdt","href":"/api-reference/request-sandbox-usdt"},{"title":"Get a sandbox mock USDT request","openapi":"swagger/swagger-combined.yaml GET /v2/sandbox/faucets/usdt/{id}","href":"/api-reference/get-sandbox-usdt-request"}]},{"group":"Withdrawals","pages":[{"title":"Preview a withdrawal","openapi":"swagger/swagger-combined.yaml POST /v2/wallets/{id}/withdrawal-preview","href":"/api-reference/withdrawal-preview"},{"title":"Withdraw funds","openapi":"swagger/swagger-combined.yaml POST /v2/wallets/{id}/withdrawals","href":"/api-reference/withdraw"},{"title":"List withdrawals","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/{id}/withdrawals","href":"/api-reference/list-withdrawals"},{"title":"Get a withdrawal","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/{id}/withdrawals/{withdrawalId}","href":"/api-reference/get-withdrawal"}]},{"group":"Approvals","pages":[{"title":"List pending Turnkey approval activities","openapi":"swagger/swagger-combined.yaml GET /v2/turnkey/activities/pending","href":"/api-reference/list-pending-turnkey-activities"},{"title":"Create Turnkey activity approval request","openapi":"swagger/swagger-combined.yaml POST /v2/turnkey/activity-approval-request","href":"/api-reference/create-turnkey-activity-approval-request"},{"title":"Vote on Turnkey activity","openapi":"swagger/swagger-combined.yaml POST /v2/turnkey/activities/{activityId}/vote","href":"/api-reference/vote-turnkey-activity"}]},{"group":"Address Book","pages":[{"title":"List address book entries","openapi":"swagger/swagger-combined.yaml GET /v2/address-book/entries","href":"/api-reference/list-address-book-entries"},{"title":"Create address book entry","openapi":"swagger/swagger-combined.yaml POST /v2/address-book/entries","href":"/api-reference/create-address-book-entry"},{"title":"Delete address book entry","openapi":"swagger/swagger-combined.yaml DELETE /v2/address-book/entries/{id}","href":"/api-reference/delete-address-book-entry"}]},{"group":"Activity","pages":[{"title":"List activity","openapi":"swagger/swagger-combined.yaml GET /v2/activity","href":"/api-reference/list-activity"},{"title":"Compute yield","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/{id}/yield","href":"/api-reference/compute-yield"}]},{"group":"Accounting","pages":[{"title":"List accounting activity","openapi":"swagger/swagger-combined.yaml GET /v2/accounting/activity","href":"/api-reference/list-accounting-activity"},{"title":"Get accounting yield period summary","openapi":"swagger/swagger-combined.yaml GET /v2/accounting/yield/period-summary","href":"/api-reference/get-accounting-yield-period-summary"}]},{"group":"Webhooks","pages":[{"title":"Create a webhook","openapi":"swagger/swagger-combined.yaml POST /v2/webhooks","href":"/api-reference/create-webhook"},{"title":"List webhooks","openapi":"swagger/swagger-combined.yaml GET /v2/webhooks","href":"/api-reference/list-webhooks"},{"title":"List webhook events","openapi":"swagger/swagger-combined.yaml GET /v2/webhooks/events","href":"/api-reference/list-webhook-events"},{"title":"Get a webhook","openapi":"swagger/swagger-combined.yaml GET /v2/webhooks/{id}","href":"/api-reference/get-webhook"},{"title":"Delete a webhook","openapi":"swagger/swagger-combined.yaml DELETE /v2/webhooks/{id}","href":"/api-reference/delete-webhook"},{"title":"List events for a webhook","openapi":"swagger/swagger-combined.yaml GET /v2/webhooks/{id}/events","href":"/api-reference/list-webhook-events-by-webhook"}]}]}]},{"tab":"gtokens","pages":[{"title":"gtokens","href":"/docs/gtokens/introduction"}]},{"tab":"MicroVaults","pages":[{"title":"MicroVaults","href":"/docs/microvaults/introduction"}]}]},"basePath":"","title":"Preview wallet allocation - Ground","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}