Docs
Search⌘ K
  • Home
  • About The Graph
  • Supported Networks
  • Protocol Contracts
  • Subgraphs
    • Substreams
      • Token API
        • Hypergraph
          • 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.

                      • Default value: 1735689600
                      • 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⁠

                        Historical BalancesSwap Events
                        Test this endpoint

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

                        1{2  "data": [3    {4      "block_num": 23383393,5      "datetime": "2025-09-17 14:27:23",6      "timestamp": 1758119243,7      "transaction_id": "0xebf58ec6ab1b7fa10fa2d64b21d7d27528c46a36d4c349fc6ddecf9836bc3bba",8      "contract": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",9      "from": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",10      "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",11      "name": "Native",12      "symbol": "ETH",13      "decimals": 18,14      "amount": "2420480000000000",15      "value": 0.00242048,16      "network_id": "mainnet"17    }18  ]19}
                        The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service