Docs
Search⌘ K
  • Home
  • About The Graph
  • Supported Networks
  • Protocol Contracts
  • Subgraphs
    • Substreams
      • Token API
        • 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

            • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{40}$
            Required

            Query Parameters

            ParameterDescriptionValue
            network_id
            string

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

            • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, matic, optimism, unichain
            mainnet
            contract
            string
              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

              Potential Responses

              StatusDescription
              200Successful Response
              ⁠Edit on GitHub⁠

              CursorTransfer Events
              Test this endpoint

              1curl --request GET \2  --url 'https://token-api.thegraph.com/balances/evm/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045?network_id=mainnet&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'
              200 Example
              1{2  "data": [3    {4      "block_num": 22586773,5      "datetime": "2025-05-29 06:58:47",6      "contract": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",7      "amount": "237637742936991878321",8      "value": 237.63774293699188,9      "decimals": 18,10      "symbol": "ETH",11      "network_id": "mainnet"12    }13  ]14}
              The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service