Docs
Search⌘ K
  • Home
  • About The Graph
  • Supported Networks
  • Protocol Contracts
  • Subgraphs
    • Substreams
      • Token API
        • AI Suite
          • Indexing
            • Resources
              Token API > EVM Endpoints

              Balances by Address

              GET/balances/evm/{address}

              Provides latest ERC-20 & Native balances by wallet address.

              Path Parameters

              ParameterDescriptionValue
              address
              string

              Filter by address

                Required

                Query Parameters

                ParameterDescriptionValue
                network_id
                string

                The Graph Network ID for EVM networks https://thegraph.com/networks

                • Default value: mainnet
                • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, matic, optimism, unichain
                Required
                mainnet
                contract
                string

                Filter by address

                  limit
                  integer

                  The maximum number of items returned in a single request.

                  • Default value: 10
                  • Minimum value: 1
                  • Maximum value: 1000
                  page
                  integer

                  The page number of the results to return.

                  • Default value: 1
                  • Minimum value: 1
                  • Maximum value: 767465558638

                  Potential Responses

                  StatusDescription
                  200Successful Response
                  400Client side error
                  401Authentication failed
                  403Forbidden
                  404Not found
                  500Server side error
                  ⁠Edit on GitHub⁠

                  Quick StartTransfer Events
                  Test this endpoint

                  1curl --request GET \2  --url 'https://token-api.thegraph.com/balances/evm/{address}?network_id=mainnet&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                  1{2  "data": [3    {4      "block_num": 22968741,5      "last_balance_update": "2025-07-21 16:24:47",6      "contract": "0x6993301413c1867aafe2caaa692ec53a0118f06e",7      "amount": "7917650000000000000000",8      "value": 7917.65,9      "name": "BOLD",10      "symbol": "BOLD",11      "decimals": 18,12      "network_id": "mainnet"13    }14  ]15}
                  The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service