Skip to content

Commit 5dc31ee

Browse files
Update faq.mdx (#937)
* Update faq.mdx Added unichain, Added historical & price questions, cleaned up a few parts. Should pass formatting check now. * Update website/src/pages/en/token-api/faq.mdx Co-authored-by: Idalith <[email protected]> * Update website/src/pages/en/token-api/faq.mdx Co-authored-by: Idalith <[email protected]> * Update website/src/pages/en/token-api/faq.mdx Co-authored-by: Idalith <[email protected]> * Update website/src/pages/en/token-api/faq.mdx Co-authored-by: Idalith <[email protected]> --------- Co-authored-by: Idalith <[email protected]>
1 parent 326eb3b commit 5dc31ee

File tree

1 file changed

+18
-10
lines changed
  • website/src/pages/en/token-api

1 file changed

+18
-10
lines changed

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

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -8,19 +8,27 @@ Get fast answers to easily integrate and scale with The Graph's high-performance
88

99
### What blockchains does the Token API support?
1010

11-
Currently, the Token API supports Ethereum, Binance Smart Chain (BSC), Polygon, Optimism, Base, and Arbitrum One.
11+
Currently, the Token API supports Ethereum, Binance Smart Chain (BSC), Polygon, Optimism, Base, Unichain, and Arbitrum One.
1212

13-
### Why isn't my API key from The Graph Market working?
13+
### How do I authenticate requests to the Token API, and why doesn't my API key from The Graph Market work?
1414

15-
Be sure to use the Access Token generated from the API key, not the API key itself. An access token can be generated from the dashboard on The Graph Market using the dropdown menu next to each API key.
15+
Authentication is managed via API tokens obtained through [The Graph Market](https://thegraph.market/). If you're experiencing issues, make sure you're using the API Token generated from the API key, not the API key itself. An API token can be found on The Graph Market dashboard next to each API key. JWT tokens issued by [Pinax](https://pinax.network/en), a core developer of The Graph, are also supported.
1616

1717
### How current is the data provided by the API relative to the blockchain?
1818

1919
The API provides data up to the latest finalized block.
2020

21-
### How do I authenticate requests to the Token API?
21+
### How do I retrieve token prices?
2222

23-
Authentication is managed via JWT tokens obtained through The Graph Market. JWT tokens issued by [Pinax](https://pinax.network/en), a core developer of The Graph, are also supported.
23+
By default, token prices are returned with token-related responses, including token balances, token transfers, token metadata, and token holders. Historical prices are available with the Open-High-Low-Close (OHLC) endpoints.
24+
25+
### Does the Token API support historical token data?
26+
27+
The Token API supports historical token balances with the `/historical/balances/evm/{address}` endpoint. You can query historical price data by pool at `/ohlc/pools/evm/{pool}` and by contract at `/ohlc/prices/evm/{contract}`.
28+
29+
### What exchanges does the Token API use for token prices?
30+
31+
The Token API currently tracks prices on Uniswap v2 and Uniswap v3, with plans to support additional exchanges in the future.
2432

2533
### Does the Token API provide a client SDK?
2634

@@ -36,7 +44,7 @@ Yes, improvements to provide data closer to the chain head are planned. Feedback
3644

3745
### Are there plans to support additional use cases such as NFTs?
3846

39-
The Graph ecosystem is actively determining the [roadmap](https://thegraph.com/blog/token-api-the-graph/) for additional use cases, including NFTs. Please provide feedback on specific features you would like prioritized on [Discord](https://discord.gg/graphprotocol).
47+
Support for NFT endpoints is coming soon. The Graph ecosystem is actively determining the [roadmap](https://thegraph.com/blog/token-api-the-graph/) for additional use cases. Please provide feedback on specific features you would like prioritized on [Discord](https://discord.gg/graphprotocol).
4048

4149
## MCP / LLM / AI Topics
4250

@@ -60,17 +68,17 @@ You can find the code for the MCP client in [The Graph's repo](https://github.co
6068

6169
Check that you included the `Authorization: Bearer <jwt>` header with the correct, non-expired token. Common issues include using the API key instead of generating a new JWT, forgetting the "Bearer" prefix, using an incorrect token, or omitting the header entirely. Ensure you copied the JWT exactly as provided by The Graph Market.
6270

63-
### Are there rate limits or usage costs?\*\*
71+
### Are there rate limits or usage costs?
6472

6573
During Beta, the Token API is free for authorized developers. While specific rate limits aren't documented, reasonable throttling exists to prevent abuse. High request volumes may trigger HTTP 429 errors. Monitor official announcements for future pricing changes after Beta.
6674

67-
### What networks are supported, and how do I specify them?
75+
### How do I specify a network?
6876

69-
You can query available networks with [this link](https://token-api.thegraph.com/#tag/monitoring/GET/networks). A full list of network IDs accepted by The Graph can be found on [The Graph's Networks](https://thegraph.com/docs/en/supported-networks/). The API supports Ethereum mainnet, Binance Smart Chain, Base, Arbitrum One, Optimism, and Polygon/Matic. Use the optional `network_id` parameter (e.g., `mainnet`, `bsc`, `base`, `arbitrum-one`, `optimism`, `matic`) to target a specific chain. Without this parameter, the API defaults to Ethereum mainnet.
77+
You can query available networks with [this link](https://token-api.thegraph.com/#tag/monitoring/GET/networks). A full list of the exact network IDs accepted by The Graph can be found on [The Graph's Networks](https://thegraph.com/docs/en/supported-networks/). Use the optional `network_id` parameter (e.g., `mainnet`, `bsc`, `base`, `arbitrum-one`, `optimism`, `matic`, `unichain`) to target a specific chain. Without this parameter, the API defaults to Ethereum mainnet.
7078

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

73-
Endpoints cap output at 10 items by default. Use pagination parameters: `limit` (up to 500) and `page` (1-indexed). For example, set `limit=50` to get 50 results, and increment `page` for subsequent batches (e.g., `page=2` for items 51-100).
81+
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).
7482

7583
### How do I fetch older transfer history?
7684

0 commit comments

Comments
 (0)