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

              • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, matic, optimism, unichain
              mainnet
              from
              string

              Filter by address

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

              Filter by address

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

              Filter by address

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

              UNIX timestamp in seconds.

              • Minimum value: 0
              endTime
              number

              UNIX timestamp in seconds.

              • Minimum value: 0
              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

              • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{64}$
              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⁠

              Balances by AddressHistorical Balances
              Test this endpoint

              1curl --request GET \2  --url 'https://token-api.thegraph.com/transfers/evm?network_id=mainnet&to=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&orderBy=timestamp&orderDirection=desc&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'
              200 Example
              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