diff --git a/nginx.conf b/nginx.conf index 577930b78772..dcd96f3bc584 100644 --- a/nginx.conf +++ b/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; diff --git a/website/src/components/CodeBlock.tsx b/website/src/components/CodeBlock.tsx index 2c3d9183e80b..8b7b21c9c15b 100644 --- a/website/src/components/CodeBlock.tsx +++ b/website/src/components/CodeBlock.tsx @@ -28,10 +28,25 @@ export const CodeBlock = ({ className, children, ...props }: CodeBlockProps) => 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} ) } + +export const CodeBlockTabs = ({ className, ...props }: ComponentProps) => { + return ( + *]:my-4', className])} + {...props} + /> + ) +} diff --git a/website/src/layout/Layout.tsx b/website/src/layout/Layout.tsx index ea8018a90231..a1b5311a6ca7 100644 --- a/website/src/layout/Layout.tsx +++ b/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 | | | +| 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](/supported-networks/). diff --git a/website/src/pages/ar/token-api/evm-dexs/_meta.js b/website/src/pages/ar/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ar/token-api/evm-dexs/_meta.js +++ b/website/src/pages/ar/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ar/token-api/evm-tokens/_meta.js b/website/src/pages/ar/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/ar/token-api/evm-tokens/_meta.js +++ b/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: '', } diff --git a/website/src/pages/ar/token-api/svm-dexs/_meta.js b/website/src/pages/ar/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ar/token-api/svm-dexs/_meta.js +++ b/website/src/pages/ar/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ar/token-api/svm-tokens/_meta.js b/website/src/pages/ar/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/ar/token-api/svm-tokens/_meta.js +++ b/website/src/pages/ar/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/cs/token-api/_meta.js b/website/src/pages/cs/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/cs/token-api/_meta.js +++ b/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: '', } diff --git a/website/src/pages/cs/token-api/endpoints/_meta.js b/website/src/pages/cs/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/cs/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/ar/token-api/endpoint-pricing.mdx b/website/src/pages/cs/token-api/endpoints/pricing.mdx similarity index 59% rename from website/src/pages/ar/token-api/endpoint-pricing.mdx rename to website/src/pages/cs/token-api/endpoints/pricing.mdx index 1354b7e2bc10..df3a04c50a55 100644 --- a/website/src/pages/ar/token-api/endpoint-pricing.mdx +++ b/website/src/pages/cs/token-api/endpoints/pricing.mdx @@ -1,5 +1,6 @@ --- title: Endpoint Pricing +sidebarTitle: Pricing --- ## Pricing Tiers @@ -9,10 +10,21 @@ 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 @@ -20,8 +32,11 @@ 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 ``` diff --git a/website/src/pages/cs/token-api/endpoints/support.mdx b/website/src/pages/cs/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/cs/token-api/evm-dexs/_meta.js b/website/src/pages/cs/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/cs/token-api/evm-dexs/_meta.js +++ b/website/src/pages/cs/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/cs/token-api/evm-tokens/_meta.js b/website/src/pages/cs/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/cs/token-api/evm-tokens/_meta.js +++ b/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: '', } diff --git a/website/src/pages/cs/token-api/svm-dexs/_meta.js b/website/src/pages/cs/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/cs/token-api/svm-dexs/_meta.js +++ b/website/src/pages/cs/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/cs/token-api/svm-tokens/_meta.js b/website/src/pages/cs/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/cs/token-api/svm-tokens/_meta.js +++ b/website/src/pages/cs/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/de/token-api/_meta.js b/website/src/pages/de/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/de/token-api/_meta.js +++ b/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: '', } diff --git a/website/src/pages/de/token-api/endpoints/_meta.js b/website/src/pages/de/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/de/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/cs/token-api/endpoint-pricing.mdx b/website/src/pages/de/token-api/endpoints/pricing.mdx similarity index 59% rename from website/src/pages/cs/token-api/endpoint-pricing.mdx rename to website/src/pages/de/token-api/endpoints/pricing.mdx index 1354b7e2bc10..df3a04c50a55 100644 --- a/website/src/pages/cs/token-api/endpoint-pricing.mdx +++ b/website/src/pages/de/token-api/endpoints/pricing.mdx @@ -1,5 +1,6 @@ --- title: Endpoint Pricing +sidebarTitle: Pricing --- ## Pricing Tiers @@ -9,10 +10,21 @@ 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 @@ -20,8 +32,11 @@ 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 ``` diff --git a/website/src/pages/de/token-api/endpoints/support.mdx b/website/src/pages/de/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/de/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/de/token-api/evm-dexs/_meta.js b/website/src/pages/de/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/de/token-api/evm-dexs/_meta.js +++ b/website/src/pages/de/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/de/token-api/evm-tokens/_meta.js b/website/src/pages/de/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/de/token-api/evm-tokens/_meta.js +++ b/website/src/pages/de/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/de/token-api/svm-dexs/_meta.js b/website/src/pages/de/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/de/token-api/svm-dexs/_meta.js +++ b/website/src/pages/de/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/de/token-api/svm-tokens/_meta.js b/website/src/pages/de/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/de/token-api/svm-tokens/_meta.js +++ b/website/src/pages/de/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/en/token-api/_meta-titles.json b/website/src/pages/en/token-api/_meta-titles.json index f7416a115cfb..f4eee8a07f29 100644 --- a/website/src/pages/en/token-api/_meta-titles.json +++ b/website/src/pages/en/token-api/_meta-titles.json @@ -7,5 +7,6 @@ "tvm-tokens": "TVM Token Endpoints", "tvm-dexs": "TVM DEX Endpoints", "monitoring": "Monitoring Endpoints", + "endpoints": "Endpoints", "guides": "Guides" } diff --git a/website/src/pages/en/token-api/_meta.js b/website/src/pages/en/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/en/token-api/_meta.js +++ b/website/src/pages/en/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: '', } diff --git a/website/src/pages/en/token-api/endpoints/_meta.js b/website/src/pages/en/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/en/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/de/token-api/endpoint-pricing.mdx b/website/src/pages/en/token-api/endpoints/pricing.mdx similarity index 59% rename from website/src/pages/de/token-api/endpoint-pricing.mdx rename to website/src/pages/en/token-api/endpoints/pricing.mdx index 1354b7e2bc10..df3a04c50a55 100644 --- a/website/src/pages/de/token-api/endpoint-pricing.mdx +++ b/website/src/pages/en/token-api/endpoints/pricing.mdx @@ -1,5 +1,6 @@ --- title: Endpoint Pricing +sidebarTitle: Pricing --- ## Pricing Tiers @@ -9,10 +10,21 @@ 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 @@ -20,8 +32,11 @@ 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 ``` diff --git a/website/src/pages/en/token-api/endpoints/support.mdx b/website/src/pages/en/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/en/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/en/token-api/evm-dexs/_meta.js b/website/src/pages/en/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/en/token-api/evm-dexs/_meta.js +++ b/website/src/pages/en/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/en/token-api/evm-tokens/_meta.js b/website/src/pages/en/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/en/token-api/evm-tokens/_meta.js +++ b/website/src/pages/en/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/en/token-api/quick-start.mdx b/website/src/pages/en/token-api/quick-start.mdx index 70631be0d91b..d415adea02bd 100644 --- a/website/src/pages/en/token-api/quick-start.mdx +++ b/website/src/pages/en/token-api/quick-start.mdx @@ -1,96 +1,103 @@ --- -title: Token API Quick Start +title: Welcome to the Token API sidebarTitle: Quick Start --- -import { Check } from '@edgeandnode/gds/icons' +The Graph's Token API lets you access both live and historical data for tokens across multiple blockchains. -![](/img/token-api-quickstart-banner.jpg) +## Gain access -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. +Make sure you already have an account on [The Graph Market](https://thegraph.com) and an **"API TOKEN (Authentication JWT)"** from the [Dashboard](https://thegraph.market/dashboard). -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. +## Use authenticated routes -## Prerequisites +Raw API endpoints are authenticated using a header, and the TypeScript Node.js SDK accepts the token as a configuration option. -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 + ```shell + curl --request GET \ + --url "https://token-api.thegraph.com/v1/evm/balances?network=mainnet&address=0x2a0c0dbecc7e4d658f48e01e3fa353f44050c208" \ + --header 'Accept: application/json' \ + --header 'Authorization: Bearer YOUR_TOKEN' + ``` -All API endpoints are authenticated using a JWT API token inserted in the header as `Authorization: Bearer `. + ```typescript + import {EVMChains, TokenAPI} from "@pinax/token-api"; -```json -{ - "headers": { - "Authorization": "Bearer eyJh•••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••NnlA" - } -} -``` + const client = new TokenAPI({ + apiToken: process.env.TOKEN_API_KEY || "" + }); -## Using JavaScript + const result = await client.evm.tokens.getBalances({ + network: EVMChains.Ethereum, + address: ['0x2a0c0dbecc7e4d658f48e01e3fa353f44050c208'] + }) + ``` -Make an API request using **JavaScript** by adding the request parameters, and then fetching from the relevant endpoint. For example: + ```python + import requests -```js label="index.js" -const address = '0x2a0c0dbecc7e4d658f48e01e3fa353f44050c208' -const options = { - method: 'GET', - headers: { - Accept: 'application/json', - Authorization: 'Bearer ', - }, -} + res = requests.get( + "https://token-api.thegraph.com/v1/evm/balances?network=mainnet&address=0x2a0c0dbecc7e4d658f48e01e3fa353f44050c208", + headers={"Authorization": "Bearer YOUR_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)) -``` + print(res.json()) + ``` -Make sure to replace `` with the JWT Token generated from your API key. + ```go + package main -## Using cURL (Command Line) + import ( + "fmt" + "encoding/json" + "net/http" + ) -To make an API request using **cURL**, open your command line and run the following command. + func main() { + req, _ := http.NewRequest("GET", + "https://token-api.thegraph.com/v1/evm/balances?network=mainnet&address=0x2a0c0dbecc7e4d658f48e01e3fa353f44050c208", + nil, + ) + req.Header.Set("Authorization", "Bearer YOUR_TOKEN") -```curl -curl --request GET \ - --url https://token-api.thegraph.com/v1/evm/balances?network=mainnet&address=${address} \ - --header 'Accept: application/json' \ - --header 'Authorization: Bearer ' -``` + res, _ := http.DefaultClient.Do(req) + defer res.Body.Close() -Make sure to replace `` with the JWT Token generated from your API key. + var data any + json.NewDecoder(res.Body).Decode(&data) -> Most Unix-like systems come with cURL preinstalled. For Windows, you may need to install cURL. + fmt.Printf("%#v\n", data) + } + ``` -## Chain and Feature Support + ```rust + use reqwest::Client; -| 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 | + #[tokio::main] + async fn main() -> reqwest::Result<()> { + let res = Client::new() + .get("https://token-api.thegraph.com/v1/evm/balances?network=mainnet&address=0x2a0c0dbecc7e4d658f48e01e3fa353f44050c208") + .bearer_auth("YOUR_TOKEN") + .send() + .await?; -A full list of chain support for The Graph services can be found [here](/supported-networks/). + println!("{}", res.text().await?); + Ok(()) + } + ``` -## Troubleshooting + -If the API call fails, try printing out the full response object for additional error details. For example: +## What's next? -```js label="index.js" -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)) -``` +Explore the most popular endpoints: + +- [EVM Transfers](/token-api/evm-tokens/transfers/) +- [Solana Swaps](/token-api/svm-dexs/swaps/) +- [EVM Token Holders](/token-api/evm-tokens/holders/) +- [EVM Swaps](/token-api/evm-dexs/swaps/) +- [EVM Historical Balances](/token-api/evm-tokens/balances-historical/) + +Check the sidebar for more endpoints that you can use with the Token API! diff --git a/website/src/pages/en/token-api/svm-dexs/_meta.js b/website/src/pages/en/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/en/token-api/svm-dexs/_meta.js +++ b/website/src/pages/en/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/en/token-api/svm-tokens/_meta.js b/website/src/pages/en/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/en/token-api/svm-tokens/_meta.js +++ b/website/src/pages/en/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/es/token-api/_meta.js b/website/src/pages/es/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/es/token-api/_meta.js +++ b/website/src/pages/es/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: '', } diff --git a/website/src/pages/es/token-api/endpoint-pricing.mdx b/website/src/pages/es/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/es/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/es/token-api/endpoints/_meta.js b/website/src/pages/es/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/es/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/es/token-api/endpoints/pricing.mdx b/website/src/pages/es/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/es/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/es/token-api/endpoints/support.mdx b/website/src/pages/es/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/es/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/es/token-api/evm-dexs/_meta.js b/website/src/pages/es/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/es/token-api/evm-dexs/_meta.js +++ b/website/src/pages/es/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/es/token-api/evm-tokens/_meta.js b/website/src/pages/es/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/es/token-api/evm-tokens/_meta.js +++ b/website/src/pages/es/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/es/token-api/svm-dexs/_meta.js b/website/src/pages/es/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/es/token-api/svm-dexs/_meta.js +++ b/website/src/pages/es/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/es/token-api/svm-tokens/_meta.js b/website/src/pages/es/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/es/token-api/svm-tokens/_meta.js +++ b/website/src/pages/es/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/fr/token-api/_meta.js b/website/src/pages/fr/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/fr/token-api/_meta.js +++ b/website/src/pages/fr/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: '', } diff --git a/website/src/pages/fr/token-api/endpoint-pricing.mdx b/website/src/pages/fr/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/fr/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/fr/token-api/endpoints/_meta.js b/website/src/pages/fr/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/fr/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/fr/token-api/endpoints/pricing.mdx b/website/src/pages/fr/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/fr/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/fr/token-api/endpoints/support.mdx b/website/src/pages/fr/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/fr/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/fr/token-api/evm-dexs/_meta.js b/website/src/pages/fr/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/fr/token-api/evm-dexs/_meta.js +++ b/website/src/pages/fr/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/fr/token-api/evm-tokens/_meta.js b/website/src/pages/fr/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/fr/token-api/evm-tokens/_meta.js +++ b/website/src/pages/fr/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/fr/token-api/svm-dexs/_meta.js b/website/src/pages/fr/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/fr/token-api/svm-dexs/_meta.js +++ b/website/src/pages/fr/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/fr/token-api/svm-tokens/_meta.js b/website/src/pages/fr/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/fr/token-api/svm-tokens/_meta.js +++ b/website/src/pages/fr/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/hi/token-api/_meta.js b/website/src/pages/hi/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/hi/token-api/_meta.js +++ b/website/src/pages/hi/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: '', } diff --git a/website/src/pages/hi/token-api/endpoint-pricing.mdx b/website/src/pages/hi/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/hi/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/hi/token-api/endpoints/_meta.js b/website/src/pages/hi/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/hi/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/hi/token-api/endpoints/pricing.mdx b/website/src/pages/hi/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/hi/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/hi/token-api/endpoints/support.mdx b/website/src/pages/hi/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/hi/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/hi/token-api/evm-dexs/_meta.js b/website/src/pages/hi/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/hi/token-api/evm-dexs/_meta.js +++ b/website/src/pages/hi/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/hi/token-api/evm-tokens/_meta.js b/website/src/pages/hi/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/hi/token-api/evm-tokens/_meta.js +++ b/website/src/pages/hi/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/hi/token-api/svm-dexs/_meta.js b/website/src/pages/hi/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/hi/token-api/svm-dexs/_meta.js +++ b/website/src/pages/hi/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/hi/token-api/svm-tokens/_meta.js b/website/src/pages/hi/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/hi/token-api/svm-tokens/_meta.js +++ b/website/src/pages/hi/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/it/token-api/_meta.js b/website/src/pages/it/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/it/token-api/_meta.js +++ b/website/src/pages/it/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: '', } diff --git a/website/src/pages/it/token-api/endpoint-pricing.mdx b/website/src/pages/it/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/it/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/it/token-api/endpoints/_meta.js b/website/src/pages/it/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/it/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/it/token-api/endpoints/pricing.mdx b/website/src/pages/it/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/it/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/it/token-api/endpoints/support.mdx b/website/src/pages/it/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/it/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/it/token-api/evm-dexs/_meta.js b/website/src/pages/it/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/it/token-api/evm-dexs/_meta.js +++ b/website/src/pages/it/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/it/token-api/evm-tokens/_meta.js b/website/src/pages/it/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/it/token-api/evm-tokens/_meta.js +++ b/website/src/pages/it/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/it/token-api/svm-dexs/_meta.js b/website/src/pages/it/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/it/token-api/svm-dexs/_meta.js +++ b/website/src/pages/it/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/it/token-api/svm-tokens/_meta.js b/website/src/pages/it/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/it/token-api/svm-tokens/_meta.js +++ b/website/src/pages/it/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/ja/token-api/_meta.js b/website/src/pages/ja/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/ja/token-api/_meta.js +++ b/website/src/pages/ja/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: '', } diff --git a/website/src/pages/ja/token-api/endpoint-pricing.mdx b/website/src/pages/ja/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/ja/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/ja/token-api/endpoints/_meta.js b/website/src/pages/ja/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/ja/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/ja/token-api/endpoints/pricing.mdx b/website/src/pages/ja/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/ja/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/ja/token-api/endpoints/support.mdx b/website/src/pages/ja/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/ja/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/ja/token-api/evm-dexs/_meta.js b/website/src/pages/ja/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ja/token-api/evm-dexs/_meta.js +++ b/website/src/pages/ja/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ja/token-api/evm-tokens/_meta.js b/website/src/pages/ja/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/ja/token-api/evm-tokens/_meta.js +++ b/website/src/pages/ja/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/ja/token-api/svm-dexs/_meta.js b/website/src/pages/ja/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ja/token-api/svm-dexs/_meta.js +++ b/website/src/pages/ja/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ja/token-api/svm-tokens/_meta.js b/website/src/pages/ja/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/ja/token-api/svm-tokens/_meta.js +++ b/website/src/pages/ja/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/ko/token-api/_meta.js b/website/src/pages/ko/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/ko/token-api/_meta.js +++ b/website/src/pages/ko/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: '', } diff --git a/website/src/pages/ko/token-api/endpoint-pricing.mdx b/website/src/pages/ko/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/ko/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/ko/token-api/endpoints/_meta.js b/website/src/pages/ko/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/ko/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/ko/token-api/endpoints/pricing.mdx b/website/src/pages/ko/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/ko/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/ko/token-api/endpoints/support.mdx b/website/src/pages/ko/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/ko/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/ko/token-api/evm-dexs/_meta.js b/website/src/pages/ko/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ko/token-api/evm-dexs/_meta.js +++ b/website/src/pages/ko/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ko/token-api/evm-tokens/_meta.js b/website/src/pages/ko/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/ko/token-api/evm-tokens/_meta.js +++ b/website/src/pages/ko/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/ko/token-api/svm-dexs/_meta.js b/website/src/pages/ko/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ko/token-api/svm-dexs/_meta.js +++ b/website/src/pages/ko/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ko/token-api/svm-tokens/_meta.js b/website/src/pages/ko/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/ko/token-api/svm-tokens/_meta.js +++ b/website/src/pages/ko/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/mr/token-api/_meta.js b/website/src/pages/mr/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/mr/token-api/_meta.js +++ b/website/src/pages/mr/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: '', } diff --git a/website/src/pages/mr/token-api/endpoint-pricing.mdx b/website/src/pages/mr/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/mr/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/mr/token-api/endpoints/_meta.js b/website/src/pages/mr/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/mr/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/mr/token-api/endpoints/pricing.mdx b/website/src/pages/mr/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/mr/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/mr/token-api/endpoints/support.mdx b/website/src/pages/mr/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/mr/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/mr/token-api/evm-dexs/_meta.js b/website/src/pages/mr/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/mr/token-api/evm-dexs/_meta.js +++ b/website/src/pages/mr/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/mr/token-api/evm-tokens/_meta.js b/website/src/pages/mr/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/mr/token-api/evm-tokens/_meta.js +++ b/website/src/pages/mr/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/mr/token-api/svm-dexs/_meta.js b/website/src/pages/mr/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/mr/token-api/svm-dexs/_meta.js +++ b/website/src/pages/mr/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/mr/token-api/svm-tokens/_meta.js b/website/src/pages/mr/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/mr/token-api/svm-tokens/_meta.js +++ b/website/src/pages/mr/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/nl/token-api/_meta.js b/website/src/pages/nl/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/nl/token-api/_meta.js +++ b/website/src/pages/nl/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: '', } diff --git a/website/src/pages/nl/token-api/endpoint-pricing.mdx b/website/src/pages/nl/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/nl/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/nl/token-api/endpoints/_meta.js b/website/src/pages/nl/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/nl/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/nl/token-api/endpoints/pricing.mdx b/website/src/pages/nl/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/nl/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/nl/token-api/endpoints/support.mdx b/website/src/pages/nl/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/nl/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/nl/token-api/evm-dexs/_meta.js b/website/src/pages/nl/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/nl/token-api/evm-dexs/_meta.js +++ b/website/src/pages/nl/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/nl/token-api/evm-tokens/_meta.js b/website/src/pages/nl/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/nl/token-api/evm-tokens/_meta.js +++ b/website/src/pages/nl/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/nl/token-api/svm-dexs/_meta.js b/website/src/pages/nl/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/nl/token-api/svm-dexs/_meta.js +++ b/website/src/pages/nl/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/nl/token-api/svm-tokens/_meta.js b/website/src/pages/nl/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/nl/token-api/svm-tokens/_meta.js +++ b/website/src/pages/nl/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/pl/token-api/_meta.js b/website/src/pages/pl/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/pl/token-api/_meta.js +++ b/website/src/pages/pl/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: '', } diff --git a/website/src/pages/pl/token-api/endpoint-pricing.mdx b/website/src/pages/pl/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/pl/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/pl/token-api/endpoints/_meta.js b/website/src/pages/pl/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/pl/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/pl/token-api/endpoints/pricing.mdx b/website/src/pages/pl/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/pl/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/pl/token-api/endpoints/support.mdx b/website/src/pages/pl/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/pl/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/pl/token-api/evm-dexs/_meta.js b/website/src/pages/pl/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/pl/token-api/evm-dexs/_meta.js +++ b/website/src/pages/pl/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/pl/token-api/evm-tokens/_meta.js b/website/src/pages/pl/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/pl/token-api/evm-tokens/_meta.js +++ b/website/src/pages/pl/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/pl/token-api/svm-dexs/_meta.js b/website/src/pages/pl/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/pl/token-api/svm-dexs/_meta.js +++ b/website/src/pages/pl/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/pl/token-api/svm-tokens/_meta.js b/website/src/pages/pl/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/pl/token-api/svm-tokens/_meta.js +++ b/website/src/pages/pl/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/pt/token-api/_meta.js b/website/src/pages/pt/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/pt/token-api/_meta.js +++ b/website/src/pages/pt/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: '', } diff --git a/website/src/pages/pt/token-api/endpoint-pricing.mdx b/website/src/pages/pt/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/pt/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/pt/token-api/endpoints/_meta.js b/website/src/pages/pt/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/pt/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/pt/token-api/endpoints/pricing.mdx b/website/src/pages/pt/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/pt/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/pt/token-api/endpoints/support.mdx b/website/src/pages/pt/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/pt/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/pt/token-api/evm-dexs/_meta.js b/website/src/pages/pt/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/pt/token-api/evm-dexs/_meta.js +++ b/website/src/pages/pt/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/pt/token-api/evm-tokens/_meta.js b/website/src/pages/pt/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/pt/token-api/evm-tokens/_meta.js +++ b/website/src/pages/pt/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/pt/token-api/svm-dexs/_meta.js b/website/src/pages/pt/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/pt/token-api/svm-dexs/_meta.js +++ b/website/src/pages/pt/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/pt/token-api/svm-tokens/_meta.js b/website/src/pages/pt/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/pt/token-api/svm-tokens/_meta.js +++ b/website/src/pages/pt/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/ro/token-api/_meta.js b/website/src/pages/ro/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/ro/token-api/_meta.js +++ b/website/src/pages/ro/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: '', } diff --git a/website/src/pages/ro/token-api/endpoint-pricing.mdx b/website/src/pages/ro/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/ro/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/ro/token-api/endpoints/_meta.js b/website/src/pages/ro/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/ro/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/ro/token-api/endpoints/pricing.mdx b/website/src/pages/ro/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/ro/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/ro/token-api/endpoints/support.mdx b/website/src/pages/ro/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/ro/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/ro/token-api/evm-dexs/_meta.js b/website/src/pages/ro/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ro/token-api/evm-dexs/_meta.js +++ b/website/src/pages/ro/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ro/token-api/evm-tokens/_meta.js b/website/src/pages/ro/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/ro/token-api/evm-tokens/_meta.js +++ b/website/src/pages/ro/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/ro/token-api/svm-dexs/_meta.js b/website/src/pages/ro/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ro/token-api/svm-dexs/_meta.js +++ b/website/src/pages/ro/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ro/token-api/svm-tokens/_meta.js b/website/src/pages/ro/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/ro/token-api/svm-tokens/_meta.js +++ b/website/src/pages/ro/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/ru/token-api/_meta.js b/website/src/pages/ru/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/ru/token-api/_meta.js +++ b/website/src/pages/ru/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: '', } diff --git a/website/src/pages/ru/token-api/endpoint-pricing.mdx b/website/src/pages/ru/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/ru/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/ru/token-api/endpoints/_meta.js b/website/src/pages/ru/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/ru/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/ru/token-api/endpoints/pricing.mdx b/website/src/pages/ru/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/ru/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/ru/token-api/endpoints/support.mdx b/website/src/pages/ru/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/ru/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/ru/token-api/evm-dexs/_meta.js b/website/src/pages/ru/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ru/token-api/evm-dexs/_meta.js +++ b/website/src/pages/ru/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ru/token-api/evm-tokens/_meta.js b/website/src/pages/ru/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/ru/token-api/evm-tokens/_meta.js +++ b/website/src/pages/ru/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/ru/token-api/svm-dexs/_meta.js b/website/src/pages/ru/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ru/token-api/svm-dexs/_meta.js +++ b/website/src/pages/ru/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ru/token-api/svm-tokens/_meta.js b/website/src/pages/ru/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/ru/token-api/svm-tokens/_meta.js +++ b/website/src/pages/ru/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/sv/token-api/_meta.js b/website/src/pages/sv/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/sv/token-api/_meta.js +++ b/website/src/pages/sv/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: '', } diff --git a/website/src/pages/sv/token-api/endpoint-pricing.mdx b/website/src/pages/sv/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/sv/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/sv/token-api/endpoints/_meta.js b/website/src/pages/sv/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/sv/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/sv/token-api/endpoints/pricing.mdx b/website/src/pages/sv/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/sv/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/sv/token-api/endpoints/support.mdx b/website/src/pages/sv/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/sv/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/sv/token-api/evm-dexs/_meta.js b/website/src/pages/sv/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/sv/token-api/evm-dexs/_meta.js +++ b/website/src/pages/sv/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/sv/token-api/evm-tokens/_meta.js b/website/src/pages/sv/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/sv/token-api/evm-tokens/_meta.js +++ b/website/src/pages/sv/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/sv/token-api/svm-dexs/_meta.js b/website/src/pages/sv/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/sv/token-api/svm-dexs/_meta.js +++ b/website/src/pages/sv/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/sv/token-api/svm-tokens/_meta.js b/website/src/pages/sv/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/sv/token-api/svm-tokens/_meta.js +++ b/website/src/pages/sv/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/tr/token-api/_meta.js b/website/src/pages/tr/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/tr/token-api/_meta.js +++ b/website/src/pages/tr/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: '', } diff --git a/website/src/pages/tr/token-api/endpoint-pricing.mdx b/website/src/pages/tr/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/tr/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/tr/token-api/endpoints/_meta.js b/website/src/pages/tr/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/tr/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/tr/token-api/endpoints/pricing.mdx b/website/src/pages/tr/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/tr/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/tr/token-api/endpoints/support.mdx b/website/src/pages/tr/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/tr/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/tr/token-api/evm-dexs/_meta.js b/website/src/pages/tr/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/tr/token-api/evm-dexs/_meta.js +++ b/website/src/pages/tr/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/tr/token-api/evm-tokens/_meta.js b/website/src/pages/tr/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/tr/token-api/evm-tokens/_meta.js +++ b/website/src/pages/tr/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/tr/token-api/svm-dexs/_meta.js b/website/src/pages/tr/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/tr/token-api/svm-dexs/_meta.js +++ b/website/src/pages/tr/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/tr/token-api/svm-tokens/_meta.js b/website/src/pages/tr/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/tr/token-api/svm-tokens/_meta.js +++ b/website/src/pages/tr/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/uk/token-api/_meta.js b/website/src/pages/uk/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/uk/token-api/_meta.js +++ b/website/src/pages/uk/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: '', } diff --git a/website/src/pages/uk/token-api/endpoint-pricing.mdx b/website/src/pages/uk/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/uk/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/uk/token-api/endpoints/_meta.js b/website/src/pages/uk/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/uk/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/uk/token-api/endpoints/pricing.mdx b/website/src/pages/uk/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/uk/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/uk/token-api/endpoints/support.mdx b/website/src/pages/uk/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/uk/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/uk/token-api/evm-dexs/_meta.js b/website/src/pages/uk/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/uk/token-api/evm-dexs/_meta.js +++ b/website/src/pages/uk/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/uk/token-api/evm-tokens/_meta.js b/website/src/pages/uk/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/uk/token-api/evm-tokens/_meta.js +++ b/website/src/pages/uk/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/uk/token-api/svm-dexs/_meta.js b/website/src/pages/uk/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/uk/token-api/svm-dexs/_meta.js +++ b/website/src/pages/uk/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/uk/token-api/svm-tokens/_meta.js b/website/src/pages/uk/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/uk/token-api/svm-tokens/_meta.js +++ b/website/src/pages/uk/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/ur/token-api/_meta.js b/website/src/pages/ur/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/ur/token-api/_meta.js +++ b/website/src/pages/ur/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: '', } diff --git a/website/src/pages/ur/token-api/endpoint-pricing.mdx b/website/src/pages/ur/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/ur/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/ur/token-api/endpoints/_meta.js b/website/src/pages/ur/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/ur/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/ur/token-api/endpoints/pricing.mdx b/website/src/pages/ur/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/ur/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/ur/token-api/endpoints/support.mdx b/website/src/pages/ur/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/ur/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/ur/token-api/evm-dexs/_meta.js b/website/src/pages/ur/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ur/token-api/evm-dexs/_meta.js +++ b/website/src/pages/ur/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ur/token-api/evm-tokens/_meta.js b/website/src/pages/ur/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/ur/token-api/evm-tokens/_meta.js +++ b/website/src/pages/ur/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/ur/token-api/svm-dexs/_meta.js b/website/src/pages/ur/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/ur/token-api/svm-dexs/_meta.js +++ b/website/src/pages/ur/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/ur/token-api/svm-tokens/_meta.js b/website/src/pages/ur/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/ur/token-api/svm-tokens/_meta.js +++ b/website/src/pages/ur/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/vi/token-api/_meta.js b/website/src/pages/vi/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/vi/token-api/_meta.js +++ b/website/src/pages/vi/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: '', } diff --git a/website/src/pages/vi/token-api/endpoint-pricing.mdx b/website/src/pages/vi/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/vi/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/vi/token-api/endpoints/_meta.js b/website/src/pages/vi/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/vi/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/vi/token-api/endpoints/pricing.mdx b/website/src/pages/vi/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/vi/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/vi/token-api/endpoints/support.mdx b/website/src/pages/vi/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/vi/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/vi/token-api/evm-dexs/_meta.js b/website/src/pages/vi/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/vi/token-api/evm-dexs/_meta.js +++ b/website/src/pages/vi/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/vi/token-api/evm-tokens/_meta.js b/website/src/pages/vi/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/vi/token-api/evm-tokens/_meta.js +++ b/website/src/pages/vi/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/vi/token-api/svm-dexs/_meta.js b/website/src/pages/vi/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/vi/token-api/svm-dexs/_meta.js +++ b/website/src/pages/vi/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/vi/token-api/svm-tokens/_meta.js b/website/src/pages/vi/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/vi/token-api/svm-tokens/_meta.js +++ b/website/src/pages/vi/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '', diff --git a/website/src/pages/zh/token-api/_meta.js b/website/src/pages/zh/token-api/_meta.js index 9588f70cec53..e9f3ca1f8b16 100644 --- a/website/src/pages/zh/token-api/_meta.js +++ b/website/src/pages/zh/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: '', } diff --git a/website/src/pages/zh/token-api/endpoint-pricing.mdx b/website/src/pages/zh/token-api/endpoint-pricing.mdx deleted file mode 100644 index 1354b7e2bc10..000000000000 --- a/website/src/pages/zh/token-api/endpoint-pricing.mdx +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Endpoint Pricing ---- - -## Pricing Tiers - -| Free Tier | Scale Tier | Pro Tier | Enterprise | -| --- | --- | --- | --- | -| $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 | -| 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 | - -## 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/evm/transfers -GET /v1/svm/transfers -GET /v1/evm/balances -GET /v1/svm/balances -GET /v1/evm/balances/native -GET /v1/svm/balances/native -``` - -## DEX Endpoints - $50/mil queries - -Access on-chain swap, liquidity pool, and decentralized exchange data - -``` -GET /v1/evm/swaps -GET /v1/svm/swaps -GET /v1/evm/pools -GET /v1/svm/pools -``` - -## NFT Endpoints - $50/mil queries - -Retrieve NFT transfers, ownership details, collections, and sales activity - -``` -GET /v1/evm/nft/items -GET /v1/evm/nft/collections -GET /v1/evm/nft/sales -GET /v1/evm/nft/ownerships -GET /v1/evm/nft/transfers -``` - -## Aggregate & Historical Endpoints - $200/mil queries - -Provide summarized, ranked, and time-series blockchain data for analytical use - -``` -GET /v1/evm/holders -GET /v1/svm/holders -GET /v1/evm/nft/holders -GET /v1/evm/pools/ohlc -GET /v1/svm/pools/ohlc -GET /v1/evm/balances/historical -``` - -## Monitoring Endpoints - Free - -Offer real-time API, network, and version health information for system status - -``` -GET /v1/health -GET /v1/version -GET /v1/networks -GET /v1/evm/dexes -GET /v1/svm/dexes -``` diff --git a/website/src/pages/zh/token-api/endpoints/_meta.js b/website/src/pages/zh/token-api/endpoints/_meta.js new file mode 100644 index 000000000000..c85dabe30711 --- /dev/null +++ b/website/src/pages/zh/token-api/endpoints/_meta.js @@ -0,0 +1,4 @@ +export default { + pricing: '', + support: '', +} diff --git a/website/src/pages/zh/token-api/endpoints/pricing.mdx b/website/src/pages/zh/token-api/endpoints/pricing.mdx new file mode 100644 index 000000000000..df3a04c50a55 --- /dev/null +++ b/website/src/pages/zh/token-api/endpoints/pricing.mdx @@ -0,0 +1,95 @@ +--- +title: Endpoint Pricing +sidebarTitle: Pricing +--- + +## Pricing Tiers + +| Free Tier | Scale Tier | Pro Tier | Enterprise | +| --- | --- | --- | --- | +| $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: 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 +GET /v1/svm/balances/native +``` + +## DEX Endpoints - $50/mil queries + +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 +``` + +## NFT Endpoints - $50/mil queries + +Retrieve NFT transfers, ownership details, collections, and sales activity + +``` +GET /v1/evm/nft/items +GET /v1/evm/nft/collections +GET /v1/evm/nft/sales +GET /v1/evm/nft/ownerships +GET /v1/evm/nft/transfers +``` + +## Aggregate & Historical Endpoints - $200/mil queries + +Provide summarized, ranked, and time-series blockchain data for analytical use + +``` +GET /v1/evm/holders +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 +``` + +## Monitoring Endpoints - Free + +Offer real-time API, network, and version health information for system status + +``` +GET /v1/health +GET /v1/version +GET /v1/networks +GET /v1/evm/dexes +GET /v1/svm/dexes +GET /v1/tvm/dexes +``` diff --git a/website/src/pages/zh/token-api/endpoints/support.mdx b/website/src/pages/zh/token-api/endpoints/support.mdx new file mode 100644 index 000000000000..50f825afdfd6 --- /dev/null +++ b/website/src/pages/zh/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 | | | | +| 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](/supported-networks/). diff --git a/website/src/pages/zh/token-api/evm-dexs/_meta.js b/website/src/pages/zh/token-api/evm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/zh/token-api/evm-dexs/_meta.js +++ b/website/src/pages/zh/token-api/evm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/zh/token-api/evm-tokens/_meta.js b/website/src/pages/zh/token-api/evm-tokens/_meta.js index 2aeed42ff9f1..a350a8e8b23f 100644 --- a/website/src/pages/zh/token-api/evm-tokens/_meta.js +++ b/website/src/pages/zh/token-api/evm-tokens/_meta.js @@ -1,8 +1,8 @@ export default { - tokens: '', transfers: '', + holders: '', + tokens: '', balances: '', 'balances-native': '', 'balances-historical': '', - holders: '', } diff --git a/website/src/pages/zh/token-api/svm-dexs/_meta.js b/website/src/pages/zh/token-api/svm-dexs/_meta.js index df1d9ecf4a6b..73b5deeddbbc 100644 --- a/website/src/pages/zh/token-api/svm-dexs/_meta.js +++ b/website/src/pages/zh/token-api/svm-dexs/_meta.js @@ -1,6 +1,6 @@ export default { + swaps: '', dexes: '', 'pools-ohlc': '', pools: '', - swaps: '', } diff --git a/website/src/pages/zh/token-api/svm-tokens/_meta.js b/website/src/pages/zh/token-api/svm-tokens/_meta.js index 1de31437004c..001e2d43341a 100644 --- a/website/src/pages/zh/token-api/svm-tokens/_meta.js +++ b/website/src/pages/zh/token-api/svm-tokens/_meta.js @@ -1,6 +1,6 @@ export default { - tokens: '', transfers: '', + tokens: '', balances: '', 'balances-native': '', holders: '',