GET
/
tokens
/
evm
/
{contract}
curl --request GET \
  --url https://token-api.thegraph.com/tokens/evm/{contract} \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "date": "2025-03-26",
      "timestamp": "2025-03-26 03:48:35",
      "block_num": 22128490,
      "address": "0xc944e90c64b2c07662a292be6244bdf05cda44a7",
      "decimals": 18,
      "symbol": "GRT",
      "name": "Graph Token",
      "network_id": "mainnet",
      "circulating_supply": "10800262823318213436822328009",
      "holders": 170271,
      "icon": {
        "web3icon": "GRT"
      },
      "price_usd": 0.1040243665135064,
      "market_cap": 1123490498.375051
    }
  ]
}

​
Endpoint Overview

Method: GET

Path: /tokens/evm/{contract}

Provides metadata for a given token, including its name, symbol, decimals, and total supply.

​
Request Parameters

ParameterTypeDescriptionNotes
contract(string, required)The wallet address to query for token balances.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.

​
Response Parameters

ParameterTypeDescriptionNotes
block_num(number)The block number of the most recent balance change for the data queried.Block numbers will differ between blockchains
timestamp(number)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”.
address(string)The address for the token contract returned.Returned in hexadecimal. Example: 0x1234abcd…
name(string)The name of the token.Results come from sources that may not be on-chain.
decimals(number)The number of decimal places of precision for the specified token.Use together with total supply to determine token amount.
symbol(string)The number of records to skip before returning results.Use together with limit for pagination.
circulating_supply(string)The number of tokens circulating.Returned as an integer, in the smallest divisible units of the token.
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

​
contract
string
required

EVM contract address to query

Example:

"0xc944e90c64b2c07662a292be6244bdf05cda44a7"

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"

Response

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