Skip to content

Token API: updated FAQ wording, updated DEX section, adjusted upgrade v1 notes #1046

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
Nov 14, 2025
Merged

Token API: updated FAQ wording, updated DEX section, adjusted upgrade v1 notes #1046

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
6f092a5
Token API: updated FAQ wording, updated DEX section, adjusted upgrade…
jhjhjh94 Nov 14, 2025
c5f1962
Token API minor adjustments, added missing chains for NFT spam detection
jhjhjh94 Nov 14, 2025
ea878fe
Added missing chains for NFT spam detection
jhjhjh94 Nov 14, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 5 additions & 9 deletions website/src/pages/en/token-api/faq.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Get fast answers to easily integrate and scale with The Graph's high-performance

### Which blockchains are supported by the Token API?

Currently, the Token API supports Ethereum Mainnet, BNB Smart Chain (BSC Mainnet), Polygon Mainnet, Optimism Mainnet, Base Mainnet, Unichain Mainnet, Avalanche C-Chain, Arbitrum One, and Solana Mainnet. A full list of supported networks can be found under the Token API column [here](/supported-networks/).
Currently, the Token API supports Ethereum Mainnet, BNB Smart Chain (BSC Mainnet), Polygon Mainnet, Optimism Mainnet, Base Mainnet, Unichain Mainnet, Avalanche C-Chain, Arbitrum One, Solana Mainnet and Tron Mainnet. A full list of supported networks can be found under the Token API column [here](/supported-networks/).

### Does the Token API support NFTs?

Expand All @@ -29,16 +29,12 @@ The API provides data up to the latest finalized block. This time varies dependi

### How do I retrieve token prices?

Token prices are available with the Open-High-Low-Close (OHLC) endpoints. For a given time period, `"open"` represents the price at the start of the time period, `"high"` represents the highest price during the time period, `"low"` represents the lowest price, and `"close"` represents the price at the end of the time period.
Token prices are available with the Open-High-Low-Close (OHLC) endpoints. For a given time period, `"open"` represents the price at the start of the time period, `"high"` represents the highest price during the time period, `"low"` represents the lowest price, and `"close"` represents the price at the end of the time period. You can change the time period using the `interval` parameter. Smaller time intervals are available on paid plans.

### Does the Token API support historical token data?

The Token API supports historical token balances with the `/v1/evm/balances/historical` endpoint. You can query historical price data by pool at `/v1/evm/pools/ohlc`. Historical balances have a similar OHLC format, but return token balances instead of prices.

### What exchanges does the Token API use for token prices?

The Token API currently tracks prices on Uniswap v2, v3, and v4, along with Jupiter, Raydium, and Pump.fun on Solana, with plans to support additional exchanges in the future.

### Does the Token API provide a client SDK or client library?

While an official client SDK is not currently available, please share feedback on any SDKs or integrations you would like to see on [Discord](https://discord.gg/graphprotocol). Community contributions are welcome to use the [OpenAPI document](https://token-api.thegraph.com/openapi) to build and share their own client libraries.
Expand Down Expand Up @@ -301,7 +297,7 @@ NFT collections on supported chains contain a spam status field indicating wheth

### How do I retrieve the spam status for a collection?

See the spam_status field on the [`/v1/evm/nft/collections/{contract}`](/token-api/evm-nfts/collections/) endpoint.
See the spam_status field on the [`/v1/evm/nft/collections/{contract}`](/token-api/evm/get-nft-collections-evm-by-contract/) endpoint.
Copy link
Contributor

@benface benface Nov 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This URL doesn't seem to be valid? https://thegraph.com/docs/en/token-api/evm/get-nft-collections-evm-by-contract/

Copy link
Contributor

@benface benface Nov 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The previous one, on the other hand, is: https://thegraph.com/docs/en/token-api/evm-nfts/collections/

But it doesn't match the endpoint's URL perfectly: contract is a query param, not a path param. I think the right fix here is:

Suggested change
See the spam_status field on the [`/v1/evm/nft/collections/{contract}`](/token-api/evm/get-nft-collections-evm-by-contract/) endpoint.
See the spam_status field on the [`/v1/evm/nft/collections`](/token-api/evm-nfts/collections/) endpoint.

Copy link
Contributor Author

@jhjhjh94 jhjhjh94 Nov 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

yea just noticed that, cross checking

Copy link
Contributor Author

@jhjhjh94 jhjhjh94 Nov 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

confirmed, it's https://thegraph.com/docs/en/token-api/evm-nfts/collections/

Copy link
Contributor Author

@jhjhjh94 jhjhjh94 Nov 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i'm asking more info about the query param you mentioned

Copy link
Contributor Author

@jhjhjh94 jhjhjh94 Nov 14, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

{contract} will be removed


### Why am I seeing "pending" spam status?

Expand Down Expand Up @@ -363,9 +359,9 @@ To query Solana Mainnet, use the SVM endpoints.

### Why do I only see 10 results? How can I get more data?

Endpoints cap output at 10 items by default. Use pagination parameters: `limit` and `page` (1-indexed) to return more results. For example, set `limit=50` to get 50 results, and increment `page` for subsequent batches (e.g., `page=2` for items 51-100).
Endpoints cap output at 10 items by default. Use pagination parameters: `limit` and `page` (1-indexed) to return more results. For example, set `limit=10` to get 10 results (higher limits are available on paid plans), and increment `page` for subsequent batches (e.g., `page=2` for items 11-20).

It is currently possible for the total number of pages to be inexact. This is because the backend provides only an approximation of the number of records in order to improve response time. To avoid getting confused by this approximation, make sure to continue fetching next pages until there is no more data, or the endpoint returns an error.
To ensure you retrieve all data, continue fetching pages until the API returns an empty data array, indicating there is no more data.

### How do I fetch older transfer history?

Expand Down
2 changes: 1 addition & 1 deletion website/src/pages/en/token-api/quick-start.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ The Token API provides access to onchain NFT and fungible token data, including

## Prerequisites

Before you begin, get a JWT API token by signing up on [The Graph Market](https://thegraph.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.
Before you begin, get a JWT API token by signing up on [The Graph Market](https://thegraph.market/plans/token-api/2025/). 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

Expand Down
2 changes: 1 addition & 1 deletion website/src/pages/en/token-api/upgrade-to-v1.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -337,7 +337,7 @@ GET /v1/evm/transfers?network=mainnet&from_address=0xabc...,0xdef...,0x123...&st

## ⚠️ Important Notes

1. **Backward Compatibility:** The old endpoints are deprecated and will be removed in the future. Migrate by **Oct 30, 2025**.
1. **Migration Notes:** The old endpoints were deprecated and removed on **October 30, 2025**. Please ensure all integrations have been migrated to the new Token API v1 endpoints.

2. **Default Sorting:** All results are now sorted by timestamp (descending) by default. Custom sorting is no longer supported.

Expand Down