> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metalntwx.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get gas-token balance

> 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`.



## OpenAPI

````yaml /reference/json-rpc/json-rpc.json post /eth_getBalance
openapi: 3.1.0
info:
  title: Metal JSON-RPC
  version: 1.0.0
  description: Interactive playground for Metal's public JSON-RPC endpoints.
servers:
  - 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
  - url: https://rpc-devnet.metalntwx.com
    description: Devnet
security: []
tags:
  - name: Chain
    description: Identify the chain and its head.
  - name: Consensus
    description: Simplex finality, node build, and gas-token metadata.
  - name: Blocks
    description: Read blocks with Metal's millisecond timestamps and proposer.
  - name: State
    description: Read accounts, contracts, and storage.
  - name: Gas
    description: Quote gas in MIP20 gas-token base units.
  - name: Transactions
    description: Submit and inspect transactions.
  - name: Logs
    description: Query event logs.
  - name: MIP20
    description: Gas-token pricing detail standard Ethereum responses cannot represent.
paths:
  /eth_getBalance:
    post:
      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`.
      operationId: eth_getBalance
      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`.
                id:
                  type: integer
                  default: 1
                  description: Request identifier echoed back in the response.
                method:
                  type: string
                  enum:
                    - eth_getBalance
                  default: eth_getBalance
                  description: JSON-RPC method name.
                params:
                  type: array
                  prefixItems:
                    - type: string
                      default: '0x0000000000000000000000000000000000000000'
                      description: Account address.
                    - type: string
                      default: latest
                      description: >-
                        Block selector: `"latest"`, `"pending"`, `"safe"`,
                        `"finalized"`, `"earliest"`, or a hex block number such
                        as `"0x1cf741"`.
                  items: false
                  minItems: 2
                  maxItems: 2
                  default:
                    - '0x0000000000000000000000000000000000000000'
                    - latest
                  description: '`[address, blockSelector]`.'
                  x-default:
                    - '0x0000000000000000000000000000000000000000'
                    - latest
            example:
              jsonrpc: '2.0'
              id: 1
              method: eth_getBalance
              params:
                - '0x0000000000000000000000000000000000000000'
                - latest
      responses:
        '200':
          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'
                  id:
                    type: integer
                  result:
                    type: string
                    description: >-
                      Default gas-token balance in base units, as a hex
                      quantity.
              example:
                jsonrpc: '2.0'
                id: 1
                result: '0x0'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.