Returns the state of a specified account identifier (address or xpub) and chain ID, focusing on balance information. The response includes details on native asset balances, token balances, and staking balances. This endpoint supports optional filters to refine the results, making it essential for wallet applications to display accurate and tailored account information.
GET
/
api
/
{chainId}
/
account
/
{accountId}
/
state
Get Account State (Balances)
curl --request GET \
--url https://api.adamik.io/api/{chainId}/account/{accountId}/state \
--header 'Authorization: <api-key>'
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Adamik","colors":{"primary":"#4261F4","light":"#4261F4","dark":"#4261F4"},"favicon":"Adamik_symbol_flat_blue.svg","logo":{"light":"https://mintcdn.com/adamiksas/YkY6Yhgmc8Rl2xni/logo/blue.svg?fit=max\u0026auto=format\u0026n=YkY6Yhgmc8Rl2xni\u0026q=85\u0026s=c8c34c5b216ccb9520ff3961f5b729bf","dark":"https://mintcdn.com/adamiksas/YkY6Yhgmc8Rl2xni/logo/dark.svg?fit=max\u0026auto=format\u0026n=YkY6Yhgmc8Rl2xni\u0026q=85\u0026s=caa20a59df53bcb3c1a1cb1beed6196a","href":"https://adamik.io"},"navbar":{"links":[{"label":"Discord Support","href":"https://discord.gg/gsZJR2JfMR"}],"primary":{"type":"button","label":"Get API Key","href":"https://dashboard.adamik.io"}},"search":{"prompt":"Search Adamik docs..."},"seo":{"metatags":{"og:image":"https://adamik-public-media.s3.eu-north-1.amazonaws.com/Social+Media/bandeau.svg","og:title":"Adamik Documentation","og:description":"Streamline blockchain integration with Adamik’s powerful API tools. Access comprehensive guides, resources, and support to unlock seamless multichain connectivity. Fast, reliable, and easy to use — everything you need in one place."},"indexing":"navigable"},"footer":{"socials":{"x":"https://twitter.com/adamik_io","github":"https://github.com/AdamikHQ","linkedin":"https://www.linkedin.com/company/adamik/","discord":"https://discord.gg/gsZJR2JfMR"}},"integrations":{"gtm":{"tagId":"GTM-PDZKXGD6"},"hotjar":{"hjid":"5204260","hjsv":"6"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"adamiksas","hasAudioNarration":false,"actualSubdomain":"adamiksas","customDomains":["docs.adamik.io"],"gitSource":{"type":"github","owner":"adamikhq","repo":"adamik-documentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21e62db8c65e77d6677a16","collectionId":"deca475b-bc87-4515-bdae-4c05f116a690","schemaVersion":"v2"},"feedback":{"thumbs":true,"issues":true},"entitlements":{},"buildId":"6ae91fb8cfb5b1d0b4b02f02:success","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"Introduction","count":17},{"language":"default","tag":"API Reference","count":15},{"language":"default","tag":"Guides and Tutorials","count":10},{"language":"default","tag":"Examples","count":5},{"language":"default","tag":"Transaction","count":5},{"language":"default","tag":"Chain","count":4},{"language":"default","tag":"API Overview","count":3},{"language":"default","tag":"Tutorials","count":3},{"language":"default","tag":"Account","count":3},{"language":"default","tag":"Signer Examples","count":2}]},"assistantConfig":{},"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":"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":"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":"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":"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":"sso-setup-deadline-banner","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}],"googleFontsInlined":false},"customCss":[{"filePath":"snippets/styles.css","content":"body{font-family:Arial,sans-serif;background-color:#1e1e1e;color:#fff}table{width:100%;border-collapse:collapse;margin:20px 0}td,th{text-align:center;border:1px solid #333;padding:20px 12px;vertical-align:middle}td{padding:12px}td:first-child{text-align:left;padding-left:12px}td.checkmark{color:green}td.cross{color:#a00}td,th{width:150px}.cell-content{display:flex;justify-content:center;align-items:center;height:100%}td a{color:#007bff;text-decoration:none}td a:hover{text-decoration:underline}.description-column{width:50%}"}],"page":{"pagePath":"api-reference/account/get-account-state-balances","slug":"/api-reference/account/get-account-state-balances","pageMetadata":{"title":"Get Account State (Balances)","description":"Returns the state of a specified account identifier (address or xpub) and chain ID, focusing on balance information. The response includes details on native asset balances, token balances, and staking balances. This endpoint supports optional filters to refine the results, making it essential for wallet applications to display accurate and tailored account information.","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api/{chainId}/account/{accountId}/state","href":"/api-reference/account/get-account-state-balances","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns the state of a specified account identifier (address or xpub) and chain ID, focusing on balance information. The response includes details on native asset balances, token balances, and staking balances. This endpoint supports optional filters to refine the results, making it essential for wallet applications to display accurate and tailored account information.\"\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 Account State (Balances)","description":"Returns the state of a specified account identifier (address or xpub) and chain ID, focusing on balance information. The response includes details on native asset balances, token balances, and staking balances. This endpoint supports optional filters to refine the results, making it essential for wallet applications to display accurate and tailored account information.","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api/{chainId}/account/{accountId}/state","href":"/api-reference/account/get-account-state-balances","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Account"],"summary":"Get Account State (Balances)","description":"Returns the state of a specified account identifier (address or xpub) and chain ID, focusing on balance information. The response includes details on native asset balances, token balances, and staking balances. This endpoint supports optional filters to refine the results, making it essential for wallet applications to display accurate and tailored account information.","parameters":["ecd9a751-f258-4d14-8fb2-5f0283a9f428","4f304b81-3d26-41c6-8410-20f386f74b12","1f123958-2505-48bf-b779-98aa2214c213","eb8addd6-4bab-4667-bba3-7e5c0ab60b37"],"responses":{"200":"31abe15f-ff1f-4e2c-acb9-045c9e489ef7"},"method":"get","type":"path","servers":["0643b805-9e00-4b0b-be35-a5fe13c17688"],"security":["89552511-4817-479c-9ace-cbb49815cb06"],"path":"/api/{chainId}/account/{accountId}/state","baseUrlOptions":["https://api.adamik.io"],"title":"Get Account State (Balances)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ecd9a751-f258-4d14-8fb2-5f0283a9f428":{"in":"path","name":"chainId","schema":{"type":"string","enum":["algorand","cosmoshub","cosmoshub-testnet","osmosis","osmosis-testnet","celestia","celestia-testnet","dydx","axelar","ethereum","sepolia","hoodi","holesky","zksync","zksync-sepolia","injective-evm-testnet","base","base-sepolia","optimism","optimism-sepolia","arbitrum","arbitrum-sepolia","bitcoin","bitcoin-testnet","bitcoin-signet","polygon","polygon-amoy","bsc","bsc-testnet","linea","linea-sepolia","avalanche","avalanche-fuji","gnosis","gnosis-chiado","moonbeam","moonriver","moonbase","fantom","mantle","rootstock","rootstock-testnet","litecoin","dogecoin","ton","chiliz","chiliz-testnet","injective","akash","band","dymension","kyve","terra2","stargaze","tron","evmos","irisnet","juno","lum-network","omniflix","sei","medibloc","passage","quasar","seda","sommelier","shentu","stride","chihuahua","bitsong","persistence","comdex","fetch-ai","humans-ai","ki","likecoin","provenance","quicksilver","saga","kava","starknet","starknet-sepolia","babylon","babylon-testnet","monad-testnet","berachain","berachain-bepolia","cronos","world-chain","world-chain-sepolia","hyperliquid","solana","aptos","aptos-testnet","stellar","stellar-testnet"],"isRequired":true,"uniqueKey":"","typeLabel":"enum\u003cstring>"},"required":true},"4f304b81-3d26-41c6-8410-20f386f74b12":{"in":"path","name":"accountId","description":"Account identifier (address, xpub, etc) for the specified chain ID","schema":{"type":"string","description":"Account identifier (address, xpub, etc) for the specified chain ID","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true},"1f123958-2505-48bf-b779-98aa2214c213":{"in":"query","name":"include","description":"Optional filter to request specific data. Use a single 'include' parameter with comma-separated values.","schema":{"type":"string","description":"Optional filter to request specific data. Use a single 'include' parameter with comma-separated values.","examples":["native,tokens,staking","native,tokens","native,staking","native","tokens","staking"],"uniqueKey":"","typeLabel":"string"}},"eb8addd6-4bab-4667-bba3-7e5c0ab60b37":{"in":"query","name":"pubkey","description":"Optional public key (in hex format) associated with the accountId. Required for Bitcoin's Babylon Staking data.","schema":{"type":"string","description":"Optional public key (in hex format) associated with the accountId. Required for Bitcoin's Babylon Staking data.","uniqueKey":"","typeLabel":"string"}}},"responses":{"31abe15f-ff1f-4e2c-acb9-045c9e489ef7":{"description":"Returns the current balance information for the specified address and chain ID.","content":{"application/json":{"schema":{"type":"object","properties":{"chainId":{"type":"string","enum":["algorand","cosmoshub","cosmoshub-testnet","osmosis","osmosis-testnet","celestia","celestia-testnet","dydx","axelar","ethereum","sepolia","hoodi","holesky","zksync","zksync-sepolia","injective-evm-testnet","base","base-sepolia","optimism","optimism-sepolia","arbitrum","arbitrum-sepolia","bitcoin","bitcoin-testnet","bitcoin-signet","polygon","polygon-amoy","bsc","bsc-testnet","linea","linea-sepolia","avalanche","avalanche-fuji","gnosis","gnosis-chiado","moonbeam","moonriver","moonbase","fantom","mantle","rootstock","rootstock-testnet","litecoin","dogecoin","ton","chiliz","chiliz-testnet","injective","akash","band","dymension","kyve","terra2","stargaze","tron","evmos","irisnet","juno","lum-network","omniflix","sei","medibloc","passage","quasar","seda","sommelier","shentu","stride","chihuahua","bitsong","persistence","comdex","fetch-ai","humans-ai","ki","likecoin","provenance","quicksilver","saga","kava","starknet","starknet-sepolia","babylon","babylon-testnet","monad-testnet","berachain","berachain-bepolia","cronos","world-chain","world-chain-sepolia","hyperliquid","solana","aptos","aptos-testnet","stellar","stellar-testnet"],"isRequired":true,"uniqueKey":"chainId","typeLabel":"enum\u003cstring>"},"accountId":{"type":"string","isRequired":true,"uniqueKey":"accountId","typeLabel":"string"},"balances":{"type":"object","properties":{"native":{"type":"object","properties":{"available":{"type":"string","description":"Amount of native currency that is immediately available for using. This excludes amounts that are locked in staking positions.","isRequired":true,"uniqueKey":"balances.native.available","typeLabel":"string"},"total":{"type":"string","description":"Total amount of native currency owned by the account, including both available and locked amounts (staking positions).","isRequired":true,"uniqueKey":"balances.native.total","typeLabel":"string"},"unconfirmed":{"type":"string","description":"Amount of native currency that is either pending (mempool) or not yet fully confirmed (not enough block confirmations). Relevant for chains with long confirmation times (like Bitcoin).","uniqueKey":"balances.native.unconfirmed","typeLabel":"string"}},"required":["available","total"],"uniqueKey":"balances.native","typeLabel":"object"},"tokens":{"type":"array","items":{"type":"object","properties":{"token":{"type":"object","properties":{"type":{"type":"string","enum":["TRC10","TRC20","ASA","ERC20","IBC","JETTON","SPL","APTOS_COIN","STELLAR_ASSET"],"isRequired":true,"uniqueKey":"balances.tokens.items.[INDEX].token.type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","isRequired":true,"uniqueKey":"balances.tokens.items.[INDEX].token.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"balances.tokens.items.[INDEX].token.name","typeLabel":"string"},"ticker":{"type":"string","isRequired":true,"uniqueKey":"balances.tokens.items.[INDEX].token.ticker","typeLabel":"string"},"decimals":{"type":"string","isRequired":true,"uniqueKey":"balances.tokens.items.[INDEX].token.decimals","typeLabel":"string"},"contractAddress":{"type":"string","uniqueKey":"balances.tokens.items.[INDEX].token.contractAddress","typeLabel":"string"}},"required":["type","id","name","ticker","decimals"],"isRequired":true,"uniqueKey":"balances.tokens.items.[INDEX].token","typeLabel":"object"},"amount":{"type":"string","description":"Current balance of this token owned by the account. The amount is expressed in the token's smallest unit (based on its decimals).","isRequired":true,"uniqueKey":"balances.tokens.items.[INDEX].amount","typeLabel":"string"}},"required":["token","amount"],"uniqueKey":"balances.tokens.items.[INDEX]","typeLabel":"object"},"uniqueKey":"balances.tokens","typeLabel":"object[]"},"staking":{"type":"object","properties":{"total":{"type":"string","description":"Total amount of native currency involved in staking positions (locked + unlocking + unlocked).","isRequired":true,"uniqueKey":"balances.staking.total","typeLabel":"string"},"locked":{"type":"string","description":"Amount of native currency currently locked in staking positions.","isRequired":true,"uniqueKey":"balances.staking.locked","typeLabel":"string"},"unlocking":{"type":"string","description":"Amount of native currency that is in the process of being unstaked (during unbonding period).","isRequired":true,"uniqueKey":"balances.staking.unlocking","typeLabel":"string"},"unlocked":{"type":"string","description":"Amount of native currency that has completed the unbonding period and is ready to be withdrawn.","isRequired":true,"uniqueKey":"balances.staking.unlocked","typeLabel":"string"},"positions":{"type":"array","items":{"type":"object","properties":{"validatorAddresses":{"type":"array","items":{"type":"string","uniqueKey":"balances.staking.positions.items.[INDEX].validatorAddresses.items.[INDEX]","typeLabel":"string"},"description":"List of validator addresses involved in staking position.","isRequired":true,"uniqueKey":"balances.staking.positions.items.[INDEX].validatorAddresses","typeLabel":"string[]"},"amount":{"type":"string","description":"Amount of native currency used in this specific staking position.","isRequired":true,"uniqueKey":"balances.staking.positions.items.[INDEX].amount","typeLabel":"string"},"status":{"type":"string","enum":["free","pending","locked","unlocking","unlocked","slashed"],"isRequired":true,"uniqueKey":"balances.staking.positions.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"stakeId":{"type":"string","description":"Unique identifier of a staking position. If provided in the account state data, it must be provided back in the transaction data when encoding a staking transaction.","uniqueKey":"balances.staking.positions.items.[INDEX].stakeId","typeLabel":"string"},"completionDate":{"type":"string","description":"Unix timestamp (in milliseconds) when the current position status will expire, when relevant.","uniqueKey":"balances.staking.positions.items.[INDEX].completionDate","typeLabel":"string"}},"required":["validatorAddresses","amount","status"],"uniqueKey":"balances.staking.positions.items.[INDEX]","typeLabel":"object"},"description":"Detailed list of individual staking positions.","isRequired":true,"uniqueKey":"balances.staking.positions","typeLabel":"object[]"},"rewards":{"type":"object","properties":{"native":{"type":"array","items":{"type":"object","properties":{"validatorAddress":{"type":"string","isRequired":true,"uniqueKey":"balances.staking.rewards.native.items.[INDEX].validatorAddress","typeLabel":"string"},"amount":{"type":"string","description":"Amount of unclaimed staking rewards in native currency from this validator.","isRequired":true,"uniqueKey":"balances.staking.rewards.native.items.[INDEX].amount","typeLabel":"string"}},"required":["validatorAddress","amount"],"uniqueKey":"balances.staking.rewards.native.items.[INDEX]","typeLabel":"object"},"description":"List of unclaimed staking rewards in native currency, per validator.","isRequired":true,"uniqueKey":"balances.staking.rewards.native","typeLabel":"object[]"},"tokens":{"type":"array","items":{"type":"object","properties":{"token":{"type":"object","properties":{"type":{"type":"string","enum":["TRC10","TRC20","ASA","ERC20","IBC","JETTON","SPL","APTOS_COIN","STELLAR_ASSET"],"isRequired":true,"uniqueKey":"balances.staking.rewards.tokens.items.[INDEX].token.type","typeLabel":"enum\u003cstring>"},"id":{"type":"string","isRequired":true,"uniqueKey":"balances.staking.rewards.tokens.items.[INDEX].token.id","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"balances.staking.rewards.tokens.items.[INDEX].token.name","typeLabel":"string"},"ticker":{"type":"string","isRequired":true,"uniqueKey":"balances.staking.rewards.tokens.items.[INDEX].token.ticker","typeLabel":"string"},"decimals":{"type":"string","isRequired":true,"uniqueKey":"balances.staking.rewards.tokens.items.[INDEX].token.decimals","typeLabel":"string"},"contractAddress":{"type":"string","uniqueKey":"balances.staking.rewards.tokens.items.[INDEX].token.contractAddress","typeLabel":"string"}},"required":["type","id","name","ticker","decimals"],"isRequired":true,"uniqueKey":"balances.staking.rewards.tokens.items.[INDEX].token","typeLabel":"object"},"amount":{"type":"string","description":"Amount of unclaimed staking rewards in this token. The amount is expressed in the token's smallest unit.","isRequired":true,"uniqueKey":"balances.staking.rewards.tokens.items.[INDEX].amount","typeLabel":"string"},"validatorAddress":{"type":"string","uniqueKey":"balances.staking.rewards.tokens.items.[INDEX].validatorAddress","typeLabel":"string"}},"required":["token","amount"],"uniqueKey":"balances.staking.rewards.tokens.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"balances.staking.rewards.tokens","typeLabel":"object[]"}},"required":["native","tokens"],"description":"Information about unclaimed staking rewards, both in native currency and tokens.","uniqueKey":"balances.staking.rewards","typeLabel":"object"}},"required":["total","locked","unlocking","unlocked","positions"],"uniqueKey":"balances.staking","typeLabel":"object"}},"isRequired":true,"uniqueKey":"balances","typeLabel":"object"}},"required":["chainId","accountId","balances"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"chainId":"algorand","accountId":"\u003cstring>","balances":{"native":{"available":"\u003cstring>","total":"\u003cstring>","unconfirmed":"\u003cstring>"},"tokens":[{"token":{"type":"TRC10","id":"\u003cstring>","name":"\u003cstring>","ticker":"\u003cstring>","decimals":"\u003cstring>","contractAddress":"\u003cstring>"},"amount":"\u003cstring>"}],"staking":{"total":"\u003cstring>","locked":"\u003cstring>","unlocking":"\u003cstring>","unlocked":"\u003cstring>","positions":[{"validatorAddresses":["\u003cstring>"],"amount":"\u003cstring>","status":"free","stakeId":"\u003cstring>","completionDate":"\u003cstring>"}],"rewards":{"native":[{"validatorAddress":"\u003cstring>","amount":"\u003cstring>"}],"tokens":[{"token":{"type":"TRC10","id":"\u003cstring>","name":"\u003cstring>","ticker":"\u003cstring>","decimals":"\u003cstring>","contractAddress":"\u003cstring>"},"amount":"\u003cstring>","validatorAddress":"\u003cstring>"}]}}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"89552511-4817-479c-9ace-cbb49815cb06":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","scopes":[]}}},"servers":{"0643b805-9e00-4b0b-be35-a5fe13c17688":{"url":"https://api.adamik.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","scopes":[]},"schema":{"title":"Authorization","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"https://api.adamik.io/openapi.json"},"subdomain":"adamiksas","siteName":"Adamik","title":"Adamik Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-10-14T07:25:51.834Z","originalFileLocation":"api-reference/account/get-account-state-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=\"Returns the state of a specified account identifier (address or xpub) and chain ID, focusing on balance information. The response includes details on native asset balances, token balances, and staking balances. This endpoint supports optional filters to refine the results, making it essential for wallet applications to display accurate and tailored account information.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Adamik\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/adamiksas/4Yt1_currL5yPrgJ/_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/adamiksas/4Yt1_currL5yPrgJ/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/adamiksas/4Yt1_currL5yPrgJ/_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/adamiksas/4Yt1_currL5yPrgJ/_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/adamiksas/4Yt1_currL5yPrgJ/_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/adamiksas/4Yt1_currL5yPrgJ/_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/adamiksas/4Yt1_currL5yPrgJ/_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/adamiksas/4Yt1_currL5yPrgJ/_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/adamiksas/4Yt1_currL5yPrgJ/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Adamik Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Streamline blockchain integration with Adamik’s powerful API tools. Access comprehensive guides, resources, and support to unlock seamless multichain connectivity. Fast, reliable, and easy to use — everything you need in one place.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Adamik\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.adamik.io/api-reference/account/get-account-state-balances\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://adamik-public-media.s3.eu-north-1.amazonaws.com/Social+Media/bandeau.svg\">\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=\"Adamik Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Streamline blockchain integration with Adamik’s powerful API tools. Access comprehensive guides, resources, and support to unlock seamless multichain connectivity. Fast, reliable, and easy to use — everything you need in one place.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://adamik-public-media.s3.eu-north-1.amazonaws.com/Social+Media/bandeau.svg\">\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/adamiksas/4Yt1_currL5yPrgJ/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Adamik\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4261F4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.adamik.io/api-reference/account/get-account-state-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/account/get-account-state-balances.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.adamik.io/#organization\",\"name\":\"Adamik\",\"url\":\"https://docs.adamik.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/adamiksas/YkY6Yhgmc8Rl2xni/logo/blue.svg?fit=max\u0026auto=format\u0026n=YkY6Yhgmc8Rl2xni\u0026q=85\u0026s=c8c34c5b216ccb9520ff3961f5b729bf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.adamik.io#website\",\"name\":\"Adamik\",\"url\":\"https://docs.adamik.io\",\"publisher\":{\"@id\":\"https://docs.adamik.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.adamik.io/api-reference/account/get-account-state-balances#webpage\",\"url\":\"https://docs.adamik.io/api-reference/account/get-account-state-balances\",\"name\":\"Get Account State (Balances)\",\"description\":\"Returns the state of a specified account identifier (address or xpub) and chain ID, focusing on balance information. The response includes details on native asset balances, token balances, and staking balances. This endpoint supports optional filters to refine the results, making it essential for wallet applications to display accurate and tailored account information.\",\"dateModified\":\"2025-10-14T07:25:51.834Z\",\"isPartOf\":{\"@id\":\"https://docs.adamik.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.adamik.io/api-reference/account/get-account-state-balances#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.adamik.io/api-reference/account/get-account-state-balances#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Adamik\",\"item\":\"https://docs.adamik.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Account State (Balances)\",\"item\":\"https://docs.adamik.io/api-reference/account/get-account-state-balances\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.adamik.io/api-reference/account/get-account-state-balances#apireference\",\"headline\":\"Get Account State (Balances)\",\"name\":\"Get Account State (Balances)\",\"description\":\"Returns the state of a specified account identifier (address or xpub) and chain ID, focusing on balance information. The response includes details on native asset balances, token balances, and staking balances. This endpoint supports optional filters to refine the results, making it essential for wallet applications to display accurate and tailored account information.\",\"url\":\"https://docs.adamik.io/api-reference/account/get-account-state-balances\",\"mainEntityOfPage\":{\"@id\":\"https://docs.adamik.io/api-reference/account/get-account-state-balances#webpage\"},\"image\":\"https://adamik-public-media.s3.eu-north-1.amazonaws.com/Social+Media/bandeau.svg\",\"dateModified\":\"2025-10-14T07:25:51.834Z\",\"publisher\":{\"@id\":\"https://docs.adamik.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.adamik.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Adamik\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Adamik","nav":{"global":null,"anchors":[{"anchor":"Introduction","icon":"house","pages":[{"title":"Introduction","href":"/get_started/welcome"}]},{"anchor":"API Reference","icon":"code","groups":[{"group":"","pages":[{"title":"Open API Specification","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api","href":"/api-reference/open-api-specification"}]},{"group":"Chain","pages":[{"title":"Get Supported Chains","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api/chains","href":"/api-reference/chain/get-supported-chains"},{"title":"Get Chain Details","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api/chains/{chainId}","href":"/api-reference/chain/get-chain-details"},{"title":"Get Token Details","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api/{chainId}/token/{tokenId}","href":"/api-reference/chain/get-token-details"},{"title":"Get Chain Validators","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api/{chainId}/validators","href":"/api-reference/chain/get-chain-validators"}]},{"group":"Transaction","pages":[{"title":"Get Transaction Details","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api/{chainId}/transaction/{transactionId}","href":"/api-reference/transaction/get-transaction-details"},{"title":"Encode a Transaction","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json post /api/{chainId}/transaction/encode","href":"/api-reference/transaction/encode-a-transaction"},{"title":"Validate Transaction","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json post /api/{chainId}/transaction/validate","href":"/api-reference/transaction/validate-transaction"},{"title":"Broadcast Transaction","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json post /api/{chainId}/transaction/broadcast","href":"/api-reference/transaction/broadcast-transaction"},{"title":"Broadcast Raw Transaction","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json post /api/{chainId}/transaction/broadcast/raw","href":"/api-reference/transaction/broadcast-raw-transaction"}]},{"group":"Utils","pages":[{"title":"Pubkey to Address","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json post /api/{chainId}/address/encode","href":"/api-reference/utils/pubkey-to-address"},{"title":"Validate Address","description":"Validates the specified address for the given chain ID, returning true if the address is valid, otherwise false.","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json post /api/{chainId}/address/validate","href":"/api-reference/utils/validate-address"}]},{"group":"Account","pages":[{"title":"Get Account State (Balances)","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api/{chainId}/account/{accountId}/state","href":"/api-reference/account/get-account-state-balances"},{"title":"Get Account Tokens (paginated)","description":"Returns the tokens (amount and details) held by a specified account identifier and chain ID. This endpoint allows for pagination over the returned tokens.","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api/{chainId}/account/{accountId}/state/tokens","href":"/api-reference/account/get-account-tokens-paginated"},{"title":"Get Account History","deprecated":null,"version":null,"openapi":"https://api.adamik.io/openapi.json get /api/{chainId}/account/{accountId}/history","href":"/api-reference/account/get-account-history"}]}]},{"anchor":"Guides and Tutorials","icon":"book","pages":[{"title":"Guides and Tutorials","href":"/guides/e2e-examples/using-Adamik-API-with-Ethereum"}]}]},"basePath":"","title":"Adamik Documentation","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}