GET
/
transfers
/
evm
/
{address}
curl --request GET \
  --url https://token-api.thegraph.com/transfers/evm/{address} \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "block_num": 22128243,
      "timestamp": 1742957927,
      "date": "2025-03-26",
      "contract": "0xc944e90c64b2c07662a292be6244bdf05cda44a7",
      "from": "0xf89d7b9c864f589bbf53a82105107622b35eaa40",
      "to": "0x2e4578e6c86380ca1759431fedeeae823e33357b",
      "amount": "4805168872000000000000",
      "transaction_id": "0x18c62cfa9c10a1e0a7bee36099151238e668ff61c97c7b9ab616aaa93c176e2c",
      "decimals": 18,
      "symbol": "GRT",
      "network_id": "mainnet",
      "price_usd": 0.1040243665135064,
      "value_usd": 499.85464790022
    }
  ]
}

​
Endpoint Overview

Method: GET

Path: /transfers/evm/{address}

Retrieves a list of token transfer events associated with the given address.

​
Request Parameters

ParameterTypeDescriptionNotes
address(string, required)The wallet address to query for token transfers.Must be a valid hexadecimal address. Example: 0x1234abcd…
network_id(string, optional)Specifies the blockchain network to query.Use this parameter when you need data from a specific EVM-compatible network.
limit(integer, optional)The maximum number of records to return.Useful for controlling response size and paginating results.
offset(integer, optional)The number of records to skip before returning results.Use together with limit for pagination.
age(integer, optional)The number of days in the past to queryDefaults to 30. Maximum is 180.

​
Response Parameters

ParameterTypeDescriptionNotes
block_num(integer)The block number of the most recent balance change for the data queried.Block numbers will differ between blockchains.
timestamp(integer)The Unix timestamp, in seconds, of the most recent balance change for the data queried.Equals the number of seconds elapsed since January 1, 1970, 00:00:00 UTC.
date(string)The date of the block from which data was queried.In the format “YYYY-MM-DD”.
contract(string)The contract involved in the token transfer.Returned in hexadecimal. Example: 0x1234abcd…
from(string)The address that initiated the token transfer.Returned in hexadecimal. Example: 0x1234abcd…
to(string)The address that received the token transfer.Returned in hexadecimal. Example: 0x1234abcd…
amount(string)The amount of tokens sent in the transfer.Returned as an integer, in the smallest divisible units of the token.
decimals(integer)The number of decimal places of precision for the specified token.Use together with amount to determine token amount.
symbol(string)The number of records to skip before returning results.Use together with limit for pagination.
network_id(string)The number of records to skip before returning results.Use together with limit for pagination.

​
Additional Notes

The field amount returns an integer number. This is the number of smallest divisible units of the token that is held by the address. Use the decimals field to determine how many of those digits are to the right of the decimal point.

For example, the token for Ethereum has 18 decimal places, and the smallest unit of Ether is one Wei. The amount field will return the number of Wei, not the number of Ether. To determine the number of Ether, you would use decimals to determine how far from the last digit the decimal is placed, in this case 18 digits.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
address
string
required

EVM wallet address to query

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

Query Parameters

​
network_id
enum<string>
default:mainnet

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

Available options:
mainnet,
arbitrum-one,
base,
bsc,
matic,
optimism
Example:

"mainnet"

​
age
integer
default:30

Indicates how many days have passed since the data's creation or insertion.

Required range: 1 <= x <= 180
​
contract
string

Filter by contract address

​
limit
integer
default:10

The maximum number of items returned in a single request.

Required range: 1 <= x <= 500
​
page
integer
default:1

The page number of the results to return.

Required range: x >= 1

Response

200 - application/json
Successful Response
​
data
object[]
required
​
statistics
object