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

                  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: 2015-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 MetadataToken Holders
                          Test this endpoint

                          1curl --request GET \2  --url 'https://token-api.thegraph.com/v1/evm/transfers?network=mainnet&transaction_id=0x96b1b180d22dae2b18a783ebdd5ae33f6867f3572f87c69a135c6c0a15a63c8e&contract=0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2&from_address=0xd8da6bf26964af9d7eed9e03e53415d37aa96045&to_address=0xdadb0d80178819f2319190d340ce9a924f783711&start_time=2015-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": 24278225,5      "datetime": "2026-01-20 19:57:11",6      "timestamp": 1768939031,7      "transaction_id": "0x589cbe12efa0cca5a29b17bf7ee49c99566f0e05e937d54104134a2d916ab265",8      "log_index": 24,9      "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",10      "type": "transfer",11      "from": "0x2393d38400cad1d0ffae85b37d76de05bb7eddc6",12      "to": "0xd4f1171683f1bc07b77d0307a01b64dba5369cf8",13      "name": "USD Coin",14      "symbol": "USDC",15      "decimals": 6,16      "amount": "2686",17      "value": 0.002686,18      "network": "mainnet"19    }20  ]21}
                          The GraphStatusTestnetBrand AssetsForumSecurityPrivacy PolicyTerms of Service