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

                  Historical Balances

                  GET/v1/evm/balances/historical

                  Returns wallet token balance changes over time in OHLCV format.

                  OHLCV historical depth is subject to plan restrictions.

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

                  पैरामीटर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

                    आवश्यक
                    contract
                    string

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

                      interval
                      string

                      The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).
                      *Plan restricted.

                      • डिफ़ॉल्ट मान: 1d
                      • स्वीकृत मान: 1h, 4h, 1d, 1w
                      1d
                      start_time
                      string

                      UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

                      • डिफ़ॉल्ट मान: 2025-10-20
                      end_time
                      string

                      UNIX timestamp in seconds or date string (e.g. "2025-01-01T00:00:00Z", "2025-01-01", ...).

                      • डिफ़ॉल्ट मान: 2050-01-01
                      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 पर संपादित करें⁠

                      Native BalancesToken Holders
                      इस एंडपॉइंट का परीक्षण करें

                      1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/balances/historical?network=mainnet&address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045&contract=0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee&interval=1d&start_time=2025-10-20&end_time=2050-01-01&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                      1{2  "data": [3    {4      "datetime": "2025-10-09 00:00:00",5      "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",6      "contract": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",7      "open": 29.589346973619755,8      "high": 50.783103394640676,9      "low": 0.7830483276016842,10      "close": 0.7841551025245886,11      "name": "Native",12      "symbol": "ETH",13      "decimals": 18,14      "network": "mainnet"15    }16  ]17}
                      The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service