Docs
खोज⌘ K
  • Home
  • The Graph के बारे में
  • समर्थित नेटवर्क
  • Protocol Contracts
  • सबग्राफ
    • सबस्ट्रीम
      • टोकन API
        • Hypergraph
          • AI Suite
            • Overview
            • Indexer टूलिंग
              • GraphTally Guide
              • Supported Network Requirements
              • Chain Integration Process Overview
              • नई श्रृंखला एकीकरण
              • Graph Horizon
                • संसाधन
                  टोकन API > EVM Token Endpoints

                  Token Balances

                  GET/v1/evm/balances

                  Returns ERC-20 token balances for a wallet address.

                  क्वेरी पैरामीटर

                  पैरामीटरDescriptionमान
                  network
                  string

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

                  • स्वीकृत मान: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
                  आवश्यक
                  mainnet
                  address
                  string

                  Filter by address
                  Single value or array of values* (separate multiple values with ,)
                  *Plan restricted.

                    आवश्यक
                    contract
                    string

                    Filter by contract address
                    Single value or array of values* (separate multiple values with ,)
                    *Plan restricted.

                      include_null_balances
                      boolean

                      Include zero/null balances in results

                        limit
                        integer

                        Number of items* returned in a single request.
                        *Plan restricted.

                        • डिफ़ॉल्ट मान: 10
                        • न्यूनतम मान: 1
                        • अधिकतम मान : 1000
                        page
                        integer

                        Page number to fetch.
                        Empty data array signifies end of results.

                        • डिफ़ॉल्ट मान: 1
                        • न्यूनतम मान: 1
                        • अधिकतम मान : 767465558638

                        संभावित प्रतिक्रियाएँ

                        स्थितिDescription
                        200

                        Successful Response

                        400

                        Client side error

                        401

                        Authentication failed

                        403

                        Forbidden

                        404

                        Not found

                        500

                        Server side error

                        ⁠GitHub पर संपादित करें⁠

                        Token TransfersNative Balances
                        इस एंडपॉइंट का परीक्षण करें

                        1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/balances?network=mainnet&address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045&contract=0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48&include_null_balances=false&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                        1{2  "data": [3    {4      "last_update": "2025-10-08 07:49:47",5      "last_update_block_num": 23531651,6      "last_update_timestamp": 1759909787,7      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",8      "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",9      "amount": "17058407780",10      "value": 17058.40778,11      "name": "USD Coin",12      "symbol": "USDC",13      "decimals": 6,14      "network": "mainnet"15    }16  ]17}
                        The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service