Skip to main content
A query that returns the current state of a smart contract instance, including its balance. Queries do not change the state of the smart contract or require network consensus. The information is returned from a single node processing the query. In Services release 0.50, Returning token balance information from the consensus node was deprecated with HIP-367. This query now returns token information by requesting the information from the Hedera Mirror Node APIs via /api/v1/accounts/{id}/tokens. Token symbol is not returned in the response. Smart Contract Info Response

Recommend Using Mirror Node REST API

For obtaining smart contract information and historical data, consider using the Mirror Node REST API endpoint Get Contract by ID which offers several advantages:
  • Cost-effective and scalable: Mirror node providers offer paid plans with a large number of queries included. The Hedera-hosted mirror node offers free queries with specific throttles for testing. While some SDK queries are currently free, these are subject to change in the future.
  • Performance: Mirror nodes don’t burden consensus nodes, allowing them to focus on processing transactions and providing efficient access to historical data without impacting network performance.
  • Historical data: Mirror nodes store complete transaction history, records, and events - ideal for analytics, auditing, and monitoring past activity.
📚 For more details, please read our blog post on querying data.
Query Signing Requirements
  • The client operator account’s private key (fee payer) is required to sign this query
Query Fees
  • Please see the transaction and query fees table for the base transaction fee
  • Please use the Hedera fee estimator to estimate your query fee

Methods

MethodTypeDescription
setContractId(<contractId>)ContractIdThe ID of the smart contract to return the token for