Skip to main content

Address

The address api also allow you pull balance details including balance history.

You can filter using currency smart contract address and get balance for specific currency. In case of native currency, you can just mention "MATIC". The balance API is particularly useful for treasury dashboards, portfolio trackers, and reconciliation workflows where you need current or historical token holdings for an address across MATIC and ERC-20 assets on Polygon.

Here is an example on getting balance of 0x198905a3e2e3ffeb20169adf9ceaf0f9e66c35b9:

{
  ethereum(network: matic) {
    address(address: {is: "0x198905a3e2e3ffeb20169adf9ceaf0f9e66c35b9"}) {
      balances {
        currency {
          address
          name
          symbol
        }
        value
      }
    }
  }
}

Filtering Addresses
  • address: Filter by a specific address or a list of addresses.
  • currency : In balances we can filter using currency address.
  • history : You can get the balance history of an address and use block height and timestamp as filters.

The following are available fields for the address:

  • balances: Returns the details on Balances.
  • history: Returns the historical balance details.
  • currency: Returns the details of currency.
info

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