Token API docs optimization

nginx.conf

@@ -169,6 +169,7 @@ http {
         rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/mcp/cline/$                         $scheme://$http_host/docs/$1/ai-suite/token-api-mcp/                                permanent;
         rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/mcp/cline/$                         $scheme://$http_host/docs/$1/ai-suite/token-api-mcp/                                permanent;
         rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/mcp/cline/$                         $scheme://$http_host/docs/$1/ai-suite/token-api-mcp/                                permanent;
+        rewrite ^/docs/([a-zA-Z][a-zA-Z])/token-api/endpoint-pricing/$                  $scheme://$http_host/docs/$1/token-api/endpoints/pricing/                           permanent;
         # Temporary redirects (302)
         rewrite ^/docs/en/querying/graph-client/$                                       $scheme://$http_host/docs/en/subgraphs/querying/graph-client/README/                redirect;
         rewrite ^/docs/en/developing/graph-ts/$                                         $scheme://$http_host/docs/en/subgraphs/developing/creating/graph-ts/README/         redirect;

website/src/components/CodeBlock.tsx

@@ -28,10 +28,25 @@ export const CodeBlock = ({ className, children, ...props }: CodeBlockProps) =>
     <ExperimentalCodeBlock
       language={language as ExperimentalCodeBlockProps['language']}
       lineNumbers={lineCount > 1}
-      className={classNames(['graph-docs-not-markdown --:my-8 --:last:mb-0 -:is-[li>*]:my-4', className])}
+      className={classNames([
+        `graph-docs-not-markdown
+        --:not-in-group/code-block-tabs:my-8
+        --:not-in-group/code-block-tabs:last:mb-0
+        -:not-in-group/code-block-tabs:is-[li>*]:my-4`,
+        className,
+      ])}
       {...(props as ComponentProps<'div'>)}
     >
       {code}
     </ExperimentalCodeBlock>
   )
 }
+
+export const CodeBlockTabs = ({ className, ...props }: ComponentProps<typeof ExperimentalCodeBlock.Tabs>) => {
+  return (
+    <ExperimentalCodeBlock.Tabs
+      className={classNames(['graph-docs-not-markdown --my-8 -:is-[li>*]:my-4', className])}
+      {...props}
+    />
+  )
+}

website/src/layout/Layout.tsx

