Skip to main content

Specific Queries on Address and Balances

Get Native MATIC and Token Balances on Polygon for an Address​

Get both the native MATIC balance and all ERC-20 token balances for a Polygon address in one query. The balance field returns the native balance, while balances(currency: {not: "MATIC"}) excludes the native token from the token list. Also retrieves smart contract attributes for the address. Run query.

Variations: Remove the not filter to include MATIC in the token list. Add currency: {is: "..."} for a specific token. Switch network to ethereum, bsc, or any EVM chain. Use aliases to rename fields for cleaner responses.

query MyQuery {
  ethereum(network: matic) {
    address(address: {is: "0xc16157e00b1bff1522c6f01246b4fb621da048d0"}) {
      native_balance: balance
      balances(currency: {not: "MATIC"}) {
        value
        currency {
          address
          name
          symbol
        }
      }
      smartContract {
        attributes {
          address {
            annotation
            address
          }
        }
      }
    }
  }
}

The value and balance fields return Float values (not strings).