2 minutes
Token API Quick Start
This product is currently in Beta and under active development. If you have any feedback, please reach out to us on Discord.
The Graph’s Token API lets you access blockchain token information via a GET request. This guide is designed to help you quickly integrate the Token API into your application.
The Token API provides access to onchain NFT and fungible token data, including live and historical balances, holders, prices, market data, token metadata, and token transfers. This API also uses the Model Context Protocol (MCP) to allow AI tools such as Claude to enrich raw blockchain data with contextual insights.
Prerequisites
Before you begin, get a JWT API token by signing up on The Graph Market. Make sure to use the JWT API Token, not the API key. Each API key can generate a new JWT API Token at any time.
Authentication
All API endpoints are authenticated using a JWT API token inserted in the header as Authorization: Bearer <token>.
{ "headers": { "Authorization": "Bearer eyJh•••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••NnlA" }}Using JavaScript
Make an API request using JavaScript by adding the request parameters, and then fetching from the relevant endpoint. For example:
const address = '0x2a0c0dbecc7e4d658f48e01e3fa353f44050c208'const options = { method: 'GET', headers: { Accept: 'application/json', Authorization: 'Bearer <token>', },}fetch(`https://token-api.thegraph.com/v1/evm/balances?network=mainnet&address=${address}`) .then((response) => response.json()) .then((response) => console.log(response)) .catch((err) => console.error(err))Make sure to replace <token> with the JWT Token generated from your API key.
Using cURL (Command Line)
To make an API request using cURL, open your command line and run the following command.
curl --request GET \ --url https://token-api.thegraph.com/v1/evm/balances?network=mainnet&address=${address} \ --header 'Accept: application/json' \ --header 'Authorization: Bearer <token>'Make sure to replace <token> with the JWT Token generated from your API key.
Most Unix-like systems come with cURL preinstalled. For Windows, you may need to install cURL.
Chain and Feature Support
| Network | Tokens | Swaps | NFTs |
|---|---|---|---|
| Ethereum Mainnet | |||
| BSC Mainnet | |||
| Base Mainnet | |||
| Unichain Mainnet | |||
| Arbitrum One | |||
| Optimism Mainnet | |||
| Polygon Mainnet | |||
| Avalanche C-Chain | |||
| Solana Mainnet | ❌ Unsupported | ||
| Tron Mainnet | ❌ Unsupported |
A full list of chain support for The Graph services can be found here.
Troubleshooting
If the API call fails, try printing out the full response object for additional error details. For example:
fetch(`https://token-api.thegraph.com/v1/evm/balances?network=mainnet&address=${address}`) .then((response) => { console.log('Status Code:', response.status) return response.json() }) .then((data) => console.log(data)) .catch((err) => console.error('Error:', err))