{
"code": "INVALID_SYMBOL",
"message": "One of the request parameters is invalid.",
"documentation": "https://docs.ondo.finance/api-reference/error-codes#invalid_symbol"
}
{
"code": "MISSING_API_KEY",
"message": "missing API key",
"documentation": "https://docs.ondo.finance/api-reference/error-codes#missing_api_key"
}
{
"code": "INTERNAL_ERROR",
"message": "An internal server error occurred. Please see the returned message and documentation for details.",
"documentation": "https://docs.ondo.finance/api-reference/error-codes#internal_error"
}
Chains
Get Token Balances for a User or Token
This endpoint retrieves all token balances for a GM Chain. Results can be optionally filtered by tokenAddress, userAddress, or both parameters together. If no filters are provided, all balances on the chain will be returned.
For caching details on this endpoint, please see: Endpoint Caching.
GET
/
v1
/
chains
/
{chainId}
/
balances
Get Token Balances for a User or Token
curl --request GET \ --url https://api.gm.ondo.finance/v1/chains/{chainId}/balances \ --header 'x-api-key: <api-key>'
{
"code": "INVALID_SYMBOL",
"message": "One of the request parameters is invalid.",
"documentation": "https://docs.ondo.finance/api-reference/error-codes#invalid_symbol"
}
{
"code": "MISSING_API_KEY",
"message": "missing API key",
"documentation": "https://docs.ondo.finance/api-reference/error-codes#missing_api_key"
}
{
"code": "INTERNAL_ERROR",
"message": "An internal server error occurred. Please see the returned message and documentation for details.",
"documentation": "https://docs.ondo.finance/api-reference/error-codes#internal_error"
}
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Ondo Finance","colors":{"primary":"#365F9F","light":"#5A86CC","dark":"#1C3966"},"logo":{"light":"https://mintcdn.com/ondofinance-8a00cd96/KRJ38X1ymyGq9hDd/logo/Ondo-Logo-Black.png?fit=max\u0026auto=format\u0026n=KRJ38X1ymyGq9hDd\u0026q=85\u0026s=8858176a6886b62337d48bad288c4e83","dark":"https://mintcdn.com/ondofinance-8a00cd96/KRJ38X1ymyGq9hDd/logo/Ondo-Logo-White.png?fit=max\u0026auto=format\u0026n=KRJ38X1ymyGq9hDd\u0026q=85\u0026s=5d52e84d469664158e15ce73c9cd5880"},"favicon":"https://mintcdn.com/ondofinance-8a00cd96/KRJ38X1ymyGq9hDd/favicon.svg?fit=max\u0026auto=format\u0026n=KRJ38X1ymyGq9hDd\u0026q=85\u0026s=835531c1673eb1bfeccbe9db3400ff31","navbar":{"links":[{"href":"mailto:support@ondo.finance","label":"Support"}]},"footer":{"socials":{"x":"https://x.com/ondofinance","github":"https://github.com/ondoprotocol"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Ondo Finance Website","icon":"globe","href":"https://ondo.finance"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ondofinance-8a00cd96","hasAudioNarration":false,"actualSubdomain":"ondofinance-8a00cd96","customDomains":["docs.ondo.finance"],"gitSource":{"type":"github","owner":"ondoprotocol","repo":"gm-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adbb5e5dc0651879da8b8b5","collectionId":"b92704ea-d39b-4a13-a4b7-8716f6f36f35","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adbb5e5dc0651879da8b8b5"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adbb5e5dc0651879da8b8b5","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Documentation","count":91},{"language":"default","tag":"Ondo Stocks \u0026 Portfolios API Reference","count":33},{"language":"default","tag":"REST API","count":22},{"language":"default","tag":"Ondo Intelligent Portfolios","count":20},{"language":"default","tag":"Ondo Stocks","count":20},{"language":"default","tag":"OUSG","count":16},{"language":"default","tag":"OUSG Token","count":12},{"language":"default","tag":"Ondo Private Markets","count":11},{"language":"default","tag":"Assets","count":11},{"language":"default","tag":"USDY","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"global.css","content":"li,p,td,th{font-size:16px!important}span[data-as=p]{display:block;margin-bottom:1em}"},{"filePath":"style.css","content":"#sidebar .sidebar-group a{font-size:14px}#sidebar{top:calc(var(--banner-height, 0px) + 7rem)!important}.wide-table-scroll>div.overflow-x-auto{overflow:visible!important;margin:0!important}.wide-table-scroll{overflow-x:auto;background-image:linear-gradient(to left,#fff,rgba(255,255,255,0)),linear-gradient(to left,rgba(0,0,0,.2),transparent);background-position:right center,right center;background-size:40px 100%,24px 100%;background-repeat:no-repeat,no-repeat;background-attachment:local,scroll;scrollbar-width:thin;scrollbar-color:rgba(0,0,0,.4) transparent}.wide-table-scroll::-webkit-scrollbar{height:10px}.wide-table-scroll::-webkit-scrollbar-track{background:0 0}.wide-table-scroll::-webkit-scrollbar-thumb{background-color:rgba(0,0,0,.3);border-radius:5px}.wide-table-scroll::-webkit-scrollbar-thumb:hover{background-color:rgba(0,0,0,.5)}.dark .wide-table-scroll{background-image:linear-gradient(to left,#0e1116,rgba(14,17,22,0)),linear-gradient(to left,rgba(255,255,255,.2),rgba(255,255,255,0));scrollbar-color:rgba(255,255,255,.4) transparent}.dark .wide-table-scroll::-webkit-scrollbar-thumb{background-color:rgba(255,255,255,.3)}.dark .wide-table-scroll::-webkit-scrollbar-thumb:hover{background-color:rgba(255,255,255,.5)}.wide-table-scroll table{border-collapse:separate;border-spacing:0;width:max-content;min-width:100%}.wide-table-scroll table td:first-child,.wide-table-scroll table th:first-child{position:sticky;left:0;z-index:1000;background-color:#fff!important;padding-left:.75rem!important;padding-right:.75rem!important;box-shadow:2px 0 4px -2px rgba(0,0,0,.15)}.dark .wide-table-scroll table td:first-child,.dark .wide-table-scroll table th:first-child{background-color:#0e1116!important;box-shadow:2px 0 4px -2px rgba(0,0,0,.5)}"}],"page":{"pagePath":"api-reference/chains/get-token-balances-for-a-user-or-token","slug":"/api-reference/chains/get-token-balances-for-a-user-or-token","pageMetadata":{"title":"Get Token Balances for a User or Token","description":"This endpoint retrieves all token balances for a GM Chain. Results can be optionally filtered by `tokenAddress`, `userAddress`, or both parameters together. If no filters are provided, all balances on the chain will be returned.\n\nFor caching details on this endpoint, please see: [Endpoint Caching](https://docs.ondo.finance/api-reference/endpoint-caching).\n","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chains/{chainId}/balances","href":"/api-reference/chains/get-token-balances-for-a-user-or-token","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"This endpoint retrieves all token balances for a GM Chain. Results can be optionally filtered by \", _jsx(_components.code, {\n children: \"tokenAddress\"\n }), \", \", _jsx(_components.code, {\n children: \"userAddress\"\n }), \", or both parameters together. If no filters are provided, all balances on the chain will be returned.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"For caching details on this endpoint, please see: \", _jsx(_components.a, {\n href: \"https://docs.ondo.finance/api-reference/endpoint-caching\",\n children: \"Endpoint Caching\"\n }), \".\"]\n })]\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 Token Balances for a User or Token","description":"This endpoint retrieves all token balances for a GM Chain. Results can be optionally filtered by `tokenAddress`, `userAddress`, or both parameters together. If no filters are provided, all balances on the chain will be returned.\n\nFor caching details on this endpoint, please see: [Endpoint Caching](https://docs.ondo.finance/api-reference/endpoint-caching).\n","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chains/{chainId}/balances","href":"/api-reference/chains/get-token-balances-for-a-user-or-token","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ondofinance-8a00cd96/1cd03d2d2a1ddf6b/geofence.js"],"openApiReferenceData":{"operation":{"tags":["Chains"],"summary":"Get Token Balances for a User or Token","description":"This endpoint retrieves all token balances for a GM Chain. Results can be optionally filtered by `tokenAddress`, `userAddress`, or both parameters together. If no filters are provided, all balances on the chain will be returned.\n\nFor caching details on this endpoint, please see: [Endpoint Caching](https://docs.ondo.finance/api-reference/endpoint-caching).\n","operationId":"getBalances","parameters":["3291ffe4-9812-4c24-9a7a-5ccfe4b9eebb","5415fb21-31d9-41fb-875d-03921e905917","510530be-9a77-4789-9e85-4faa77d88b93"],"responses":{"200":"8f3d6229-8da6-4395-9258-66e78e908e51","400":"6bf24bae-859f-4ce9-961b-4edf474b4df5","401":"1176c193-a2ad-4233-bec4-2e6a51b22e62","429":"eedb546d-6e41-4563-bd07-b37e252e4bc9","500":"7b882fca-2309-4412-8bc0-33c24db9db0a"},"security":["9297dd62-6a03-4e90-8276-b4c7d2694ccc"],"method":"get","type":"path","servers":["8f7b30d5-94d0-41e8-b1fd-76dbcb4d9f47"],"path":"/v1/chains/{chainId}/balances","baseUrlOptions":["https://api.gm.ondo.finance"],"title":"Get Token Balances for a User or Token","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"3291ffe4-9812-4c24-9a7a-5ccfe4b9eebb":{"name":"chainId","in":"path","description":"The chain's identifier including the chain name and chain id.","required":true,"schema":{"type":"string","description":"The chain's identifier including the chain name and chain id.","enum":["ethereum-1","bsc-56","solana-900"],"isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"5415fb21-31d9-41fb-875d-03921e905917":{"name":"tokenAddress","in":"query","description":"Filter by a token contract address (optional).","schema":{"type":"string","description":"Filter by a token contract address (optional).","uniqueKey":"","typeLabel":"string"}},"510530be-9a77-4789-9e85-4faa77d88b93":{"name":"userAddress","in":"query","description":"Filter by a user wallet address (optional).","schema":{"type":"string","description":"Filter by a user wallet address (optional).","uniqueKey":"","typeLabel":"string"}}},"responses":{"8f3d6229-8da6-4395-9258-66e78e908e51":{"description":"OK","content":{"application/json":{"schema":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","properties":{"tokenAddress":{"type":"string","description":"The contract address of the token on the specified chain.","isRequired":true,"uniqueKey":"tokens.items.[INDEX].tokenAddress","typeLabel":"string"},"tokenSymbol":{"type":"string","description":"The symbol of the token on the specified chain.","isRequired":true,"uniqueKey":"tokens.items.[INDEX].tokenSymbol","typeLabel":"string"},"balances":{"type":"array","items":{"type":"object","properties":{"holderAddress":{"type":"object","properties":{"account":{"type":"string","description":"The address of the holder account.","isRequired":true,"uniqueKey":"tokens.items.[INDEX].balances.items.[INDEX].holderAddress.account","typeLabel":"string"}},"required":["account"],"isRequired":true,"uniqueKey":"tokens.items.[INDEX].balances.items.[INDEX].holderAddress","typeLabel":"object"},"balance":{"type":"string","description":"The token balanced, represented as a string-encoded decimal with up to 18 digits after the decimal point.","isRequired":true,"uniqueKey":"tokens.items.[INDEX].balances.items.[INDEX].balance","typeLabel":"string"}},"required":["holderAddress","balance"],"uniqueKey":"tokens.items.[INDEX].balances.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"tokens.items.[INDEX].balances","typeLabel":"object[]"}},"required":["tokenAddress","tokenSymbol","balances"],"uniqueKey":"tokens.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"tokens","typeLabel":"object[]"}},"required":["tokens"],"uniqueKey":"","typeLabel":"object"},"example":{"tokens":[{"tokenAddress":"0x14c3abf95cb9c93a8b82c1cdcb76d72cb87b2d4c","tokenSymbol":"AAPLon","balances":[{"holderAddress":{"account":"0x13116e8b4ffc8125b859ec60917fba540e59e55e"},"balance":"0.467583800117038432"},{"holderAddress":{"account":"0x1db995cb2b3d9679383f0e597704a41e1521f4e1"},"balance":"0.641380199330235549"}]},{"tokenAddress":"0xf6b1117ec07684d3958cad8beb1b302bfd21103f","tokenSymbol":"TSLAon","balances":[{"holderAddress":{"account":"0x00000688768803bbd44095770895ad27ad6b0d95"},"balance":"0.030594824589372964"},{"holderAddress":{"account":"0x1db995cb2b3d9679383f0e597704a41e1521f4e1"},"balance":"0.088854297224463519"}]},"..."]},"examples":{"Example":{"title":"Example","value":{"tokens":[{"tokenAddress":"0x14c3abf95cb9c93a8b82c1cdcb76d72cb87b2d4c","tokenSymbol":"AAPLon","balances":[{"holderAddress":{"account":"0x13116e8b4ffc8125b859ec60917fba540e59e55e"},"balance":"0.467583800117038432"},{"holderAddress":{"account":"0x1db995cb2b3d9679383f0e597704a41e1521f4e1"},"balance":"0.641380199330235549"}]},{"tokenAddress":"0xf6b1117ec07684d3958cad8beb1b302bfd21103f","tokenSymbol":"TSLAon","balances":[{"holderAddress":{"account":"0x00000688768803bbd44095770895ad27ad6b0d95"},"balance":"0.030594824589372964"},{"holderAddress":{"account":"0x1db995cb2b3d9679383f0e597704a41e1521f4e1"},"balance":"0.088854297224463519"}]},"..."]}}},"exampleType":"examples"}},"exampleType":"examples"},"6bf24bae-859f-4ce9-961b-4edf474b4df5":{"description":"One of the request parameters is invalid. Please see the returned message and documentation for details.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A reason code identifying the specific type of error. See the Error Codes reference for a full list of possible values.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"documentation":{"type":"string","description":"A URL to the relevant documentation for this error.","uniqueKey":"documentation","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"code":"INVALID_SYMBOL","message":"One of the request parameters is invalid.","documentation":"https://docs.ondo.finance/api-reference/error-codes#invalid_symbol"}}},"exampleType":"examples"}},"exampleType":"examples"},"1176c193-a2ad-4233-bec4-2e6a51b22e62":{"description":"Missing or invalid API key.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A reason code identifying the specific type of error. See the Error Codes reference for a full list of possible values.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"documentation":{"type":"string","description":"A URL to the relevant documentation for this error.","uniqueKey":"documentation","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"code":"MISSING_API_KEY","message":"missing API key","documentation":"https://docs.ondo.finance/api-reference/error-codes#missing_api_key"}}},"exampleType":"examples"}},"exampleType":"examples"},"eedb546d-6e41-4563-bd07-b37e252e4bc9":{"description":"The account has exceeded its rate limits. Please see the returned message and documentation for details.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A reason code identifying the specific type of error. See the Error Codes reference for a full list of possible values.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"documentation":{"type":"string","description":"A URL to the relevant documentation for this error.","uniqueKey":"documentation","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"code":"RATE_LIMITED","message":"rate limit exceeded","documentation":"https://docs.ondo.finance/api-reference/error-codes#rate_limited"}}},"exampleType":"examples"}},"exampleType":"examples"},"7b882fca-2309-4412-8bc0-33c24db9db0a":{"description":"An internal server error occurred. Please see the returned message and documentation for details.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","description":"A human-readable message providing more details about the error.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"type":"string","description":"A reason code identifying the specific type of error. See the Error Codes reference for a full list of possible values.","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"documentation":{"type":"string","description":"A URL to the relevant documentation for this error.","uniqueKey":"documentation","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"error":{"title":"error","value":{"code":"INTERNAL_ERROR","message":"An internal server error occurred. Please see the returned message and documentation for details.","documentation":"https://docs.ondo.finance/api-reference/error-codes#internal_error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"9297dd62-6a03-4e90-8276-b4c7d2694ccc":{"apiKey":{"type":"apiKey","name":"x-api-key","in":"header","scopes":[],"schemeName":"apiKey"}}},"servers":{"8f7b30d5-94d0-41e8-b1fd-76dbcb4d9f47":{"url":"https://api.gm.ondo.finance","description":"GM Backend API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","name":"x-api-key","in":"header","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"ondofinance-8a00cd96","siteName":"Ondo Finance","title":"Get Token Balances for a User or Token - Ondo Finance","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-23T19:30:54.541Z","originalFileLocation":"api-reference/chains/get-token-balances-for-a-user-or-token.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=\"This endpoint retrieves all token balances for a GM Chain. Results can be optionally filtered by tokenAddress, userAddress, or both parameters together. If no filters are provided, all balances on the chain will be returned. For caching details on this endpoint, please see: Endpoint Caching.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Ondo Finance\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ondofinance-8a00cd96/6PXaak7DbXv1F4RG/_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/ondofinance-8a00cd96/6PXaak7DbXv1F4RG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ondofinance-8a00cd96/6PXaak7DbXv1F4RG/_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/ondofinance-8a00cd96/6PXaak7DbXv1F4RG/_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/ondofinance-8a00cd96/6PXaak7DbXv1F4RG/_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/ondofinance-8a00cd96/6PXaak7DbXv1F4RG/_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/ondofinance-8a00cd96/6PXaak7DbXv1F4RG/_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/ondofinance-8a00cd96/6PXaak7DbXv1F4RG/_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/ondofinance-8a00cd96/6PXaak7DbXv1F4RG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Token Balances for a User or Token - Ondo Finance\">\u003cmeta data-mint-head property=\"og:description\" content=\"This endpoint retrieves all token balances for a GM Chain. Results can be optionally filtered by tokenAddress, userAddress, or both parameters together. If no filters are provided, all balances on the chain will be returned. For caching details on this endpoint, please see: Endpoint Caching.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Ondo Finance\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ondo.finance/api-reference/chains/get-token-balances-for-a-user-or-token\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ondofinance-8a00cd96.mintlify.app/_mintlify/api/og/v2?division=Chains\u0026amp;title=Get+Token+Balances+for+a+User+or+Token\u0026amp;description=This+endpoint+retrieves+all+token+balances+for+a+GM+Chain.+Results+can+be+optionally+filtered+by+%60tokenAddress%60%2C+%60userAddress%60%2C+or+both+parameters+together.+If+\u0026amp;theme=124ed1144ba215c41a4d23cf\u0026amp;signature=2d7f23f62c1510804b55acfd99021446b524e59d3540b15cc1fafaccdb4ba4a8\">\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 Token Balances for a User or Token - Ondo Finance\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"This endpoint retrieves all token balances for a GM Chain. Results can be optionally filtered by tokenAddress, userAddress, or both parameters together. If no filters are provided, all balances on the chain will be returned. For caching details on this endpoint, please see: Endpoint Caching.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ondofinance-8a00cd96.mintlify.app/_mintlify/api/og/v2?division=Chains\u0026amp;title=Get+Token+Balances+for+a+User+or+Token\u0026amp;description=This+endpoint+retrieves+all+token+balances+for+a+GM+Chain.+Results+can+be+optionally+filtered+by+%60tokenAddress%60%2C+%60userAddress%60%2C+or+both+parameters+together.+If+\u0026amp;theme=124ed1144ba215c41a4d23cf\u0026amp;signature=2d7f23f62c1510804b55acfd99021446b524e59d3540b15cc1fafaccdb4ba4a8\">\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/ondofinance-8a00cd96/6PXaak7DbXv1F4RG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Ondo Finance\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#365F9F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ondo.finance/api-reference/chains/get-token-balances-for-a-user-or-token\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/chains/get-token-balances-for-a-user-or-token.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ondo.finance/#organization\",\"name\":\"Ondo Finance\",\"url\":\"https://docs.ondo.finance\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ondofinance-8a00cd96/KRJ38X1ymyGq9hDd/logo/Ondo-Logo-Black.png?fit=max\u0026auto=format\u0026n=KRJ38X1ymyGq9hDd\u0026q=85\u0026s=8858176a6886b62337d48bad288c4e83\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ondo.finance#website\",\"name\":\"Ondo Finance\",\"url\":\"https://docs.ondo.finance\",\"publisher\":{\"@id\":\"https://docs.ondo.finance/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ondo.finance/api-reference/chains/get-token-balances-for-a-user-or-token#webpage\",\"url\":\"https://docs.ondo.finance/api-reference/chains/get-token-balances-for-a-user-or-token\",\"name\":\"Get Token Balances for a User or Token\",\"description\":\"This endpoint retrieves all token balances for a GM Chain. Results can be optionally filtered by tokenAddress, userAddress, or both parameters together. If no filters are provided, all balances on the chain will be returned. For caching details on this endpoint, please see: Endpoint Caching.\",\"dateModified\":\"2026-10-23T19:30:54.541Z\",\"isPartOf\":{\"@id\":\"https://docs.ondo.finance#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ondo.finance/api-reference/chains/get-token-balances-for-a-user-or-token#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ondo.finance/api-reference/chains/get-token-balances-for-a-user-or-token#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://docs.ondo.finance/api-reference/attestations/request-a-mint-or-redeem-attestation\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Token Balances for a User or Token\",\"item\":\"https://docs.ondo.finance/api-reference/chains/get-token-balances-for-a-user-or-token\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ondo.finance/api-reference/chains/get-token-balances-for-a-user-or-token#apireference\",\"headline\":\"Get Token Balances for a User or Token\",\"name\":\"Get Token Balances for a User or Token\",\"description\":\"This endpoint retrieves all token balances for a GM Chain. Results can be optionally filtered by tokenAddress, userAddress, or both parameters together. If no filters are provided, all balances on the chain will be returned. For caching details on this endpoint, please see: Endpoint Caching.\",\"url\":\"https://docs.ondo.finance/api-reference/chains/get-token-balances-for-a-user-or-token\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ondo.finance/api-reference/chains/get-token-balances-for-a-user-or-token#webpage\"},\"dateModified\":\"2026-10-23T19:30:54.541Z\",\"publisher\":{\"@id\":\"https://docs.ondo.finance/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ondo.finance#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Ondo Finance\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Ondo Finance","nav":{"global":{"anchors":[{"anchor":"Ondo Finance Website","icon":"globe","href":"https://ondo.finance"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"Ondo Stocks \u0026 Portfolios API Reference","groups":[{"group":"Home","pages":[{"title":"Overview","href":"/api-reference/overview"},{"title":"Quickstart","href":"/api-reference/quickstart"}]},{"group":"REST API","pages":[{"group":"Attestations","pages":[{"title":"Request a Mint or Redeem Attestation","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/attestations","href":"/api-reference/attestations/request-a-mint-or-redeem-attestation"},{"title":"Request a Soft Attestation Quote","deprecated":null,"version":null,"openapi":"/openapi.json post /v1/attestations/soft","href":"/api-reference/attestations/request-a-soft-attestation-quote"}]},{"group":"Assets","pages":[{"title":"Get Current Prices for All Supported Assets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/all/prices/latest","href":"/api-reference/assets/get-current-prices-for-all-supported-assets"},{"title":"Get Current Price for an Asset","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/{symbol}/prices/latest","href":"/api-reference/assets/get-current-price-for-an-asset"},{"title":"Get Enhanced Prices for All Supported Assets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/all/prices/latest/enhanced","href":"/api-reference/assets/get-enhanced-prices-for-all-supported-assets"},{"title":"Get OHLC (Open, High, Low, Close) Data for an Asset","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/{symbol}/prices/ohlc","href":"/api-reference/assets/get-ohlc-open-high-low-close-data-for-an-asset"},{"title":"Get Market Data for All Supported Assets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/all/market","href":"/api-reference/assets/get-market-data-for-all-supported-assets"},{"title":"Get Market Data for an Asset","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/{symbol}/market","href":"/api-reference/assets/get-market-data-for-an-asset"},{"title":"Get Dividend Information for an Asset","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/{symbol}/dividends","href":"/api-reference/assets/get-dividend-information-for-an-asset"},{"title":"Get All Contract Addresses Across Networks","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/all/addresses","href":"/api-reference/assets/get-all-contract-addresses-across-networks"},{"title":"Get Contract Addresses for an Asset","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/{symbol}/addresses","href":"/api-reference/assets/get-contract-addresses-for-an-asset"},{"title":"Get Metadata for All Supported Assets","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/all/metadata","href":"/api-reference/assets/get-metadata-for-all-supported-assets"},{"title":"Get Shares Multiplier History for an Asset","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/assets/{symbol}/shares-multiplier","href":"/api-reference/assets/get-shares-multiplier-history-for-an-asset"}]},{"group":"Portfolios","pages":[{"title":"Get All Portfolios","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/portfolios","href":"/api-reference/portfolios/get-all-portfolios"},{"title":"Get a Portfolio","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/portfolios/{symbol}","href":"/api-reference/portfolios/get-a-portfolio"}]},{"group":"Tickers","pages":[{"title":"Get Price and Volume Data for All Supported Tickers","description":"This endpoint retrieves the latest price and volume data for all supported tickers. A ticker represents a specific asset in the market.\n\nFor caching details on this endpoint, please see: [Endpoint Caching](https://docs.ondo.finance/api-reference/endpoint-caching).\n","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/tickers","href":"/api-reference/tickers/get-price-and-volume-data-for-all-supported-tickers"}]},{"group":"Chains","pages":[{"title":"Get Token Balances for a User or Token","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chains/{chainId}/balances","href":"/api-reference/chains/get-token-balances-for-a-user-or-token"},{"title":"Get Token Info","description":"This endpoint retrieves contract information about a token on a GM chain.\n\nFor caching details on this endpoint, please see: [Endpoint Caching](https://docs.ondo.finance/api-reference/endpoint-caching).\n","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/chains/{chainId}/tokens/{tokenAddress}/info","href":"/api-reference/chains/get-token-info"}]},{"group":"Limits","pages":[{"title":"Get Trading Limits","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/limits/trading","href":"/api-reference/limits/get-trading-limits"},{"title":"Get Session Limits","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/limits/session","href":"/api-reference/limits/get-session-limits"}]},{"group":"Status","pages":[{"title":"Get Current Market Status","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/status/market","href":"/api-reference/status/get-current-market-status"},{"title":"Get Asset Statuses","deprecated":null,"version":null,"openapi":"/openapi.json get /v1/status/assets","href":"/api-reference/status/get-asset-statuses"}]}]},{"group":"Streaming API","pages":[{"title":"Protobuf Schema \u0026 Code Generation","href":"/api-reference/protobuf-schema"},{"title":"Price Streaming","href":"/api-reference/price-streaming"},{"title":"OHLC Streaming","href":"/api-reference/ohlc-streaming"},{"title":"Soft Quote Depth Streaming","href":"/api-reference/soft-quote-depth-streaming"}]},{"group":"References","pages":[{"title":"Upcoming API changes","href":"/api-reference/upcoming-changes"},{"title":"ITN Integration","href":"/api-reference/itn-integration"},{"title":"Smart Contract Reference","href":"/api-reference/smart-contracts"},{"title":"Endpoint Caching","href":"/api-reference/endpoint-caching"},{"title":"Error Codes","href":"/api-reference/error-codes"}]}]},{"tab":"Partner Docs","hidden":true,"pages":[{"title":"Partner Docs","href":"/partner-docs/overview"}]}]},"title":"Get Token Balances for a User or Token - Ondo Finance","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}