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

              Transfer Events

              GET/transfers/evm

              Provides ERC-20 & Native transfer events.

              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
              from
              string

              Filter by address

                to
                string

                Filter by address

                  contract
                  string

                  Filter by address

                    startTime
                    integer

                    UNIX timestamp in seconds.

                    • Minimum value: -9007199254740991
                    • Maximum value: 9007199254740991
                    endTime
                    integer

                    UNIX timestamp in seconds.

                    • Default value: 9999999999
                    • Minimum value: -9007199254740991
                    • Maximum value: 9007199254740991
                    orderBy
                    string

                    The field by which to order the results.

                    • Default value: timestamp
                    • Accepted values: timestamp
                    timestamp
                    orderDirection
                    string

                    The order in which to return the results: Ascending (asc) or Descending (desc).

                    • Default value: desc
                    • Accepted values: asc, desc
                    desc
                    transaction_id
                    string

                    Filter by transaction

                      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⁠

                      Balances by AddressHistorical Balances
                      Test this endpoint

                      1curl --request GET \2  --url 'https://token-api.thegraph.com/transfers/evm?network_id=mainnet&startTime=0&endTime=9999999999&orderBy=timestamp&orderDirection=desc&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                      1{2  "data": [3    {4      "block_num": 22349873,5      "datetime": "2025-04-26 01:18:47",6      "timestamp": 1745630327,7      "transaction_id": "0xd80ed9764b0bc25b982668f66ec1cf46dbe27bcd01dffcd487f43c92f72b2a84",8      "contract": "0xc944e90c64b2c07662a292be6244bdf05cda44a7",9      "from": "0x7d2fbc0eefdb8721b27d216469e79ef288910a83",10      "to": "0xa5eb953d1ce9d6a99893cbf6d83d8abcca9b8804",11      "decimals": 18,12      "symbol": "GRT",13      "value": 11068.39395865999914    }15  ]16}
                      The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service