Retrieves the balance of a specific token for an address.
Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed).
Token address can be:
Contract ID (C-prefixed, 56 characters)
CODE:ISSUER format (e.g., USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN)
Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO/CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA?network=mainnet
Timestamp when balance was 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/token-balance","slug":"/api-reference/market-data/token-balance","pageMetadata":{"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"},"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 li: \"li\",\n p: \"p\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Retrieves the balance of a specific token for an 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: \"Token address can be:\"\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Contract ID (C-prefixed, 56 characters)\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"CODE:ISSUER format (e.g., USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN)\"\n }), \"\\n\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO/CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA?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}/{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"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/soroswap/8cf4cc027d03ca5b/analytics.js"],"openApiReferenceData":{"operation":{"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","operationId":"BalancesController_getTokenBalance","parameters":["0d22fd0a-ba07-4f97-8edd-1d0832ec1674","21b9b127-e599-46fd-8b26-9e2a3afbc1b2","eeb7f1af-ce85-46cf-9942-2cab9e605e86"],"responses":{"200":"0b2f2fcc-5973-4e12-a98c-cd9cd4ae321a","400":"5ce22fe0-1782-4d5a-837b-a8b2d6df45d2","401":"528b3f30-def2-4924-a994-e52df2922e94","403":"099e9631-1ba7-43fc-9d90-515bea3bad28","503":"b4ca5931-1417-4b00-aada-457fbeacf223"},"summary":"Get balance for a specific token","tags":["Balances"],"security":["12adfdbe-12be-49a5-999e-b5d806de0582"],"method":"get","type":"path","servers":[],"path":"/balances/{walletAddress}/{tokenAddress}","baseUrlOptions":["https://api.soroswap.finance"],"title":"Get balance for a specific token","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0d22fd0a-ba07-4f97-8edd-1d0832ec1674":{"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"}},"21b9b127-e599-46fd-8b26-9e2a3afbc1b2":{"name":"tokenAddress","required":true,"in":"path","description":"Token address - either contract ID (C...) or CODE:ISSUER format","schema":{"type":"string","example":"CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA","isRequired":true,"description":"Token address - either contract ID (C...) or CODE:ISSUER format","uniqueKey":"","typeLabel":"string"}},"eeb7f1af-ce85-46cf-9942-2cab9e605e86":{"name":"network","required":true,"in":"query","description":"Network to query balance on","schema":{"enum":["mainnet","testnet"],"type":"string","isRequired":true,"description":"Network to query balance on","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"0b2f2fcc-5973-4e12-a98c-cd9cd4ae321a":{"description":"Returns the token balance. If token is not in asset list, code will be null and decimals defaults to 7","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"},"balance":{"type":"object","description":"Token balance information","required":["asset","amount","rawAmount","available","availableRaw"],"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":"balance.asset.code","typeLabel":"string"},"issuer":{"oneOf":[{"type":"string","example":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","description":"Asset issuer (null for native XLM and pure Soroban tokens)","isRequired":true,"uniqueKey":"balance.asset.issuer.oneOf.0","typeLabel":"string"},{"type":"null","example":"GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN","description":"Asset issuer (null for native XLM and pure Soroban tokens)","isRequired":true,"uniqueKey":"balance.asset.issuer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"balance.asset.issuer","typeLabel":"string | null"},"contract":{"type":"string","example":"CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA","description":"Soroban contract address","isRequired":true,"uniqueKey":"balance.asset.contract","typeLabel":"string"},"name":{"oneOf":[{"type":"string","example":"Stellar Lumens","description":"Human-readable asset name","isRequired":true,"uniqueKey":"balance.asset.name.oneOf.0","typeLabel":"string"},{"type":"null","example":"Stellar Lumens","description":"Human-readable asset name","isRequired":true,"uniqueKey":"balance.asset.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"balance.asset.name","typeLabel":"string | null"},"icon":{"oneOf":[{"type":"string","example":"https://example.com/xlm-icon.png","description":"Asset icon URL","isRequired":true,"uniqueKey":"balance.asset.icon.oneOf.0","typeLabel":"string"},{"type":"null","example":"https://example.com/xlm-icon.png","description":"Asset icon URL","isRequired":true,"uniqueKey":"balance.asset.icon.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"balance.asset.icon","typeLabel":"string | null"},"decimals":{"type":"number","example":7,"description":"Token decimals","isRequired":true,"uniqueKey":"balance.asset.decimals","typeLabel":"number"}},"isRequired":true,"uniqueKey":"balance.asset","typeLabel":"object"},"amount":{"type":"string","example":"100.0000000","description":"Human-readable balance with decimals","isRequired":true,"uniqueKey":"balance.amount","typeLabel":"string"},"rawAmount":{"type":"string","example":"1000000000","description":"Raw balance in smallest unit (stroops for XLM, token decimals for others)","isRequired":true,"uniqueKey":"balance.rawAmount","typeLabel":"string"},"available":{"type":"string","example":"97.5000000","description":"Available/spendable amount (for XLM on G-accounts: balance minus reserves)","isRequired":true,"uniqueKey":"balance.available","typeLabel":"string"},"availableRaw":{"type":"string","example":"975000000","description":"Raw available/spendable amount in smallest unit","isRequired":true,"uniqueKey":"balance.availableRaw","typeLabel":"string"}},"isRequired":true,"uniqueKey":"balance","typeLabel":"object"},"updatedAt":{"type":"number","example":1702483200000,"description":"Timestamp when balance was fetched (ms since epoch)","isRequired":true,"uniqueKey":"updatedAt","typeLabel":"number"}},"required":["wallet","network","balance","updatedAt"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"wallet":"GDMTVHLWJTHSUDMZVVMXXH6VJHA2ZV3HNG5LYNAZ6RTWB7GISM6PGTUV","network":"mainnet","balance":{"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"},"5ce22fe0-1782-4d5a-837b-a8b2d6df45d2":{"description":"Bad Request - Invalid address or token address format","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"528b3f30-def2-4924-a994-e52df2922e94":{"description":"Unauthorized - Missing or invalid authentication","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"099e9631-1ba7-43fc-9d90-515bea3bad28":{"description":"An expired or invalid JWT, or a valid credential without the required role.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"b4ca5931-1417-4b00-aada-457fbeacf223":{"description":"Service Unavailable - Database connection unavailable","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"12adfdbe-12be-49a5-999e-b5d806de0582":{"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 balance for a specific token - Soroswap Finance","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T13:18:56.322Z","originalFileLocation":"api-reference/market-data/token-balance.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 the balance of a specific token for an address. Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed). Token address can be: - Contract ID (C-prefixed, 56 characters) - CODE:ISSUER format (e.g., USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN) Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO/CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA?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 balance for a specific token - Soroswap Finance\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves the balance of a specific token for an address. Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed). Token address can be: - Contract ID (C-prefixed, 56 characters) - CODE:ISSUER format (e.g., USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN) Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO/CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA?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/token-balance\">\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+balance+for+a+specific+token\u0026amp;description=Retrieves+the+balance+of+a+specific+token+for+an+address.%0A%0ASupports+both+wallet+addresses+%28G-prefixed%29+and+smart+contracts%2Faccounts+%28C-prefixed%29.%0A%0AToken+address\u0026amp;theme=8d438c899d3ef343df4b702c\u0026amp;signature=475211bde8ab4335240b08499f98f9d78bac7a65ef772137cc89cc8ccf467faf\">\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 balance for a specific token - Soroswap Finance\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves the balance of a specific token for an address. Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed). Token address can be: - Contract ID (C-prefixed, 56 characters) - CODE:ISSUER format (e.g., USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN) Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO/CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA?network=mainnet\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://soroswap.mintlify.site/_mintlify/api/og/v2?division=Market+data\u0026amp;title=Get+balance+for+a+specific+token\u0026amp;description=Retrieves+the+balance+of+a+specific+token+for+an+address.%0A%0ASupports+both+wallet+addresses+%28G-prefixed%29+and+smart+contracts%2Faccounts+%28C-prefixed%29.%0A%0AToken+address\u0026amp;theme=8d438c899d3ef343df4b702c\u0026amp;signature=475211bde8ab4335240b08499f98f9d78bac7a65ef772137cc89cc8ccf467faf\">\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/token-balance\">\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/token-balance.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/token-balance#webpage\",\"url\":\"https://docs.soroswap.finance/api-reference/market-data/token-balance\",\"name\":\"Get balance for a specific token\",\"description\":\"Retrieves the balance of a specific token for an address. Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed). Token address can be: - Contract ID (C-prefixed, 56 characters) - CODE:ISSUER format (e.g., USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN) Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO/CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA?network=mainnet\",\"dateModified\":\"2026-10-21T13:18:56.322Z\",\"isPartOf\":{\"@id\":\"https://docs.soroswap.finance#website\"},\"breadcrumb\":{\"@id\":\"https://docs.soroswap.finance/api-reference/market-data/token-balance#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.soroswap.finance/api-reference/market-data/token-balance#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 balance for a specific token\",\"item\":\"https://docs.soroswap.finance/api-reference/market-data/token-balance\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.soroswap.finance/api-reference/market-data/token-balance#apireference\",\"headline\":\"Get balance for a specific token\",\"name\":\"Get balance for a specific token\",\"description\":\"Retrieves the balance of a specific token for an address. Supports both wallet addresses (G-prefixed) and smart contracts/accounts (C-prefixed). Token address can be: - Contract ID (C-prefixed, 56 characters) - CODE:ISSUER format (e.g., USDC:GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN) Example: GET /balances/GALAXYVOIDAOPZTDLHILAJQKCVVFMD4IKLXLSZV5YHO7VY74IWZILUTO/CAS3J7GYLGXMF6TDJBBYYSE3HQ6BBSMLNUQ34T6TZMYMW2EVH34XOWMA?network=mainnet\",\"url\":\"https://docs.soroswap.finance/api-reference/market-data/token-balance\",\"mainEntityOfPage\":{\"@id\":\"https://docs.soroswap.finance/api-reference/market-data/token-balance#webpage\"},\"dateModified\":\"2026-10-21T13:18:56.322Z\",\"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","href":"/api-reference/market-data/pool"},{"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"},{"openapi":"GET /balances/{walletAddress}/{tokenAddress}","title":"Get balance for a specific token","href":"/api-reference/market-data/token-balance"}]},{"group":"Liquidity (Soroswap AMM)","pages":[{"openapi":"POST /liquidity/add","description":"Builds an unsigned transaction that deposits two assets into a Soroswap AMM pool, or creates the pool when none exists. Amounts in stroops; amountB must match the pool ratio within slippageBps (default 1%).","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 balance for a specific token - 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"]}