Deposit addresses keyed by chain. Sandbox wallets use ethereum_sepolia and solana_devnet, plus tron_shasta and stellar_testnet; production wallets use arbitrum, base, ethereum, polygon, and solana, plus tron and stellar. New wallets prepare Stellar automatically in the background; only ready addresses are returned. Production wallets also prepare tempo (USDC.e); its address is returned only after setup and deposit monitoring are ready. The Tempo address can differ from the Ethereum address. Tempo is not available in sandbox.
Percentage targets when automatic rebalancing is enabled. Always null when it is disabled.
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":"6aee2f7eb934480efcad869f","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":71},{"language":"default","tag":"Portfolio Wallets","count":61},{"language":"default","tag":"MicroVaults","count":36},{"language":"default","tag":"gtokens","count":33},{"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":"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},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/get-wallet","slug":"/api-reference/get-wallet","pageMetadata":{"title":"Get a portfolio wallet","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/{id}","description":"Returns the wallet with balances, strategy, positions, and deposit addresses.","href":"/api-reference/get-wallet"},"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: \"Returns the wallet with balances, strategy, positions, and deposit addresses.\"\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{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}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":"Get a portfolio wallet","openapi":"swagger/swagger-combined.yaml GET /v2/wallets/{id}","description":"Returns the wallet with balances, strategy, positions, and deposit addresses.","href":"/api-reference/get-wallet"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Portfolio Wallets"],"operationId":"getWalletV2","summary":"Get a Wallet","description":"Returns the wallet with balances, strategy, positions, and deposit addresses.","parameters":["1b75aae3-7a82-4876-9543-895c53dceb41"],"responses":{"200":"4490ea33-4fe5-495e-919e-71c07f9d962e","400":"081e842a-020c-4a1a-af60-1dee1fed2c0c","401":"a771bed8-ac09-49a4-b0ba-7939b139408f","404":"1bb317dd-49b0-4cd5-942a-5a24ad0df4d9","429":"5719ddcb-afc0-4a1a-ac2e-45bf33d11a06","500":"382c0b64-0c8d-41b9-bcca-c46e3de56ae3"},"method":"get","type":"path","servers":["c5886484-d20e-43ca-87e4-1cb7ba6d7c5c","ebd86803-5abc-4814-ac10-36ab83dbcd99"],"security":["843e642c-dbaf-4d33-8190-5f46bea3e1ee"],"path":"/v2/wallets/{id}","baseUrlOptions":["https://sandbox.groundtech.co","https://production.groundtech.co"],"title":"Get a Wallet","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1b75aae3-7a82-4876-9543-895c53dceb41":{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"Wallet ID","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Wallet ID"}},"responses":{"4490ea33-4fe5-495e-919e-71c07f9d962e":{"description":"Wallet details","content":{"application/json":{"schema":{"type":"object","required":["id","autoRebalance","label","createdAt","status","failureReason","depositAddresses","balance","positions","strategyAllocations"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"autoRebalance":{"type":"boolean","description":"Whether Ground automatically deploys deposits and maintains the wallet's percentage targets.","isRequired":true,"uniqueKey":"autoRebalance","typeLabel":"boolean"},"label":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"label.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"label.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"label","typeLabel":"string | null"},"createdAt":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"status":{"type":"string","description":"Compact wallet lifecycle and active-workflow status.","enum":["creating","idle","withdrawal_active","rebalance_active","withdrawal_and_rebalance_active","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"failureReason":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"failureReason.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"failureReason.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"failureReason","typeLabel":"string | null"},"depositAddresses":{"type":"object","description":"Deposit addresses keyed by chain. Sandbox wallets use `ethereum_sepolia` and `solana_devnet`, plus `tron_shasta` and `stellar_testnet`; production wallets use `arbitrum`, `base`, `ethereum`, `polygon`, and `solana`, plus `tron` and `stellar`. New wallets prepare Stellar automatically in the background; only ready addresses are returned. Production wallets also prepare `tempo` (USDC.e); its address is returned only after setup and deposit monitoring are ready. The Tempo address can differ from the Ethereum address. Tempo is not available in sandbox.","additionalProperties":{"type":"string","uniqueKey":"depositAddresses.additionalProperties","typeLabel":"string"},"example":{"arbitrum":"0xAbC1230000000000000000000000000000000001","base":"0xAbC1230000000000000000000000000000000001","ethereum":"0xAbC1230000000000000000000000000000000001","polygon":"0xAbC1230000000000000000000000000000000001","solana":"7vFgKxM3bP4oEFbqkPmA5E2rYJ8HqKz8abc1","stellar":"GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF","tron":"TBXSw8fM4jpQkGc6zZjsVABFpVN7UvXPdV"},"isRequired":true,"uniqueKey":"depositAddresses","typeLabel":"object"},"balance":{"type":"object","required":["totalUsd","withdrawableUsd","reservedUsd","earnedUsd"],"properties":{"totalUsd":{"type":"string","description":"Gross economically owned wallet value across cash, positions, and in-transit customer-owned value.","isRequired":true,"uniqueKey":"balance.totalUsd","typeLabel":"string"},"withdrawableUsd":{"type":"string","description":"Gross wallet value available to start a withdrawal, before execution fees. Excludes funds reserved for ongoing operations or awaiting settlement.","isRequired":true,"uniqueKey":"balance.withdrawableUsd","typeLabel":"string"},"reservedUsd":{"type":"string","description":"Customer-owned value reserved by active wallet workflows.","isRequired":true,"uniqueKey":"balance.reservedUsd","typeLabel":"string"},"earnedUsd":{"type":"string","description":"Customer-facing lifetime realized gross yield earned to date, before explicit protocol fees and protocol slippage.","isRequired":true,"uniqueKey":"balance.earnedUsd","typeLabel":"string"}},"isRequired":true,"uniqueKey":"balance","typeLabel":"object"},"positions":{"type":"array","items":{"type":"object","required":["id","kind","label","valueUsd"],"properties":{"id":{"type":"string","description":"Public position ID. Noncash positions use catalog IDs; cash positions use stable synthetic IDs.","isRequired":true,"uniqueKey":"positions.items.[INDEX].id","typeLabel":"string"},"kind":{"type":"string","enum":["yield_source","stock","cash","bridge","external_payout","unknown"],"isRequired":true,"uniqueKey":"positions.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"label":{"type":"string","description":"Human-readable display name.","isRequired":true,"uniqueKey":"positions.items.[INDEX].label","typeLabel":"string"},"valueUsd":{"type":"string","description":"Current USD value of this position.","isRequired":true,"uniqueKey":"positions.items.[INDEX].valueUsd","typeLabel":"string"},"tokenDecimals":{"oneOf":[{"type":"integer","minimum":0,"description":"Decimal precision used by nativeUnits for this noncash holding.","uniqueKey":"positions.items.[INDEX].tokenDecimals.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"description":"Decimal precision used by nativeUnits for this noncash holding.","uniqueKey":"positions.items.[INDEX].tokenDecimals.oneOf.1","typeLabel":"null"}],"uniqueKey":"positions.items.[INDEX].tokenDecimals","typeLabel":"integer | null"},"nativeUnits":{"type":"string","pattern":"^(0|[1-9]\\d*)$","description":"Exact noncash token quantity in its catalog decimals.","uniqueKey":"positions.items.[INDEX].nativeUnits","typeLabel":"string"},"assetSymbol":{"type":"string","description":"Provider stock token symbol, such as QQQon.","uniqueKey":"positions.items.[INDEX].assetSymbol","typeLabel":"string"},"priceUsd":{"type":"any","uniqueKey":"positions.items.[INDEX].priceUsd","typeLabel":"any"},"priceFreshness":{"type":"any","uniqueKey":"positions.items.[INDEX].priceFreshness","typeLabel":"any"},"withdrawableUsd":{"type":"string","description":"Amount of this position currently available to initiate for withdrawal. Pending provider-managed redemption value remains in valueUsd but is excluded here.","uniqueKey":"positions.items.[INDEX].withdrawableUsd","typeLabel":"string"},"pct":{"type":"number","description":"Target allocation percentage. Present on yield positions and configured cash allocations; omitted on unconfigured synthetic positions.","uniqueKey":"positions.items.[INDEX].pct","typeLabel":"number"},"allocationGroup":{"type":"string","enum":["usdc","usdt","usdt:tron"],"description":"Group used to organize strategy allocations. Group membership does not imply assets are directly interchangeable.","uniqueKey":"positions.items.[INDEX].allocationGroup","typeLabel":"enum\u003cstring>"},"token":{"type":"string","enum":["usdc","usdt"],"description":"Allocation group used to validate, fund, rebalance, and withdraw an allocation independently from other allocation groups.","uniqueKey":"positions.items.[INDEX].token","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","description":"Chain for the cash or yield-source position.","uniqueKey":"positions.items.[INDEX].chain","typeLabel":"string"},"productId":{"type":"string","description":"Product identity for yield sources that share a product across networks.","uniqueKey":"positions.items.[INDEX].productId","typeLabel":"string"},"mode":{"oneOf":[{"type":"string","description":"Current operating mode when the yield source can be identified.","uniqueKey":"positions.items.[INDEX].mode.oneOf.0","typeLabel":"string"},{"type":"null","description":"Current operating mode when the yield source can be identified.","uniqueKey":"positions.items.[INDEX].mode.oneOf.1","typeLabel":"null"}],"uniqueKey":"positions.items.[INDEX].mode","typeLabel":"string | null"},"apyBps":{"oneOf":[{"type":"integer","description":"Annualized yield in denominationCurrency, expressed in basis points; null when unavailable or stale.","uniqueKey":"positions.items.[INDEX].apyBps.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Annualized yield in denominationCurrency, expressed in basis points; null when unavailable or stale.","uniqueKey":"positions.items.[INDEX].apyBps.oneOf.1","typeLabel":"null"}],"uniqueKey":"positions.items.[INDEX].apyBps","typeLabel":"integer | null"},"denominationCurrency":{"type":"string","description":"Currency of this yield-source position's apyBps. valueUsd remains the USD valuation.","example":"MXN","uniqueKey":"positions.items.[INDEX].denominationCurrency","typeLabel":"string"},"navUpdateMode":{"oneOf":[{"type":"string","enum":["continuous","discrete",null],"description":"Whether client-side accrual between price snapshots is appropriate.","uniqueKey":"positions.items.[INDEX].navUpdateMode.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["continuous","discrete",null],"description":"Whether client-side accrual between price snapshots is appropriate.","uniqueKey":"positions.items.[INDEX].navUpdateMode.oneOf.1","typeLabel":"null"}],"uniqueKey":"positions.items.[INDEX].navUpdateMode","typeLabel":"enum\u003cstring> | null"},"priceAsOf":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp of the reference price used to value the position.","uniqueKey":"positions.items.[INDEX].priceAsOf.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp of the reference price used to value the position.","uniqueKey":"positions.items.[INDEX].priceAsOf.oneOf.1","typeLabel":"null"}],"uniqueKey":"positions.items.[INDEX].priceAsOf","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"positions.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"positions","typeLabel":"object[]"},"strategyAllocations":{"oneOf":[{"type":"object","description":"Percentage targets when automatic rebalancing is enabled. Always null when it is disabled.","properties":{"usdc":{"type":"array","items":{"type":"object","required":["yieldSourceId","targetWeightBps"],"properties":{"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.","isRequired":true,"uniqueKey":"strategyAllocations.oneOf.0.usdc.items.[INDEX].yieldSourceId","typeLabel":"string"},"targetWeightBps":{"type":"integer","minimum":0,"maximum":10000,"description":"Target weight within this allocation group, in basis points.","isRequired":true,"uniqueKey":"strategyAllocations.oneOf.0.usdc.items.[INDEX].targetWeightBps","typeLabel":"integer"},"allocationGroup":{"type":"string","enum":["usdc","usdt","usdt:tron"],"description":"Group used to organize strategy allocations. Group membership does not imply assets are directly interchangeable.","uniqueKey":"strategyAllocations.oneOf.0.usdc.items.[INDEX].allocationGroup","typeLabel":"enum\u003cstring>"},"token":{"type":"string","enum":["usdc","usdt"],"description":"Allocation group used to validate, fund, rebalance, and withdraw an allocation independently from other allocation groups.","uniqueKey":"strategyAllocations.oneOf.0.usdc.items.[INDEX].token","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","description":"Chain for a chain-scoped cash target.","uniqueKey":"strategyAllocations.oneOf.0.usdc.items.[INDEX].chain","typeLabel":"string"}},"uniqueKey":"strategyAllocations.oneOf.0.usdc.items.[INDEX]","typeLabel":"object"},"uniqueKey":"strategyAllocations.oneOf.0.usdc","typeLabel":"object[]"},"usdt":{"type":"array","items":{"type":"object","required":["yieldSourceId","targetWeightBps"],"properties":{"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.","isRequired":true,"uniqueKey":"strategyAllocations.oneOf.0.usdt.items.[INDEX].yieldSourceId","typeLabel":"string"},"targetWeightBps":{"type":"integer","minimum":0,"maximum":10000,"description":"Target weight within this allocation group, in basis points.","isRequired":true,"uniqueKey":"strategyAllocations.oneOf.0.usdt.items.[INDEX].targetWeightBps","typeLabel":"integer"},"allocationGroup":{"type":"string","enum":["usdc","usdt","usdt:tron"],"description":"Group used to organize strategy allocations. Group membership does not imply assets are directly interchangeable.","uniqueKey":"strategyAllocations.oneOf.0.usdt.items.[INDEX].allocationGroup","typeLabel":"enum\u003cstring>"},"token":{"type":"string","enum":["usdc","usdt"],"description":"Allocation group used to validate, fund, rebalance, and withdraw an allocation independently from other allocation groups.","uniqueKey":"strategyAllocations.oneOf.0.usdt.items.[INDEX].token","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","description":"Chain for a chain-scoped cash target.","uniqueKey":"strategyAllocations.oneOf.0.usdt.items.[INDEX].chain","typeLabel":"string"}},"uniqueKey":"strategyAllocations.oneOf.0.usdt.items.[INDEX]","typeLabel":"object"},"uniqueKey":"strategyAllocations.oneOf.0.usdt","typeLabel":"object[]"},"usdt:tron":{"type":"array","items":{"type":"object","required":["yieldSourceId","targetWeightBps"],"properties":{"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.","isRequired":true,"uniqueKey":"strategyAllocations.oneOf.0.usdt:tron.items.[INDEX].yieldSourceId","typeLabel":"string"},"targetWeightBps":{"type":"integer","minimum":0,"maximum":10000,"description":"Target weight within this allocation group, in basis points.","isRequired":true,"uniqueKey":"strategyAllocations.oneOf.0.usdt:tron.items.[INDEX].targetWeightBps","typeLabel":"integer"},"allocationGroup":{"type":"string","enum":["usdc","usdt","usdt:tron"],"description":"Group used to organize strategy allocations. Group membership does not imply assets are directly interchangeable.","uniqueKey":"strategyAllocations.oneOf.0.usdt:tron.items.[INDEX].allocationGroup","typeLabel":"enum\u003cstring>"},"token":{"type":"string","enum":["usdc","usdt"],"description":"Allocation group used to validate, fund, rebalance, and withdraw an allocation independently from other allocation groups.","uniqueKey":"strategyAllocations.oneOf.0.usdt:tron.items.[INDEX].token","typeLabel":"enum\u003cstring>"},"chain":{"type":"string","description":"Chain for a chain-scoped cash target.","uniqueKey":"strategyAllocations.oneOf.0.usdt:tron.items.[INDEX].chain","typeLabel":"string"}},"uniqueKey":"strategyAllocations.oneOf.0.usdt:tron.items.[INDEX]","typeLabel":"object"},"description":"Native TRON USDT allocations, independently weighted from Ethereum USDT. Each group totals 100 percent (10000 basis points in responses).","uniqueKey":"strategyAllocations.oneOf.0.usdt:tron","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"strategyAllocations.oneOf.0","typeLabel":"object"},{"type":"null","isRequired":true,"uniqueKey":"strategyAllocations.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"strategyAllocations","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"production":{"title":"production","value":{"id":"b1c2d3e4-0000-4000-8000-000000000001","label":"Corporate Treasury","createdAt":"2025-09-01T00:00:00Z","status":"idle","failureReason":null,"depositAddresses":{"arbitrum":"0xAbC1230000000000000000000000000000000001","base":"0xAbC1230000000000000000000000000000000001","ethereum":"0xAbC1230000000000000000000000000000000001","polygon":"0xAbC1230000000000000000000000000000000001","solana":"7vFgKxM3bP4oEFbqkPmA5E2rYJ8HqKz8abc1","stellar":"GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF","tron":"TBXSw8fM4jpQkGc6zZjsVABFpVN7UvXPdV"},"balance":{"totalUsd":"100.000000","withdrawableUsd":"100.000000","reservedUsd":"0.000000","earnedUsd":"5.000000"},"positions":[{"id":"syrup-usdc","kind":"yield_source","label":"Syrup USDC","valueUsd":"40.000000","pct":40,"chain":"ethereum","token":"usdc","allocationGroup":"usdc","withdrawableUsd":"40.000000","mode":"active","denominationCurrency":"USD","apyBps":null,"navUpdateMode":"continuous","priceAsOf":"2026-10-19T12:00:00.000Z"},{"id":"morpho-gauntlet-usdc","kind":"yield_source","label":"Morpho Gauntlet USDC Prime","valueUsd":"30.000000","pct":30,"chain":"ethereum","token":"usdc","allocationGroup":"usdc","withdrawableUsd":"30.000000","mode":"active","denominationCurrency":"USD","apyBps":null,"navUpdateMode":"continuous","priceAsOf":"2026-10-19T12:00:00.000Z"},{"id":"morpho-steakhouse-usdc","kind":"yield_source","label":"Morpho Steakhouse USDC Prime","valueUsd":"30.000000","pct":30,"chain":"ethereum","token":"usdc","allocationGroup":"usdc","withdrawableUsd":"30.000000","mode":"active","denominationCurrency":"USD","apyBps":null,"navUpdateMode":"continuous","priceAsOf":"2026-10-19T12:00:00.000Z"}],"autoRebalance":true,"strategyAllocations":{"usdc":[{"yieldSourceId":"syrup-usdc","targetWeightBps":4000,"chain":"ethereum","token":"usdc","allocationGroup":"usdc"},{"yieldSourceId":"morpho-gauntlet-usdc","targetWeightBps":3000,"chain":"ethereum","token":"usdc","allocationGroup":"usdc"},{"yieldSourceId":"morpho-steakhouse-usdc","targetWeightBps":3000,"chain":"ethereum","token":"usdc","allocationGroup":"usdc"}],"usdt":[{"yieldSourceId":"cash","targetWeightBps":10000,"token":"usdt","chain":"ethereum","allocationGroup":"usdt"}],"usdt:tron":[{"yieldSourceId":"cash","targetWeightBps":10000,"token":"usdt","chain":"tron","allocationGroup":"usdt:tron"}]}}},"sandbox":{"title":"sandbox","value":{"id":"b1c2d3e4-0000-4000-8000-000000000002","label":"Sandbox Treasury","createdAt":"2026-08-05T00:00:00Z","status":"idle","failureReason":null,"depositAddresses":{"ethereum_sepolia":"0xFf71D07826d0aFcEcDF07Be9c499f9DDF3ee5cFa","solana_devnet":"DmaePN7kL6WjSecMaH4urdS8zN8FwNPTxbdTqFwAw6Fd","tron_shasta":"TBXSw8fM4jpQkGc6zZjsVABFpVN7UvXPdV","stellar_testnet":"GAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAWHF"},"balance":{"totalUsd":"10.000000","withdrawableUsd":"10.000000","reservedUsd":"0.000000","earnedUsd":"0.000000"},"positions":[{"id":"cash:solana_devnet:usdc","kind":"cash","label":"USDC (Solana Devnet)","valueUsd":"10.000000","chain":"solana_devnet","token":"usdc","allocationGroup":"usdc","withdrawableUsd":"10.000000","pct":100}],"autoRebalance":true,"strategyAllocations":{"usdc":[{"yieldSourceId":"cash","targetWeightBps":10000,"token":"usdc"}],"usdt":[{"yieldSourceId":"cash","targetWeightBps":10000,"token":"usdt","chain":"ethereum_sepolia","allocationGroup":"usdt"}],"usdt:tron":[{"yieldSourceId":"cash","targetWeightBps":10000,"token":"usdt","chain":"tron_shasta","allocationGroup":"usdt:tron"}]}}}},"exampleType":"examples"}},"exampleType":"examples"},"081e842a-020c-4a1a-af60-1dee1fed2c0c":{"description":"Invalid path parameter","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":"id must be a valid UUID v4","code":"validation_error"},"examples":{"Example":{"title":"Example","value":{"error":"id must be a valid UUID v4","code":"validation_error"}}},"exampleType":"examples"}},"exampleType":"examples"},"a771bed8-ac09-49a4-b0ba-7939b139408f":{"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"},"1bb317dd-49b0-4cd5-942a-5a24ad0df4d9":{"description":"Wallet not found","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":{"wallet_not_found":{"title":"wallet_not_found","value":{"error":"Wallet not found","code":"wallet_not_found"}}},"exampleType":"examples"}},"exampleType":"examples"},"5719ddcb-afc0-4a1a-ac2e-45bf33d11a06":{"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"},"382c0b64-0c8d-41b9-bcca-c46e3de56ae3":{"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":{"843e642c-dbaf-4d33-8190-5f46bea3e1ee":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"c5886484-d20e-43ca-87e4-1cb7ba6d7c5c":{"url":"https://sandbox.groundtech.co"},"ebd86803-5abc-4814-ac10-36ab83dbcd99":{"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":"Get a portfolio wallet - Ground","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-12T00:41:24.516Z","originalFileLocation":"api-reference/get-wallet.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=\"Returns the wallet with balances, strategy, positions, and deposit addresses.\">\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=\"Get a portfolio wallet - Ground\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the wallet with balances, strategy, positions, and deposit addresses.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ground\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.groundtech.co/api-reference/get-wallet\">\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=\"Get a portfolio wallet - Ground\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the wallet with balances, strategy, positions, and deposit addresses.\">\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/get-wallet\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-wallet.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/get-wallet#webpage\",\"url\":\"https://docs.groundtech.co/api-reference/get-wallet\",\"name\":\"Get a portfolio wallet\",\"description\":\"Returns the wallet with balances, strategy, positions, and deposit addresses.\",\"dateModified\":\"2026-07-12T00:41:24.516Z\",\"isPartOf\":{\"@id\":\"https://docs.groundtech.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.groundtech.co/api-reference/get-wallet#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.groundtech.co/api-reference/get-wallet#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\":\"Get a portfolio wallet\",\"item\":\"https://docs.groundtech.co/api-reference/get-wallet\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.groundtech.co/api-reference/get-wallet#apireference\",\"headline\":\"Get a portfolio wallet\",\"name\":\"Get a portfolio wallet\",\"description\":\"Returns the wallet with balances, strategy, positions, and deposit addresses.\",\"url\":\"https://docs.groundtech.co/api-reference/get-wallet\",\"mainEntityOfPage\":{\"@id\":\"https://docs.groundtech.co/api-reference/get-wallet#webpage\"},\"image\":\"https://docs.groundtech.co/docs/assets/og/og-default.png\",\"dateModified\":\"2026-07-12T00:41:24.516Z\",\"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","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","description":"Returns aggregate balance and yield totals across the authenticated organization's wallets.","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}","description":"Updates the wallet label.","href":"/api-reference/update-wallet"},{"title":"Update wallet strategy","openapi":"swagger/swagger-combined.yaml PATCH /v2/wallets/{id}/strategy","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","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":"Get a portfolio wallet - Ground","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}