{
"code": "INTERNAL_ERROR",
"message": "Internal Server Error"
}
Yield
Get position
Get the wallet’s supplied USDC balance and estimated withdrawal availability in the selected market. Provide marketId or chainId. Para derives the chain from marketId; chainId alone selects Aave V3. If both are supplied, they must identify the same chain.
GET
/
v1
/
wallets
/
{walletId}
/
yield
/
position
Get position
curl --request GET \ --url https://api.beta.getpara.com/v1/wallets/{walletId}/yield/position \ --header 'X-API-Key: <api-key>'
Optional when marketId is supplied; must match its chain. Without marketId, selects Aave V3 on this chain. Native USDC on Ethereum mainnet (1) or Base mainnet (8453), or Aave test USDC on Sepolia (11155111). Base Sepolia (84532) uses test USDC and is available only in sandbox and local test environments.
Market ID from the markets endpoint. Determines the chain and asset. Required if chainId is omitted. Without marketId, chainId selects Aave V3. Unsupported IDs or a mismatched chainId return 400. The sandbox-only Morpho demo market is morpho-v2-base-sepolia-demo-usdc on Base Sepolia (84532); it holds test USDC idle and earns no lending yield.
Current position value in USDC decimal units, including accrued yield. Aave uses the aToken balance; Morpho uses previewRedeem for the current shares, rounding down. Not historical earnings.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Para Docs","description":"Para is the most comprehensive wallet and authentication suite for crypto applications.","colors":{"primary":"#FF4E00","light":"#FF4E00","dark":"#FF4E00"},"logo":{"light":"https://mintcdn.com/getpara/30lQMU2mHiFlT8O0/logo/light.svg?fit=max\u0026auto=format\u0026n=30lQMU2mHiFlT8O0\u0026q=85\u0026s=342b25f634bb7c26fefb0769da8f0555","dark":"https://mintcdn.com/getpara/30lQMU2mHiFlT8O0/logo/dark.svg?fit=max\u0026auto=format\u0026n=30lQMU2mHiFlT8O0\u0026q=85\u0026s=6404d8529516f7e178e3781b864656c9"},"favicon":"https://mintcdn.com/getpara/K-Gy3Q2JkFCvA3gr/favicon.svg?fit=max\u0026auto=format\u0026n=K-Gy3Q2JkFCvA3gr\u0026q=85\u0026s=877317a7a2973b619ffca0cc05e46195","api":{"playground":{"display":"interactive"}},"appearance":{"default":"light","strict":true},"background":{"decoration":"windows","color":{"light":"#FFFFFF","dark":"#000000"}},"navbar":{"links":[{"icon":"slack","href":"https://join.slack.com/t/para-community/shared_invite/zt-304keeulc-Oqs4eusCUAJEpE9DBwAqrg","label":"Community"}],"primary":{"type":"button","label":"Get Access","href":"https://developer.getpara.com/"}},"footer":{"socials":{"x":"https://x.com/get_para","github":"https://github.com/getpara","linkedin":"https://www.linkedin.com/company/parahq","slack":"https://join.slack.com/t/para-community/shared_invite/zt-304keeulc-Oqs4eusCUAJEpE9DBwAqrg","website":"https://getpara.com"}},"search":{"prompt":"Search Para Docs..."},"seo":{"indexing":"all"},"icons":{"library":"fontawesome"},"styling":{"eyebrows":"section","latex":false},"integrations":{"ga4":{"measurementId":"G-J2BJTJZW8H"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"getpara","hasAudioNarration":false,"actualSubdomain":"getpara","customDomains":["docs.getpara.com"],"gitSource":{"type":"github","owner":"capsule-org","repo":"docs-mintlify","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aedf7e4fb71aa062f1160ab","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":730},{"language":"default","tag":"Reference","count":575},{"language":"default","tag":"Build","count":436},{"language":"default","tag":"React \u0026 Web","count":273},{"language":"default","tag":"React Native","count":224},{"language":"default","tag":"React Hooks","count":139},{"language":"default","tag":"Types \u0026 Configuration","count":130},{"language":"default","tag":"Client Methods","count":122},{"language":"default","tag":"Transact on Chains","count":103},{"language":"default","tag":"REST API","count":100}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"v3/rest/api/yield/get-position","slug":"/v3/rest/api/yield/get-position","pageMetadata":{"title":"Get position","description":"Get the wallet's supplied USDC balance and estimated withdrawal availability in the selected market. Provide marketId or chainId. Para derives the chain from marketId; chainId alone selects Aave V3. If both are supplied, they must identify the same chain.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/wallets/{walletId}/yield/position","href":"/v3/rest/api/yield/get-position","autogeneratedByOpenApi":true},"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: \"Get the wallet’s supplied USDC balance and estimated withdrawal availability in the selected market. Provide marketId or chainId. Para derives the chain from marketId; chainId alone selects Aave V3. If both are supplied, they must identify the same chain.\"\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":{"config":{},"pageMetadata":{"title":"Get position","description":"Get the wallet's supplied USDC balance and estimated withdrawal availability in the selected market. Provide marketId or chainId. Para derives the chain from marketId; chainId alone selects Aave V3. If both are supplied, they must identify the same chain.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/wallets/{walletId}/yield/position","href":"/v3/rest/api/yield/get-position","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/getpara/98686b284aa093b7/tab-sync.js"],"openApiReferenceData":{"operation":{"operationId":"getYieldPosition","summary":"Get position","tags":["Yield"],"description":"Get the wallet's supplied USDC balance and estimated withdrawal availability in the selected market. Provide marketId or chainId. Para derives the chain from marketId; chainId alone selects Aave V3. If both are supplied, they must identify the same chain.","parameters":["a107a733-4442-41c9-80e8-ab45fda76d69","9585b08c-bde0-48c4-8983-0da1ff27cce6","4edba9f4-4d7f-41ce-b35a-1e5618f01ec2","ca90b13a-fcba-4342-b03c-49ffd5db5c7a"],"responses":{"200":"3723ea8c-9e5b-487a-9c7a-bf6bb154746e","400":"0e2c65de-7b43-46b2-b00e-18507aa7386e","401":"38f9d5a9-6410-4be7-b1e0-01d1a929ed71","403":"059879bb-0f23-4540-b0b1-6eb27fe4819d","404":"9e6f3901-d97e-43f5-a732-b285fdd6e1a9","409":"d55a1520-e5ac-4ce8-990b-45111a943eea","429":"120dc36c-db7c-41ae-97e7-c4efab9922b5","500":"fd413312-c7dc-40ef-a3ae-5215dccd2792"},"method":"get","type":"path","servers":["84e136c7-b7b8-4f59-9f7c-86990ff9ffe0","42d2d9d7-05ba-4437-820b-f5afc2833189"],"security":["90b4b28c-bdd5-4c66-b5b8-caf6c9c9df3d"],"path":"/v1/wallets/{walletId}/yield/position","baseUrlOptions":["https://api.beta.getpara.com","https://api.getpara.com"],"title":"Get position","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"a107a733-4442-41c9-80e8-ab45fda76d69":{"name":"walletId","in":"path","required":true,"description":"Wallet UUID. A malformed or inaccessible wallet ID returns `404`.","schema":{"type":"string","format":"uuid","example":"0a1b2c3d-4e5f-6789-abcd-ef0123456789","isRequired":true,"description":"Wallet UUID. A malformed or inaccessible wallet ID returns `404`.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"9585b08c-bde0-48c4-8983-0da1ff27cce6":{"name":"X-Request-Id","in":"header","required":false,"description":"UUID for request tracing. Para returns one if omitted.","schema":{"type":"string","format":"uuid","isRequired":false,"description":"UUID for request tracing. Para returns one if omitted.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"4edba9f4-4d7f-41ce-b35a-1e5618f01ec2":{"name":"chainId","in":"query","required":false,"description":"Optional when marketId is supplied; must match its chain. Without marketId, selects Aave V3 on this chain. Native USDC on Ethereum mainnet (1) or Base mainnet (8453), or Aave test USDC on Sepolia (11155111). Base Sepolia (84532) uses test USDC and is available only in sandbox and local test environments.","schema":{"type":"integer","enum":[1,8453,11155111,84532],"isRequired":false,"description":"Optional when marketId is supplied; must match its chain. Without marketId, selects Aave V3 on this chain. Native USDC on Ethereum mainnet (1) or Base mainnet (8453), or Aave test USDC on Sepolia (11155111). Base Sepolia (84532) uses test USDC and is available only in sandbox and local test environments.","uniqueKey":"","typeLabel":"enum\u003cinteger>"}},"ca90b13a-fcba-4342-b03c-49ffd5db5c7a":{"name":"marketId","in":"query","required":false,"description":"Market ID from the markets endpoint. Determines the chain and asset. Required if chainId is omitted. Without marketId, chainId selects Aave V3. Unsupported IDs or a mismatched chainId return 400. The sandbox-only Morpho demo market is morpho-v2-base-sepolia-demo-usdc on Base Sepolia (84532); it holds test USDC idle and earns no lending yield.","schema":{"type":"string","example":"morpho-v2-base-steakhouse-usdc","isRequired":false,"description":"Market ID from the markets endpoint. Determines the chain and asset. Required if chainId is omitted. Without marketId, chainId selects Aave V3. Unsupported IDs or a mismatched chainId return 400. The sandbox-only Morpho demo market is morpho-v2-base-sepolia-demo-usdc on Base Sepolia (84532); it holds test USDC idle and earns no lending yield.","uniqueKey":"","typeLabel":"string"}}},"responses":{"3723ea8c-9e5b-487a-9c7a-bf6bb154746e":{"description":"Current position and snapshot block.","content":{"application/json":{"schema":{"type":"object","properties":{"chainId":{"example":8453,"type":"integer","enum":[1,8453,11155111],"isRequired":true,"uniqueKey":"chainId","typeLabel":"enum\u003cinteger>"},"marketId":{"type":"string","example":"morpho-v2-base-steakhouse-usdc","isRequired":true,"uniqueKey":"marketId","typeLabel":"string"},"protocol":{"type":"string","enum":["aave-v3","morpho-v2"],"isRequired":true,"uniqueKey":"protocol","typeLabel":"enum\u003cstring>"},"asset":{"type":"string","enum":["USDC"],"isRequired":true,"uniqueKey":"asset","typeLabel":"enum\u003cstring>"},"tokenAddress":{"type":"string","isRequired":true,"uniqueKey":"tokenAddress","typeLabel":"string"},"suppliedBalance":{"type":"string","description":"Current position value in USDC decimal units, including accrued yield. Aave uses the aToken balance; Morpho uses previewRedeem for the current shares, rounding down. Not historical earnings.","isRequired":true,"uniqueKey":"suppliedBalance","typeLabel":"string"},"walletBalance":{"type":"string","description":"Wallet USDC balance in decimal units.","isRequired":true,"uniqueKey":"walletBalance","typeLabel":"string"},"withdrawal":{"type":"object","properties":{"availableAmount":{"oneOf":[{"type":"string","description":"Advisory amount in USDC units. Morpho returns the full-position previewRedeem value only when a full redemption simulation succeeds, null if it fails, and zero for an empty position. This is not an exact maximum; a partial withdrawal may still succeed. Morpho V2 maxWithdraw and maxRedeem return zero and are not used. Aave returns null for failed simulation or debt constraints, and zero for inactive or paused reserves.","isRequired":true,"uniqueKey":"withdrawal.availableAmount.oneOf.0","typeLabel":"string"},{"type":"null","description":"Advisory amount in USDC units. Morpho returns the full-position previewRedeem value only when a full redemption simulation succeeds, null if it fails, and zero for an empty position. This is not an exact maximum; a partial withdrawal may still succeed. Morpho V2 maxWithdraw and maxRedeem return zero and are not used. Aave returns null for failed simulation or debt constraints, and zero for inactive or paused reserves.","isRequired":true,"uniqueKey":"withdrawal.availableAmount.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"withdrawal.availableAmount","typeLabel":"string | null"},"advisory":{"type":"boolean","enum":[true],"isRequired":true,"uniqueKey":"withdrawal.advisory","typeLabel":"enum\u003cboolean>"},"restrictions":{"type":"array","items":{"type":"string","uniqueKey":"withdrawal.restrictions.items.[INDEX]","typeLabel":"string"},"description":"Examples: reserve_inactive, reserve_paused, collateral_or_debt_constraints, limited_reserve_liquidity, withdrawal_simulation_unavailable, zero_redeemable_assets.","isRequired":true,"uniqueKey":"withdrawal.restrictions","typeLabel":"string[]"}},"required":["availableAmount","advisory","restrictions"],"isRequired":true,"uniqueKey":"withdrawal","typeLabel":"object"},"blockNumber":{"type":"integer","isRequired":true,"uniqueKey":"blockNumber","typeLabel":"integer"},"blockTimestamp":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"blockTimestamp","typeLabel":"string\u003cdate-time>"},"availableLiquidity":{"type":"string","description":"Aave only. USDC held by the reserve aToken contract; other protocol constraints may restrict withdrawals.","uniqueKey":"availableLiquidity","typeLabel":"string"},"vaultAddress":{"type":"string","description":"Morpho only. Address of the selected Morpho V2 vault on Ethereum or Base.","example":"0xbeef0e0834849aCC03f0089F01f4F1Eeb06873C9","uniqueKey":"vaultAddress","typeLabel":"string"},"shares":{"type":"object","description":"Morpho only. Vault share balance in raw units, not a USDC amount.","properties":{"balance":{"type":"string","pattern":"^[0-9]+$","isRequired":true,"uniqueKey":"shares.balance","typeLabel":"string"},"decimals":{"type":"integer","enum":[18],"isRequired":true,"uniqueKey":"shares.decimals","typeLabel":"enum\u003cinteger>"}},"required":["balance","decimals"],"uniqueKey":"shares","typeLabel":"object"},"reserve":{"type":"object","description":"Aave only. Current reserve configuration.","properties":{"active":{"type":"boolean","isRequired":true,"uniqueKey":"reserve.active","typeLabel":"boolean"},"frozen":{"type":"boolean","isRequired":true,"uniqueKey":"reserve.frozen","typeLabel":"boolean"},"paused":{"type":"boolean","isRequired":true,"uniqueKey":"reserve.paused","typeLabel":"boolean"}},"required":["active","frozen","paused"],"uniqueKey":"reserve","typeLabel":"object"}},"required":["chainId","protocol","marketId","asset","tokenAddress","suppliedBalance","walletBalance","withdrawal","blockNumber","blockTimestamp"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"chainId":8453,"marketId":"morpho-v2-base-steakhouse-usdc","protocol":"aave-v3","asset":"USDC","tokenAddress":"\u003cstring>","suppliedBalance":"\u003cstring>","walletBalance":"\u003cstring>","withdrawal":{"availableAmount":"\u003cstring>","advisory":true,"restrictions":["\u003cstring>"]},"blockNumber":123,"blockTimestamp":"2023-11-07T05:31:56Z","availableLiquidity":"\u003cstring>","vaultAddress":"0xbeef0e0834849aCC03f0089F01f4F1Eeb06873C9","shares":{"balance":"\u003cstring>","decimals":18},"reserve":{"active":true,"frozen":true,"paused":true}}}},"exampleType":"generated"}},"exampleType":"generated"},"0e2c65de-7b43-46b2-b00e-18507aa7386e":{"description":"Invalid request body","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"INVALID_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"transactionId":{"type":"string","format":"uuid","description":"Persisted transaction record id. Present only when a broadcast request failed after a history row was created.","uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"failureStage":{"type":"string","enum":["mpc_sign","signature_apply","signer_verify","broadcast","monitor_timeout"],"description":"Which stage of the broadcast lifecycle failed. Present on persisted broadcast failures.","uniqueKey":"failureStage","typeLabel":"enum\u003cstring>"},"failureCode":{"type":"string","description":"Machine-readable failure reason from the underlying broadcast helper (e.g. `INSUFFICIENT_NATIVE_BALANCE`, `EXECUTION_FAILED`). Present on broadcast-stage failures.","uniqueKey":"failureCode","typeLabel":"string"},"signedTransaction":{"type":"string","description":"Legacy signed transaction bytes on broadcast failures after signing. Sponsored responses never expose signed payloads.","uniqueKey":"signedTransaction","typeLabel":"string"}},"additionalProperties":true,"description":"All error responses include `code` and `message` fields. Some errors include extra fields (e.g. `walletId` on 409 Conflict).\nBroadcast failures that occur after a persisted transaction row is created include `transactionId`,\n`failureStage`, and (on broadcast-stage failures) `failureCode`, and also set the `x-transaction-id`\nresponse header. Legacy failures after signing can include `signedTransaction` for inspecting\nthe already-signed bytes. Sponsored responses never expose signed payloads; recover the original\noperation with its tracking ID or original request and idempotency key.\n\nCommon error codes: `INVALID_REQUEST`, `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `CONFLICT`, `WALLET_ALREADY_EXISTS`, `WALLET_ALREADY_CLAIMED`, `RATE_LIMITED`, `INTERNAL_ERROR`.\n","uniqueKey":"","typeLabel":"object"},"example":{"code":"INVALID_REQUEST","message":"type must be one of EVM, SOLANA, COSMOS, STELLAR, SUI"},"examples":{"Example":{"title":"Example","value":{"code":"INVALID_REQUEST","message":"type must be one of EVM, SOLANA, COSMOS, STELLAR, SUI"}}},"exampleType":"examples"}},"exampleType":"examples"},"38f9d5a9-6410-4be7-b1e0-01d1a929ed71":{"description":"API key not provided","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"INVALID_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"transactionId":{"type":"string","format":"uuid","description":"Persisted transaction record id. Present only when a broadcast request failed after a history row was created.","uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"failureStage":{"type":"string","enum":["mpc_sign","signature_apply","signer_verify","broadcast","monitor_timeout"],"description":"Which stage of the broadcast lifecycle failed. Present on persisted broadcast failures.","uniqueKey":"failureStage","typeLabel":"enum\u003cstring>"},"failureCode":{"type":"string","description":"Machine-readable failure reason from the underlying broadcast helper (e.g. `INSUFFICIENT_NATIVE_BALANCE`, `EXECUTION_FAILED`). Present on broadcast-stage failures.","uniqueKey":"failureCode","typeLabel":"string"},"signedTransaction":{"type":"string","description":"Legacy signed transaction bytes on broadcast failures after signing. Sponsored responses never expose signed payloads.","uniqueKey":"signedTransaction","typeLabel":"string"}},"additionalProperties":true,"description":"All error responses include `code` and `message` fields. Some errors include extra fields (e.g. `walletId` on 409 Conflict).\nBroadcast failures that occur after a persisted transaction row is created include `transactionId`,\n`failureStage`, and (on broadcast-stage failures) `failureCode`, and also set the `x-transaction-id`\nresponse header. Legacy failures after signing can include `signedTransaction` for inspecting\nthe already-signed bytes. Sponsored responses never expose signed payloads; recover the original\noperation with its tracking ID or original request and idempotency key.\n\nCommon error codes: `INVALID_REQUEST`, `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `CONFLICT`, `WALLET_ALREADY_EXISTS`, `WALLET_ALREADY_CLAIMED`, `RATE_LIMITED`, `INTERNAL_ERROR`.\n","uniqueKey":"","typeLabel":"object"},"example":{"code":"UNAUTHORIZED","message":"secret api key not provided"},"examples":{"Example":{"title":"Example","value":{"code":"UNAUTHORIZED","message":"secret api key not provided"}}},"exampleType":"examples"}},"exampleType":"examples"},"059879bb-0f23-4540-b0b1-6eb27fe4819d":{"description":"Invalid API key","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"INVALID_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"transactionId":{"type":"string","format":"uuid","description":"Persisted transaction record id. Present only when a broadcast request failed after a history row was created.","uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"failureStage":{"type":"string","enum":["mpc_sign","signature_apply","signer_verify","broadcast","monitor_timeout"],"description":"Which stage of the broadcast lifecycle failed. Present on persisted broadcast failures.","uniqueKey":"failureStage","typeLabel":"enum\u003cstring>"},"failureCode":{"type":"string","description":"Machine-readable failure reason from the underlying broadcast helper (e.g. `INSUFFICIENT_NATIVE_BALANCE`, `EXECUTION_FAILED`). Present on broadcast-stage failures.","uniqueKey":"failureCode","typeLabel":"string"},"signedTransaction":{"type":"string","description":"Legacy signed transaction bytes on broadcast failures after signing. Sponsored responses never expose signed payloads.","uniqueKey":"signedTransaction","typeLabel":"string"}},"additionalProperties":true,"description":"All error responses include `code` and `message` fields. Some errors include extra fields (e.g. `walletId` on 409 Conflict).\nBroadcast failures that occur after a persisted transaction row is created include `transactionId`,\n`failureStage`, and (on broadcast-stage failures) `failureCode`, and also set the `x-transaction-id`\nresponse header. Legacy failures after signing can include `signedTransaction` for inspecting\nthe already-signed bytes. Sponsored responses never expose signed payloads; recover the original\noperation with its tracking ID or original request and idempotency key.\n\nCommon error codes: `INVALID_REQUEST`, `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `CONFLICT`, `WALLET_ALREADY_EXISTS`, `WALLET_ALREADY_CLAIMED`, `RATE_LIMITED`, `INTERNAL_ERROR`.\n","uniqueKey":"","typeLabel":"object"},"example":{"code":"FORBIDDEN","message":"invalid secret api key"},"examples":{"Example":{"title":"Example","value":{"code":"FORBIDDEN","message":"invalid secret api key"}}},"exampleType":"examples"}},"exampleType":"examples"},"9e6f3901-d97e-43f5-a732-b285fdd6e1a9":{"description":"Wallet not found","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"INVALID_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"transactionId":{"type":"string","format":"uuid","description":"Persisted transaction record id. Present only when a broadcast request failed after a history row was created.","uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"failureStage":{"type":"string","enum":["mpc_sign","signature_apply","signer_verify","broadcast","monitor_timeout"],"description":"Which stage of the broadcast lifecycle failed. Present on persisted broadcast failures.","uniqueKey":"failureStage","typeLabel":"enum\u003cstring>"},"failureCode":{"type":"string","description":"Machine-readable failure reason from the underlying broadcast helper (e.g. `INSUFFICIENT_NATIVE_BALANCE`, `EXECUTION_FAILED`). Present on broadcast-stage failures.","uniqueKey":"failureCode","typeLabel":"string"},"signedTransaction":{"type":"string","description":"Legacy signed transaction bytes on broadcast failures after signing. Sponsored responses never expose signed payloads.","uniqueKey":"signedTransaction","typeLabel":"string"}},"additionalProperties":true,"description":"All error responses include `code` and `message` fields. Some errors include extra fields (e.g. `walletId` on 409 Conflict).\nBroadcast failures that occur after a persisted transaction row is created include `transactionId`,\n`failureStage`, and (on broadcast-stage failures) `failureCode`, and also set the `x-transaction-id`\nresponse header. Legacy failures after signing can include `signedTransaction` for inspecting\nthe already-signed bytes. Sponsored responses never expose signed payloads; recover the original\noperation with its tracking ID or original request and idempotency key.\n\nCommon error codes: `INVALID_REQUEST`, `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `CONFLICT`, `WALLET_ALREADY_EXISTS`, `WALLET_ALREADY_CLAIMED`, `RATE_LIMITED`, `INTERNAL_ERROR`.\n","uniqueKey":"","typeLabel":"object"},"example":{"code":"NOT_FOUND","message":"wallet not found"},"examples":{"Example":{"title":"Example","value":{"code":"NOT_FOUND","message":"wallet not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"d55a1520-e5ac-4ce8-990b-45111a943eea":{"description":"Wallet is not ready for signing.","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"INVALID_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"transactionId":{"type":"string","format":"uuid","description":"Persisted transaction record id. Present only when a broadcast request failed after a history row was created.","uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"failureStage":{"type":"string","enum":["mpc_sign","signature_apply","signer_verify","broadcast","monitor_timeout"],"description":"Which stage of the broadcast lifecycle failed. Present on persisted broadcast failures.","uniqueKey":"failureStage","typeLabel":"enum\u003cstring>"},"failureCode":{"type":"string","description":"Machine-readable failure reason from the underlying broadcast helper (e.g. `INSUFFICIENT_NATIVE_BALANCE`, `EXECUTION_FAILED`). Present on broadcast-stage failures.","uniqueKey":"failureCode","typeLabel":"string"},"signedTransaction":{"type":"string","description":"Legacy signed transaction bytes on broadcast failures after signing. Sponsored responses never expose signed payloads.","uniqueKey":"signedTransaction","typeLabel":"string"}},"additionalProperties":true,"description":"All error responses include `code` and `message` fields. Some errors include extra fields (e.g. `walletId` on 409 Conflict).\nBroadcast failures that occur after a persisted transaction row is created include `transactionId`,\n`failureStage`, and (on broadcast-stage failures) `failureCode`, and also set the `x-transaction-id`\nresponse header. Legacy failures after signing can include `signedTransaction` for inspecting\nthe already-signed bytes. Sponsored responses never expose signed payloads; recover the original\noperation with its tracking ID or original request and idempotency key.\n\nCommon error codes: `INVALID_REQUEST`, `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `CONFLICT`, `WALLET_ALREADY_EXISTS`, `WALLET_ALREADY_CLAIMED`, `RATE_LIMITED`, `INTERNAL_ERROR`.\n","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"INVALID_REQUEST","message":"\u003cstring>","transactionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","failureStage":"mpc_sign","failureCode":"\u003cstring>","signedTransaction":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"120dc36c-db7c-41ae-97e7-c4efab9922b5":{"description":"Rate limit exceeded","headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds until the rate limit window resets","example":60}},"content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"INVALID_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"transactionId":{"type":"string","format":"uuid","description":"Persisted transaction record id. Present only when a broadcast request failed after a history row was created.","uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"failureStage":{"type":"string","enum":["mpc_sign","signature_apply","signer_verify","broadcast","monitor_timeout"],"description":"Which stage of the broadcast lifecycle failed. Present on persisted broadcast failures.","uniqueKey":"failureStage","typeLabel":"enum\u003cstring>"},"failureCode":{"type":"string","description":"Machine-readable failure reason from the underlying broadcast helper (e.g. `INSUFFICIENT_NATIVE_BALANCE`, `EXECUTION_FAILED`). Present on broadcast-stage failures.","uniqueKey":"failureCode","typeLabel":"string"},"signedTransaction":{"type":"string","description":"Legacy signed transaction bytes on broadcast failures after signing. Sponsored responses never expose signed payloads.","uniqueKey":"signedTransaction","typeLabel":"string"}},"additionalProperties":true,"description":"All error responses include `code` and `message` fields. Some errors include extra fields (e.g. `walletId` on 409 Conflict).\nBroadcast failures that occur after a persisted transaction row is created include `transactionId`,\n`failureStage`, and (on broadcast-stage failures) `failureCode`, and also set the `x-transaction-id`\nresponse header. Legacy failures after signing can include `signedTransaction` for inspecting\nthe already-signed bytes. Sponsored responses never expose signed payloads; recover the original\noperation with its tracking ID or original request and idempotency key.\n\nCommon error codes: `INVALID_REQUEST`, `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `CONFLICT`, `WALLET_ALREADY_EXISTS`, `WALLET_ALREADY_CLAIMED`, `RATE_LIMITED`, `INTERNAL_ERROR`.\n","uniqueKey":"","typeLabel":"object"},"example":{"code":"RATE_LIMITED","message":"Rate limit exceeded, try again shortly."},"examples":{"Example":{"title":"Example","value":{"code":"RATE_LIMITED","message":"Rate limit exceeded, try again shortly."}}},"exampleType":"examples"}},"exampleType":"examples"},"fd413312-c7dc-40ef-a3ae-5215dccd2792":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Machine-readable error code for programmatic handling","example":"INVALID_REQUEST","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"transactionId":{"type":"string","format":"uuid","description":"Persisted transaction record id. Present only when a broadcast request failed after a history row was created.","uniqueKey":"transactionId","typeLabel":"string\u003cuuid>"},"failureStage":{"type":"string","enum":["mpc_sign","signature_apply","signer_verify","broadcast","monitor_timeout"],"description":"Which stage of the broadcast lifecycle failed. Present on persisted broadcast failures.","uniqueKey":"failureStage","typeLabel":"enum\u003cstring>"},"failureCode":{"type":"string","description":"Machine-readable failure reason from the underlying broadcast helper (e.g. `INSUFFICIENT_NATIVE_BALANCE`, `EXECUTION_FAILED`). Present on broadcast-stage failures.","uniqueKey":"failureCode","typeLabel":"string"},"signedTransaction":{"type":"string","description":"Legacy signed transaction bytes on broadcast failures after signing. Sponsored responses never expose signed payloads.","uniqueKey":"signedTransaction","typeLabel":"string"}},"additionalProperties":true,"description":"All error responses include `code` and `message` fields. Some errors include extra fields (e.g. `walletId` on 409 Conflict).\nBroadcast failures that occur after a persisted transaction row is created include `transactionId`,\n`failureStage`, and (on broadcast-stage failures) `failureCode`, and also set the `x-transaction-id`\nresponse header. Legacy failures after signing can include `signedTransaction` for inspecting\nthe already-signed bytes. Sponsored responses never expose signed payloads; recover the original\noperation with its tracking ID or original request and idempotency key.\n\nCommon error codes: `INVALID_REQUEST`, `UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `CONFLICT`, `WALLET_ALREADY_EXISTS`, `WALLET_ALREADY_CLAIMED`, `RATE_LIMITED`, `INTERNAL_ERROR`.\n","uniqueKey":"","typeLabel":"object"},"example":{"code":"INTERNAL_ERROR","message":"Internal Server Error"},"examples":{"Example":{"title":"Example","value":{"code":"INTERNAL_ERROR","message":"Internal Server Error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"90b4b28c-bdd5-4c66-b5b8-caf6c9c9df3d":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your partner secret key (server-side only)","x-default":"sk_your_secret_key_here","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"84e136c7-b7b8-4f59-9f7c-86990ff9ffe0":{"url":"https://api.beta.getpara.com","description":"Beta"},"42d2d9d7-05ba-4437-820b-f5afc2833189":{"url":"https://api.getpara.com","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Your partner secret key (server-side only)","x-default":"sk_your_secret_key_here","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"Your partner secret key (server-side only)","isRequired":true,"default":"sk_your_secret_key_here","typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"getpara","siteName":"Para Docs","title":"Get position - Para Docs","navMaps":{"firstHrefInVersion":{"3.0 (Current)":{"href":"/v3/rest/api/yield/get-position","matchLevel":0},"2.0 (LTS)":{"href":"/v2/rest/api/yield/get-position","matchLevel":1}},"firstHrefInLanguage":{}},"lastModified":"2026-10-30T16:10:29.434Z","originalFileLocation":"v3/rest/api/yield/get-position.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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=\"Get the wallet\u0026#x27;s supplied USDC balance and estimated withdrawal availability in the selected market. Provide marketId or chainId. Para derives the chain from marketId; chainId alone selects Aave V3. If both are supplied, they must identify the same chain.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Para Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/getpara/0DxXdBBXXRUUv88T/_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/getpara/0DxXdBBXXRUUv88T/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/getpara/0DxXdBBXXRUUv88T/_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/getpara/0DxXdBBXXRUUv88T/_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/getpara/0DxXdBBXXRUUv88T/_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/getpara/0DxXdBBXXRUUv88T/_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/getpara/0DxXdBBXXRUUv88T/_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/getpara/0DxXdBBXXRUUv88T/_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/getpara/0DxXdBBXXRUUv88T/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get position - Para Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get the wallet\u0026#x27;s supplied USDC balance and estimated withdrawal availability in the selected market. Provide marketId or chainId. Para derives the chain from marketId; chainId alone selects Aave V3. If both are supplied, they must identify the same chain.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Para Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getpara.com/v3/rest/api/yield/get-position\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://getpara.mintlify.site/_mintlify/api/og/v2?division=Yield\u0026amp;title=Get+position\u0026amp;description=Get+the+wallet%27s+supplied+USDC+balance+and+estimated+withdrawal+availability+in+the+selected+market.+Provide+marketId+or+chainId.+Para+derives+the+chain+from+ma\u0026amp;theme=9bbe966b673f4a3310f46488\u0026amp;signature=8f17e9c528031a54a514fbe4bbf70acf160e37ceec5c41eb02f9c6c79eccdf4b\">\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 position - Para Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get the wallet\u0026#x27;s supplied USDC balance and estimated withdrawal availability in the selected market. Provide marketId or chainId. Para derives the chain from marketId; chainId alone selects Aave V3. If both are supplied, they must identify the same chain.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://getpara.mintlify.site/_mintlify/api/og/v2?division=Yield\u0026amp;title=Get+position\u0026amp;description=Get+the+wallet%27s+supplied+USDC+balance+and+estimated+withdrawal+availability+in+the+selected+market.+Provide+marketId+or+chainId.+Para+derives+the+chain+from+ma\u0026amp;theme=9bbe966b673f4a3310f46488\u0026amp;signature=8f17e9c528031a54a514fbe4bbf70acf160e37ceec5c41eb02f9c6c79eccdf4b\">\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/getpara/0DxXdBBXXRUUv88T/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Para Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF4E00\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getpara.com/v3/rest/api/yield/get-position\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/v3/rest/api/yield/get-position.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getpara.com/#organization\",\"name\":\"Para Docs\",\"url\":\"https://docs.getpara.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/getpara/30lQMU2mHiFlT8O0/logo/light.svg?fit=max\u0026auto=format\u0026n=30lQMU2mHiFlT8O0\u0026q=85\u0026s=342b25f634bb7c26fefb0769da8f0555\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getpara.com#website\",\"name\":\"Para Docs\",\"url\":\"https://docs.getpara.com\",\"publisher\":{\"@id\":\"https://docs.getpara.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getpara.com/v3/rest/api/yield/get-position#webpage\",\"url\":\"https://docs.getpara.com/v3/rest/api/yield/get-position\",\"name\":\"Get position\",\"description\":\"Get the wallet's supplied USDC balance and estimated withdrawal availability in the selected market. Provide marketId or chainId. Para derives the chain from marketId; chainId alone selects Aave V3. If both are supplied, they must identify the same chain.\",\"dateModified\":\"2026-10-30T16:10:29.434Z\",\"isPartOf\":{\"@id\":\"https://docs.getpara.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getpara.com/v3/rest/api/yield/get-position#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getpara.com/v3/rest/api/yield/get-position#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.getpara.com/v3/rest/api/yield/list-markets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Yield\",\"item\":\"https://docs.getpara.com/v3/rest/api/yield/list-markets\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get position\",\"item\":\"https://docs.getpara.com/v3/rest/api/yield/get-position\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getpara.com/v3/rest/api/yield/get-position#apireference\",\"headline\":\"Get position\",\"name\":\"Get position\",\"description\":\"Get the wallet's supplied USDC balance and estimated withdrawal availability in the selected market. Provide marketId or chainId. Para derives the chain from marketId; chainId alone selects Aave V3. If both are supplied, they must identify the same chain.\",\"url\":\"https://docs.getpara.com/v3/rest/api/yield/get-position\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getpara.com/v3/rest/api/yield/get-position#webpage\"},\"dateModified\":\"2026-10-30T16:10:29.434Z\",\"publisher\":{\"@id\":\"https://docs.getpara.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getpara.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Para Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Para Docs","nav":{"global":{"anchors":[]},"versions":[{"version":"3.0 (Current)","default":true,"tag":"Latest","tabs":[{"tab":"Plan","icon":"compass","pages":[{"title":"Plan","href":"/v3/introduction/welcome"}]},{"tab":"Build","icon":"code","anchors":[{"anchor":"React \u0026 Web","icon":"react","pages":[{"title":"React \u0026 Web","href":"/v3/react/quickstart"}]},{"anchor":"REST API","icon":"server","groups":[{"group":"Get Started","icon":"rocket","pages":[{"title":"REST API","sidebarTitle":"Get Started","icon":"server","href":"/v3/rest/overview"}]},{"group":"Set Up Project","icon":"wrench","pages":[{"title":"Setup","sidebarTitle":"Setup","icon":"wrench","href":"/v3/rest/setup"},{"title":"REST SDK","sidebarTitle":"REST SDK","icon":"code","href":"/v3/rest/sdk"},{"group":"Developer Portal","icon":"gear","pages":[{"title":"Get Your API Key","sidebarTitle":"Get Your API Key","icon":"key","href":"/v3/rest/setup/developer-portal-setup"},{"title":"Developer Portal Email Branding","sidebarTitle":"Brand Your Emails","icon":"envelope","href":"/v3/rest/setup/developer-portal-email-branding"},{"title":"Developer Portal Payment Integration","sidebarTitle":"Set Up Fiat Onramps","icon":"credit-card","href":"/v3/rest/setup/developer-portal-payments"},{"title":"Developer Portal Security Settings","sidebarTitle":"Manage App Security","icon":"shield","href":"/v3/rest/setup/developer-portal-security"}]}]},{"group":"Create and Manage Wallets","icon":"wallet","pages":[{"title":"Bring your own auth","sidebarTitle":"BYO auth","icon":"user-lock","href":"/v3/rest/byo-auth"},{"title":"Wallet Lifecycle by Wallet Type","sidebarTitle":"Wallet Lifecycle","icon":"wallet","href":"/v3/rest/wallet-lifecycle"},{"title":"Multiple Wallets per User","sidebarTitle":"Multi-Wallet Setup","icon":"wallet","href":"/v3/rest/multi-wallet"}]},{"group":"Sign and Transact","icon":"signature","pages":[{"title":"Sign Messages by Wallet Type","sidebarTitle":"Sign Messages","icon":"signature","href":"/v3/rest/signing"},{"title":"Transaction Signing by Wallet Type","sidebarTitle":"Sign Transactions","icon":"signature","href":"/v3/rest/transaction-signing"},{"title":"Gas Sponsorship","sidebarTitle":"Gas Sponsorship","icon":"gas-pump","href":"/v3/rest/gas-sponsorship"},{"title":"Automatic Fee Retry","sidebarTitle":"Automatic Fee Retry","icon":"arrows-rotate","href":"/v3/rest/automatic-retry"},{"title":"Yield","sidebarTitle":"Yield","icon":"coins","href":"/v3/rest/yield"},{"title":"Transaction History","sidebarTitle":"Transaction History","icon":"clock-rotate-left","href":"/v3/rest/transaction-history"}]},{"group":"Add Permissions","icon":"shield-check","pages":[{"title":"Guardrails for app-owned wallets","sidebarTitle":"Overview","icon":"shield-check","href":"/v3/rest/permissions"},{"title":"Create policies in the Developer Portal","sidebarTitle":"Developer Portal","icon":"sliders","href":"/v3/rest/permissions/developer-portal"},{"title":"Write policy JSON","sidebarTitle":"Write policy JSON","icon":"code","href":"/v3/rest/permissions/json"},{"title":"Test your policies","sidebarTitle":"Test your policies","icon":"flask","href":"/v3/rest/permissions/testing"},{"title":"Go to production","sidebarTitle":"Go to production","icon":"rocket","href":"/v3/rest/permissions/production"},{"group":"Templates","pages":[{"title":"Guardrail templates","sidebarTitle":"Overview","icon":"copy","href":"/v3/rest/permissions/templates"},{"title":"Spending caps","sidebarTitle":"Spending caps","icon":"file-code","href":"/v3/rest/permissions/templates/spending-caps"},{"title":"Recipient and contract allowlists","sidebarTitle":"Allowlists","icon":"file-code","href":"/v3/rest/permissions/templates/allowlists"},{"title":"Approval thresholds and tiers","sidebarTitle":"Approval tiers","icon":"file-code","href":"/v3/rest/permissions/templates/approval-tiers"},{"title":"Treasury approvals","sidebarTitle":"Treasury","icon":"file-code","href":"/v3/rest/permissions/templates/treasury"},{"title":"Message and raw signing","sidebarTitle":"Message signing","icon":"file-code","href":"/v3/rest/permissions/templates/message-signing"}]},{"group":"Advanced","pages":[{"title":"Conditional approvals","sidebarTitle":"Conditional approvals","icon":"users","href":"/v3/rest/permissions/conditional-approvals"},{"title":"Collect approval signatures","sidebarTitle":"Approval signatures","icon":"signature","href":"/v3/rest/permissions/approval-signatures"},{"title":"Adjustable parameters","sidebarTitle":"Adjustable parameters","icon":"gauge","href":"/v3/rest/permissions/adjustable-parameters"},{"title":"Signing delegation","sidebarTitle":"Signing delegation","icon":"clock-rotate-left","href":"/v3/rest/permissions/signing-delegation"},{"title":"Manage the policy lifecycle","sidebarTitle":"Policy lifecycle","icon":"rotate","href":"/v3/rest/permissions/lifecycle"},{"title":"Manage permissions from your backend","sidebarTitle":"Backend administration","icon":"server","href":"/v3/rest/permissions-administration"}]}]},{"group":"Use Pregeneration","icon":"key","pages":[{"title":"Migrate SDK pregen wallets to REST API","sidebarTitle":"Migrate from SDK pregen","icon":"arrow-right-arrow-left","href":"/v3/rest/migrate-from-sdk-pregen"}]},{"group":"Endpoints","pages":[{"group":"Yield","pages":[{"title":"List markets","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/wallets/{walletId}/yield/markets","href":"/v3/rest/api/yield/list-markets"},{"title":"Deposit","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/yield/deposits","href":"/v3/rest/api/yield/deposit"},{"title":"Withdraw","description":"Withdraw some or all supplied USDC from the selected market to the same wallet.\n\nOptional autoRetry reuses shared same-nonce recovery per existing phase, with separately\nauthorized approval/action execution-gas ceilings and one original operation deadline.\nAction authorization is required; a needed approval requires an explicit approval ceiling.\nInclude an approval ceiling on deposits unless existing allowance is known to cover the amount;\nwithdrawals never prepare an approval transaction.\nFees rise by at least 12.5%, rounded up, at least 60 seconds after the last EVM broadcast,\nusing fresh higher estimates when affordable. No fixed retry count or fresh-nonce replay.\nEvery attempt checks current authority, policy and same-transaction accounting;\nincompatible accounting fails closed before signing. An initial review does not\nauthorize changed fees or guarantee that an approved spend overage can be reused. Replacements reuse phase principal accounting, while a\nlater action is separately evaluated. Approval must confirm before action signing.\nIf authorization expires between phases, confirmed approval progress remains visible\nand the unsigned action does not execute. Potentially submitted attempts remain monitored.\n","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/yield/withdrawals","href":"/v3/rest/api/yield/withdraw"},{"title":"Get position","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/wallets/{walletId}/yield/position","href":"/v3/rest/api/yield/get-position"},{"title":"Get operation","description":"Get the current status, transactions, and any error for a yield operation.","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/wallets/{walletId}/yield/operations/{operationId}","href":"/v3/rest/api/yield/get-operation"},{"title":"Cancel operation","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/yield/operations/{operationId}/cancel","href":"/v3/rest/api/yield/cancel-operation"}]},{"group":"Screening","pages":[{"title":"Get Address Screening Status","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/address-screening/status","href":"/v3/rest/api/screening/get-address-screening-status"}]},{"group":"Wallets","pages":[{"title":"List Wallets","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/wallets","href":"/v3/rest/api/wallets/list-wallets"},{"title":"Create Wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets","href":"/v3/rest/api/wallets/create-wallet"},{"title":"Get Wallet","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/wallets/{walletId}","href":"/v3/rest/api/wallets/get-wallet"},{"title":"Update Wallet Identifier","deprecated":null,"version":null,"openapi":"/openapi.yaml patch /v1/wallets/{walletId}","href":"/v3/rest/api/wallets/update-wallet-identifier"},{"title":"Migrate SDK Pregen Wallet Share","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/migrate-share","href":"/v3/rest/api/wallets/migrate-sdk-pregen-wallet-share"},{"title":"Get Wallet Balance","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/wallets/{walletId}/balance","href":"/v3/rest/api/wallets/get-wallet-balance"}]},{"group":"Enclave","pages":[{"title":"Get Enclave Public Key","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/enclave/public-key","href":"/v3/rest/api/enclave/get-enclave-public-key"}]},{"group":"Signing","pages":[{"title":"Sign Raw","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/sign-raw","href":"/v3/rest/api/signing/sign-raw"},{"title":"Sign Transaction","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/sign-transaction","href":"/v3/rest/api/signing/sign-transaction"},{"title":"Sign Message","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/sign-message","href":"/v3/rest/api/signing/sign-message"},{"title":"Sign Typed Data","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/sign-typed-data","href":"/v3/rest/api/signing/sign-typed-data"},{"title":"Sign Authorization (EIP-7702)","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/sign-authorization","href":"/v3/rest/api/signing/sign-authorization-eip-7702"},{"title":"Transfer","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/transfer","href":"/v3/rest/api/signing/transfer"},{"title":"List Transactions","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/wallets/{walletId}/transactions","href":"/v3/rest/api/signing/list-transactions"},{"title":"Get Transaction","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/wallets/{walletId}/transactions/{transactionId}","href":"/v3/rest/api/signing/get-transaction"},{"title":"Speed Up Transfer","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/transactions/{transactionId}/speed-up","href":"/v3/rest/api/signing/speed-up-transfer"},{"title":"Cancel Transfer","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/transactions/{transactionId}/cancel","href":"/v3/rest/api/signing/cancel-transfer"},{"title":"Resume Sponsored Transaction","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/transactions/{transactionId}/resume","href":"/v3/rest/api/signing/resume-sponsored-transaction"},{"title":"Estimate Transfer Fee","deprecated":null,"version":null,"openapi":"/openapi.yaml post /v1/wallets/{walletId}/estimate-fee","href":"/v3/rest/api/signing/estimate-transfer-fee"}]},{"group":"Faucet","pages":[{"title":"Request Testnet Tokens","deprecated":null,"version":null,"openapi":"/openapi.yaml post /faucet","href":"/v3/rest/api/faucet/request-testnet-tokens"}]},{"group":"On-Ramp","pages":[{"title":"Get On-Ramp Purchase","deprecated":null,"version":null,"openapi":"/openapi.yaml get /v1/onramp/purchases/{purchaseId}","href":"/v3/rest/api/on-ramp/get-on-ramp-purchase"}]}]}]},{"anchor":"Node \u0026 Server","icon":"server","pages":[{"title":"Node \u0026 Server","href":"/v3/server/overview"}]},{"anchor":"React Native","icon":"react","pages":[{"title":"React Native","href":"/v3/react-native/quickstart"}]},{"anchor":"Flutter","icon":"flutter","pages":[{"title":"Flutter","href":"/v3/flutter/overview"}]},{"anchor":"Swift","icon":"swift","pages":[{"title":"Swift","href":"/v3/swift/overview"}]},{"anchor":"Partner Network","icon":"list-check","pages":[{"title":"Partner Network","href":"/v3/walkthroughs/overview"}]}]},{"tab":"Tools","icon":"terminal","pages":[{"title":"Tools","href":"/v3/developer-tools/overview"}]},{"tab":"Reference","icon":"book-open","pages":[{"title":"Reference","href":"/v3/references/overview"}]}]},{"version":"2.0 (LTS)","pages":[{"title":"2.0 (LTS)","href":"/v2/rest/api/yield/get-position"}]}]},"basePath":"","title":"Get position - Para Docs","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"]}