Docs
Search⌘ K
  • Home
  • حول The Graph
  • الشبكات المدعومة
  • Protocol Contracts
  • Subgraphs
    • متعدد-السلاسل
      • Token API
        • Hypergraph
          • AI Suite
            • Indexing
              • Resources
                Token API > EVM Endpoints

                Token Balances by Wallet Address

                GET/balances/evm/{address}

                The EVM Balances endpoint provides a snapshot of an account’s current token holdings. The endpoint returns the current balances of native and ERC-20 tokens held by a specified wallet address on an Ethereum-compatible blockchain.

                Path Parameters

                ParameterالوصفValue
                address
                string

                Filter by address

                  Required

                  Query Parameters

                  ParameterالوصفValue
                  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

                    Statusالوصف
                    200Successful Response
                    400Client side error
                    401Authentication failed
                    403Forbidden
                    404Not found
                    500Server side error
                    ⁠Edit on GitHub⁠

                    بداية سريعةHistorical Balances
                    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