Docs
⌘ K

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.

  • Accepted pattern: ^(0[xX])?[0-9a-fA-F]{64}$
  • Format: evm-tx-hash
contract
string

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

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

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

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

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

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

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

    end_time
    string

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

      start_block
      integer

      Filter by block number

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

      Filter by block number

      • 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