Returns the account’s balance in the chain’s default MIP20 gas token. Metal has no native asset, so the method does not report ETH. For any other token, call the MIP20 contract’s balanceOf via eth_call.
Default gas-token balance in base units, as a hex quantity.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Metal Developer Docs","colors":{"primary":"#101010","light":"#FFFFFF","dark":"#101010"},"logo":{"light":"https://mintcdn.com/nexus-ed339086/8NETQ7EroQCQNtZt/logo/light.svg?fit=max\u0026auto=format\u0026n=8NETQ7EroQCQNtZt\u0026q=85\u0026s=8014698736b169612a6590ce69d58883","dark":"https://mintcdn.com/nexus-ed339086/8NETQ7EroQCQNtZt/logo/dark.svg?fit=max\u0026auto=format\u0026n=8NETQ7EroQCQNtZt\u0026q=85\u0026s=5a46b40554cde2b544365ab3757ac675","href":"https://metalntwx.com"},"favicon":"https://mintcdn.com/nexus-ed339086/CdWwGT0bcT9zD-Uw/favicon.svg?fit=max\u0026auto=format\u0026n=CdWwGT0bcT9zD-Uw\u0026q=85\u0026s=f35321352c5de28978c9d79e5631a2f1","api":{"playground":{"proxy":false},"examples":{"prefill":true}},"navbar":{"links":[{"href":"https://metalntwx.com","label":"Website"}]},"footer":{"socials":{}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"nexus-ed339086","hasAudioNarration":false,"actualSubdomain":"nexus-ed339086","customDomains":["docs.metalntwx.com"],"gitSource":{"type":"github","owner":"mx56db","repo":"metal","deployBranch":"main","contentDirectory":"docs/external-developers","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aebbbfaadab846ec705ccf3","collectionId":"43f0fced-43b0-4426-b139-006c89aba297","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aebbbfaadab846ec705ccf3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aebbbfaadab846ec705ccf3","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"Blockchain","count":110},{"language":"default","tag":"Reference","count":33},{"language":"default","tag":"JSON-RPC","count":27},{"language":"default","tag":"Build","count":26},{"language":"default","tag":"Learn","count":17},{"language":"default","tag":"Agents","count":13},{"language":"default","tag":"Start","count":11},{"language":"default","tag":"Interoperability","count":8},{"language":"default","tag":"Network fundamentals","count":8},{"language":"default","tag":"MIP410","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"vite-origin","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":"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":"reference/json-rpc/state/get-gas-token-balance","slug":"/reference/json-rpc/state/get-gas-token-balance","pageMetadata":{"title":"Get gas-token balance","description":"Returns the account's balance in the chain's default MIP20 gas token. Metal has no native asset, so the method does not report ETH. For any other token, call the MIP20 contract's `balanceOf` via `eth_call`.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getBalance","href":"/reference/json-rpc/state/get-gas-token-balance","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns the account’s balance in the chain’s default MIP20 gas token. Metal has no native asset, so the method does not report ETH. For any other token, call the MIP20 contract’s \", _jsx(_components.code, {\n children: \"balanceOf\"\n }), \" via \", _jsx(_components.code, {\n children: \"eth_call\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get gas-token balance","description":"Returns the account's balance in the chain's default MIP20 gas token. Metal has no native asset, so the method does not report ETH. For any other token, call the MIP20 contract's `balanceOf` via `eth_call`.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getBalance","href":"/reference/json-rpc/state/get-gas-token-balance","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"eth_getBalance","tags":["State"],"summary":"Get gas-token balance","description":"Returns the account's balance in the chain's default MIP20 gas token. Metal has no native asset, so the method does not report ETH. For any other token, call the MIP20 contract's `balanceOf` via `eth_call`.","requestBody":"ae24475d-96d6-485e-81f5-af2133dd1a11","responses":{"200":"a2dd82b8-0d64-467b-a351-b7a8558576eb"},"method":"post","type":"path","servers":["caef7baf-3d86-41dc-8f71-87640e73c748","37d41364-2f26-4bb6-a72b-675139ae51eb"],"security":[],"path":"/eth_getBalance","baseUrlOptions":["https://rpc-testnet.metalntwx.com/v1/{endpointId}","https://rpc-devnet.metalntwx.com"],"title":"Get gas-token balance","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.jsonrpc":"2.0","body.id":1,"body.method":"eth_getBalance"}],"disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["jsonrpc","id","method","params"],"properties":{"jsonrpc":{"type":"string","enum":["2.0"],"default":"2.0","description":"JSON-RPC protocol version. Always `2.0`.","isRequired":true,"uniqueKey":"jsonrpc","typeLabel":"enum\u003cstring>"},"id":{"type":"integer","default":1,"description":"Request identifier echoed back in the response.","isRequired":true,"uniqueKey":"id","typeLabel":"integer"},"method":{"type":"string","enum":["eth_getBalance"],"default":"eth_getBalance","description":"JSON-RPC method name.","isRequired":true,"uniqueKey":"method","typeLabel":"enum\u003cstring>"},"params":{"type":"object","_tupleOriginal":true,"properties":{"[0]":{"type":"string","default":"0x0000000000000000000000000000000000000000","description":"Account address.","uniqueKey":"params.[0]","typeLabel":"string"},"[1]":{"type":"string","default":"latest","description":"Block selector: `\"latest\"`, `\"pending\"`, `\"safe\"`, `\"finalized\"`, `\"earliest\"`, or a hex block number such as `\"0x1cf741\"`.","uniqueKey":"params.[1]","typeLabel":"string"}},"description":"`[address, blockSelector]`.","isRequired":true,"uniqueKey":"params","typeLabel":"tuple"}},"uniqueKey":"","typeLabel":"object"},"example":{"jsonrpc":"2.0","id":1,"method":"eth_getBalance","params":["0x0000000000000000000000000000000000000000","latest"]},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":1,"method":"eth_getBalance","params":["0x0000000000000000000000000000000000000000","latest"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"a2dd82b8-0d64-467b-a351-b7a8558576eb":{"description":"JSON-RPC 2.0 response. Errors are reported in-band via an `error` object with `code` and `message` in place of `result`.","content":{"application/json":{"schema":{"type":"object","properties":{"jsonrpc":{"type":"string","enum":["2.0"],"uniqueKey":"jsonrpc","typeLabel":"enum\u003cstring>"},"id":{"type":"integer","uniqueKey":"id","typeLabel":"integer"},"result":{"type":"string","description":"Default gas-token balance in base units, as a hex quantity.","uniqueKey":"result","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"jsonrpc":"2.0","id":1,"result":"0x0"},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":1,"result":"0x0"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{"caef7baf-3d86-41dc-8f71-87640e73c748":{"url":"https://rpc-testnet.metalntwx.com/v1/{endpointId}","variables":{"endpointId":{"default":"YOUR_ENDPOINT_ID","description":"Your endpoint ID from the Metal console. It is a credential, so keep it private. Paste it once, and the playground remembers it in this browser."}},"description":"Testnet"},"37d41364-2f26-4bb6-a72b-675139ae51eb":{"url":"https://rpc-devnet.metalntwx.com","description":"Devnet"}}},"originalFileLocation":"reference/json-rpc/json-rpc.json"},"subdomain":"nexus-ed339086","siteName":"Metal Developer Docs","title":"Get gas-token balance - Metal Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T08:24:07.503Z","originalFileLocation":"reference/json-rpc/state/get-gas-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=\"Returns the account\u0026#x27;s balance in the chain\u0026#x27;s default MIP20 gas token. Metal has no native asset, so the method does not report ETH. For any other token, call the MIP20 contract\u0026#x27;s balanceOf via eth_call.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Metal Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_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/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/nexus-ed339086/1R91Tpp7hAjZirY3/_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/nexus-ed339086/1R91Tpp7hAjZirY3/_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/nexus-ed339086/1R91Tpp7hAjZirY3/_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/nexus-ed339086/1R91Tpp7hAjZirY3/_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/nexus-ed339086/1R91Tpp7hAjZirY3/_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/nexus-ed339086/1R91Tpp7hAjZirY3/_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/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get gas-token balance - Metal Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the account\u0026#x27;s balance in the chain\u0026#x27;s default MIP20 gas token. Metal has no native asset, so the method does not report ETH. For any other token, call the MIP20 contract\u0026#x27;s balanceOf via eth_call.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Metal Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://nexus-ed339086.mintlify.site/_mintlify/api/og/v2?division=State\u0026amp;title=Get+gas-token+balance\u0026amp;description=Returns+the+account%27s+balance+in+the+chain%27s+default+MIP20+gas+token.+Metal+has+no+native+asset%2C+so+the+method+does+not+report+ETH.+For+any+other+token%2C+call+th\u0026amp;theme=391fcc429c2f0a56224a63fc\u0026amp;signature=32a01450faf6360614f85cdb210e8dcd8b654e176a59525bd98f49c6ee9df460\">\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 gas-token balance - Metal Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the account\u0026#x27;s balance in the chain\u0026#x27;s default MIP20 gas token. Metal has no native asset, so the method does not report ETH. For any other token, call the MIP20 contract\u0026#x27;s balanceOf via eth_call.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nexus-ed339086.mintlify.site/_mintlify/api/og/v2?division=State\u0026amp;title=Get+gas-token+balance\u0026amp;description=Returns+the+account%27s+balance+in+the+chain%27s+default+MIP20+gas+token.+Metal+has+no+native+asset%2C+so+the+method+does+not+report+ETH.+For+any+other+token%2C+call+th\u0026amp;theme=391fcc429c2f0a56224a63fc\u0026amp;signature=32a01450faf6360614f85cdb210e8dcd8b654e176a59525bd98f49c6ee9df460\">\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/nexus-ed339086/1R91Tpp7hAjZirY3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Metal Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#101010\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/reference/json-rpc/state/get-gas-token-balance.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.metalntwx.com/#organization\",\"name\":\"Metal Developer Docs\",\"url\":\"https://docs.metalntwx.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/nexus-ed339086/8NETQ7EroQCQNtZt/logo/light.svg?fit=max\u0026auto=format\u0026n=8NETQ7EroQCQNtZt\u0026q=85\u0026s=8014698736b169612a6590ce69d58883\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.metalntwx.com#website\",\"name\":\"Metal Developer Docs\",\"url\":\"https://docs.metalntwx.com\",\"publisher\":{\"@id\":\"https://docs.metalntwx.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance#webpage\",\"url\":\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance\",\"name\":\"Get gas-token balance\",\"description\":\"Returns the account's balance in the chain's default MIP20 gas token. Metal has no native asset, so the method does not report ETH. For any other token, call the MIP20 contract's balanceOf via eth_call.\",\"dateModified\":\"2026-10-22T08:24:07.503Z\",\"isPartOf\":{\"@id\":\"https://docs.metalntwx.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Metal Developer Docs\",\"item\":\"https://docs.metalntwx.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get gas-token balance\",\"item\":\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance#apireference\",\"headline\":\"Get gas-token balance\",\"name\":\"Get gas-token balance\",\"description\":\"Returns the account's balance in the chain's default MIP20 gas token. Metal has no native asset, so the method does not report ETH. For any other token, call the MIP20 contract's balanceOf via eth_call.\",\"url\":\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance\",\"mainEntityOfPage\":{\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance#webpage\"},\"dateModified\":\"2026-10-22T08:24:07.503Z\",\"publisher\":{\"@id\":\"https://docs.metalntwx.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.metalntwx.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Metal Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Metal Developer Docs","nav":{"global":null,"products":[{"product":"Blockchain","description":"Chain, asset standards, SDKs, and integration guides","tabs":[{"tab":"Start","pages":[{"title":"Start","href":"/start/introduction"}]},{"tab":"Build","pages":[{"title":"Build","href":"/build/prepare/design-a-payment-integration"}]},{"tab":"Learn","pages":[{"title":"Learn","href":"/learn/architecture"}]},{"tab":"Reference","pages":[{"title":"Reference","href":"/reference/contract-addresses"}]},{"tab":"JSON-RPC","groups":[{"group":"Getting started","pages":[{"title":"Metal JSON-RPC","icon":"rectangle-api","href":"/reference/json-rpc/overview"}]},{"group":"Chain","pages":[{"title":"Get the chain ID","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_chainId","href":"/reference/json-rpc/chain/get-the-chain-id"},{"title":"Get the latest block number","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_blockNumber","href":"/reference/json-rpc/chain/get-the-latest-block-number"}]},{"group":"Consensus","pages":[{"title":"Get consensus status","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /consensus_status","href":"/reference/json-rpc/consensus/get-consensus-status"},{"title":"Get a finality certificate","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_getFinalityCertificate","href":"/reference/json-rpc/consensus/get-a-finality-certificate"},{"title":"Get node build info","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_nodeInfo","href":"/reference/json-rpc/consensus/get-node-build-info"},{"title":"Get gas-token display metadata","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_nativeCurrency","href":"/reference/json-rpc/consensus/get-gas-token-display-metadata"}]},{"group":"Blocks","pages":[{"title":"Get a block by number","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getBlockByNumber","href":"/reference/json-rpc/blocks/get-a-block-by-number"},{"title":"Get a block by hash","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getBlockByHash","href":"/reference/json-rpc/blocks/get-a-block-by-hash"},{"title":"Get retained blob sidecars","description":"Returns the complete verified EIP-7594 sidecar bundle for a canonical finalized execution block hash. A null result also covers unknown, noncanonical, unfinalized, blob-free, or pruned blocks. Clients must verify the blobs and commitments against the ordered versioned hashes in the block transactions. This is a JSON-RPC retrieval method; Metal does not currently expose the standard Beacon blobs HTTP route.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_getBlobSidecars","href":"/reference/json-rpc/blocks/get-retained-blob-sidecars"}]},{"group":"State","pages":[{"title":"Get gas-token balance","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getBalance","href":"/reference/json-rpc/state/get-gas-token-balance"},{"title":"Get account nonce","description":"Returns the number of transactions sent from the address, as a hex quantity. Use the `\"pending\"` selector to pick the next nonce for a new transaction.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getTransactionCount","href":"/reference/json-rpc/state/get-account-nonce"},{"title":"Get contract code","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getCode","href":"/reference/json-rpc/state/get-contract-code"},{"title":"Get a storage slot","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getStorageAt","href":"/reference/json-rpc/state/get-a-storage-slot"},{"title":"Get account and storage proofs","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getProof","href":"/reference/json-rpc/state/get-account-and-storage-proofs"},{"title":"Call a contract (read-only)","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_call","href":"/reference/json-rpc/state/call-a-contract-read-only"}]},{"group":"Gas","pages":[{"title":"Estimate gas","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_estimateGas","href":"/reference/json-rpc/gas/estimate-gas"},{"title":"Get the gas price","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_gasPrice","href":"/reference/json-rpc/gas/get-the-gas-price"},{"title":"Get the max priority fee","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_maxPriorityFeePerGas","href":"/reference/json-rpc/gas/get-the-max-priority-fee"},{"title":"Get fee history","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_feeHistory","href":"/reference/json-rpc/gas/get-fee-history"}]},{"group":"Transactions","pages":[{"title":"Submit a raw transaction","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_sendRawTransaction","href":"/reference/json-rpc/transactions/submit-a-raw-transaction"},{"title":"Get a transaction by hash","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getTransactionByHash","href":"/reference/json-rpc/transactions/get-a-transaction-by-hash"},{"title":"Get a transaction receipt","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getTransactionReceipt","href":"/reference/json-rpc/transactions/get-a-transaction-receipt"}]},{"group":"Logs","pages":[{"title":"Query event logs","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_getLogs","href":"/reference/json-rpc/logs/query-event-logs"}]},{"group":"MIP20","pages":[{"title":"List pending MIP20 transactions","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_pendingMip20Transactions","href":"/reference/json-rpc/mip20/list-pending-mip20-transactions"},{"title":"Get MIP20 gas for a transaction","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_getMip20GasByTransactionHash","href":"/reference/json-rpc/mip20/get-mip20-gas-for-a-transaction"},{"title":"Get MIP20 gas for a block","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /metal_getMip20GasByBlock","href":"/reference/json-rpc/mip20/get-mip20-gas-for-a-block"}]}]}]},{"product":"Agents","description":"Agents paying and getting paid over x402","pages":[{"title":"Agents","href":"/agents/quickstart"}]}]},"basePath":"","title":"Get gas-token balance - Metal Developer Docs","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Myd8dsju.js","utils-C2HkQgW0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-8rSppmTv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B6MjiCFm.js","snippetPresets-DwrSAONL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-1-a5UQKQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C541m7wZ.js","shallow-CWELCZ77.js","getApiPlaygroundDisplay-CTo5Zn03.js","CodeSnippet-D--dzvnl.js","CodeSnippets-DM3cXEDh.js","Page-CxAy5y67.js","getPastedJson-C-VECgcL.js","icon-BPq2-Mg3.js","MethodPill-D9J5cUHd.js","DuplicateIcon-BqHaxUnD.js","createIcon-CIbcZHp9.js","DynamicMarkdown-BKiHAm_d.js","SectionHeading-DstQXt3H.js","axios-vUo_bRtp.js","Markdown-CpxgzsKA.js","clsx-C5EfhVm0.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CJ9Oly2E.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Mk6P3qvh.js"]}