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

                Token Transfers

                GET/v1/evm/transfers

                Returns ERC-20 and native token transfers with transaction and block data.

                Query Parameters

                ParameterDescriptionValue
                network
                string

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

                • Accepted values: arbitrum-one, avalanche, base, bsc, mainnet, optimism, polygon, unichain
                Required
                mainnet
                transaction_id
                string

                Filter by transaction hash
                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.

                    from_address
                    string

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

                      to_address
                      string

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

                        start_time
                        string

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

                        • Default value: 2025-01-01
                        end_time
                        string

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

                        • Default value: 2050-01-01
                        start_block
                        integer

                        Filter by block number

                        • Minimum value: 0
                        • Maximum value: 9007199254740991
                        end_block
                        integer

                        Filter by block number

                        • Default value: 9999999999
                        • Minimum value: 0
                        • Maximum value: 9007199254740991
                        limit
                        integer

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

                        • Default value: 10
                        • Minimum value: 1
                        • Maximum value: 1000
                        page
                        integer

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

                        • Default value: 1
                        • Minimum value: 1
                        • Maximum value: 767465558638

                        Potential Responses

                        StatusDescription
                        200

                        Successful Response

                        400

                        Client side error

                        401

                        Authentication failed

                        403

                        Forbidden

                        404

                        Not found

                        500

                        Server side error

                        ⁠Edit on GitHub⁠

                        Token MetadataSupported DEXs
                        Test this endpoint

                        1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/transfers?network=mainnet&start_time=2025-01-01&end_time=2050-01-01&start_block=0&end_block=9999999999&limit=10&page=1' \3  --header 'Authorization: Bearer {token}'

                        1{2  "data": [3    {4      "block_num": 23565775,5      "datetime": "2025-10-13 02:19:47",6      "timestamp": 1760321987,7      "transaction_id": "0x96b1b180d22dae2b18a783ebdd5ae33f6867f3572f87c69a135c6c0a15a63c8e",8      "log_index": 4404,9      "contract": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",10      "from": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",11      "to": "0xdadb0d80178819f2319190d340ce9a924f783711",12      "name": "Native",13      "symbol": "ETH",14      "decimals": 18,15      "amount": "5038198000000",16      "value": 0.000005038198,17      "network": "mainnet"18    }19  ]20}
                        The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service