Executes a call against the selected block’s state without creating a transaction. Use this for MIP20 balanceOf and other view functions. value must be 0 — Metal has no native asset.
{"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/call-a-contract-read-only","slug":"/reference/json-rpc/state/call-a-contract-read-only","pageMetadata":{"title":"Call a contract (read-only)","description":"Executes a call against the selected block's state without creating a transaction. Use this for MIP20 `balanceOf` and other view functions. `value` must be `0` — Metal has no native asset.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_call","href":"/reference/json-rpc/state/call-a-contract-read-only","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: [\"Executes a call against the selected block’s state without creating a transaction. Use this for MIP20 \", _jsx(_components.code, {\n children: \"balanceOf\"\n }), \" and other view functions. \", _jsx(_components.code, {\n children: \"value\"\n }), \" must be \", _jsx(_components.code, {\n children: \"0\"\n }), \" — Metal has no native asset.\"]\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":"Call a contract (read-only)","description":"Executes a call against the selected block's state without creating a transaction. Use this for MIP20 `balanceOf` and other view functions. `value` must be `0` — Metal has no native asset.","deprecated":null,"version":null,"openapi":"/reference/json-rpc/json-rpc.json post /eth_call","href":"/reference/json-rpc/state/call-a-contract-read-only","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"eth_call","tags":["State"],"summary":"Call a contract (read-only)","description":"Executes a call against the selected block's state without creating a transaction. Use this for MIP20 `balanceOf` and other view functions. `value` must be `0` — Metal has no native asset.","requestBody":"cda41179-9547-43f3-ba27-0666995c0c51","responses":{"200":"ba000d49-ee9c-4483-a87c-05d934bbc0a1"},"method":"post","type":"path","servers":["caef7baf-3d86-41dc-8f71-87640e73c748","37d41364-2f26-4bb6-a72b-675139ae51eb"],"security":[],"path":"/eth_call","baseUrlOptions":["https://rpc-testnet.metalntwx.com/v1/{endpointId}","https://rpc-devnet.metalntwx.com"],"title":"Call a contract (read-only)","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.jsonrpc":"2.0","body.id":1,"body.method":"eth_call"}],"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_call"],"default":"eth_call","description":"JSON-RPC method name.","isRequired":true,"uniqueKey":"method","typeLabel":"enum\u003cstring>"},"params":{"type":"object","_tupleOriginal":true,"properties":{"[0]":{"type":"object","description":"The call to execute.","properties":{"from":{"type":"string","description":"Sender address.","uniqueKey":"params.[0].from","typeLabel":"string"},"to":{"type":"string","description":"Target contract or account address.","uniqueKey":"params.[0].to","typeLabel":"string"},"data":{"type":"string","description":"Call data, ABI-encoded.","uniqueKey":"params.[0].data","typeLabel":"string"},"gas":{"type":"string","description":"Gas limit as a hex quantity.","uniqueKey":"params.[0].gas","typeLabel":"string"}},"default":{"to":"0x0000000000000000000000000000000000000000","data":"0x"},"uniqueKey":"params.[0]","typeLabel":"object"},"[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":"`[callObject, blockSelector]`.","isRequired":true,"uniqueKey":"params","typeLabel":"tuple"}},"uniqueKey":"","typeLabel":"object"},"example":{"jsonrpc":"2.0","id":1,"method":"eth_call","params":[{"to":"0x0000000000000000000000000000000000000000","data":"0x"},"latest"]},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":1,"method":"eth_call","params":[{"to":"0x0000000000000000000000000000000000000000","data":"0x"},"latest"]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"ba000d49-ee9c-4483-a87c-05d934bbc0a1":{"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":"Return data of the call as hex data.","uniqueKey":"result","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"jsonrpc":"2.0","id":1,"result":"0x"},"examples":{"Example":{"title":"Example","value":{"jsonrpc":"2.0","id":1,"result":"0x"}}},"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":"Call a contract (read-only) - Metal Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-22T08:24:07.547Z","originalFileLocation":"reference/json-rpc/state/call-a-contract-read-only.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=\"Executes a call against the selected block\u0026#x27;s state without creating a transaction. Use this for MIP20 balanceOf and other view functions. value must be 0 — Metal has no native asset.\">\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=\"Call a contract (read-only) - Metal Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Executes a call against the selected block\u0026#x27;s state without creating a transaction. Use this for MIP20 balanceOf and other view functions. value must be 0 — Metal has no native asset.\">\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/call-a-contract-read-only\">\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=Call+a+contract+%28read-only%29\u0026amp;description=Executes+a+call+against+the+selected+block%27s+state+without+creating+a+transaction.+Use+this+for+MIP20+%60balanceOf%60+and+other+view+functions.+%60value%60+must+be+%600%60+\u0026amp;theme=391fcc429c2f0a56224a63fc\u0026amp;signature=bae14ce647e67f7756ad6eb1d47028a505a42cdb2eb8d26b1a8d18244e45c0e6\">\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=\"Call a contract (read-only) - Metal Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Executes a call against the selected block\u0026#x27;s state without creating a transaction. Use this for MIP20 balanceOf and other view functions. value must be 0 — Metal has no native asset.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://nexus-ed339086.mintlify.site/_mintlify/api/og/v2?division=State\u0026amp;title=Call+a+contract+%28read-only%29\u0026amp;description=Executes+a+call+against+the+selected+block%27s+state+without+creating+a+transaction.+Use+this+for+MIP20+%60balanceOf%60+and+other+view+functions.+%60value%60+must+be+%600%60+\u0026amp;theme=391fcc429c2f0a56224a63fc\u0026amp;signature=bae14ce647e67f7756ad6eb1d47028a505a42cdb2eb8d26b1a8d18244e45c0e6\">\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/call-a-contract-read-only\">\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/call-a-contract-read-only.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/call-a-contract-read-only#webpage\",\"url\":\"https://docs.metalntwx.com/reference/json-rpc/state/call-a-contract-read-only\",\"name\":\"Call a contract (read-only)\",\"description\":\"Executes a call against the selected block's state without creating a transaction. Use this for MIP20 balanceOf and other view functions. value must be 0 — Metal has no native asset.\",\"dateModified\":\"2026-10-22T08:24:07.547Z\",\"isPartOf\":{\"@id\":\"https://docs.metalntwx.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/state/call-a-contract-read-only#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/state/call-a-contract-read-only#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"State\",\"item\":\"https://docs.metalntwx.com/reference/json-rpc/state/get-gas-token-balance\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Call a contract (read-only)\",\"item\":\"https://docs.metalntwx.com/reference/json-rpc/state/call-a-contract-read-only\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/state/call-a-contract-read-only#apireference\",\"headline\":\"Call a contract (read-only)\",\"name\":\"Call a contract (read-only)\",\"description\":\"Executes a call against the selected block's state without creating a transaction. Use this for MIP20 balanceOf and other view functions. value must be 0 — Metal has no native asset.\",\"url\":\"https://docs.metalntwx.com/reference/json-rpc/state/call-a-contract-read-only\",\"mainEntityOfPage\":{\"@id\":\"https://docs.metalntwx.com/reference/json-rpc/state/call-a-contract-read-only#webpage\"},\"dateModified\":\"2026-10-22T08:24:07.547Z\",\"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","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","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","description":"Returns EIP-1186 account and storage proofs against the selected block state root. Proof availability depends on the node retaining that state. The balance field is the native EVM account balance, not the default MIP20 balance returned by Metal eth_getBalance. To prove a MIP20 balance, query the token contract and its balance storage slot. Verify proofs against a trusted finalized header. See https://eips.ethereum.org/EIPS/eip-1186 for the standard response fields.","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","description":"Returns an estimate of the gas needed for the call or transaction, as a hex quantity.","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":"Call a contract (read-only) - 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"]}