@@ -56,6 +56,7 @@ import {
 import {
   Callout,
   CodeBlock,
+  CodeBlockTabs,
   DocSearch,
   Heading,
   Image,
@@ -610,6 +611,8 @@ export default function Layout({ pageOpts, children }: NextraThemeLayoutProps<Fr
                 img: ImageWrapper,
                 // TODO: Fix "[Shiki] X instances have been created. Shiki is supposed to be used as a singleton" warnings
                 pre: CodeBlock,
+                CodeBlock,
+                CodeBlockTabs,
                 // TODO: Build and use `ExperimentalTable`
                 table: Table,
                 VideoEmbed,

website/src/pages/ar/token-api/_meta.js

@@ -2,15 +2,15 @@ import titles from './_meta-titles.json'
 
 export default {
   'quick-start': '',
+  'svm-tokens': titles['svm-tokens'] ?? '',
+  'svm-dexs': titles['svm-dexs'] ?? '',
   'evm-tokens': titles['evm-tokens'] ?? '',
   'evm-dexs': titles['evm-dexs'] ?? '',
   'evm-nfts': titles['evm-nfts'] ?? '',
-  'svm-tokens': titles['svm-tokens'] ?? '',
-  'svm-dexs': titles['svm-dexs'] ?? '',
   'tvm-tokens': titles['tvm-tokens'] ?? '',
   'tvm-dexs': titles['tvm-dexs'] ?? '',
   monitoring: titles['monitoring'] ?? '',
-  'endpoint-pricing': '',
+  endpoints: titles['endpoints'] ?? '',
   guides: titles['guides'] ?? '',
   faq: '',
 }

website/src/pages/ar/token-api/endpoints/_meta.js

@@ -0,0 +1,4 @@
+export default {
+  pricing: '',
+  support: '',
+}

website/src/pages/en/token-api/endpoint-pricing.mdx → website/src/pages/ar/token-api/endpoints/pricing.mdx

@@ -1,5 +1,6 @@
 ---
 title: Endpoint Pricing
+sidebarTitle: Pricing
 ---
 
 ## Pricing Tiers

website/src/pages/ar/token-api/endpoints/support.mdx

@@ -0,0 +1,23 @@
+---
+title: Endpoint Feature Matrix
+sidebarTitle: Support Matrix
+---
+
+import { Check } from '@edgeandnode/gds/icons'
+
+## Chain and Feature Support
+
+| Network           |          Tokens           |           Swaps           |           NFTs            |
+| ----------------- | :-----------------------: | :-----------------------: | :-----------------------: |
+| Ethereum Mainnet  | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| BSC Mainnet       | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Base Mainnet      | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Unichain Mainnet  | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Arbitrum One      | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Optimism Mainnet  | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Polygon Mainnet   | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Avalanche C-Chain | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Solana Mainnet    | <Check alt="Supported" /> | <Check alt="Supported" /> |      ❌ Unsupported       |
+| Tron Mainnet      | <Check alt="Supported" /> | <Check alt="Supported" /> |      ❌ Unsupported       |
+
+A full list of chain support for The Graph services can be found [here](/supported-networks/).

website/src/pages/ar/token-api/evm-dexs/_meta.js

@@ -1,6 +1,6 @@
 export default {
+  swaps: '',
   dexes: '',
   'pools-ohlc': '',
   pools: '',
-  swaps: '',
 }

website/src/pages/ar/token-api/evm-tokens/_meta.js

@@ -1,8 +1,8 @@
 export default {
-  tokens: '',
   transfers: '',
+  holders: '',
+  tokens: '',
   balances: '',
   'balances-native': '',
   'balances-historical': '',
-  holders: '',
 }

website/src/pages/ar/token-api/svm-dexs/_meta.js

@@ -1,6 +1,6 @@
 export default {
+  swaps: '',
   dexes: '',
   'pools-ohlc': '',
   pools: '',
-  swaps: '',
 }

website/src/pages/ar/token-api/svm-tokens/_meta.js

@@ -1,6 +1,6 @@
 export default {
-  tokens: '',
   transfers: '',
+  tokens: '',
   balances: '',
   'balances-native': '',
   holders: '',

website/src/pages/cs/token-api/_meta.js

@@ -2,15 +2,15 @@ import titles from './_meta-titles.json'
 
 export default {
   'quick-start': '',
+  'svm-tokens': titles['svm-tokens'] ?? '',
+  'svm-dexs': titles['svm-dexs'] ?? '',
   'evm-tokens': titles['evm-tokens'] ?? '',
   'evm-dexs': titles['evm-dexs'] ?? '',
   'evm-nfts': titles['evm-nfts'] ?? '',
-  'svm-tokens': titles['svm-tokens'] ?? '',
-  'svm-dexs': titles['svm-dexs'] ?? '',
   'tvm-tokens': titles['tvm-tokens'] ?? '',
   'tvm-dexs': titles['tvm-dexs'] ?? '',
   monitoring: titles['monitoring'] ?? '',
-  'endpoint-pricing': '',
+  endpoints: titles['endpoints'] ?? '',
   guides: titles['guides'] ?? '',
   faq: '',
 }

website/src/pages/cs/token-api/endpoints/_meta.js

@@ -0,0 +1,4 @@
+export default {
+  pricing: '',
+  support: '',
+}

website/src/pages/ar/token-api/endpoint-pricing.mdx → website/src/pages/cs/token-api/endpoints/pricing.mdx

@@ -1,5 +1,6 @@
 ---
 title: Endpoint Pricing
+sidebarTitle: Pricing
 ---
 
 ## Pricing Tiers
@@ -9,19 +10,33 @@ title: Endpoint Pricing
 | $25 of total usage across available endpoints | $50 of total usage across available endpoints | $200 of total usage across available endpoints | Custom plan across available endpoints |
 | Query parameters: 10 items returned, batch size 1 | Query parameters: 100 items returned, batch size 25 | Query parameters: 500 items returned, batch size 50 | Custom items returned and batch size |
 | Rate limit: 200/min | Rate limit: 500/min | Rate limit: 1000/min | Custom rate limit |
-| Time parameters: 1d, 1w intervals | Time parameters: 4h, 1d, 1w intervals | Time parameters: 1h, 4h, 1d, 1w intervals | Time parameters: 1h, 4h, 1d, 1w intervals |
-| Historical price data: 6 months availability | Historical price data: 2 years availability | Historical price data: Full availability | Historical price data: Full availability |
+| Time parameters: 4h, 1d, 1w intervals | Time parameters: 1h, 4h, 1d, 1w intervals | Time parameters: 1h, 4h, 1d, 1w intervals | Time parameters: 1h, 4h, 1d, 1w intervals |
+| Time interval window: 168 bars | Time interval window: 2160 bars | Time interval window: Full | Time interval window: Full |
+| Historical price data: Full availability | Historical price data: Full availability | Historical price data: Full availability | Historical price data: Full availability |
 | No additional queries allowed outside of free tier | Pay-as-you-go once included usage is exceeded | Pay-as-you-go once included usage is exceeded | SLAs + Engineering Support |
 
+## Time Intervals and Parameters (\*)
+
+1. The **time interval window** is calculated as: **`bars × interval`**.
+   - **Example**: The Free plan provides 168 bars with a 4h interval: 168 × 4h = 28 days of data.
+2. **Full historical data** is available on all plans.
+3. **Pagination** is still required to fetch all results. Users won't receive more data than the plan's total bar limit.
+   - **Example**: The Free plan allows 168 bars and a 10-result limit per query, so you'll need 17 queries to retrieve all pages.
+4. You can use **`start_time`** and **`end_time`** to move your time window across history.
+   - **Example**: `start_time=2025-01-01`, `end_time=2025-01-28`, and `interval=4h` (Free plan) will return 28 days of data for that range.
+
 ## Token Endpoints - $15/mil queries
 
 Query token transfers, balances, and metadata across EVM and SVM blockchains
 
 ```
 GET /v1/evm/tokens
 GET /v1/svm/tokens
+GET /v1/tvm/tokens
 GET /v1/evm/transfers
 GET /v1/svm/transfers
+GET /v1/tvm/transfers
+GET /v1/tvm/transfers/native
 GET /v1/evm/balances
 GET /v1/svm/balances
 GET /v1/evm/balances/native
@@ -35,6 +50,7 @@ Access on-chain swap, liquidity pool, and decentralized exchange data
 ```
 GET /v1/evm/swaps
 GET /v1/svm/swaps
+GET /v1/tvm/swaps
 GET /v1/evm/pools
 GET /v1/svm/pools
 ```
@@ -61,6 +77,7 @@ GET /v1/svm/holders
 GET /v1/evm/nft/holders
 GET /v1/evm/pools/ohlc
 GET /v1/svm/pools/ohlc
+GET /v1/tvm/pools/ohlc
 GET /v1/evm/balances/historical
 ```
 
@@ -74,4 +91,5 @@ GET /v1/version
 GET /v1/networks
 GET /v1/evm/dexes
 GET /v1/svm/dexes
+GET /v1/tvm/dexes
 ```

website/src/pages/cs/token-api/endpoints/support.mdx

@@ -0,0 +1,23 @@
+---
+title: Endpoint Feature Matrix
+sidebarTitle: Support Matrix
+---
+
+import { Check } from '@edgeandnode/gds/icons'
+
+## Chain and Feature Support
+
+| Network           |          Tokens           |           Swaps           |           NFTs            |
+| ----------------- | :-----------------------: | :-----------------------: | :-----------------------: |
+| Ethereum Mainnet  | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| BSC Mainnet       | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Base Mainnet      | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Unichain Mainnet  | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Arbitrum One      | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Optimism Mainnet  | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Polygon Mainnet   | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Avalanche C-Chain | <Check alt="Supported" /> | <Check alt="Supported" /> | <Check alt="Supported" /> |
+| Solana Mainnet    | <Check alt="Supported" /> | <Check alt="Supported" /> |      ❌ Unsupported       |
+| Tron Mainnet      | <Check alt="Supported" /> | <Check alt="Supported" /> |      ❌ Unsupported       |
+
+A full list of chain support for The Graph services can be found [here](/supported-networks/).

website/src/pages/cs/token-api/evm-dexs/_meta.js

@@ -1,6 +1,6 @@
 export default {
+  swaps: '',
   dexes: '',
   'pools-ohlc': '',
   pools: '',
-  swaps: '',
 }

website/src/pages/cs/token-api/evm-tokens/_meta.js

@@ -1,8 +1,8 @@
 export default {
-  tokens: '',
   transfers: '',
+  holders: '',
+  tokens: '',
   balances: '',
   'balances-native': '',
   'balances-historical': '',
-  holders: '',
 }

website/src/pages/cs/token-api/svm-dexs/_meta.js

@@ -1,6 +1,6 @@
 export default {
+  swaps: '',
   dexes: '',
   'pools-ohlc': '',
   pools: '',
-  swaps: '',
 }

website/src/pages/cs/token-api/svm-tokens/_meta.js

@@ -1,6 +1,6 @@
 export default {
-  tokens: '',
   transfers: '',
+  tokens: '',
   balances: '',
   'balances-native': '',
   holders: '',

website/src/pages/de/token-api/_meta.js

@@ -2,15 +2,15 @@ import titles from './_meta-titles.json'
 
 export default {
   'quick-start': '',
+  'svm-tokens': titles['svm-tokens'] ?? '',
+  'svm-dexs': titles['svm-dexs'] ?? '',
   'evm-tokens': titles['evm-tokens'] ?? '',
   'evm-dexs': titles['evm-dexs'] ?? '',
   'evm-nfts': titles['evm-nfts'] ?? '',
-  'svm-tokens': titles['svm-tokens'] ?? '',
-  'svm-dexs': titles['svm-dexs'] ?? '',
   'tvm-tokens': titles['tvm-tokens'] ?? '',
   'tvm-dexs': titles['tvm-dexs'] ?? '',
   monitoring: titles['monitoring'] ?? '',
-  'endpoint-pricing': '',
+  endpoints: titles['endpoints'] ?? '',
   guides: titles['guides'] ?? '',
   faq: '',
 }

website/src/pages/de/token-api/endpoints/_meta.js

@@ -0,0 +1,4 @@
+export default {
+  pricing: '',
+  support: '',
+}

website/src/pages/cs/token-api/endpoint-pricing.mdx → website/src/pages/de/token-api/endpoints/pricing.mdx

@@ -1,5 +1,6 @@
 ---
 title: Endpoint Pricing
+sidebarTitle: Pricing
 ---
 
 ## Pricing Tiers
@@ -9,19 +10,33 @@ title: Endpoint Pricing
 | $25 of total usage across available endpoints | $50 of total usage across available endpoints | $200 of total usage across available endpoints | Custom plan across available endpoints |
 | Query parameters: 10 items returned, batch size 1 | Query parameters: 100 items returned, batch size 25 | Query parameters: 500 items returned, batch size 50 | Custom items returned and batch size |
 | Rate limit: 200/min | Rate limit: 500/min | Rate limit: 1000/min | Custom rate limit |
-| Time parameters: 1d, 1w intervals | Time parameters: 4h, 1d, 1w intervals | Time parameters: 1h, 4h, 1d, 1w intervals | Time parameters: 1h, 4h, 1d, 1w intervals |
-| Historical price data: 6 months availability | Historical price data: 2 years availability | Historical price data: Full availability | Historical price data: Full availability |
+| Time parameters: 4h, 1d, 1w intervals | Time parameters: 1h, 4h, 1d, 1w intervals | Time parameters: 1h, 4h, 1d, 1w intervals | Time parameters: 1h, 4h, 1d, 1w intervals |
+| Time interval window: 168 bars | Time interval window: 2160 bars | Time interval window: Full | Time interval window: Full |
+| Historical price data: Full availability | Historical price data: Full availability | Historical price data: Full availability | Historical price data: Full availability |
 | No additional queries allowed outside of free tier | Pay-as-you-go once included usage is exceeded | Pay-as-you-go once included usage is exceeded | SLAs + Engineering Support |
 
+## Time Intervals and Parameters (\*)
+
+1. The **time interval window** is calculated as: **`bars × interval`**.
+   - **Example**: The Free plan provides 168 bars with a 4h interval: 168 × 4h = 28 days of data.
+2. **Full historical data** is available on all plans.
+3. **Pagination** is still required to fetch all results. Users won't receive more data than the plan's total bar limit.
+   - **Example**: The Free plan allows 168 bars and a 10-result limit per query, so you'll need 17 queries to retrieve all pages.
+4. You can use **`start_time`** and **`end_time`** to move your time window across history.
+   - **Example**: `start_time=2025-01-01`, `end_time=2025-01-28`, and `interval=4h` (Free plan) will return 28 days of data for that range.
+
 ## Token Endpoints - $15/mil queries
 
 Query token transfers, balances, and metadata across EVM and SVM blockchains
 
 ```
 GET /v1/evm/tokens
 GET /v1/svm/tokens
+GET /v1/tvm/tokens
 GET /v1/evm/transfers
 GET /v1/svm/transfers
+GET /v1/tvm/transfers
+GET /v1/tvm/transfers/native
 GET /v1/evm/balances
 GET /v1/svm/balances
 GET /v1/evm/balances/native
@@ -35,6 +50,7 @@ Access on-chain swap, liquidity pool, and decentralized exchange data
 ```
 GET /v1/evm/swaps
 GET /v1/svm/swaps
+GET /v1/tvm/swaps
 GET /v1/evm/pools
 GET /v1/svm/pools
 ```
@@ -61,6 +77,7 @@ GET /v1/svm/holders
 GET /v1/evm/nft/holders
 GET /v1/evm/pools/ohlc
 GET /v1/svm/pools/ohlc
+GET /v1/tvm/pools/ohlc
 GET /v1/evm/balances/historical
 ```
 
@@ -74,4 +91,5 @@ GET /v1/version
 GET /v1/networks
 GET /v1/evm/dexes
 GET /v1/svm/dexes
+GET /v1/tvm/dexes
 ```