Skip to content

Commit 2415f35

Browse files
authored
Token API: updated FAQ wording, updated DEX section, adjusted upgrade v1 notes (#1046)
* Token API: updated FAQ wording, updated DEX section, adjusted upgrade v1 notes * Token API minor adjustments, added missing chains for NFT spam detection * Added missing chains for NFT spam detection
1 parent 6bd9241 commit 2415f35

File tree

4 files changed

+15
-14
lines changed

4 files changed

+15
-14
lines changed

website/src/pages/en/token-api/evm-nfts/collections.mdx

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,5 +12,10 @@ The `spam_status` flag indicates if the NFT is likely spam. If status shows `pen
1212

1313
Spam detection is supported for:
1414

15-
- mainnet
16-
- base
15+
- Arbitrum One
16+
- Avalanche C-Chain
17+
- Base Mainnet
18+
- BSC Mainnet
19+
- Ethereum Mainnet
20+
- Optimism Mainnet
21+
- Polygon Mainnet

website/src/pages/en/token-api/faq.mdx

Lines changed: 6 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ Get fast answers to easily integrate and scale with The Graph's high-performance
99

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

12-
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/).
12+
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/).
1313

1414
### Does the Token API support NFTs?
1515

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

3030
### How do I retrieve token prices?
3131

32-
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.
32+
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.
3333

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

3636
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.
3737

38-
### What exchanges does the Token API use for token prices?
39-
40-
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.
41-
4238
### Does the Token API provide a client SDK or client library?
4339

4440
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.
@@ -301,15 +297,15 @@ NFT collections on supported chains contain a spam status field indicating wheth
301297

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

304-
See the spam_status field on the [`/v1/evm/nft/collections/{contract}`](/token-api/evm-nfts/collections/) endpoint.
300+
See the spam_status field on the [`/v1/evm/nft/collections/`](/token-api/evm-nfts/collections/) endpoint.
305301

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

308304
There are millions of collections and we only analyze for spam on demand. If you see a pending status, query it again after 5-10 seconds and the status should be updated.
309305

310306
### What chains contain NFT spam detection?
311307

312-
Spam detection is currently supported for the following chains:
308+
NFT spam detection is currently supported for the following chains:
313309

314310
- Arbitrum One
315311
- Avalanche C-Chain
@@ -363,9 +359,9 @@ To query Solana Mainnet, use the SVM endpoints.
363359

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

366-
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).
362+
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).
367363

368-
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.
364+
To ensure you retrieve all data, continue fetching pages until the API returns an empty data array, indicating there is no more data.
369365

370366
### How do I fetch older transfer history?
371367

website/src/pages/en/token-api/quick-start.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ The Token API provides access to onchain NFT and fungible token data, including
1515

1616
## Prerequisites
1717

18-
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.
18+
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.
1919

2020
## Authentication
2121

website/src/pages/en/token-api/upgrade-to-v1.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -337,7 +337,7 @@ GET /v1/evm/transfers?network=mainnet&from_address=0xabc...,0xdef...,0x123...&st
337337

338338
## ⚠️ Important Notes
339339

340-
1. **Backward Compatibility:** The old endpoints are deprecated and will be removed in the future. Migrate by **Oct 30, 2025**.
340+
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.
341341

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

0 commit comments

Comments
 (0)