Skip to main content

Address

The address allows us to retrieve information about a specific address including any smart contract.

Therefore, this api can be helpful to get the initial supply and other attributes of any token. Polygon (Matic) shares the EVM address model with Ethereum: the address API returns MATIC balance, annotations, balance history, and—for contracts—token metadata, protocol type, and on-chain attributes. Use it for wallet interfaces, token-supply lookups, and contract verification on Polygon's low-fee network before diving into transfer or DEX data.

Here is an example that demonstrates how to retrieve basic information about the USDT Token smart contract:

query {
  ethereum(network: matic) {
    address(address: {is: "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"}) {
      smartContract {
        attributes {
          address {
            address
            annotation
          }
          name
          value
          type
        }
        contractType
        protocolType
        currency {
          decimals
          name
          symbol
          tokenType
        }
      }
      balance
      annotation
      address
    }
  }
}
Filtering Addresses
  • address: Filter by a specific address or a list of addresses.

The following are available fields for the address:

  • address: Returns the address.
  • annotation: Returns the annotation of the address if available.
  • balance: Returns the current balance of the address.
  • balances: Returns the balance history of the address.
  • smartContract: Returns details if the address is that of a smart contract.
info

Sign up on our GraphQL IDE and get your Access Token, Read our guide on getting started.