Timestamp when balances were fetched (ms since epoch)
Example:
1702483200000
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Soroswap Finance","description":"The Swap Aggregator for Stellar: one API that quotes every Stellar venue and returns the best route, plus the Soroswap AMM.","colors":{"primary":"#8866DD","light":"#A98BE8","dark":"#6F4FC7"},"logo":{"light":"https://mintcdn.com/soroswap/1xzCGA5zGx88_Gb9/logo/light.svg?fit=max\u0026auto=format\u0026n=1xzCGA5zGx88_Gb9\u0026q=85\u0026s=167296c66e3d90415a7f2aa982f7843b","dark":"https://mintcdn.com/soroswap/1xzCGA5zGx88_Gb9/logo/dark.svg?fit=max\u0026auto=format\u0026n=1xzCGA5zGx88_Gb9\u0026q=85\u0026s=77ca3dbbc4d3854eb6f326c89561e074","href":"https://soroswap.finance"},"favicon":"https://mintcdn.com/soroswap/1xzCGA5zGx88_Gb9/favicon.png?fit=max\u0026auto=format\u0026n=1xzCGA5zGx88_Gb9\u0026q=85\u0026s=001876061b5f304af9d8fa19a3ff1da0","api":{"openapi":"https://api.soroswap.finance/api-json","mdx":{"auth":{"method":"bearer"},"server":"https://api.soroswap.finance"}},"navbar":{"links":[{"href":"https://app.soroswap.finance","label":"Launch App"},{"href":"https://discord.gg/A2rQ3cm9XG","label":"Support"}],"primary":{"type":"button","label":"Open console","href":"https://console.soroswap.finance"}},"footer":{"socials":{"x":"https://x.com/SoroswapFinance","discord":"https://discord.gg/A2rQ3cm9XG","github":"https://github.com/soroswap"}},"integrations":{"posthog":{"apiKey":"phc_C6MfPNluY4B1Kx7kFa4d2XPJmcGHhQAplhnzD8hIt6G","apiHost":"https://us.i.posthog.com","sessionRecording":false}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"markdown":{"instructions":["Soroswap Aggregator API: base URL https://api.soroswap.finance, pick the network with ?network=mainnet or ?network=testnet (omitted means mainnet).","Auth: Authorization: Bearer sk_... on every call. Get a key at https://console.soroswap.finance/register. A missing or invalid key returns 401 with code and registerUrl (POST /send returns 403 instead); an expired JWT or a missing role returns 403. Free plan 1 request/s; see https://docs.soroswap.finance/api/plans.md.","Flow: POST /quote (assetIn, assetOut as C... contract addresses, amount as an integer string in the smallest unit, tradeType, protocols) -> POST /quote/build with the unchanged quote and from -> the user signs the XDR -> POST /send. Build right after quoting: a Soroban XDR is valid for 180 seconds. Submit it as is, never re-simulate it.","Partner id: every account has one (9 hex chars, permanent). Read partnerId from GET /partner, or in the console at https://console.soroswap.finance under Fees \u0026 payouts. The partner fee itself is switched on by Soroswap; see https://docs.soroswap.finance/api/fees.md.","AI tools: docs MCP at https://docs.soroswap.finance/mcp (claude mcp add --transport http soroswap-docs https://docs.soroswap.finance/mcp), skill with npx skills add https://docs.soroswap.finance. Other clients: https://docs.soroswap.finance/api/build-with-ai.md.","Units and Stellar pitfalls: https://docs.soroswap.finance/api/stellar-gotchas.md. Errors and retries: https://docs.soroswap.finance/api/errors.md."]},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Dune Dashboard","icon":"chart-line","href":"https://dune.com/paltalabs/soroswap"},{"anchor":"GitHub","icon":"github","href":"https://github.com/soroswap"},{"anchor":"Discord","icon":"discord","href":"https://discord.gg/A2rQ3cm9XG"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"soroswap","hasAudioNarration":false,"actualSubdomain":"soroswap","customDomains":["docs.soroswap.finance"],"gitSource":{"type":"github","owner":"soroswap","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"}},"buildId":"6af23399611a194646c15860","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"Learn","count":39},{"language":"default","tag":"Soroswap AMM","count":34},{"language":"default","tag":"API Reference","count":27},{"language":"default","tag":"Aggregator API","count":15},{"language":"default","tag":"Concepts","count":15},{"language":"default","tag":"Technical Reference","count":13},{"language":"default","tag":"Tutorials","count":11},{"language":"default","tag":"Getting Started","count":7},{"language":"default","tag":"Account","count":6},{"language":"default","tag":"Market data","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/market-data/balances","slug":"/api-reference/market-data/balances","pageMetadata":{"openapi":"GET /balances/{walletAddress}","title":"Get all token balances for an address","description":"Retrieves all token balances from the asset list for a specific address.\n\nSupports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed).\n\nExample: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO?network=mainnet","href":"/api-reference/market-data/balances"},"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 p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Retrieves all token balances from the asset list for a specific address.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed).\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO?network=mainnet\"\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":{"openapi":"GET /balances/{walletAddress}","title":"Get all token balances for an address","description":"Retrieves all token balances from the asset list for a specific address.\n\nSupports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed).\n\nExample: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO?network=mainnet","href":"/api-reference/market-data/balances"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/soroswap/8cf4cc027d03ca5b/analytics.js"],"openApiReferenceData":{"operation":{"description":"Retrieves all token balances from the asset list for a specific address.\n\nSupports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed).\n\nExample: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO?network=mainnet","operationId":"BalancesController_getAllBalances","parameters":["6286c518-16fa-402f-ad21-1692a11f6e7c","cc56e20d-58f2-4bcf-a82b-5d415f5d0b16"],"responses":{"200":"fe893947-c194-4ade-992c-2fc2f5e02695","400":"381201f8-c1e5-414b-85ef-79a70a9277ae","401":"8e675990-8bbd-4b99-b111-0e186e9078d0","403":"36efd10c-9c32-44d1-9918-3e2dffbbaaf5","503":"de347c35-2fc7-4437-b9bd-808872b9ef40"},"summary":"Get all token balances for an address","tags":["Balances"],"security":["27d9cb1a-83d4-4972-9253-a22f42ef4fb8"],"method":"get","type":"path","servers":[],"path":"/balances/{walletAddress}","baseUrlOptions":["https://api.soroswap.finance"],"title":"Get all token balances for an address","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"6286c518-16fa-402f-ad21-1692a11f6e7c":{"name":"walletAddress","required":true,"in":"path","description":"Stellar address - wallet (G-prefixed) or contract (C-prefixed)","schema":{"type":"string","example":"GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO","isRequired":true,"description":"Stellar address - wallet (G-prefixed) or contract (C-prefixed)","uniqueKey":"","typeLabel":"string"}},"cc56e20d-58f2-4bcf-a82b-5d415f5d0b16":{"name":"network","required":true,"in":"query","description":"Network to query balances on","schema":{"enum":["mainnet","testnet"],"type":"string","isRequired":true,"description":"Network to query balances on","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"fe893947-c194-4ade-992c-2fc2f5e02695":{"description":"Returns balances for all tokens in the asset list","content":{"application/json":{"schema":{"type":"object","properties":{"wallet":{"type":"string","example":"GDMTVHLWJTHSUDMZVVMXXH6VJHA2ZV3HNG5LYNAZ6RTWB7GISM6PGTUV","description":"Wallet address","isRequired":true,"uniqueKey":"wallet","typeLabel":"string"},"network":{"type":"string","example":"mainnet","description":"Network","isRequired":true,"uniqueKey":"network","typeLabel":"string"},"balances":{"description":"Array of token balances","type":"array","items":{"type":"object","properties":{"asset":{"type":"object","description":"Asset information","required":["code","issuer","contract","name","icon","decimals"],"properties":{"code":{"type":"string","example":"XLM","description":"Token code/symbol","isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.code","typeLabel":"string"},"issuer":{"oneOf":[{"type":"string","example":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","description":"Asset issuer (null for native XLM and pure Soroban tokens)","isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.issuer.oneOf.0","typeLabel":"string"},{"type":"null","example":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","description":"Asset issuer (null for native XLM and pure Soroban tokens)","isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.issuer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.issuer","typeLabel":"string | null"},"contract":{"type":"string","example":"CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA","description":"Soroban contract address","isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.contract","typeLabel":"string"},"name":{"oneOf":[{"type":"string","example":"Stellar Lumens","description":"Human-readable asset name","isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Stellar Lumens","description":"Human-readable asset name","isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.name","typeLabel":"string | null"},"icon":{"oneOf":[{"type":"string","example":"https://example.com/xlm-icon.png","description":"Asset icon URL","isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.icon.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://example.com/xlm-icon.png","description":"Asset icon URL","isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.icon.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.icon","typeLabel":"string | null"},"decimals":{"type":"number","example":7,"description":"Token decimals","isRequired":true,"uniqueKey":"balances.items.[INDEX].asset.decimals","typeLabel":"number"}},"isRequired":true,"uniqueKey":"balances.items.[INDEX].asset","typeLabel":"object"},"amount":{"type":"string","example":"100.0000000","description":"Human-readable balance with decimals","isRequired":true,"uniqueKey":"balances.items.[INDEX].amount","typeLabel":"string"},"rawAmount":{"type":"string","example":"1000000000","description":"Raw balance in smallest unit (stroops for XLM, token decimals for others)","isRequired":true,"uniqueKey":"balances.items.[INDEX].rawAmount","typeLabel":"string"},"available":{"type":"string","example":"97.5000000","description":"Available/spendable amount (for XLM on G-accounts: balance minus reserves)","isRequired":true,"uniqueKey":"balances.items.[INDEX].available","typeLabel":"string"},"availableRaw":{"type":"string","example":"975000000","description":"Raw available/spendable amount in smallest unit","isRequired":true,"uniqueKey":"balances.items.[INDEX].availableRaw","typeLabel":"string"}},"required":["asset","amount","rawAmount","available","availableRaw"],"uniqueKey":"balances.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"balances","typeLabel":"object[]"},"updatedAt":{"type":"number","example":1702483200000,"description":"Timestamp when balances were fetched (ms since epoch)","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"number"}},"required":["wallet","network","balances","updatedAt"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"wallet":"GDMTVHLWJTHSUDMZVVMXXH6VJHA2ZV3HNG5LYNAZ6RTWB7GISM6PGTUV","network":"mainnet","balances":[{"asset":{"code":"XLM","issuer":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","contract":"CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA","name":"Stellar Lumens","icon":"https://example.com/xlm-icon.png","decimals":7},"amount":"100.0000000","rawAmount":"1000000000","available":"97.5000000","availableRaw":"975000000"}],"updatedAt":1702483200000}}},"exampleType":"generated"}},"exampleType":"generated"},"381201f8-c1e5-414b-85ef-79a70a9277ae":{"description":"Bad Request - Invalid address","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"8e675990-8bbd-4b99-b111-0e186e9078d0":{"description":"Unauthorized - Missing or invalid authentication","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"36efd10c-9c32-44d1-9918-3e2dffbbaaf5":{"description":"An expired or invalid JWT, or a valid credential without the required role.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"de347c35-2fc7-4437-b9bd-808872b9ef40":{"description":"Service Unavailable - Database connection unavailable","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"27d9cb1a-83d4-4972-9253-a22f42ef4fb8":{"bearer":{"scheme":"bearer","bearerFormat":"JWT","type":"http","scopes":[],"schemeName":"bearer"}}},"servers":{},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","bearerFormat":"JWT","type":"http","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"https://api.soroswap.finance/api-json"},"subdomain":"soroswap","siteName":"Soroswap Finance","title":"Get all token balances for an address - Soroswap Finance","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T13:18:56.338Z","originalFileLocation":"api-reference/market-data/balances.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=\"Retrieves all token balances from the asset list for a specific address. Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed). Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO?network=mainnet\">\u003cmeta data-mint-head name=\"application-name\" content=\"Soroswap 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/soroswap/fuylThFPBoCQikOJ/_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/soroswap/fuylThFPBoCQikOJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/soroswap/fuylThFPBoCQikOJ/_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/soroswap/fuylThFPBoCQikOJ/_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/soroswap/fuylThFPBoCQikOJ/_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/soroswap/fuylThFPBoCQikOJ/_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/soroswap/fuylThFPBoCQikOJ/_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/soroswap/fuylThFPBoCQikOJ/_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/soroswap/fuylThFPBoCQikOJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get all token balances for an address - Soroswap Finance\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves all token balances from the asset list for a specific address. Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed). Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO?network=mainnet\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Soroswap Finance\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.soroswap.finance/api-reference/market-data/balances\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://soroswap.mintlify.site/_mintlify/api/og/v2?division=Market+data\u0026amp;title=Get+all+token+balances+for+an+address\u0026amp;description=Retrieves+all+token+balances+from+the+asset+list+for+a+specific+address.%0A%0ASupports+both+wallet+addresses+%28G-prefixed%29+and+smart+contracts%2Faccounts+%28C-prefixed%29.\u0026amp;theme=8d438c899d3ef343df4b702c\u0026amp;signature=bda60520dfd47486452ecfec64576246ee3430484b31bd14e1075d9579b25356\">\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 all token balances for an address - Soroswap Finance\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves all token balances from the asset list for a specific address. Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed). Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO?network=mainnet\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://soroswap.mintlify.site/_mintlify/api/og/v2?division=Market+data\u0026amp;title=Get+all+token+balances+for+an+address\u0026amp;description=Retrieves+all+token+balances+from+the+asset+list+for+a+specific+address.%0A%0ASupports+both+wallet+addresses+%28G-prefixed%29+and+smart+contracts%2Faccounts+%28C-prefixed%29.\u0026amp;theme=8d438c899d3ef343df4b702c\u0026amp;signature=bda60520dfd47486452ecfec64576246ee3430484b31bd14e1075d9579b25356\">\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/soroswap/fuylThFPBoCQikOJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Soroswap Finance\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#8866DD\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.soroswap.finance/api-reference/market-data/balances\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/market-data/balances.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.soroswap.finance/#organization\",\"name\":\"Soroswap Finance\",\"url\":\"https://docs.soroswap.finance\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/soroswap/1xzCGA5zGx88_Gb9/logo/light.svg?fit=max\u0026auto=format\u0026n=1xzCGA5zGx88_Gb9\u0026q=85\u0026s=167296c66e3d90415a7f2aa982f7843b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.soroswap.finance#website\",\"name\":\"Soroswap Finance\",\"url\":\"https://docs.soroswap.finance\",\"publisher\":{\"@id\":\"https://docs.soroswap.finance/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.soroswap.finance/api-reference/market-data/balances#webpage\",\"url\":\"https://docs.soroswap.finance/api-reference/market-data/balances\",\"name\":\"Get all token balances for an address\",\"description\":\"Retrieves all token balances from the asset list for a specific address. Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed). Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO?network=mainnet\",\"dateModified\":\"2026-10-21T13:18:56.338Z\",\"isPartOf\":{\"@id\":\"https://docs.soroswap.finance#website\"},\"breadcrumb\":{\"@id\":\"https://docs.soroswap.finance/api-reference/market-data/balances#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.soroswap.finance/api-reference/market-data/balances#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Market data\",\"item\":\"https://docs.soroswap.finance/api-reference/market-data/price\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get all token balances for an address\",\"item\":\"https://docs.soroswap.finance/api-reference/market-data/balances\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.soroswap.finance/api-reference/market-data/balances#apireference\",\"headline\":\"Get all token balances for an address\",\"name\":\"Get all token balances for an address\",\"description\":\"Retrieves all token balances from the asset list for a specific address. Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed). Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO?network=mainnet\",\"url\":\"https://docs.soroswap.finance/api-reference/market-data/balances\",\"mainEntityOfPage\":{\"@id\":\"https://docs.soroswap.finance/api-reference/market-data/balances#webpage\"},\"dateModified\":\"2026-10-21T13:18:56.338Z\",\"publisher\":{\"@id\":\"https://docs.soroswap.finance/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.soroswap.finance#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Soroswap Finance\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Soroswap Finance","nav":{"global":{"anchors":[{"anchor":"Dune Dashboard","icon":"chart-line","href":"https://dune.com/paltalabs/soroswap"},{"anchor":"GitHub","icon":"github","href":"https://github.com/soroswap"},{"anchor":"Discord","icon":"discord","href":"https://discord.gg/A2rQ3cm9XG"}]},"tabs":[{"tab":"Aggregator API","pages":[{"title":"Aggregator API","href":""}]},{"tab":"API Reference","groups":[{"group":"Swap","pages":[{"openapi":"GET /protocols","title":"Available protocols","href":"/api-reference/quote/protocols"},{"openapi":"POST /quote","title":"Quote","href":"/api-reference/quote/quote"},{"openapi":"POST /quote/build","title":"Build","href":"/api-reference/quote/build"},{"openapi":"POST /send","title":"Send","href":"/api-reference/quote/send"},{"openapi":"POST /swap","title":"Swap (all-in-one)","href":"/api-reference/quote/swap"}]},{"group":"Partner","pages":[{"openapi":"GET /partner","title":"Partner profile","href":"/api-reference/partner/partner-profile"},{"openapi":"PUT /partner/rate","title":"Set the fee your users pay","href":"/api-reference/partner/set-rate"},{"openapi":"PUT /partner/payout-address","title":"Set the USDC payout address","href":"/api-reference/partner/set-payout-address"},{"openapi":"GET /partner/statements","title":"List your payouts","href":"/api-reference/partner/list-payouts"},{"openapi":"GET /partner/statements/{payoutId}","title":"Statement for one payout","href":"/api-reference/partner/payout-statement"}]},{"group":"Market data","pages":[{"openapi":"GET /price","title":"Price information","href":"/api-reference/market-data/price"},{"openapi":"GET /asset-list","title":"Get asset lists","href":"/api-reference/market-data/asset-lists"},{"openapi":"GET /pools","title":"Pools","href":"/api-reference/market-data/pools"},{"openapi":"GET /pools/{tokenA}/{tokenB}","title":"Pool for two tokens","description":"Retrieves the pool for the given tokens","href":"/api-reference/market-data/pool"},{"openapi":"GET /balances/{walletAddress}","title":"Get all token balances for an address","href":"/api-reference/market-data/balances"},{"openapi":"GET /balances/{walletAddress}/{tokenAddress}","title":"Get balance for a specific token","description":"Retrieves the balance of a specific token for an address.\n\nSupports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed).\n\nToken address can be:\n- Contract ID (C-prefixed, 56 characters)\n- CODE:ISSUER format (e.g., USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN)\n\nExample: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO/CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA?network=mainnet","href":"/api-reference/market-data/token-balance"}]},{"group":"Liquidity (Soroswap AMM)","pages":[{"openapi":"POST /liquidity/add","title":"Add liquidity to a pool","href":"/api-reference/liquidity/add"},{"openapi":"POST /liquidity/remove","title":"Remove liquidity from a pool","href":"/api-reference/liquidity/remove"},{"openapi":"GET /liquidity/positions/{address}","title":"Get user positions in pools","href":"/api-reference/liquidity/positions"}]},{"group":"Account","pages":[{"openapi":"POST /register","title":"Register a new user","href":"/api-reference/account/register"},{"openapi":"POST /login","title":"Login","href":"/api-reference/account/login"},{"openapi":"POST /refresh","title":"Refresh access token","href":"/api-reference/account/refresh"},{"openapi":"POST /api-keys/generate","title":"Generate API Key","href":"/api-reference/account/generate-api-key"},{"openapi":"GET /api-keys","title":"Get API Keys","href":"/api-reference/account/list-api-keys"},{"openapi":"POST /api-keys/{keyId}/revoke","title":"Revoke API Key","href":"/api-reference/account/revoke-api-key"}]},{"group":"Utilities","pages":[{"openapi":"GET /health","title":"Health","href":"/api-reference/utilities/health"},{"openapi":"GET /api/{network}/{contractName}","title":"Soroswap contracts","href":"/api-reference/utilities/contracts"}]}]},{"tab":"Soroswap AMM","pages":[{"title":"Soroswap AMM","href":"/amm"}]},{"tab":"Learn","pages":[{"title":"Learn","href":"/what-is-soroswap"}]}]},"basePath":"","title":"Get all token balances for an address - Soroswap Finance","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}