diff --git a/website/route-lockfile.txt b/website/route-lockfile.txt index 222170ce9c61..338ba8a8e1db 100644 --- a/website/route-lockfile.txt +++ b/website/route-lockfile.txt @@ -255,8 +255,12 @@ /en/token-api/evm-nfts/ownerships/ /en/token-api/evm-nfts/sales/ /en/token-api/evm-nfts/transfers/ +/en/token-api/evm-tokens-native/balances-historical-native/ +/en/token-api/evm-tokens-native/balances-native/ +/en/token-api/evm-tokens-native/holders-native/ +/en/token-api/evm-tokens-native/tokens-native/ +/en/token-api/evm-tokens-native/transfers-native/ /en/token-api/evm-tokens/balances-historical/ -/en/token-api/evm-tokens/balances-native/ /en/token-api/evm-tokens/balances/ /en/token-api/evm-tokens/holders/ /en/token-api/evm-tokens/tokens/ @@ -271,7 +275,7 @@ /en/token-api/svm-dexs/pools-ohlc/ /en/token-api/svm-dexs/pools/ /en/token-api/svm-dexs/swaps/ -/en/token-api/svm-tokens/balances-native/ +/en/token-api/svm-tokens-native/balances-native/ /en/token-api/svm-tokens/balances/ /en/token-api/svm-tokens/holders/ /en/token-api/svm-tokens/owner/ @@ -281,6 +285,7 @@ /en/token-api/tvm-dexs/pools-ohlc/ /en/token-api/tvm-dexs/pools/ /en/token-api/tvm-dexs/swaps/ +/en/token-api/tvm-tokens-native/tokens-native/ +/en/token-api/tvm-tokens-native/transfers-native/ /en/token-api/tvm-tokens/tokens/ -/en/token-api/tvm-tokens/transfers-native/ /en/token-api/tvm-tokens/transfers/ diff --git a/website/src/openApi/index.ts b/website/src/openApi/index.ts index f1fc0fcb7800..fa4accb0f1f8 100644 --- a/website/src/openApi/index.ts +++ b/website/src/openApi/index.ts @@ -13,10 +13,26 @@ export const APIS: Record = { // url: 'https://token-api.service.stage.pinax.network/openapi', // staging document: tokenApi as OpenAPIV3_1.Document, sections: { - 'EVM Tokens': { + 'SVM Tokens': { + path: '/token-api/svm-tokens', + operationIdPrefixes: ['getV1Svm'], + }, + 'SVM Tokens (Native)': { + path: '/token-api/svm-tokens-native', + operationIdPrefixes: ['getV1Svm'], + }, + 'SVM DEXs': { + path: '/token-api/svm-dexs', + operationIdPrefixes: ['getV1Svm'], + }, + 'EVM Tokens (ERC-20)': { path: '/token-api/evm-tokens', operationIdPrefixes: ['getV1Evm'], }, + 'EVM Tokens (Native)': { + path: '/token-api/evm-tokens-native', + operationIdPrefixes: ['getV1Evm'], + }, 'EVM DEXs': { path: '/token-api/evm-dexs', operationIdPrefixes: ['getV1Evm'], @@ -25,18 +41,14 @@ export const APIS: Record = { path: '/token-api/evm-nfts', operationIdPrefixes: ['getV1EvmNft'], }, - 'SVM Tokens': { - path: '/token-api/svm-tokens', - operationIdPrefixes: ['getV1Svm'], - }, - 'SVM DEXs': { - path: '/token-api/svm-dexs', - operationIdPrefixes: ['getV1Svm'], - }, - 'TVM Tokens': { + 'TVM Tokens (ERC-20)': { path: '/token-api/tvm-tokens', operationIdPrefixes: ['getV1Tvm'], }, + 'TVM Tokens (Native)': { + path: '/token-api/tvm-tokens-native', + operationIdPrefixes: ['getV1Tvm'], + }, 'TVM DEXs': { path: '/token-api/tvm-dexs', operationIdPrefixes: ['getV1Tvm'], diff --git a/website/src/openApi/tokenApi.json b/website/src/openApi/tokenApi.json index fc6291839e72..81028d1a1d6b 100644 --- a/website/src/openApi/tokenApi.json +++ b/website/src/openApi/tokenApi.json @@ -3,7 +3,7 @@ "info": { "title": "Token API", "description": "Power your apps & AI agents with real-time token data.", - "version": "3.7.2+8e84108 (2026-01-07)" + "version": "3.8.0+bbff1ca (2026-01-29)" }, "servers": [ { @@ -26,13 +26,13 @@ } }, "paths": { - "/v1/evm/balances/historical": { + "/v1/evm/transfers": { "get": { - "operationId": "getV1EvmBalancesHistorical", - "summary": "Historical Balances", - "description": "Returns wallet token balance changes over time in OHLCV format.\n\nOHLCV historical depth is subject to plan restrictions.", + "operationId": "getV1EvmTransfers", + "summary": "Token Transfers", + "description": "Returns ERC-20 transfers with transaction and block data.", "tags": [ - "EVM Tokens" + "EVM Tokens (ERC-20)" ], "security": [ { @@ -52,40 +52,71 @@ "items": { "type": "object", "properties": { + "block_num": { + "type": "number" + }, "datetime": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "address": { + "timestamp": { + "type": "number" + }, + "transaction_id": { "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + "description": "Filter by transaction hash", + "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" }, "contract": { "type": "string", "description": "Filter by contract address", "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }, - "decimals": { - "type": "number" + "from": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" }, - "open": { - "type": "number" + "to": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" }, - "high": { - "type": "number" + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] }, - "low": { - "type": "number" + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] }, - "close": { - "type": "number" + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] }, - "name": { + "amount": { "type": "string" }, - "symbol": { - "type": "string" + "value": { + "type": "number" }, "network": { "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", @@ -104,16 +135,18 @@ } }, "required": [ + "block_num", "datetime", - "address", + "timestamp", + "transaction_id", "contract", - "decimals", - "open", - "high", - "low", - "close", + "from", + "to", "name", "symbol", + "decimals", + "amount", + "value", "network" ] } @@ -176,16 +209,20 @@ "value": { "data": [ { - "datetime": "2025-10-09 00:00:00", - "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", - "contract": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", - "open": 29.589346973619755, - "high": 50.783103394640676, - "low": 0.7830483276016842, - "close": 0.7841551025245886, - "name": "Native", - "symbol": "ETH", - "decimals": 18, + "block_num": 24278225, + "datetime": "2026-01-20 19:57:11", + "timestamp": 1768939031, + "transaction_id": "0x589cbe12efa0cca5a29b17bf7ee49c99566f0e05e937d54104134a2d916ab265", + "log_index": 24, + "contract": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", + "type": "transfer", + "from": "0x2393d38400cad1d0ffae85b37d76de05bb7eddc6", + "to": "0xd4f1171683f1bc07b77d0307a01b64dba5369cf8", + "name": "USD Coin", + "symbol": "USDC", + "decimals": 6, + "amount": "2686", + "value": 0.002686, "network": "mainnet" } ] @@ -541,20 +578,37 @@ }, { "in": "query", - "name": "address", + "name": "transaction_id", "schema": { "type": "string", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + "example": "0x96b1b180d22dae2b18a783ebdd5ae33f6867f3572f87c69a135c6c0a15a63c8e", + "anyOf": [ + { + "type": "string", + "description": "Filter by transaction hash", + "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by transaction hash", + "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" + } + } + ] }, - "required": true, - "description": "Filter by address" + "description": "Filter by transaction hash
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", "name": "contract", "schema": { "type": "string", - "example": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", "anyOf": [ { "type": "string", @@ -578,26 +632,64 @@ }, { "in": "query", - "name": "interval", + "name": "from_address", "schema": { "type": "string", - "enum": [ - "1h", - "4h", - "1d", - "1w" - ], - "example": "1w", - "default": "1d" + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + } + } + ] }, - "description": "The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).
*Plan restricted." + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "to_address", + "schema": { + "type": "string", + "example": "0xdadb0d80178819f2319190d340ce9a924f783711", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + } + } + ] + }, + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", "name": "start_time", "schema": { "type": "string", - "default": "2025-12-08" + "default": "2015-01-01" }, "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." }, @@ -610,6 +702,28 @@ }, "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." }, + { + "in": "query", + "name": "start_block", + "schema": { + "default": 0, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" + }, + { + "in": "query", + "name": "end_block", + "schema": { + "default": 9999999999, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" + }, { "in": "query", "name": "limit", @@ -635,13 +749,13 @@ ] } }, - "/v1/evm/balances/native": { + "/v1/evm/transfers/native": { "get": { - "operationId": "getV1EvmBalancesNative", - "summary": "Native Balances", - "description": "Returns EVM native balances for wallet addresses.", + "operationId": "getV1EvmTransfersNative", + "summary": "Native Transfers", + "description": "Returns Native transfers with transaction and block data.", "tags": [ - "EVM Tokens" + "EVM Tokens (Native)" ], "security": [ { @@ -661,31 +775,30 @@ "items": { "type": "object", "properties": { - "last_update": { + "block_num": { + "type": "number" + }, + "datetime": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "last_update_block_num": { + "timestamp": { "type": "number" }, - "last_update_timestamp": { - "type": "number" + "transaction_id": { + "type": "string", + "description": "Filter by transaction hash", + "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" }, - "address": { + "from": { "type": "string", "description": "Filter by address", "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" }, - "contract": { + "to": { "type": "string", - "description": "Filter by contract address", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" - }, - "amount": { - "type": "string" - }, - "value": { - "type": "number" + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" }, "name": { "anyOf": [ @@ -717,6 +830,12 @@ } ] }, + "amount": { + "type": "string" + }, + "value": { + "type": "number" + }, "network": { "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", "example": "mainnet", @@ -734,16 +853,17 @@ } }, "required": [ - "last_update", - "last_update_block_num", - "last_update_timestamp", - "address", - "contract", - "amount", - "value", + "block_num", + "datetime", + "timestamp", + "transaction_id", + "from", + "to", "name", "symbol", "decimals", + "amount", + "value", "network" ] } @@ -806,16 +926,20 @@ "value": { "data": [ { - "last_update": "2025-10-15 23:16:23", - "last_update_block_num": 23586308, - "last_update_timestamp": 1760570183, - "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", - "contract": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", - "amount": "784155102524588711", - "value": 0.7841551025245886, - "name": "Native", + "block_num": 24280071, + "datetime": "2026-01-21 02:07:35", + "timestamp": 1768961255, + "transaction_id": "0x73d346e1d286b893a3a0bb6b022845dc84cded73757b9ad89ae2c958fe266edf", + "transaction_index": 251, + "call_index": 3, + "type": "call", + "from": "0xd2b37ade14708bf18904047b1e31f8166d39612b", + "to": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", + "name": "Ethereum", "symbol": "ETH", "decimals": 18, + "amount": "25000000000000", + "value": 0.000025, "network": "mainnet" } ] @@ -1171,15 +1295,42 @@ }, { "in": "query", - "name": "address", + "name": "transaction_id", "schema": { "type": "string", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", + "example": "0x96b1b180d22dae2b18a783ebdd5ae33f6867f3572f87c69a135c6c0a15a63c8e", "anyOf": [ { "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + "description": "Filter by transaction hash", + "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by transaction hash", + "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" + } + } + ] + }, + "description": "Filter by transaction hash
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "from_address", + "schema": { + "type": "string", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" }, { "type": "string" @@ -1194,16 +1345,74 @@ } ] }, - "required": true, "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "include_null_balances", + "name": "to_address", "schema": { - "type": "boolean" + "type": "string", + "example": "0xdadb0d80178819f2319190d340ce9a924f783711", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + } + } + ] }, - "description": "Include zero/null balances in results" + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "start_time", + "schema": { + "type": "string", + "default": "2015-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "end_time", + "schema": { + "type": "string", + "default": "2050-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "start_block", + "schema": { + "default": 0, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" + }, + { + "in": "query", + "name": "end_block", + "schema": { + "default": 9999999999, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" }, { "in": "query", @@ -1236,7 +1445,7 @@ "summary": "Token Balances", "description": "Returns ERC-20 token balances for a wallet address.", "tags": [ - "EVM Tokens" + "EVM Tokens (ERC-20)" ], "security": [ { @@ -1852,13 +2061,18 @@ ] } }, - "/v1/evm/dexes": { + "/v1/evm/balances/native": { "get": { - "operationId": "getV1EvmDexes", - "summary": "Supported DEXs", - "description": "Returns all supported EVM DEXs.", + "operationId": "getV1EvmBalancesNative", + "summary": "Native Balances", + "description": "Returns EVM native balances for wallet addresses.", "tags": [ - "EVM DEXs" + "EVM Tokens (Native)" + ], + "security": [ + { + "bearerAuth": [] + } ], "responses": { "200": { @@ -1873,34 +2087,56 @@ "items": { "type": "object", "properties": { - "factory": { + "last_update": { + "type": "string", + "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + }, + "last_update_block_num": { + "type": "number" + }, + "last_update_timestamp": { + "type": "number" + }, + "address": { "type": "string", "description": "Filter by address", "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" }, - "protocol": { - "description": "Protocol name", - "example": "uniswap_v3", - "type": "string", - "enum": [ - "uniswap_v1", - "uniswap_v2", - "uniswap_v3", - "uniswap_v4", - "bancor", - "curvefi", - "balancer" - ] + "amount": { + "type": "string" }, - "uaw": { + "value": { "type": "number" }, - "transactions": { - "type": "number" + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] }, - "last_activity": { - "description": "ISO 8601 datetime string", - "type": "string" + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] }, "network": { "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", @@ -1919,11 +2155,15 @@ } }, "required": [ - "factory", - "protocol", - "uaw", - "transactions", - "last_activity", + "last_update", + "last_update_block_num", + "last_update_timestamp", + "address", + "amount", + "value", + "name", + "symbol", + "decimals", "network" ] } @@ -1986,11 +2226,15 @@ "value": { "data": [ { - "factory": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f", - "protocol": "uniswap_v2", - "uaw": 10432787, - "transactions": 16029788, - "last_activity": "2025-11-06 16:00:00", + "last_update": "2026-01-22 11:00:11", + "last_update_block_num": 24289888, + "last_update_timestamp": 1769079611, + "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", + "amount": "32112523848657725248", + "value": 32.11252384865772, + "name": "Ethereum", + "symbol": "ETH", + "decimals": 18, "network": "mainnet" } ] @@ -2346,36 +2590,42 @@ }, { "in": "query", - "name": "limit", - "schema": { - "default": 10, - "type": "integer", - "minimum": 1, - "maximum": 1000 - }, - "description": "Number of items* returned in a single request.
*Plan restricted." - }, - { - "in": "query", - "name": "page", + "name": "address", "schema": { - "default": 1, - "type": "integer", - "minimum": 1, - "maximum": 767465558638 + "type": "string", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + } + } + ] }, - "description": "Page number to fetch.
Empty `data` array signifies end of results." + "required": true, + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." } ] } }, - "/v1/evm/holders": { + "/v1/evm/balances/historical": { "get": { - "operationId": "getV1EvmHolders", - "summary": "Token Holders", - "description": "Returns top token holders ranked by balance.", + "operationId": "getV1EvmBalancesHistorical", + "summary": "Historical Token Balances", + "description": "Returns wallet ERC-20 token balance changes over time in OHLCV format.\n\nOHLCV historical depth is subject to plan restrictions.", "tags": [ - "EVM Tokens" + "EVM Tokens (ERC-20)" ], "security": [ { @@ -2395,16 +2645,10 @@ "items": { "type": "object", "properties": { - "last_update": { + "datetime": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "last_update_block_num": { - "type": "number" - }, - "last_update_timestamp": { - "type": "number" - }, "address": { "type": "string", "description": "Filter by address", @@ -2415,41 +2659,26 @@ "description": "Filter by contract address", "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }, - "amount": { - "type": "string" + "decimals": { + "type": "number" }, - "value": { + "open": { "type": "number" }, - "name": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] + "high": { + "type": "number" }, - "symbol": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] + "low": { + "type": "number" }, - "decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] + "close": { + "type": "number" + }, + "name": { + "type": "string" + }, + "symbol": { + "type": "string" }, "network": { "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", @@ -2468,16 +2697,16 @@ } }, "required": [ - "last_update", - "last_update_block_num", - "last_update_timestamp", + "datetime", "address", "contract", - "amount", - "value", + "decimals", + "open", + "high", + "low", + "close", "name", "symbol", - "decimals", "network" ] } @@ -2540,16 +2769,16 @@ "value": { "data": [ { - "last_update": "2025-10-16 09:08:11", - "last_update_block_num": 23589233, - "last_update_timestamp": 1760605691, - "address": "0x59cd1c87501baa753d0b5b5ab5d8416a45cd71db", - "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", - "amount": "97590855599990900949144", - "value": 97590.85559999091, - "name": "Wrapped Ether", - "symbol": "WETH", - "decimals": 18, + "datetime": "2026-01-09 00:00:00", + "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", + "contract": "0xdac17f958d2ee523a2206206994597c13d831ec7", + "open": 269.18034, + "high": 269.18034, + "low": 269.18034, + "close": 269.18034, + "name": "Tether USD", + "symbol": "USDT", + "decimals": 6, "network": "mainnet" } ] @@ -2905,13 +3134,74 @@ }, { "in": "query", - "name": "contract", + "name": "address", "schema": { "type": "string", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" }, "required": true, - "description": "Filter by contract address" + "description": "Filter by address" + }, + { + "in": "query", + "name": "contract", + "schema": { + "type": "string", + "example": "0xdac17f958d2ee523a2206206994597c13d831ec7", + "anyOf": [ + { + "type": "string", + "description": "Filter by contract address", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by contract address", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + } + } + ] + }, + "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "interval", + "schema": { + "type": "string", + "enum": [ + "1h", + "4h", + "1d", + "1w" + ], + "example": "1d", + "default": "1d" + }, + "description": "The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).
*Plan restricted." + }, + { + "in": "query", + "name": "start_time", + "schema": { + "type": "string", + "default": "2015-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "end_time", + "schema": { + "type": "string", + "default": "2050-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." }, { "in": "query", @@ -2938,13 +3228,13 @@ ] } }, - "/v1/evm/nft/collections": { + "/v1/evm/balances/historical/native": { "get": { - "operationId": "getV1EvmNftCollections", - "summary": "NFT Collection", - "description": "Returns NFT collection metadata, supply stats, owner count, and transfer history.\n\nThe `spam_status` flag indicates if the NFT is likely spam. If status shows `pending`, retry in a few seconds.\n\nSpam detection is supported for:\n\n* mainnet\n* base\n* polygon\n* arbitrum-one\n* avalanche\n* optimism\n* bsc", + "operationId": "getV1EvmBalancesHistoricalNative", + "summary": "Historical Native Balances", + "description": "Returns wallet Native balance changes over time in OHLCV format.\n\nOHLCV historical depth is subject to plan restrictions.", "tags": [ - "EVM NFTs" + "EVM Tokens (Native)" ], "security": [ { @@ -2964,11 +3254,11 @@ "items": { "type": "object", "properties": { - "contract_creation": { + "datetime": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "contract_creator": { + "address": { "type": "string", "description": "Filter by address", "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" @@ -2978,38 +3268,27 @@ "description": "Filter by contract address", "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }, - "name": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "symbol": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] + "decimals": { + "type": "number" }, - "owners": { + "open": { "type": "number" }, - "total_supply": { + "high": { "type": "number" }, - "total_unique_supply": { + "low": { "type": "number" }, - "total_transfers": { + "close": { "type": "number" }, + "name": { + "type": "string" + }, + "symbol": { + "type": "string" + }, "network": { "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", "example": "mainnet", @@ -3024,30 +3303,20 @@ "polygon", "unichain" ] - }, - "spam_status": { - "type": "string", - "enum": [ - "spam", - "not_spam", - "pending", - "not_supported", - "error" - ] } }, "required": [ - "contract_creation", - "contract_creator", + "datetime", + "address", "contract", + "decimals", + "open", + "high", + "low", + "close", "name", "symbol", - "owners", - "total_supply", - "total_unique_supply", - "total_transfers", - "network", - "spam_status" + "network" ] } }, @@ -3109,18 +3378,16 @@ "value": { "data": [ { - "contract_creation": "2021-07-22 12:26:01", - "contract_creator": "0xe9da256a28630efdc637bfd4c65f0887be1aeda8", - "contract": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8", - "name": "PudgyPenguins", - "symbol": "PPG", - "token_standard": "ERC721", - "owners": 4952, - "total_supply": 8888, - "total_unique_supply": 8888, - "total_transfers": 193641, - "network": "mainnet", - "spam_status": "pending" + "datetime": "2026-01-21 00:00:00", + "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", + "open": 33.11251005136684, + "high": 33.11251115136684, + "low": 32.11250812040242, + "close": 32.112509521402416, + "name": "Ethereum", + "symbol": "ETH", + "decimals": 18, + "network": "mainnet" } ] } @@ -3475,13 +3742,47 @@ }, { "in": "query", - "name": "contract", + "name": "address", "schema": { "type": "string", - "example": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8" + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" }, "required": true, - "description": "Filter by contract address" + "description": "Filter by address" + }, + { + "in": "query", + "name": "interval", + "schema": { + "type": "string", + "enum": [ + "1h", + "4h", + "1d", + "1w" + ], + "example": "1d", + "default": "1d" + }, + "description": "The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).
*Plan restricted." + }, + { + "in": "query", + "name": "start_time", + "schema": { + "type": "string", + "default": "2015-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "end_time", + "schema": { + "type": "string", + "default": "2050-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." }, { "in": "query", @@ -3508,13 +3809,13 @@ ] } }, - "/v1/evm/nft/holders": { + "/v1/evm/swaps": { "get": { - "operationId": "getV1EvmNftHolders", - "summary": "NFT Holders", - "description": "Returns wallet addresses holding NFT collection tokens with quantity and percentage distribution.", + "operationId": "getV1EvmSwaps", + "summary": "Swap Events", + "description": "Returns DEX swaps events with input & output token amounts.", "tags": [ - "EVM NFTs" + "EVM DEXs" ], "security": [ { @@ -3534,37 +3835,171 @@ "items": { "type": "object", "properties": { - "contract": { - "type": "string", - "description": "Filter by contract address", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + "block_num": { + "type": "number" }, - "token_standard": { - "description": "Token standard", - "example": "ERC721", + "datetime": { "type": "string", - "enum": [ - "ERC721", - "ERC1155" + "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + }, + "timestamp": { + "type": "number" + }, + "transaction_id": { + "type": "string" + }, + "factory": { + "type": "string", + "description": "Filter by factory address", + "example": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f" + }, + "pool": { + "description": "Filter by pool address", + "type": "string", + "example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", + "anyOf": [ + { + "type": "string" + }, + { + "type": "string" + } ] }, - "address": { + "input_token": { + "type": "object", + "properties": { + "address": { + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "null" + } + ] + }, + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "address", + "symbol", + "decimals" + ] + }, + "output_token": { + "type": "object", + "properties": { + "address": { + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "null" + } + ] + }, + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "address", + "symbol", + "decimals" + ] + }, + "caller": { "type": "string", "description": "Filter by address", "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" }, - "quantity": { - "description": "Number of tokens held by this address", + "sender": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + "recipient": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + "input_amount": { + "type": "string" + }, + "input_value": { "type": "number" }, - "unique_tokens": { - "description": "Number of unique token IDs held by this address", + "output_amount": { + "type": "string" + }, + "output_value": { "type": "number" }, - "percentage": { - "description": "Percentage of total supply held by this address", + "price": { "type": "number" }, + "price_inv": { + "type": "number" + }, + "protocol": { + "description": "Protocol name", + "example": "uniswap_v3", + "type": "string", + "enum": [ + "uniswap_v1", + "uniswap_v2", + "uniswap_v3", + "uniswap_v4", + "bancor", + "curvefi", + "balancer" + ] + }, + "summary": { + "type": "string" + }, "network": { "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", "example": "mainnet", @@ -3582,12 +4017,25 @@ } }, "required": [ - "contract", - "token_standard", - "address", - "quantity", - "unique_tokens", - "percentage", + "block_num", + "datetime", + "timestamp", + "transaction_id", + "factory", + "pool", + "input_token", + "output_token", + "caller", + "sender", + "recipient", + "input_amount", + "input_value", + "output_amount", + "output_value", + "price", + "price_inv", + "protocol", + "summary", "network" ] } @@ -3650,12 +4098,33 @@ "value": { "data": [ { - "contract": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8", - "token_standard": "ERC721", - "address": "0x29469395eaf6f95920e59f858042f0e28d98a20b", - "quantity": 358, - "unique_tokens": 358, - "percentage": 4.027902790279028, + "block_num": 23590326, + "datetime": "2025-10-16 12:48:47", + "timestamp": 1760618927, + "transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca", + "factory": "0x1f98431c8ad98523631ae4a59f267346ea31f984", + "pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", + "input_token": { + "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", + "symbol": "USDC", + "decimals": 6 + }, + "output_token": { + "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", + "symbol": "WETH", + "decimals": 18 + }, + "caller": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", + "sender": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", + "recipient": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", + "input_amount": "40735537734", + "input_value": 40735.537734, + "output_amount": "10042247631260591234", + "output_value": 10.042247631260592, + "price": 246517483.4798306, + "price_inv": 4.0565074163667475e-9, + "protocol": "uniswap_v3", + "summary": "Swap 40.74 thousand USDC for 10.042247631260592 WETH on Uniswap V3", "network": "mainnet" } ] @@ -4011,25 +4480,3050 @@ }, { "in": "query", - "name": "contract", + "name": "transaction_id", "schema": { "type": "string", - "example": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8" + "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca", + "anyOf": [ + { + "type": "string", + "description": "Filter by transaction hash", + "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by transaction hash", + "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" + } + } + ] }, - "required": true, - "description": "Filter by contract address" + "description": "Filter by transaction hash
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "limit", + "name": "factory", "schema": { - "default": 10, - "type": "integer", - "minimum": 1, - "maximum": 1000 - }, - "description": "Number of items* returned in a single request.
*Plan restricted." - }, + "type": "string", + "example": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f", + "anyOf": [ + { + "type": "string", + "description": "Filter by factory address", + "example": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by factory address", + "example": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f" + } + } + ] + }, + "description": "Filter by factory address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "pool", + "schema": { + "type": "string", + "example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", + "anyOf": [ + { + "description": "Filter by pool address", + "type": "string", + "example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", + "anyOf": [ + { + "type": "string" + }, + { + "type": "string" + } + ] + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "description": "Filter by pool address", + "type": "string", + "example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", + "anyOf": [ + { + "type": "string" + }, + { + "type": "string" + } + ] + } + } + ] + }, + "description": "Filter by pool address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "caller", + "schema": { + "type": "string", + "example": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + } + } + ] + }, + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "sender", + "schema": { + "type": "string", + "example": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + } + } + ] + }, + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "recipient", + "schema": { + "type": "string", + "example": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + } + } + ] + }, + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "input_contract", + "schema": { + "type": "string", + "example": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", + "anyOf": [ + { + "type": "string", + "description": "Filter by contract address", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by contract address", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + } + } + ] + }, + "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "output_contract", + "schema": { + "type": "string", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", + "anyOf": [ + { + "type": "string", + "description": "Filter by contract address", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by contract address", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + } + } + ] + }, + "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "protocol", + "schema": { + "example": "uniswap_v3", + "default": "", + "type": "string", + "enum": [ + "uniswap_v1", + "uniswap_v2", + "uniswap_v3", + "uniswap_v4", + "bancor", + "curvefi", + "balancer" + ] + }, + "description": "Protocol name" + }, + { + "in": "query", + "name": "start_time", + "schema": { + "type": "string", + "default": "2015-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "end_time", + "schema": { + "type": "string", + "default": "2050-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "start_block", + "schema": { + "default": 0, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" + }, + { + "in": "query", + "name": "end_block", + "schema": { + "default": 9999999999, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" + }, + { + "in": "query", + "name": "limit", + "schema": { + "default": 10, + "type": "integer", + "minimum": 1, + "maximum": 1000 + }, + "description": "Number of items* returned in a single request.
*Plan restricted." + }, + { + "in": "query", + "name": "page", + "schema": { + "default": 1, + "type": "integer", + "minimum": 1, + "maximum": 767465558638 + }, + "description": "Page number to fetch.
Empty `data` array signifies end of results." + } + ] + } + }, + "/v1/evm/dexes": { + "get": { + "operationId": "getV1EvmDexes", + "summary": "Supported DEXs", + "description": "Returns all supported EVM DEXs.", + "tags": [ + "EVM DEXs" + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": { + "type": "array", + "items": { + "type": "object", + "properties": { + "factory": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + "protocol": { + "description": "Protocol name", + "example": "uniswap_v3", + "type": "string", + "enum": [ + "uniswap_v1", + "uniswap_v2", + "uniswap_v3", + "uniswap_v4", + "bancor", + "curvefi", + "balancer" + ] + }, + "uaw": { + "type": "number" + }, + "transactions": { + "type": "number" + }, + "last_activity": { + "description": "ISO 8601 datetime string", + "type": "string" + }, + "network": { + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", + "example": "mainnet", + "type": "string", + "enum": [ + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" + ] + } + }, + "required": [ + "factory", + "protocol", + "uaw", + "transactions", + "last_activity", + "network" + ] + } + }, + "statistics": { + "type": "object", + "properties": { + "elapsed": { + "type": "number" + }, + "rows_read": { + "type": "number" + }, + "bytes_read": { + "type": "number" + } + } + }, + "pagination": { + "type": "object", + "properties": { + "previous_page": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + }, + "current_page": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + } + }, + "required": [ + "previous_page", + "current_page" + ] + }, + "results": { + "type": "number" + }, + "request_time": { + "description": "ISO 8601 datetime string", + "type": "string" + }, + "duration_ms": { + "type": "number" + } + }, + "required": [ + "data", + "statistics", + "pagination", + "results", + "request_time", + "duration_ms" + ] + }, + "examples": { + "example": { + "value": { + "data": [ + { + "factory": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f", + "protocol": "uniswap_v2", + "uaw": 10432787, + "transactions": 16029788, + "last_activity": "2025-11-06 16:00:00", + "network": "mainnet" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Client side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 400, + "code": "bad_query_input", + "message": "Invalid query parameter provided" + } + } + } + } + } + }, + "401": { + "description": "Authentication failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 401, + "code": "unauthorized", + "message": "Authentication required" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 403, + "code": "forbidden", + "message": "Access denied" + } + } + } + } + } + }, + "404": { + "description": "Not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 404, + "code": "not_found_data", + "message": "Resource not found" + } + } + } + } + } + }, + "500": { + "description": "Server side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 500 + }, + { + "type": "number", + "const": 502 + }, + { + "type": "number", + "const": 504 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "bad_database_response", + "connection_refused", + "database_timeout", + "internal_server_error" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 500, + "code": "internal_server_error", + "message": "An unexpected error occurred" + } + } + } + } + } + } + }, + "parameters": [ + { + "in": "query", + "name": "network", + "schema": { + "example": "mainnet", + "type": "string", + "enum": [ + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" + ] + }, + "required": true, + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks" + }, + { + "in": "query", + "name": "limit", + "schema": { + "default": 10, + "type": "integer", + "minimum": 1, + "maximum": 1000 + }, + "description": "Number of items* returned in a single request.
*Plan restricted." + }, + { + "in": "query", + "name": "page", + "schema": { + "default": 1, + "type": "integer", + "minimum": 1, + "maximum": 767465558638 + }, + "description": "Page number to fetch.
Empty `data` array signifies end of results." + } + ] + } + }, + "/v1/evm/holders": { + "get": { + "operationId": "getV1EvmHolders", + "summary": "Token Holders", + "description": "Returns top token holders ranked by ERC-20 balance.", + "tags": [ + "EVM Tokens (ERC-20)" + ], + "security": [ + { + "bearerAuth": [] + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": { + "type": "array", + "items": { + "type": "object", + "properties": { + "last_update": { + "type": "string", + "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + }, + "last_update_block_num": { + "type": "number" + }, + "last_update_timestamp": { + "type": "number" + }, + "address": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + "contract": { + "type": "string", + "description": "Filter by contract address", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + }, + "amount": { + "type": "string" + }, + "value": { + "type": "number" + }, + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] + }, + "network": { + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", + "example": "mainnet", + "type": "string", + "enum": [ + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" + ] + } + }, + "required": [ + "last_update", + "last_update_block_num", + "last_update_timestamp", + "address", + "contract", + "amount", + "value", + "name", + "symbol", + "decimals", + "network" + ] + } + }, + "statistics": { + "type": "object", + "properties": { + "elapsed": { + "type": "number" + }, + "rows_read": { + "type": "number" + }, + "bytes_read": { + "type": "number" + } + } + }, + "pagination": { + "type": "object", + "properties": { + "previous_page": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + }, + "current_page": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + } + }, + "required": [ + "previous_page", + "current_page" + ] + }, + "results": { + "type": "number" + }, + "request_time": { + "description": "ISO 8601 datetime string", + "type": "string" + }, + "duration_ms": { + "type": "number" + } + }, + "required": [ + "data", + "statistics", + "pagination", + "results", + "request_time", + "duration_ms" + ] + }, + "examples": { + "example": { + "value": { + "data": [ + { + "last_update": "2026-01-23 06:37:11", + "last_update_block_num": 24295739, + "last_update_timestamp": 1769150231, + "address": "0xf977814e90da44bfa03b6295a0616a897441acec", + "contract": "0xdac17f958d2ee523a2206206994597c13d831ec7", + "amount": "20000000000000000", + "value": 20000000000, + "name": "Tether USD", + "symbol": "USDT", + "decimals": 6, + "network": "mainnet" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Client side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 400, + "code": "bad_query_input", + "message": "Invalid query parameter provided" + } + } + } + } + } + }, + "401": { + "description": "Authentication failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 401, + "code": "unauthorized", + "message": "Authentication required" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 403, + "code": "forbidden", + "message": "Access denied" + } + } + } + } + } + }, + "404": { + "description": "Not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 404, + "code": "not_found_data", + "message": "Resource not found" + } + } + } + } + } + }, + "500": { + "description": "Server side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 500 + }, + { + "type": "number", + "const": 502 + }, + { + "type": "number", + "const": 504 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "bad_database_response", + "connection_refused", + "database_timeout", + "internal_server_error" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 500, + "code": "internal_server_error", + "message": "An unexpected error occurred" + } + } + } + } + } + } + }, + "parameters": [ + { + "in": "query", + "name": "network", + "schema": { + "example": "mainnet", + "type": "string", + "enum": [ + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" + ] + }, + "required": true, + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks" + }, + { + "in": "query", + "name": "contract", + "schema": { + "type": "string", + "example": "0xdac17f958d2ee523a2206206994597c13d831ec7" + }, + "required": true, + "description": "Filter by contract address" + }, + { + "in": "query", + "name": "limit", + "schema": { + "default": 10, + "type": "integer", + "minimum": 1, + "maximum": 1000 + }, + "description": "Number of items* returned in a single request.
*Plan restricted." + }, + { + "in": "query", + "name": "page", + "schema": { + "default": 1, + "type": "integer", + "minimum": 1, + "maximum": 767465558638 + }, + "description": "Page number to fetch.
Empty `data` array signifies end of results." + } + ] + } + }, + "/v1/evm/holders/native": { + "get": { + "operationId": "getV1EvmHoldersNative", + "summary": "Native Holders", + "description": "Returns top token holders ranked by Native balance.", + "tags": [ + "EVM Tokens (Native)" + ], + "security": [ + { + "bearerAuth": [] + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": { + "type": "array", + "items": { + "type": "object", + "properties": { + "last_update": { + "type": "string", + "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + }, + "last_update_block_num": { + "type": "number" + }, + "last_update_timestamp": { + "type": "number" + }, + "address": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + "amount": { + "type": "string" + }, + "value": { + "type": "number" + }, + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] + }, + "network": { + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", + "example": "mainnet", + "type": "string", + "enum": [ + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" + ] + } + }, + "required": [ + "last_update", + "last_update_block_num", + "last_update_timestamp", + "address", + "amount", + "value", + "name", + "symbol", + "decimals", + "network" + ] + } + }, + "statistics": { + "type": "object", + "properties": { + "elapsed": { + "type": "number" + }, + "rows_read": { + "type": "number" + }, + "bytes_read": { + "type": "number" + } + } + }, + "pagination": { + "type": "object", + "properties": { + "previous_page": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + }, + "current_page": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + } + }, + "required": [ + "previous_page", + "current_page" + ] + }, + "results": { + "type": "number" + }, + "request_time": { + "description": "ISO 8601 datetime string", + "type": "string" + }, + "duration_ms": { + "type": "number" + } + }, + "required": [ + "data", + "statistics", + "pagination", + "results", + "request_time", + "duration_ms" + ] + }, + "examples": { + "example": { + "value": { + "data": [ + { + "last_update": "2026-01-23 20:25:35", + "last_update_block_num": 24299860, + "last_update_timestamp": 1769199935, + "address": "0x00000000219ab540356cbb839cbe05303d7705fa", + "amount": "78761803578844096172899779", + "value": 78761803.5788441, + "name": "Ethereum", + "symbol": "ETH", + "decimals": 18, + "network": "mainnet" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Client side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 400, + "code": "bad_query_input", + "message": "Invalid query parameter provided" + } + } + } + } + } + }, + "401": { + "description": "Authentication failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 401, + "code": "unauthorized", + "message": "Authentication required" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 403, + "code": "forbidden", + "message": "Access denied" + } + } + } + } + } + }, + "404": { + "description": "Not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 404, + "code": "not_found_data", + "message": "Resource not found" + } + } + } + } + } + }, + "500": { + "description": "Server side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 500 + }, + { + "type": "number", + "const": 502 + }, + { + "type": "number", + "const": 504 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "bad_database_response", + "connection_refused", + "database_timeout", + "internal_server_error" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 500, + "code": "internal_server_error", + "message": "An unexpected error occurred" + } + } + } + } + } + } + }, + "parameters": [ + { + "in": "query", + "name": "network", + "schema": { + "example": "mainnet", + "type": "string", + "enum": [ + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" + ] + }, + "required": true, + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks" + }, + { + "in": "query", + "name": "limit", + "schema": { + "default": 10, + "type": "integer", + "minimum": 1, + "maximum": 1000 + }, + "description": "Number of items* returned in a single request.
*Plan restricted." + }, + { + "in": "query", + "name": "page", + "schema": { + "default": 1, + "type": "integer", + "minimum": 1, + "maximum": 767465558638 + }, + "description": "Page number to fetch.
Empty `data` array signifies end of results." + } + ] + } + }, + "/v1/evm/nft/collections": { + "get": { + "operationId": "getV1EvmNftCollections", + "summary": "NFT Collection", + "description": "Returns NFT collection metadata, supply stats, owner count, and transfer history.\n\nThe `spam_status` flag indicates if the NFT is likely spam. If status shows `pending`, retry in a few seconds.\n\nSpam detection is supported for:\n\n* mainnet\n* base\n* polygon\n* arbitrum-one\n* avalanche\n* optimism\n* bsc", + "tags": [ + "EVM NFTs" + ], + "security": [ + { + "bearerAuth": [] + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": { + "type": "array", + "items": { + "type": "object", + "properties": { + "contract_creation": { + "type": "string", + "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + }, + "contract_creator": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + "contract": { + "type": "string", + "description": "Filter by contract address", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + }, + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "owners": { + "type": "number" + }, + "total_supply": { + "type": "number" + }, + "total_unique_supply": { + "type": "number" + }, + "total_transfers": { + "type": "number" + }, + "network": { + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", + "example": "mainnet", + "type": "string", + "enum": [ + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" + ] + }, + "spam_status": { + "type": "string", + "enum": [ + "spam", + "not_spam", + "pending", + "not_supported", + "error" + ] + } + }, + "required": [ + "contract_creation", + "contract_creator", + "contract", + "name", + "symbol", + "owners", + "total_supply", + "total_unique_supply", + "total_transfers", + "network", + "spam_status" + ] + } + }, + "statistics": { + "type": "object", + "properties": { + "elapsed": { + "type": "number" + }, + "rows_read": { + "type": "number" + }, + "bytes_read": { + "type": "number" + } + } + }, + "pagination": { + "type": "object", + "properties": { + "previous_page": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + }, + "current_page": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + } + }, + "required": [ + "previous_page", + "current_page" + ] + }, + "results": { + "type": "number" + }, + "request_time": { + "description": "ISO 8601 datetime string", + "type": "string" + }, + "duration_ms": { + "type": "number" + } + }, + "required": [ + "data", + "statistics", + "pagination", + "results", + "request_time", + "duration_ms" + ] + }, + "examples": { + "example": { + "value": { + "data": [ + { + "contract_creation": "2021-07-22 12:26:01", + "contract_creator": "0xe9da256a28630efdc637bfd4c65f0887be1aeda8", + "contract": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8", + "name": "PudgyPenguins", + "symbol": "PPG", + "token_standard": "ERC721", + "owners": 4952, + "total_supply": 8888, + "total_unique_supply": 8888, + "total_transfers": 193641, + "network": "mainnet", + "spam_status": "pending" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Client side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 400, + "code": "bad_query_input", + "message": "Invalid query parameter provided" + } + } + } + } + } + }, + "401": { + "description": "Authentication failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 401, + "code": "unauthorized", + "message": "Authentication required" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 403, + "code": "forbidden", + "message": "Access denied" + } + } + } + } + } + }, + "404": { + "description": "Not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 404, + "code": "not_found_data", + "message": "Resource not found" + } + } + } + } + } + }, + "500": { + "description": "Server side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 500 + }, + { + "type": "number", + "const": 502 + }, + { + "type": "number", + "const": 504 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "bad_database_response", + "connection_refused", + "database_timeout", + "internal_server_error" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 500, + "code": "internal_server_error", + "message": "An unexpected error occurred" + } + } + } + } + } + } + }, + "parameters": [ + { + "in": "query", + "name": "network", + "schema": { + "example": "mainnet", + "type": "string", + "enum": [ + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" + ] + }, + "required": true, + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks" + }, + { + "in": "query", + "name": "contract", + "schema": { + "type": "string", + "example": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8" + }, + "required": true, + "description": "Filter by contract address" + }, + { + "in": "query", + "name": "limit", + "schema": { + "default": 10, + "type": "integer", + "minimum": 1, + "maximum": 1000 + }, + "description": "Number of items* returned in a single request.
*Plan restricted." + }, + { + "in": "query", + "name": "page", + "schema": { + "default": 1, + "type": "integer", + "minimum": 1, + "maximum": 767465558638 + }, + "description": "Page number to fetch.
Empty `data` array signifies end of results." + } + ] + } + }, + "/v1/evm/nft/holders": { + "get": { + "operationId": "getV1EvmNftHolders", + "summary": "NFT Holders", + "description": "Returns wallet addresses holding NFT collection tokens with quantity and percentage distribution.", + "tags": [ + "EVM NFTs" + ], + "security": [ + { + "bearerAuth": [] + } + ], + "responses": { + "200": { + "description": "Successful Response", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "data": { + "type": "array", + "items": { + "type": "object", + "properties": { + "contract": { + "type": "string", + "description": "Filter by contract address", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + }, + "token_standard": { + "description": "Token standard", + "example": "ERC721", + "type": "string", + "enum": [ + "ERC721", + "ERC1155" + ] + }, + "address": { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + "quantity": { + "description": "Number of tokens held by this address", + "type": "number" + }, + "unique_tokens": { + "description": "Number of unique token IDs held by this address", + "type": "number" + }, + "percentage": { + "description": "Percentage of total supply held by this address", + "type": "number" + }, + "network": { + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", + "example": "mainnet", + "type": "string", + "enum": [ + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" + ] + } + }, + "required": [ + "contract", + "token_standard", + "address", + "quantity", + "unique_tokens", + "percentage", + "network" + ] + } + }, + "statistics": { + "type": "object", + "properties": { + "elapsed": { + "type": "number" + }, + "rows_read": { + "type": "number" + }, + "bytes_read": { + "type": "number" + } + } + }, + "pagination": { + "type": "object", + "properties": { + "previous_page": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + }, + "current_page": { + "type": "integer", + "minimum": 1, + "maximum": 9007199254740991 + } + }, + "required": [ + "previous_page", + "current_page" + ] + }, + "results": { + "type": "number" + }, + "request_time": { + "description": "ISO 8601 datetime string", + "type": "string" + }, + "duration_ms": { + "type": "number" + } + }, + "required": [ + "data", + "statistics", + "pagination", + "results", + "request_time", + "duration_ms" + ] + }, + "examples": { + "example": { + "value": { + "data": [ + { + "contract": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8", + "token_standard": "ERC721", + "address": "0x29469395eaf6f95920e59f858042f0e28d98a20b", + "quantity": 358, + "unique_tokens": 358, + "percentage": 4.027902790279028, + "network": "mainnet" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Client side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 400, + "code": "bad_query_input", + "message": "Invalid query parameter provided" + } + } + } + } + } + }, + "401": { + "description": "Authentication failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 401, + "code": "unauthorized", + "message": "Authentication required" + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 403, + "code": "forbidden", + "message": "Access denied" + } + } + } + } + } + }, + "404": { + "description": "Not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 404, + "code": "not_found_data", + "message": "Resource not found" + } + } + } + } + } + }, + "500": { + "description": "Server side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 500 + }, + { + "type": "number", + "const": 502 + }, + { + "type": "number", + "const": 504 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "bad_database_response", + "connection_refused", + "database_timeout", + "internal_server_error" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] + }, + "examples": { + "example": { + "value": { + "status": 500, + "code": "internal_server_error", + "message": "An unexpected error occurred" + } + } + } + } + } + } + }, + "parameters": [ + { + "in": "query", + "name": "network", + "schema": { + "example": "mainnet", + "type": "string", + "enum": [ + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" + ] + }, + "required": true, + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks" + }, + { + "in": "query", + "name": "contract", + "schema": { + "type": "string", + "example": "0xbd3531da5cf5857e7cfaa92426877b022e612cf8" + }, + "required": true, + "description": "Filter by contract address" + }, + { + "in": "query", + "name": "limit", + "schema": { + "default": 10, + "type": "integer", + "minimum": 1, + "maximum": 1000 + }, + "description": "Number of items* returned in a single request.
*Plan restricted." + }, { "in": "query", "name": "page", @@ -8227,7 +11721,7 @@ "name": "start_time", "schema": { "type": "string", - "default": "2025-12-08" + "default": "2015-01-01" }, "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." }, @@ -8265,13 +11759,13 @@ ] } }, - "/v1/evm/swaps": { + "/v1/evm/tokens": { "get": { - "operationId": "getV1EvmSwaps", - "summary": "Swap Events", - "description": "Returns DEX swaps events with input & output token amounts.", + "operationId": "getV1EvmTokens", + "summary": "Token Metadata", + "description": "Returns ERC-20 token metadata including supply and holder count.", "tags": [ - "EVM DEXs" + "EVM Tokens (ERC-20)" ], "security": [ { @@ -8291,171 +11785,60 @@ "items": { "type": "object", "properties": { - "block_num": { - "type": "number" - }, - "datetime": { + "last_update": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "timestamp": { + "last_update_block_num": { "type": "number" }, - "transaction_id": { - "type": "string" - }, - "factory": { - "type": "string", - "description": "Filter by factory address", - "example": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f" - }, - "pool": { - "description": "Filter by pool address", - "type": "string", - "example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", - "anyOf": [ - { - "type": "string" - }, - { - "type": "string" - } - ] - }, - "input_token": { - "type": "object", - "properties": { - "address": { - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - }, - { - "type": "null" - } - ] - }, - "symbol": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] - } - }, - "required": [ - "address", - "symbol", - "decimals" - ] - }, - "output_token": { - "type": "object", - "properties": { - "address": { - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - }, - { - "type": "null" - } - ] - }, - "symbol": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] - } - }, - "required": [ - "address", - "symbol", - "decimals" - ] - }, - "caller": { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - }, - "sender": { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + "last_update_timestamp": { + "type": "number" }, - "recipient": { + "contract": { "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + "description": "Filter by contract address", + "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }, - "input_amount": { - "type": "string" + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] }, - "input_value": { - "type": "number" + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] }, - "output_amount": { - "type": "string" + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] }, - "output_value": { + "circulating_supply": { "type": "number" }, - "price": { + "total_supply": { "type": "number" }, - "price_inv": { + "holders": { "type": "number" }, - "protocol": { - "description": "Protocol name", - "example": "uniswap_v3", - "type": "string", - "enum": [ - "uniswap_v1", - "uniswap_v2", - "uniswap_v3", - "uniswap_v4", - "bancor", - "curvefi", - "balancer" - ] - }, - "summary": { - "type": "string" - }, "network": { "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", "example": "mainnet", @@ -8470,28 +11853,30 @@ "polygon", "unichain" ] + }, + "icon": { + "type": "object", + "properties": { + "web3icon": { + "type": "string" + } + }, + "required": [ + "web3icon" + ] } }, "required": [ - "block_num", - "datetime", - "timestamp", - "transaction_id", - "factory", - "pool", - "input_token", - "output_token", - "caller", - "sender", - "recipient", - "input_amount", - "input_value", - "output_amount", - "output_value", - "price", - "price_inv", - "protocol", - "summary", + "last_update", + "last_update_block_num", + "last_update_timestamp", + "contract", + "name", + "symbol", + "decimals", + "circulating_supply", + "total_supply", + "holders", "network" ] } @@ -8554,34 +11939,19 @@ "value": { "data": [ { - "block_num": 23590326, - "datetime": "2025-10-16 12:48:47", - "timestamp": 1760618927, - "transaction_id": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca", - "factory": "0x1f98431c8ad98523631ae4a59f267346ea31f984", - "pool": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", - "input_token": { - "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", - "symbol": "USDC", - "decimals": 6 - }, - "output_token": { - "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", - "symbol": "WETH", - "decimals": 18 - }, - "caller": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", - "sender": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", - "recipient": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", - "input_amount": "40735537734", - "input_value": 40735.537734, - "output_amount": "10042247631260591234", - "output_value": 10.042247631260592, - "price": 246517483.4798306, - "price_inv": 4.0565074163667475e-9, - "protocol": "uniswap_v3", - "summary": "Swap 40.74 thousand USDC for 10.042247631260592 WETH on Uniswap V3", - "network": "mainnet" + "last_update": "2026-01-25 14:26:59", + "last_update_block_num": 24312418, + "last_update_timestamp": 1769351219, + "contract": "0xdac17f958d2ee523a2206206994597c13d831ec7", + "circulating_supply": 103302123410.98102, + "holders": 11573781, + "name": "Tether USD", + "symbol": "USDT", + "decimals": 6, + "network": "mainnet", + "icon": { + "web3icon": "USDT" + } } ] } @@ -8758,136 +12128,15 @@ "code": { "type": "string", "enum": [ - "authentication_failed", - "bad_header", - "missing_required_header", - "bad_query_input", - "forbidden", - "method_not_allowed", - "route_not_found", - "unauthorized", - "not_found_data" - ] - }, - "message": { - "type": "string" - } - }, - "required": [ - "status", - "code", - "message" - ] - }, - "examples": { - "example": { - "value": { - "status": 403, - "code": "forbidden", - "message": "Access denied" - } - } - } - } - } - }, - "404": { - "description": "Not found", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "status": { - "anyOf": [ - { - "type": "number", - "const": 400 - }, - { - "type": "number", - "const": 401 - }, - { - "type": "number", - "const": 403 - }, - { - "type": "number", - "const": 404 - }, - { - "type": "number", - "const": 405 - } - ] - }, - "code": { - "type": "string", - "enum": [ - "authentication_failed", - "bad_header", - "missing_required_header", - "bad_query_input", - "forbidden", - "method_not_allowed", - "route_not_found", - "unauthorized", - "not_found_data" - ] - }, - "message": { - "type": "string" - } - }, - "required": [ - "status", - "code", - "message" - ] - }, - "examples": { - "example": { - "value": { - "status": 404, - "code": "not_found_data", - "message": "Resource not found" - } - } - } - } - } - }, - "500": { - "description": "Server side error", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "status": { - "anyOf": [ - { - "type": "number", - "const": 500 - }, - { - "type": "number", - "const": 502 - }, - { - "type": "number", - "const": 504 - } - ] - }, - "code": { - "type": "string", - "enum": [ - "bad_database_response", - "connection_refused", - "database_timeout", - "internal_server_error" + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" ] }, "message": { @@ -8903,360 +12152,178 @@ "examples": { "example": { "value": { - "status": 500, - "code": "internal_server_error", - "message": "An unexpected error occurred" + "status": 403, + "code": "forbidden", + "message": "Access denied" } } } } } - } - }, - "parameters": [ - { - "in": "query", - "name": "network", - "schema": { - "example": "mainnet", - "type": "string", - "enum": [ - "arbitrum-one", - "avalanche", - "base", - "bsc", - "mainnet", - "optimism", - "polygon", - "unichain" - ] - }, - "required": true, - "description": "The Graph Network ID for EVM networks https://thegraph.com/networks" - }, - { - "in": "query", - "name": "transaction_id", - "schema": { - "type": "string", - "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca", - "anyOf": [ - { - "type": "string", - "description": "Filter by transaction hash", - "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by transaction hash", - "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" - } - } - ] - }, - "description": "Filter by transaction hash
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "factory", - "schema": { - "type": "string", - "example": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f", - "anyOf": [ - { - "type": "string", - "description": "Filter by factory address", - "example": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by factory address", - "example": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f" - } - } - ] - }, - "description": "Filter by factory address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "pool", - "schema": { - "type": "string", - "example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", - "anyOf": [ - { - "description": "Filter by pool address", - "type": "string", - "example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", - "anyOf": [ - { - "type": "string" - }, - { - "type": "string" - } - ] - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "description": "Filter by pool address", - "type": "string", - "example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", - "anyOf": [ - { - "type": "string" - }, - { - "type": "string" - } - ] - } - } - ] - }, - "description": "Filter by pool address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "caller", - "schema": { - "type": "string", - "example": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - } - } - ] - }, - "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "sender", - "schema": { - "type": "string", - "example": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - } - } - ] - }, - "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, - { - "in": "query", - "name": "recipient", - "schema": { - "type": "string", - "example": "0xa69babef1ca67a37ffaf7a485dfff3382056e78c", - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - } - } - ] - }, - "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "input_contract", - "schema": { - "type": "string", - "example": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", - "anyOf": [ - { - "type": "string", - "description": "Filter by contract address", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" - }, - { - "type": "string" + "404": { + "description": "Not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 400 + }, + { + "type": "number", + "const": 401 + }, + { + "type": "number", + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by contract address", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + "examples": { + "example": { + "value": { + "status": 404, + "code": "not_found_data", + "message": "Resource not found" + } } } - ] - }, - "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + } + } }, - { - "in": "query", - "name": "output_contract", - "schema": { - "type": "string", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", - "anyOf": [ - { - "type": "string", - "description": "Filter by contract address", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" - }, - { - "type": "string" + "500": { + "description": "Server side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 500 + }, + { + "type": "number", + "const": 502 + }, + { + "type": "number", + "const": 504 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "bad_database_response", + "connection_refused", + "database_timeout", + "internal_server_error" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by contract address", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + "examples": { + "example": { + "value": { + "status": 500, + "code": "internal_server_error", + "message": "An unexpected error occurred" + } } } - ] - }, - "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, + } + } + } + }, + "parameters": [ { "in": "query", - "name": "protocol", + "name": "network", "schema": { - "example": "uniswap_v3", - "default": "", + "example": "mainnet", "type": "string", "enum": [ - "uniswap_v1", - "uniswap_v2", - "uniswap_v3", - "uniswap_v4", - "bancor", - "curvefi", - "balancer" + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" ] }, - "description": "Protocol name" - }, - { - "in": "query", - "name": "start_time", - "schema": { - "type": "string", - "default": "2015-01-01" - }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + "required": true, + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks" }, { "in": "query", - "name": "end_time", + "name": "contract", "schema": { "type": "string", - "default": "2050-01-01" - }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." - }, - { - "in": "query", - "name": "start_block", - "schema": { - "default": 0, - "type": "integer", - "minimum": 0, - "maximum": 9007199254740991 - }, - "description": "Filter by block number" - }, - { - "in": "query", - "name": "end_block", - "schema": { - "default": 9999999999, - "type": "integer", - "minimum": 0, - "maximum": 9007199254740991 - }, - "description": "Filter by block number" - }, - { - "in": "query", - "name": "limit", - "schema": { - "default": 10, - "type": "integer", - "minimum": 1, - "maximum": 1000 - }, - "description": "Number of items* returned in a single request.
*Plan restricted." - }, - { - "in": "query", - "name": "page", - "schema": { - "default": 1, - "type": "integer", - "minimum": 1, - "maximum": 767465558638 + "example": "0xdac17f958d2ee523a2206206994597c13d831ec7" }, - "description": "Page number to fetch.
Empty `data` array signifies end of results." + "required": true, + "description": "Filter by contract address" } ] } }, - "/v1/evm/tokens": { + "/v1/evm/tokens/native": { "get": { - "operationId": "getV1EvmTokens", - "summary": "Token Metadata", - "description": "Returns ERC-20 token metadata including supply and holder count.", + "operationId": "getV1EvmTokensNative", + "summary": "Native Metadata", + "description": "Returns Native metadata including supply and holder count.", "tags": [ - "EVM Tokens" + "EVM Tokens (Native)" ], "security": [ { @@ -9286,11 +12353,6 @@ "last_update_timestamp": { "type": "number" }, - "contract": { - "type": "string", - "description": "Filter by contract address", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" - }, "name": { "anyOf": [ { @@ -9361,7 +12423,6 @@ "last_update", "last_update_block_num", "last_update_timestamp", - "contract", "name", "symbol", "decimals", @@ -9430,16 +12491,14 @@ "value": { "data": [ { - "last_update": "2025-10-16 09:24:47", - "last_update_block_num": 23589316, - "last_update_timestamp": 1760606687, - "contract": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2", - "name": "Wrapped Ether", - "symbol": "WETH", + "last_update": "2026-01-25 14:19:11", + "last_update_block_num": 24312379, + "last_update_timestamp": 1769350751, + "circulating_supply": 161355003.5024305, + "holders": 176087418, + "name": "Ethereum", + "symbol": "ETH", "decimals": 18, - "circulating_supply": 2335108.0877502915, - "total_supply": 2335107.8841477665, - "holders": 3014993, "network": "mainnet", "icon": { "web3icon": "ETH" @@ -9795,49 +12854,17 @@ }, "required": true, "description": "The Graph Network ID for EVM networks https://thegraph.com/networks" - }, - { - "in": "query", - "name": "contract", - "schema": { - "type": "string", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" - }, - "required": true, - "description": "Filter by contract address" - }, - { - "in": "query", - "name": "limit", - "schema": { - "default": 10, - "type": "integer", - "minimum": 1, - "maximum": 1000 - }, - "description": "Number of items* returned in a single request.
*Plan restricted." - }, - { - "in": "query", - "name": "page", - "schema": { - "default": 1, - "type": "integer", - "minimum": 1, - "maximum": 767465558638 - }, - "description": "Page number to fetch.
Empty `data` array signifies end of results." } ] } }, - "/v1/evm/transfers": { + "/v1/svm/balances/native": { "get": { - "operationId": "getV1EvmTransfers", - "summary": "Token Transfers", - "description": "Returns ERC-20 and native token transfers with transaction and block data.", + "operationId": "getV1SvmBalancesNative", + "summary": "Native Balances", + "description": "Returns SOL native balances for wallet addresses.", "tags": [ - "EVM Tokens" + "SVM Tokens (Native)" ], "security": [ { @@ -9857,35 +12884,51 @@ "items": { "type": "object", "properties": { - "block_num": { - "type": "number" - }, - "datetime": { + "last_update": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "timestamp": { + "last_update_block_num": { "type": "number" }, - "transaction_id": { - "type": "string", - "description": "Filter by transaction hash", - "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" + "last_update_timestamp": { + "type": "number" }, - "contract": { + "program_id": { + "description": "Filter by SPL token program ID", + "example": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "type": "string", - "description": "Filter by contract address", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" + "enum": [ + "11111111111111111111111111111111", + "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", + "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" + ] }, - "from": { + "address": { "type": "string", "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + "example": "So11111111111111111111111111111111111111112" }, - "to": { + "mint": { "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + }, + "amount": { + "type": "string" + }, + "value": { + "type": "number" + }, + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] }, "name": { "anyOf": [ @@ -9907,51 +12950,38 @@ } ] }, - "decimals": { + "uri": { "anyOf": [ { - "type": "number" + "type": "string" }, { "type": "null" } ] }, - "amount": { - "type": "string" - }, - "value": { - "type": "number" - }, "network": { - "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", - "example": "mainnet", + "description": "The Graph Network ID for SVM networks https://thegraph.com/networks", + "example": "solana", "type": "string", "enum": [ - "arbitrum-one", - "avalanche", - "base", - "bsc", - "mainnet", - "optimism", - "polygon", - "unichain" + "solana" ] } }, "required": [ - "block_num", - "datetime", - "timestamp", - "transaction_id", - "contract", - "from", - "to", - "name", - "symbol", - "decimals", + "last_update", + "last_update_block_num", + "last_update_timestamp", + "program_id", + "address", + "mint", "amount", "value", + "decimals", + "name", + "symbol", + "uri", "network" ] } @@ -10014,20 +13044,19 @@ "value": { "data": [ { - "block_num": 23565775, - "datetime": "2025-10-13 02:19:47", - "timestamp": 1760321987, - "transaction_id": "0x96b1b180d22dae2b18a783ebdd5ae33f6867f3572f87c69a135c6c0a15a63c8e", - "log_index": 4404, - "contract": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", - "from": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", - "to": "0xdadb0d80178819f2319190d340ce9a924f783711", - "name": "Native", - "symbol": "ETH", - "decimals": 18, - "amount": "5038198000000", - "value": 0.000005038198, - "network": "mainnet" + "last_update": "2025-10-16 08:20:15", + "last_update_block_num": 373711220, + "last_update_timestamp": 1760602815, + "program_id": "11111111111111111111111111111111", + "address": "So11111111111111111111111111111111111111112", + "mint": "So11111111111111111111111111111111111111111", + "amount": "1173096711863", + "value": 1173.096711863, + "decimals": 9, + "name": "SOL", + "symbol": "SOL", + "uri": null, + "network": "solana" } ] } @@ -10364,114 +13393,26 @@ "in": "query", "name": "network", "schema": { - "example": "mainnet", + "example": "solana", "type": "string", "enum": [ - "arbitrum-one", - "avalanche", - "base", - "bsc", - "mainnet", - "optimism", - "polygon", - "unichain" + "solana" ] }, "required": true, - "description": "The Graph Network ID for EVM networks https://thegraph.com/networks" - }, - { - "in": "query", - "name": "transaction_id", - "schema": { - "type": "string", - "example": "0x96b1b180d22dae2b18a783ebdd5ae33f6867f3572f87c69a135c6c0a15a63c8e", - "anyOf": [ - { - "type": "string", - "description": "Filter by transaction hash", - "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by transaction hash", - "example": "0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca" - } - } - ] - }, - "description": "Filter by transaction hash
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "contract", - "schema": { - "type": "string", - "example": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", - "anyOf": [ - { - "type": "string", - "description": "Filter by contract address", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by contract address", - "example": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" - } - } - ] - }, - "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "from_address", - "schema": { - "type": "string", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045", - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - } - } - ] - }, - "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "The Graph Network ID for SVM networks https://thegraph.com/networks" }, { "in": "query", - "name": "to_address", + "name": "address", "schema": { "type": "string", - "example": "0xdadb0d80178819f2319190d340ce9a924f783711", + "example": "So11111111111111111111111111111111111111112", "anyOf": [ { "type": "string", "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + "example": "So11111111111111111111111111111111111111112" }, { "type": "string" @@ -10481,52 +13422,21 @@ "items": { "type": "string", "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + "example": "So11111111111111111111111111111111111111112" } } ] }, + "required": true, "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "start_time", - "schema": { - "type": "string", - "default": "2015-01-01" - }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." - }, - { - "in": "query", - "name": "end_time", - "schema": { - "type": "string", - "default": "2050-01-01" - }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." - }, - { - "in": "query", - "name": "start_block", - "schema": { - "default": 0, - "type": "integer", - "minimum": 0, - "maximum": 9007199254740991 - }, - "description": "Filter by block number" - }, - { - "in": "query", - "name": "end_block", + "name": "include_null_balances", "schema": { - "default": 9999999999, - "type": "integer", - "minimum": 0, - "maximum": 9007199254740991 + "type": "boolean" }, - "description": "Filter by block number" + "description": "Include zero/null balances in results" }, { "in": "query", @@ -10553,11 +13463,11 @@ ] } }, - "/v1/svm/balances/native": { - "get": { - "operationId": "getV1SvmBalancesNative", - "summary": "Native Balances", - "description": "Returns SOL native balances for wallet addresses.", + "/v1/svm/balances": { + "get": { + "operationId": "getV1SvmBalances", + "summary": "Token Balances", + "description": "Returns SPL token balances for Solana token owners with mint and program data.", "tags": [ "SVM Tokens" ], @@ -10599,10 +13509,15 @@ "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" ] }, - "address": { + "owner": { "type": "string", - "description": "Filter by address", - "example": "So11111111111111111111111111111111111111112" + "description": "Filter by owner address", + "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" + }, + "token_account": { + "type": "string", + "description": "Filter by token account address", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" }, "mint": { "type": "string", @@ -10669,7 +13584,8 @@ "last_update_block_num", "last_update_timestamp", "program_id", - "address", + "owner", + "token_account", "mint", "amount", "value", @@ -10739,18 +13655,19 @@ "value": { "data": [ { - "last_update": "2025-10-16 08:20:15", - "last_update_block_num": 373711220, - "last_update_timestamp": 1760602815, - "program_id": "11111111111111111111111111111111", - "address": "So11111111111111111111111111111111111111112", - "mint": "So11111111111111111111111111111111111111111", - "amount": "1173096711863", - "value": 1173.096711863, - "decimals": 9, - "name": "SOL", - "symbol": "SOL", - "uri": null, + "last_update": "2025-10-09 02:10:01", + "last_update_block_num": 372132067, + "last_update_timestamp": 1759975801, + "program_id": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", + "owner": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", + "token_account": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", + "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", + "amount": "85605114004", + "value": 85605.114004, + "decimals": 6, + "name": "Pump", + "symbol": "PUMP", + "uri": "https://ipfs.io/ipfs/bafkreibcglldkfdekdkxgumlveoe6qv3pbiceypkwtli33clbzul7leo4m", "network": "solana" } ] @@ -11099,15 +14016,15 @@ }, { "in": "query", - "name": "address", + "name": "owner", "schema": { "type": "string", - "example": "So11111111111111111111111111111111111111112", + "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", "anyOf": [ { "type": "string", - "description": "Filter by address", - "example": "So11111111111111111111111111111111111111112" + "description": "Filter by owner address", + "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" }, { "type": "string" @@ -11116,14 +14033,83 @@ "type": "array", "items": { "type": "string", - "description": "Filter by address", - "example": "So11111111111111111111111111111111111111112" + "description": "Filter by owner address", + "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" } } ] }, "required": true, - "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "Filter by owner address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "token_account", + "schema": { + "type": "string", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", + "anyOf": [ + { + "type": "string", + "description": "Filter by token account address", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by token account address", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + } + } + ] + }, + "description": "Filter by token account address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "mint", + "schema": { + "type": "string", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", + "anyOf": [ + { + "type": "string", + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + } + } + ] + }, + "description": "Filter by mint address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "program_id", + "schema": { + "example": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", + "default": "", + "type": "string", + "enum": [ + "11111111111111111111111111111111", + "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", + "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" + ] + }, + "description": "Filter by SPL token program ID" }, { "in": "query", @@ -11158,18 +14144,13 @@ ] } }, - "/v1/svm/balances": { + "/v1/svm/dexes": { "get": { - "operationId": "getV1SvmBalances", - "summary": "Token Balances", - "description": "Returns SPL token balances for Solana token owners with mint and program data.", + "operationId": "getV1SvmDexes", + "summary": "Supported DEXs", + "description": "Returns all supported Solana DEXs.", "tags": [ - "SVM Tokens" - ], - "security": [ - { - "bearerAuth": [] - } + "SVM DEXs" ], "responses": { "200": { @@ -11184,111 +14165,49 @@ "items": { "type": "object", "properties": { - "last_update": { - "type": "string", - "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" - }, - "last_update_block_num": { - "type": "number" - }, - "last_update_timestamp": { - "type": "number" - }, "program_id": { - "description": "Filter by SPL token program ID", - "example": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", + "description": "Filter by program ID", + "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", "type": "string", "enum": [ - "11111111111111111111111111111111", - "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", - "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" + "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", + "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C", + "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", + "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK", + "Eo7WjKq67rjJQSZxS6z3YkapzY3eMj6Xy8X5EQVn5UaB", + "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo", + "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG", + "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", + "JUP4Fb2cqiRUcaTHdrPC8h2gNsA2ETXiPDD33WcGuJB", + "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" ] }, - "owner": { - "type": "string", - "description": "Filter by owner address", - "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" - }, - "token_account": { - "type": "string", - "description": "Filter by token account address", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + "program_name": { + "type": "string" }, - "mint": { + "amm": { "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + "description": "Filter by AMM address", + "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8" }, - "amount": { + "amm_name": { "type": "string" }, - "value": { - "type": "number" - }, - "decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] - }, - "name": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "symbol": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "uri": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "network": { - "description": "The Graph Network ID for SVM networks https://thegraph.com/networks", - "example": "solana", - "type": "string", - "enum": [ - "solana" - ] - } - }, - "required": [ - "last_update", - "last_update_block_num", - "last_update_timestamp", - "program_id", - "owner", - "token_account", - "mint", - "amount", - "value", - "decimals", - "name", - "symbol", - "uri", - "network" + "is_aggregator": { + "type": "boolean" + }, + "transactions": { + "type": "number" + } + }, + "required": [ + "program_id", + "program_name", + "amm", + "amm_name", + "is_aggregator", + "transactions" ] } }, @@ -11350,20 +14269,12 @@ "value": { "data": [ { - "last_update": "2025-10-09 02:10:01", - "last_update_block_num": 372132067, - "last_update_timestamp": 1759975801, - "program_id": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", - "owner": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", - "token_account": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", - "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", - "amount": "85605114004", - "value": 85605.114004, - "decimals": 6, - "name": "Pump", - "symbol": "PUMP", - "uri": "https://ipfs.io/ipfs/bafkreibcglldkfdekdkxgumlveoe6qv3pbiceypkwtli33clbzul7leo4m", - "network": "solana" + "program_id": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "program_name": "Jupiter Aggregator v6", + "amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", + "amm_name": "Raydium Liquidity Pool V4", + "is_aggregator": true, + "transactions": 1008573050 } ] } @@ -11709,111 +14620,6 @@ "required": true, "description": "The Graph Network ID for SVM networks https://thegraph.com/networks" }, - { - "in": "query", - "name": "owner", - "schema": { - "type": "string", - "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", - "anyOf": [ - { - "type": "string", - "description": "Filter by owner address", - "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by owner address", - "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" - } - } - ] - }, - "required": true, - "description": "Filter by owner address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "token_account", - "schema": { - "type": "string", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", - "anyOf": [ - { - "type": "string", - "description": "Filter by token account address", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by token account address", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" - } - } - ] - }, - "description": "Filter by token account address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "mint", - "schema": { - "type": "string", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", - "anyOf": [ - { - "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" - } - } - ] - }, - "description": "Filter by mint address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "program_id", - "schema": { - "example": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", - "default": "", - "type": "string", - "enum": [ - "11111111111111111111111111111111", - "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", - "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" - ] - }, - "description": "Filter by SPL token program ID" - }, - { - "in": "query", - "name": "include_null_balances", - "schema": { - "type": "boolean" - }, - "description": "Include zero/null balances in results" - }, { "in": "query", "name": "limit", @@ -11839,13 +14645,18 @@ ] } }, - "/v1/svm/dexes": { + "/v1/svm/holders": { "get": { - "operationId": "getV1SvmDexes", - "summary": "Supported DEXs", - "description": "Returns all supported Solana DEXs.", + "operationId": "getV1SvmHolders", + "summary": "Token Holders", + "description": "Returns top token holders ranked by balance.", "tags": [ - "SVM DEXs" + "SVM Tokens" + ], + "security": [ + { + "bearerAuth": [] + } ], "responses": { "200": { @@ -11860,6 +14671,26 @@ "items": { "type": "object", "properties": { + "last_update": { + "type": "string", + "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + }, + "last_update_block_num": { + "type": "number" + }, + "last_update_timestamp": { + "type": "number" + }, + "owner": { + "type": "string", + "description": "Filter by address", + "example": "So11111111111111111111111111111111111111112" + }, + "mint": { + "type": "string", + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + }, "program_id": { "description": "Filter by program ID", "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", @@ -11878,31 +14709,75 @@ "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" ] }, - "program_name": { + "amount": { "type": "string" }, - "amm": { - "type": "string", - "description": "Filter by AMM address", - "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8" + "value": { + "type": "number" }, - "amm_name": { - "type": "string" + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] }, - "is_aggregator": { - "type": "boolean" + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] }, - "transactions": { - "type": "number" + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "uri": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "network": { + "description": "The Graph Network ID for SVM networks https://thegraph.com/networks", + "example": "solana", + "type": "string", + "enum": [ + "solana" + ] } }, "required": [ + "last_update", + "last_update_block_num", + "last_update_timestamp", + "owner", + "mint", "program_id", - "program_name", - "amm", - "amm_name", - "is_aggregator", - "transactions" + "amount", + "value", + "decimals", + "name", + "symbol", + "uri", + "network" ] } }, @@ -11964,12 +14839,19 @@ "value": { "data": [ { - "program_id": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", - "program_name": "Jupiter Aggregator v6", - "amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", - "amm_name": "Raydium Liquidity Pool V4", - "is_aggregator": true, - "transactions": 1008573050 + "last_update": "2025-09-17 20:06:47", + "last_update_block_num": 367491952, + "last_update_timestamp": 1758139607, + "owner": "7AN6avKCJPMkXkW8kPwMuHmaWvJeHH69e8rKpLf9rdfk", + "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", + "program_id": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", + "amount": "365461857133582111", + "value": 365461857133.5821, + "decimals": 6, + "name": "Pump", + "symbol": "PUMP", + "uri": "https://ipfs.io/ipfs/bafkreibcglldkfdekdkxgumlveoe6qv3pbiceypkwtli33clbzul7leo4m", + "network": "solana" } ] } @@ -12315,6 +15197,16 @@ "required": true, "description": "The Graph Network ID for SVM networks https://thegraph.com/networks" }, + { + "in": "query", + "name": "mint", + "schema": { + "type": "string", + "example": "So11111111111111111111111111111111111111112" + }, + "required": true, + "description": "Filter by mint address" + }, { "in": "query", "name": "limit", @@ -12340,11 +15232,11 @@ ] } }, - "/v1/svm/holders": { + "/v1/svm/owner": { "get": { - "operationId": "getV1SvmHolders", - "summary": "Token Holders", - "description": "Returns top token holders ranked by balance.", + "operationId": "getV1SvmOwner", + "summary": "Account Owner Lookup", + "description": "Returns owner address of an associated token account (ATA) with closure status.", "tags": [ "SVM Tokens" ], @@ -12376,79 +15268,18 @@ "last_update_timestamp": { "type": "number" }, - "owner": { - "type": "string", - "description": "Filter by address", - "example": "So11111111111111111111111111111111111111112" - }, - "mint": { + "account": { "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + "description": "Filter by token account address", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" }, - "program_id": { - "description": "Filter by program ID", - "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "owner": { "type": "string", - "enum": [ - "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", - "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C", - "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", - "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK", - "Eo7WjKq67rjJQSZxS6z3YkapzY3eMj6Xy8X5EQVn5UaB", - "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", - "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo", - "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG", - "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", - "JUP4Fb2cqiRUcaTHdrPC8h2gNsA2ETXiPDD33WcGuJB", - "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" - ] - }, - "amount": { - "type": "string" - }, - "value": { - "type": "number" - }, - "decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] - }, - "name": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "symbol": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] + "description": "Filter by owner address", + "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" }, - "uri": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] + "is_closed": { + "type": "boolean" }, "network": { "description": "The Graph Network ID for SVM networks https://thegraph.com/networks", @@ -12463,15 +15294,9 @@ "last_update", "last_update_block_num", "last_update_timestamp", + "account", "owner", - "mint", - "program_id", - "amount", - "value", - "decimals", - "name", - "symbol", - "uri", + "is_closed", "network" ] } @@ -12534,18 +15359,12 @@ "value": { "data": [ { - "last_update": "2025-09-17 20:06:47", - "last_update_block_num": 367491952, - "last_update_timestamp": 1758139607, - "owner": "7AN6avKCJPMkXkW8kPwMuHmaWvJeHH69e8rKpLf9rdfk", - "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", - "program_id": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", - "amount": "365461857133582111", - "value": 365461857133.5821, - "decimals": 6, - "name": "Pump", - "symbol": "PUMP", - "uri": "https://ipfs.io/ipfs/bafkreibcglldkfdekdkxgumlveoe6qv3pbiceypkwtli33clbzul7leo4m", + "last_update": "2025-07-14 17:17:19", + "last_update_block_num": 353288878, + "last_update_timestamp": 1752513439, + "account": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", + "owner": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", + "is_closed": false, "network": "solana" } ] @@ -12894,13 +15713,31 @@ }, { "in": "query", - "name": "mint", + "name": "account", "schema": { "type": "string", - "example": "So11111111111111111111111111111111111111112" + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", + "anyOf": [ + { + "type": "string", + "description": "Filter by token account address", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by token account address", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + } + } + ] }, "required": true, - "description": "Filter by mint address" + "description": "Filter by token account address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", @@ -12927,13 +15764,13 @@ ] } }, - "/v1/svm/owner": { + "/v1/svm/pools/ohlc": { "get": { - "operationId": "getV1SvmOwner", - "summary": "Account Owner Lookup", - "description": "Returns owner address of an associated token account (ATA) with closure status.", + "operationId": "getV1SvmPoolsOhlc", + "summary": "Pool OHLCV", + "description": "Provides pricing data in the Open/High/Low/Close/Volume (OHCLV) format for DEX pools.", "tags": [ - "SVM Tokens" + "SVM DEXs" ], "security": [ { @@ -12953,46 +15790,87 @@ "items": { "type": "object", "properties": { - "last_update": { + "datetime": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "last_update_block_num": { - "type": "number" - }, - "last_update_timestamp": { - "type": "number" + "amm": { + "type": "string", + "description": "Filter by AMM address", + "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8" }, - "account": { + "amm_pool": { "type": "string", - "description": "Filter by token account address", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + "description": "Filter by AMM pool address", + "example": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J" }, - "owner": { + "token0": { "type": "string", - "description": "Filter by owner address", - "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, - "is_closed": { - "type": "boolean" + "token0_decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] }, - "network": { - "description": "The Graph Network ID for SVM networks https://thegraph.com/networks", - "example": "solana", + "token1": { "type": "string", - "enum": [ - "solana" + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + }, + "token1_decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } ] + }, + "open": { + "type": "number" + }, + "high": { + "type": "number" + }, + "low": { + "type": "number" + }, + "close": { + "type": "number" + }, + "volume": { + "type": "number" + }, + "uaw": { + "type": "number" + }, + "transactions": { + "type": "number" } }, "required": [ - "last_update", - "last_update_block_num", - "last_update_timestamp", - "account", - "owner", - "is_closed", - "network" + "datetime", + "amm", + "amm_pool", + "token0", + "token0_decimals", + "token1", + "token1_decimals", + "open", + "high", + "low", + "close", + "volume", + "uaw", + "transactions" ] } }, @@ -13054,13 +15932,20 @@ "value": { "data": [ { - "last_update": "2025-07-14 17:17:19", - "last_update_block_num": 353288878, - "last_update_timestamp": 1752513439, - "account": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", - "owner": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", - "is_closed": false, - "network": "solana" + "datetime": "2025-10-16 00:00:00", + "amm": "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", + "amm_pool": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J", + "token0": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", + "token0_decimals": 6, + "token1": "So11111111111111111111111111111111111111112", + "token1_decimals": 9, + "open": 0.0020385820805914096, + "high": 0.002037622484039942, + "low": 0.002029088299722426, + "close": 0.0020285665581652053, + "volume": 0.14567917800000002, + "uaw": 8, + "transactions": 8 } ] } @@ -13408,31 +16293,46 @@ }, { "in": "query", - "name": "account", + "name": "amm_pool", "schema": { "type": "string", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", - "anyOf": [ - { - "type": "string", - "description": "Filter by token account address", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by token account address", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" - } - } - ] + "example": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J" }, "required": true, - "description": "Filter by token account address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "Filter by AMM pool address" + }, + { + "in": "query", + "name": "interval", + "schema": { + "type": "string", + "enum": [ + "1h", + "4h", + "1d", + "1w" + ], + "default": "1d" + }, + "description": "The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).
*Plan restricted." + }, + { + "in": "query", + "name": "start_time", + "schema": { + "type": "string", + "default": "2015-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "end_time", + "schema": { + "type": "string", + "default": "2050-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." }, { "in": "query", @@ -13459,11 +16359,11 @@ ] } }, - "/v1/svm/pools/ohlc": { + "/v1/svm/pools": { "get": { - "operationId": "getV1SvmPoolsOhlc", - "summary": "Pool OHLCV", - "description": "Provides pricing data in the Open/High/Low/Close/Volume (OHCLV) format for DEX pools.", + "operationId": "getV1SvmPools", + "summary": "Liquidity Pools", + "description": "Returns AMM pool information from Solana DEX protocols with transaction counts.", "tags": [ "SVM DEXs" ], @@ -13485,87 +16385,72 @@ "items": { "type": "object", "properties": { - "datetime": { + "program_id": { + "description": "Filter by program ID", + "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", "type": "string", - "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + "enum": [ + "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", + "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C", + "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", + "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK", + "Eo7WjKq67rjJQSZxS6z3YkapzY3eMj6Xy8X5EQVn5UaB", + "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo", + "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG", + "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", + "JUP4Fb2cqiRUcaTHdrPC8h2gNsA2ETXiPDD33WcGuJB", + "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" + ] + }, + "program_name": { + "type": "string" }, "amm": { "type": "string", "description": "Filter by AMM address", "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8" }, + "amm_name": { + "type": "string" + }, "amm_pool": { "type": "string", "description": "Filter by AMM pool address", "example": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J" }, - "token0": { + "input_mint": { "type": "string", "description": "Filter by mint address", "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, - "token0_decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] - }, - "token1": { + "output_mint": { "type": "string", "description": "Filter by mint address", "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, - "token1_decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] - }, - "open": { - "type": "number" - }, - "high": { - "type": "number" - }, - "low": { - "type": "number" - }, - "close": { - "type": "number" - }, - "volume": { - "type": "number" - }, - "uaw": { - "type": "number" - }, "transactions": { "type": "number" + }, + "network": { + "description": "The Graph Network ID for SVM networks https://thegraph.com/networks", + "example": "solana", + "type": "string", + "enum": [ + "solana" + ] } }, "required": [ - "datetime", + "program_id", + "program_name", "amm", + "amm_name", "amm_pool", - "token0", - "token0_decimals", - "token1", - "token1_decimals", - "open", - "high", - "low", - "close", - "volume", - "uaw", - "transactions" + "input_mint", + "output_mint", + "transactions", + "network" ] } }, @@ -13627,20 +16512,15 @@ "value": { "data": [ { - "datetime": "2025-10-16 00:00:00", - "amm": "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", - "amm_pool": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J", - "token0": "9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump", - "token0_decimals": 6, - "token1": "So11111111111111111111111111111111111111112", - "token1_decimals": 9, - "open": 0.0020385820805914096, - "high": 0.002037622484039942, - "low": 0.002029088299722426, - "close": 0.0020285665581652053, - "volume": 0.14567917800000002, - "uaw": 8, - "transactions": 8 + "program_id": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "program_name": "Jupiter Aggregator v6", + "amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", + "amm_name": "Raydium Liquidity Pool V4", + "amm_pool": "", + "input_mint": "So11111111111111111111111111111111111111112", + "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", + "transactions": 6583671, + "network": "solana" } ] } @@ -13983,51 +16863,168 @@ "solana" ] }, - "required": true, - "description": "The Graph Network ID for SVM networks https://thegraph.com/networks" - }, - { - "in": "query", - "name": "amm_pool", - "schema": { - "type": "string", - "example": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J" - }, - "required": true, - "description": "Filter by AMM pool address" + "required": true, + "description": "The Graph Network ID for SVM networks https://thegraph.com/networks" + }, + { + "in": "query", + "name": "amm", + "schema": { + "type": "string", + "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", + "anyOf": [ + { + "type": "string", + "description": "Filter by AMM address", + "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by AMM address", + "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8" + } + } + ] + }, + "description": "Filter by AMM address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "amm_pool", + "schema": { + "type": "string", + "example": "", + "anyOf": [ + { + "type": "string", + "description": "Filter by AMM pool address", + "example": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by AMM pool address", + "example": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J" + } + } + ] + }, + "description": "Filter by AMM pool address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "interval", + "name": "input_mint", "schema": { "type": "string", - "enum": [ - "1h", - "4h", - "1d", - "1w" - ], - "default": "1d" + "example": "So11111111111111111111111111111111111111112", + "anyOf": [ + { + "type": "string", + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + } + } + ] }, - "description": "The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).
*Plan restricted." + "description": "Filter by mint address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "start_time", + "name": "output_mint", "schema": { "type": "string", - "default": "2025-12-08" + "example": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", + "anyOf": [ + { + "type": "string", + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + } + } + ] }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + "description": "Filter by mint address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "end_time", + "name": "program_id", "schema": { - "type": "string", - "default": "2050-01-01" + "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "anyOf": [ + { + "description": "Filter by program ID", + "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "type": "string", + "enum": [ + "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", + "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C", + "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", + "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK", + "Eo7WjKq67rjJQSZxS6z3YkapzY3eMj6Xy8X5EQVn5UaB", + "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo", + "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG", + "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", + "JUP4Fb2cqiRUcaTHdrPC8h2gNsA2ETXiPDD33WcGuJB", + "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" + ] + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "description": "Filter by program ID", + "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "type": "string", + "enum": [ + "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", + "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C", + "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", + "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK", + "Eo7WjKq67rjJQSZxS6z3YkapzY3eMj6Xy8X5EQVn5UaB", + "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo", + "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG", + "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", + "JUP4Fb2cqiRUcaTHdrPC8h2gNsA2ETXiPDD33WcGuJB", + "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" + ] + } + } + ] }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + "description": "Filter by program ID
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", @@ -14054,11 +17051,11 @@ ] } }, - "/v1/svm/pools": { + "/v1/svm/swaps": { "get": { - "operationId": "getV1SvmPools", - "summary": "Liquidity Pools", - "description": "Returns AMM pool information from Solana DEX protocols with transaction counts.", + "operationId": "getV1SvmSwaps", + "summary": "Swap Events", + "description": "Returns AMM swap events from Solana DEXs with input/output tokens and amounts.", "tags": [ "SVM DEXs" ], @@ -14080,6 +17077,27 @@ "items": { "type": "object", "properties": { + "block_num": { + "type": "number" + }, + "datetime": { + "type": "string", + "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + }, + "timestamp": { + "type": "number" + }, + "signature": { + "type": "string", + "description": "Filter by transaction signature", + "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA" + }, + "transaction_index": { + "type": "number" + }, + "instruction_index": { + "type": "number" + }, "program_id": { "description": "Filter by program ID", "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", @@ -14106,25 +17124,30 @@ "description": "Filter by AMM address", "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8" }, - "amm_name": { - "type": "string" - }, "amm_pool": { "type": "string", "description": "Filter by AMM pool address", "example": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J" }, + "user": { + "type": "string", + "description": "Filter by address", + "example": "So11111111111111111111111111111111111111112" + }, "input_mint": { "type": "string", "description": "Filter by mint address", "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, + "input_amount": { + "type": "number" + }, "output_mint": { "type": "string", "description": "Filter by mint address", "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, - "transactions": { + "output_amount": { "type": "number" }, "network": { @@ -14137,14 +17160,21 @@ } }, "required": [ + "block_num", + "datetime", + "timestamp", + "signature", + "transaction_index", + "instruction_index", "program_id", "program_name", "amm", - "amm_name", "amm_pool", + "user", "input_mint", + "input_amount", "output_mint", - "transactions", + "output_amount", "network" ] } @@ -14207,14 +17237,21 @@ "value": { "data": [ { + "block_num": 373763118, + "datetime": "2025-10-16 14:03:09", + "timestamp": 1760623389, + "signature": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA", + "transaction_index": 8, + "instruction_index": 1, "program_id": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", "program_name": "Jupiter Aggregator v6", "amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", - "amm_name": "Raydium Liquidity Pool V4", "amm_pool": "", - "input_mint": "So11111111111111111111111111111111111111112", + "user": "5MGfsuYNRhbuN6x1M6WaR3721dSDGtXpcsHxNsgkjsXC", + "input_mint": "HmrzeZapM1EygFc4tBJUXwWTzv5Ahy8axLSAadBx51sw", + "input_amount": 49572355581648, "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", - "transactions": 6583671, + "output_amount": 936671, "network": "solana" } ] @@ -14561,6 +17598,33 @@ "required": true, "description": "The Graph Network ID for SVM networks https://thegraph.com/networks" }, + { + "in": "query", + "name": "signature", + "schema": { + "type": "string", + "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA", + "anyOf": [ + { + "type": "string", + "description": "Filter by transaction signature", + "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by transaction signature", + "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA" + } + } + ] + }, + "description": "Filter by transaction signature
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, { "in": "query", "name": "amm", @@ -14615,12 +17679,39 @@ }, "description": "Filter by AMM pool address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, + { + "in": "query", + "name": "user", + "schema": { + "type": "string", + "example": "5MGfsuYNRhbuN6x1M6WaR3721dSDGtXpcsHxNsgkjsXC", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "So11111111111111111111111111111111111111112" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by address", + "example": "So11111111111111111111111111111111111111112" + } + } + ] + }, + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, { "in": "query", "name": "input_mint", "schema": { "type": "string", - "example": "So11111111111111111111111111111111111111112", + "example": "HmrzeZapM1EygFc4tBJUXwWTzv5Ahy8axLSAadBx51sw", "anyOf": [ { "type": "string", @@ -14719,7 +17810,47 @@ } ] }, - "description": "Filter by program ID
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "Filter by program ID
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "start_time", + "schema": { + "type": "string", + "default": "2020-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "end_time", + "schema": { + "type": "string", + "default": "2050-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "start_block", + "schema": { + "default": 0, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" + }, + { + "in": "query", + "name": "end_block", + "schema": { + "default": 9999999999, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" }, { "in": "query", @@ -14746,13 +17877,13 @@ ] } }, - "/v1/svm/swaps": { + "/v1/svm/tokens": { "get": { - "operationId": "getV1SvmSwaps", - "summary": "Swap Events", - "description": "Returns AMM swap events from Solana DEXs with input/output tokens and amounts.", + "operationId": "getV1SvmTokens", + "summary": "Token Metadata", + "description": "Provides SVM token contract metadata.", "tags": [ - "SVM DEXs" + "SVM Tokens" ], "security": [ { @@ -14772,104 +17903,85 @@ "items": { "type": "object", "properties": { - "block_num": { - "type": "number" - }, - "datetime": { + "last_update": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "timestamp": { - "type": "number" - }, - "signature": { - "type": "string", - "description": "Filter by transaction signature", - "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA" - }, - "transaction_index": { + "last_update_block_num": { "type": "number" }, - "instruction_index": { + "last_update_timestamp": { "type": "number" }, "program_id": { - "description": "Filter by program ID", - "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", + "description": "Filter by SPL token program ID", + "example": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "type": "string", "enum": [ - "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", - "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C", - "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", - "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK", - "Eo7WjKq67rjJQSZxS6z3YkapzY3eMj6Xy8X5EQVn5UaB", - "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", - "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo", - "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG", - "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", - "JUP4Fb2cqiRUcaTHdrPC8h2gNsA2ETXiPDD33WcGuJB", - "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" + "11111111111111111111111111111111", + "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", + "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" ] }, - "program_name": { - "type": "string" - }, - "amm": { - "type": "string", - "description": "Filter by AMM address", - "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8" - }, - "amm_pool": { - "type": "string", - "description": "Filter by AMM pool address", - "example": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J" - }, - "user": { - "type": "string", - "description": "Filter by address", - "example": "So11111111111111111111111111111111111111112" - }, - "input_mint": { + "mint": { "type": "string", "description": "Filter by mint address", "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, - "input_amount": { - "type": "number" + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] }, - "output_mint": { - "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] }, - "output_amount": { - "type": "number" + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] }, - "network": { - "description": "The Graph Network ID for SVM networks https://thegraph.com/networks", - "example": "solana", - "type": "string", - "enum": [ - "solana" + "uri": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } ] + }, + "network": { + "type": "string" } }, "required": [ - "block_num", - "datetime", - "timestamp", - "signature", - "transaction_index", - "instruction_index", + "last_update", + "last_update_block_num", + "last_update_timestamp", "program_id", - "program_name", - "amm", - "amm_pool", - "user", - "input_mint", - "input_amount", - "output_mint", - "output_amount", + "mint", + "decimals", + "name", + "symbol", + "uri", "network" ] } @@ -14932,99 +18044,26 @@ "value": { "data": [ { - "block_num": 373763118, - "datetime": "2025-10-16 14:03:09", - "timestamp": 1760623389, - "signature": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA", - "transaction_index": 8, - "instruction_index": 1, - "program_id": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", - "program_name": "Jupiter Aggregator v6", - "amm": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", - "amm_pool": "", - "user": "5MGfsuYNRhbuN6x1M6WaR3721dSDGtXpcsHxNsgkjsXC", - "input_mint": "HmrzeZapM1EygFc4tBJUXwWTzv5Ahy8axLSAadBx51sw", - "input_amount": 49572355581648, - "output_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", - "output_amount": 936671, - "network": "solana" - } - ] - } - } - } - } - } - }, - "400": { - "description": "Client side error", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "status": { - "anyOf": [ - { - "type": "number", - "const": 400 - }, - { - "type": "number", - "const": 401 - }, - { - "type": "number", - "const": 403 - }, - { - "type": "number", - "const": 404 - }, - { - "type": "number", - "const": 405 - } - ] - }, - "code": { - "type": "string", - "enum": [ - "authentication_failed", - "bad_header", - "missing_required_header", - "bad_query_input", - "forbidden", - "method_not_allowed", - "route_not_found", - "unauthorized", - "not_found_data" - ] - }, - "message": { - "type": "string" - } - }, - "required": [ - "status", - "code", - "message" - ] - }, - "examples": { - "example": { - "value": { - "status": 400, - "code": "bad_query_input", - "message": "Invalid query parameter provided" + "last_update": "2025-10-16 10:34:46", + "last_update_block_num": 373731565, + "last_update_timestamp": 1760610886, + "program_id": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", + "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", + "decimals": 6, + "name": "Pump", + "symbol": "PUMP", + "uri": "https://ipfs.io/ipfs/bafkreibcglldkfdekdkxgumlveoe6qv3pbiceypkwtli33clbzul7leo4m", + "network": "solana" + } + ] } } } } } }, - "401": { - "description": "Authentication failed", + "400": { + "description": "Client side error", "content": { "application/json": { "schema": { @@ -15081,17 +18120,17 @@ "examples": { "example": { "value": { - "status": 401, - "code": "unauthorized", - "message": "Authentication required" + "status": 400, + "code": "bad_query_input", + "message": "Invalid query parameter provided" } } } } } }, - "403": { - "description": "Forbidden", + "401": { + "description": "Authentication failed", "content": { "application/json": { "schema": { @@ -15148,17 +18187,17 @@ "examples": { "example": { "value": { - "status": 403, - "code": "forbidden", - "message": "Access denied" + "status": 401, + "code": "unauthorized", + "message": "Authentication required" } } } } } }, - "404": { - "description": "Not found", + "403": { + "description": "Forbidden", "content": { "application/json": { "schema": { @@ -15215,17 +18254,17 @@ "examples": { "example": { "value": { - "status": 404, - "code": "not_found_data", - "message": "Resource not found" + "status": 403, + "code": "forbidden", + "message": "Access denied" } } } } } }, - "500": { - "description": "Server side error", + "404": { + "description": "Not found", "content": { "application/json": { "schema": { @@ -15235,317 +18274,140 @@ "anyOf": [ { "type": "number", - "const": 500 + "const": 400 }, { "type": "number", - "const": 502 + "const": 401 }, { "type": "number", - "const": 504 - } - ] - }, - "code": { - "type": "string", - "enum": [ - "bad_database_response", - "connection_refused", - "database_timeout", - "internal_server_error" - ] - }, - "message": { - "type": "string" - } - }, - "required": [ - "status", - "code", - "message" - ] - }, - "examples": { - "example": { - "value": { - "status": 500, - "code": "internal_server_error", - "message": "An unexpected error occurred" - } - } - } - } - } - } - }, - "parameters": [ - { - "in": "query", - "name": "network", - "schema": { - "example": "solana", - "type": "string", - "enum": [ - "solana" - ] - }, - "required": true, - "description": "The Graph Network ID for SVM networks https://thegraph.com/networks" - }, - { - "in": "query", - "name": "signature", - "schema": { - "type": "string", - "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA", - "anyOf": [ - { - "type": "string", - "description": "Filter by transaction signature", - "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by transaction signature", - "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA" - } - } - ] - }, - "description": "Filter by transaction signature
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "amm", - "schema": { - "type": "string", - "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", - "anyOf": [ - { - "type": "string", - "description": "Filter by AMM address", - "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by AMM address", - "example": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8" - } - } - ] - }, - "description": "Filter by AMM address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "amm_pool", - "schema": { - "type": "string", - "example": "", - "anyOf": [ - { - "type": "string", - "description": "Filter by AMM pool address", - "example": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by AMM pool address", - "example": "AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J" - } - } - ] - }, - "description": "Filter by AMM pool address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "user", - "schema": { - "type": "string", - "example": "5MGfsuYNRhbuN6x1M6WaR3721dSDGtXpcsHxNsgkjsXC", - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "So11111111111111111111111111111111111111112" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by address", - "example": "So11111111111111111111111111111111111111112" - } - } - ] - }, - "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "input_mint", - "schema": { - "type": "string", - "example": "HmrzeZapM1EygFc4tBJUXwWTzv5Ahy8axLSAadBx51sw", - "anyOf": [ - { - "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" - } - } - ] - }, - "description": "Filter by mint address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "output_mint", - "schema": { - "type": "string", - "example": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", - "anyOf": [ - { - "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" - }, - { - "type": "string" + "const": 403 + }, + { + "type": "number", + "const": 404 + }, + { + "type": "number", + "const": 405 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "authentication_failed", + "bad_header", + "missing_required_header", + "bad_query_input", + "forbidden", + "method_not_allowed", + "route_not_found", + "unauthorized", + "not_found_data" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" + ] }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + "examples": { + "example": { + "value": { + "status": 404, + "code": "not_found_data", + "message": "Resource not found" + } } } - ] - }, - "description": "Filter by mint address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + } + } }, - { - "in": "query", - "name": "program_id", - "schema": { - "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", - "anyOf": [ - { - "description": "Filter by program ID", - "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", - "type": "string", - "enum": [ - "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", - "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C", - "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", - "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK", - "Eo7WjKq67rjJQSZxS6z3YkapzY3eMj6Xy8X5EQVn5UaB", - "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", - "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo", - "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG", - "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", - "JUP4Fb2cqiRUcaTHdrPC8h2gNsA2ETXiPDD33WcGuJB", - "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" + "500": { + "description": "Server side error", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "status": { + "anyOf": [ + { + "type": "number", + "const": 500 + }, + { + "type": "number", + "const": 502 + }, + { + "type": "number", + "const": 504 + } + ] + }, + "code": { + "type": "string", + "enum": [ + "bad_database_response", + "connection_refused", + "database_timeout", + "internal_server_error" + ] + }, + "message": { + "type": "string" + } + }, + "required": [ + "status", + "code", + "message" ] }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "description": "Filter by program ID", - "example": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", - "type": "string", - "enum": [ - "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj", - "CPMMoo8L3F4NbTegBCKVNunggL7H1ZpdTHKxQB5qKP1C", - "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8", - "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK", - "Eo7WjKq67rjJQSZxS6z3YkapzY3eMj6Xy8X5EQVn5UaB", - "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4", - "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo", - "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG", - "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA", - "JUP4Fb2cqiRUcaTHdrPC8h2gNsA2ETXiPDD33WcGuJB", - "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P" - ] + "examples": { + "example": { + "value": { + "status": 500, + "code": "internal_server_error", + "message": "An unexpected error occurred" + } } } - ] - }, - "description": "Filter by program ID
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, + } + } + } + }, + "parameters": [ { "in": "query", - "name": "start_time", + "name": "network", "schema": { + "example": "solana", "type": "string", - "default": "2020-01-01" + "enum": [ + "solana" + ] }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + "required": true, + "description": "The Graph Network ID for SVM networks https://thegraph.com/networks" }, { "in": "query", - "name": "end_time", + "name": "mint", "schema": { "type": "string", - "default": "2050-01-01" - }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." - }, - { - "in": "query", - "name": "start_block", - "schema": { - "default": 0, - "type": "integer", - "minimum": 0, - "maximum": 9007199254740991 - }, - "description": "Filter by block number" - }, - { - "in": "query", - "name": "end_block", - "schema": { - "default": 9999999999, - "type": "integer", - "minimum": 0, - "maximum": 9007199254740991 + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, - "description": "Filter by block number" + "required": true, + "description": "Filter by mint address" }, { "in": "query", @@ -15572,11 +18434,11 @@ ] } }, - "/v1/svm/tokens": { + "/v1/svm/transfers": { "get": { - "operationId": "getV1SvmTokens", - "summary": "Token Metadata", - "description": "Provides SVM token contract metadata.", + "operationId": "getV1SvmTransfers", + "summary": "Token Transfers", + "description": "Returns SPL token transfers with program, authority, and account information.", "tags": [ "SVM Tokens" ], @@ -15598,14 +18460,23 @@ "items": { "type": "object", "properties": { - "last_update": { + "block_num": { + "type": "number" + }, + "datetime": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "last_update_block_num": { + "timestamp": { "type": "number" }, - "last_update_timestamp": { + "signature": { + "type": "string" + }, + "transaction_index": { + "type": "number" + }, + "instruction_index": { "type": "number" }, "program_id": { @@ -15623,6 +18494,27 @@ "description": "Filter by mint address", "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" }, + "authority": { + "type": "string", + "description": "Filter by authority address", + "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" + }, + "source": { + "type": "string", + "description": "Filter by address", + "example": "So11111111111111111111111111111111111111112" + }, + "destination": { + "type": "string", + "description": "Filter by address", + "example": "So11111111111111111111111111111111111111112" + }, + "amount": { + "type": "string" + }, + "value": { + "type": "number" + }, "decimals": { "anyOf": [ { @@ -15664,15 +18556,28 @@ ] }, "network": { - "type": "string" + "description": "The Graph Network ID for SVM networks https://thegraph.com/networks", + "example": "solana", + "type": "string", + "enum": [ + "solana" + ] } }, "required": [ - "last_update", - "last_update_block_num", - "last_update_timestamp", + "block_num", + "datetime", + "timestamp", + "signature", + "transaction_index", + "instruction_index", "program_id", "mint", + "authority", + "source", + "destination", + "amount", + "value", "decimals", "name", "symbol", @@ -15739,11 +18644,19 @@ "value": { "data": [ { - "last_update": "2025-10-16 10:34:46", - "last_update_block_num": 373731565, - "last_update_timestamp": 1760610886, + "block_num": 372132067, + "datetime": "2025-10-09 02:10:01", + "timestamp": 1759975801, + "signature": "2Y3YJMa7Gx96ZprnWxSQHiahGdbiNFwF1DdT4ZWGf8cwJnv4fRTcFg9Z5THuAHhja66fi6Jd8fLngtH1d8qSNj3H", + "transaction_index": 65, + "instruction_index": 0, "program_id": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", + "authority": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", + "source": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", + "destination": "64nnJ2CBUZ3VasttjVhxbQXqzbjAxnj4VT4vBrrveNV", + "amount": "835996345", + "value": 835.996345, "decimals": 6, "name": "Pump", "symbol": "PUMP", @@ -16094,15 +19007,195 @@ "required": true, "description": "The Graph Network ID for SVM networks https://thegraph.com/networks" }, + { + "in": "query", + "name": "signature", + "schema": { + "type": "string", + "example": "2Y3YJMa7Gx96ZprnWxSQHiahGdbiNFwF1DdT4ZWGf8cwJnv4fRTcFg9Z5THuAHhja66fi6Jd8fLngtH1d8qSNj3H", + "anyOf": [ + { + "type": "string", + "description": "Filter by transaction signature", + "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by transaction signature", + "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA" + } + } + ] + }, + "description": "Filter by transaction signature
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "source", + "schema": { + "type": "string", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", + "anyOf": [ + { + "type": "string", + "description": "Filter by token account address", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by token account address", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + } + } + ] + }, + "description": "Filter by token account address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "destination", + "schema": { + "type": "string", + "example": "64nnJ2CBUZ3VasttjVhxbQXqzbjAxnj4VT4vBrrveNV", + "anyOf": [ + { + "type": "string", + "description": "Filter by token account address", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by token account address", + "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + } + } + ] + }, + "description": "Filter by token account address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "authority", + "schema": { + "type": "string", + "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", + "anyOf": [ + { + "type": "string", + "description": "Filter by authority address", + "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by authority address", + "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" + } + } + ] + }, + "description": "Filter by authority address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, { "in": "query", "name": "mint", "schema": { "type": "string", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", + "anyOf": [ + { + "type": "string", + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by mint address", + "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + } + } + ] }, - "required": true, - "description": "Filter by mint address" + "description": "Filter by mint address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "program_id", + "schema": { + "example": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", + "default": "", + "type": "string", + "enum": [ + "11111111111111111111111111111111", + "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", + "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" + ] + }, + "description": "Filter by SPL token program ID" + }, + { + "in": "query", + "name": "start_time", + "schema": { + "type": "string", + "default": "2020-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "end_time", + "schema": { + "type": "string", + "default": "2050-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "start_block", + "schema": { + "default": 0, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" + }, + { + "in": "query", + "name": "end_block", + "schema": { + "default": 9999999999, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" }, { "in": "query", @@ -16129,13 +19222,13 @@ ] } }, - "/v1/svm/transfers": { + "/v1/tvm/transfers": { "get": { - "operationId": "getV1SvmTransfers", + "operationId": "getV1TvmTransfers", "summary": "Token Transfers", - "description": "Returns SPL token transfers with program, authority, and account information.", + "description": "Returns ERC-20 transfers with transaction and block data.", "tags": [ - "SVM Tokens" + "TVM Tokens (ERC-20)" ], "security": [ { @@ -16165,44 +19258,34 @@ "timestamp": { "type": "number" }, - "signature": { - "type": "string" + "transaction_id": { + "type": "string", + "description": "Filter by transaction hash", + "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" }, "transaction_index": { "type": "number" }, - "instruction_index": { + "log_index": { "type": "number" }, - "program_id": { - "description": "Filter by SPL token program ID", - "example": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", - "type": "string", - "enum": [ - "11111111111111111111111111111111", - "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", - "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" - ] - }, - "mint": { - "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + "log_ordinal": { + "type": "number" }, - "authority": { + "contract": { "type": "string", - "description": "Filter by authority address", - "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" + "description": "Filter by contract address", + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" }, - "source": { + "from": { "type": "string", "description": "Filter by address", - "example": "So11111111111111111111111111111111111111112" + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" }, - "destination": { + "to": { "type": "string", "description": "Filter by address", - "example": "So11111111111111111111111111111111111111112" + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" }, "amount": { "type": "string" @@ -16210,16 +19293,6 @@ "value": { "type": "number" }, - "decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] - }, "name": { "anyOf": [ { @@ -16240,10 +19313,10 @@ } ] }, - "uri": { + "decimals": { "anyOf": [ { - "type": "string" + "type": "number" }, { "type": "null" @@ -16251,11 +19324,11 @@ ] }, "network": { - "description": "The Graph Network ID for SVM networks https://thegraph.com/networks", - "example": "solana", + "description": "The Graph Network ID for TVM networks https://thegraph.com/networks", + "example": "tron", "type": "string", "enum": [ - "solana" + "tron" ] } }, @@ -16263,20 +19336,18 @@ "block_num", "datetime", "timestamp", - "signature", + "transaction_id", "transaction_index", - "instruction_index", - "program_id", - "mint", - "authority", - "source", - "destination", + "log_index", + "log_ordinal", + "contract", + "from", + "to", "amount", "value", - "decimals", "name", "symbol", - "uri", + "decimals", "network" ] } @@ -16339,24 +19410,21 @@ "value": { "data": [ { - "block_num": 372132067, - "datetime": "2025-10-09 02:10:01", - "timestamp": 1759975801, - "signature": "2Y3YJMa7Gx96ZprnWxSQHiahGdbiNFwF1DdT4ZWGf8cwJnv4fRTcFg9Z5THuAHhja66fi6Jd8fLngtH1d8qSNj3H", - "transaction_index": 65, - "instruction_index": 0, - "program_id": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", - "mint": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", - "authority": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", - "source": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", - "destination": "64nnJ2CBUZ3VasttjVhxbQXqzbjAxnj4VT4vBrrveNV", - "amount": "835996345", - "value": 835.996345, + "block_num": 49014118, + "datetime": "2023-03-01 06:55:06", + "timestamp": 1677653706, + "transaction_id": "0xa85ee0572469b128690c00a80f03a328c882b7339496faf64a1ad0707b537329", + "log_index": 0, + "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", + "type": "transfer", + "from": "THx5jmvnQkRjDpYEpkaLn7yCvgafXzxiAF", + "to": "TCc3eBTbWXcUwfmgWP58VnyVGS6HE3gGe3", + "name": "Tether USD", + "symbol": "USDT", "decimals": 6, - "name": "Pump", - "symbol": "PUMP", - "uri": "https://ipfs.io/ipfs/bafkreibcglldkfdekdkxgumlveoe6qv3pbiceypkwtli33clbzul7leo4m", - "network": "solana" + "amount": "10000000000", + "value": 10000, + "network": "tron" } ] } @@ -16693,53 +19761,26 @@ "in": "query", "name": "network", "schema": { - "example": "solana", + "example": "tron", "type": "string", "enum": [ - "solana" + "tron" ] }, "required": true, - "description": "The Graph Network ID for SVM networks https://thegraph.com/networks" - }, - { - "in": "query", - "name": "signature", - "schema": { - "type": "string", - "example": "2Y3YJMa7Gx96ZprnWxSQHiahGdbiNFwF1DdT4ZWGf8cwJnv4fRTcFg9Z5THuAHhja66fi6Jd8fLngtH1d8qSNj3H", - "anyOf": [ - { - "type": "string", - "description": "Filter by transaction signature", - "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by transaction signature", - "example": "5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA" - } - } - ] - }, - "description": "Filter by transaction signature
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "The Graph Network ID for TVM networks https://thegraph.com/networks" }, { "in": "query", - "name": "source", + "name": "transaction_id", "schema": { "type": "string", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW", + "example": "46c608cd66c873753f7d86a3dc6b46453052505730cc5f6e951533083b1d40ab", "anyOf": [ { "type": "string", - "description": "Filter by token account address", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + "description": "Filter by transaction hash", + "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" }, { "type": "string" @@ -16748,25 +19789,25 @@ "type": "array", "items": { "type": "string", - "description": "Filter by token account address", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + "description": "Filter by transaction hash", + "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" } } ] }, - "description": "Filter by token account address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "Filter by transaction hash
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "destination", + "name": "contract", "schema": { "type": "string", - "example": "64nnJ2CBUZ3VasttjVhxbQXqzbjAxnj4VT4vBrrveNV", + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "anyOf": [ { "type": "string", - "description": "Filter by token account address", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + "description": "Filter by contract address", + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" }, { "type": "string" @@ -16775,25 +19816,25 @@ "type": "array", "items": { "type": "string", - "description": "Filter by token account address", - "example": "5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW" + "description": "Filter by contract address", + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" } } ] }, - "description": "Filter by token account address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "authority", + "name": "from_address", "schema": { "type": "string", - "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9", + "example": "TAYtGZzxZf1GhPfGwZKskWQnz7Qj3rwLDh", "anyOf": [ { "type": "string", - "description": "Filter by authority address", - "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" + "description": "Filter by address", + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" }, { "type": "string" @@ -16802,25 +19843,25 @@ "type": "array", "items": { "type": "string", - "description": "Filter by authority address", - "example": "GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9" + "description": "Filter by address", + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" } } ] }, - "description": "Filter by authority address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "mint", + "name": "to_address", "schema": { "type": "string", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn", + "example": "THWuviP5wEiPBLZ1g1iPPiH4kV7FRXWFP1", "anyOf": [ { "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + "description": "Filter by address", + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" }, { "type": "string" @@ -16829,35 +19870,20 @@ "type": "array", "items": { "type": "string", - "description": "Filter by mint address", - "example": "pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn" + "description": "Filter by address", + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" } } ] }, - "description": "Filter by mint address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "program_id", - "schema": { - "example": "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", - "default": "", - "type": "string", - "enum": [ - "11111111111111111111111111111111", - "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb", - "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" - ] - }, - "description": "Filter by SPL token program ID" + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", "name": "start_time", "schema": { "type": "string", - "default": "2020-01-01" + "default": "2015-01-01" }, "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." }, @@ -16917,13 +19943,18 @@ ] } }, - "/v1/tvm/dexes": { + "/v1/tvm/transfers/native": { "get": { - "operationId": "getV1TvmDexes", - "summary": "Supported DEXs", - "description": "Returns all supported TVM DEXs.", + "operationId": "getV1TvmTransfersNative", + "summary": "Native Transfers", + "description": "Returns Native transfers with transaction and block data.", "tags": [ - "TVM DEXs" + "TVM Tokens (Native)" + ], + "security": [ + { + "bearerAuth": [] + } ], "responses": { "200": { @@ -16938,32 +19969,69 @@ "items": { "type": "object", "properties": { - "factory": { + "block_num": { + "type": "number" + }, + "datetime": { + "type": "string", + "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + }, + "timestamp": { + "type": "number" + }, + "transaction_id": { + "type": "string", + "description": "Filter by transaction hash", + "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" + }, + "transaction_index": { + "type": "number" + }, + "from": { "type": "string", "description": "Filter by address", "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" }, - "protocol": { - "description": "Protocol name", - "example": "uniswap_v2", + "to": { "type": "string", - "enum": [ - "uniswap_v1", - "uniswap_v2", - "uniswap_v3", - "uniswap_v4", - "sunpump" - ] + "description": "Filter by address", + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" }, - "transactions": { - "type": "number" + "amount": { + "type": "string" }, - "uaw": { + "value": { "type": "number" }, - "last_activity": { - "type": "string", - "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] }, "network": { "description": "The Graph Network ID for TVM networks https://thegraph.com/networks", @@ -16975,11 +20043,18 @@ } }, "required": [ - "factory", - "protocol", - "transactions", - "uaw", - "last_activity", + "block_num", + "datetime", + "timestamp", + "transaction_id", + "transaction_index", + "from", + "to", + "amount", + "value", + "name", + "symbol", + "decimals", "network" ] } @@ -17042,11 +20117,20 @@ "value": { "data": [ { - "protocol": "uniswap_v1", - "factory": "TXk8rQSAvPvBBNtqSoY6nCfsXWCSSpTVQF", - "last_activity": "2025-12-16 05:16:18", - "transactions": 48269088, - "uaw": 2848148, + "block_num": 79432572, + "datetime": "2026-01-21 02:12:54", + "timestamp": 1768961574, + "transaction_id": "0x0909857e613151f23c51d30829de6a7ba5307cbf74de1fd67dcf67aadfbaa55a", + "transaction_index": 131, + "call_index": null, + "type": "transaction", + "from": "0x177b7305b003d1e61941c5eec3737e482a1fe947", + "to": "0xb41393b990cb28881458313d77910c6164772036", + "name": "Tron", + "symbol": "TRX", + "decimals": 6, + "amount": "5000000", + "value": 5, "network": "tron" } ] @@ -17393,6 +20477,127 @@ "required": true, "description": "The Graph Network ID for TVM networks https://thegraph.com/networks" }, + { + "in": "query", + "name": "transaction_id", + "schema": { + "type": "string", + "example": "7504152368a31f51dc0128f07b01815a4f1033c8247a7c2f415a55d59cfe4351", + "anyOf": [ + { + "type": "string", + "description": "Filter by transaction hash", + "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by transaction hash", + "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" + } + } + ] + }, + "description": "Filter by transaction hash
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "from_address", + "schema": { + "type": "string", + "example": "TAYtGZzxZf1GhPfGwZKskWQnz7Qj3rwLDh", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by address", + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" + } + } + ] + }, + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "to_address", + "schema": { + "type": "string", + "example": "TMXZAySpsog7WtaeKb8WotoHepNsD1jjTc", + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by address", + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" + } + } + ] + }, + "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + }, + { + "in": "query", + "name": "start_time", + "schema": { + "type": "string", + "default": "2015-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "end_time", + "schema": { + "type": "string", + "default": "2050-01-01" + }, + "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + }, + { + "in": "query", + "name": "start_block", + "schema": { + "default": 0, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" + }, + { + "in": "query", + "name": "end_block", + "schema": { + "default": 9999999999, + "type": "integer", + "minimum": 0, + "maximum": 9007199254740991 + }, + "description": "Filter by block number" + }, { "in": "query", "name": "limit", @@ -17418,13 +20623,13 @@ ] } }, - "/v1/tvm/pools": { + "/v1/tvm/tokens": { "get": { - "operationId": "getV1TvmPools", - "summary": "Liquidity Pools", - "description": "Returns DEX pool metadata including tokens, fees and protocol.", + "operationId": "getV1TvmTokens", + "summary": "Token Metadata", + "description": "Provides ERC-20 token contract metadata.", "tags": [ - "TVM DEXs" + "TVM Tokens (ERC-20)" ], "security": [ { @@ -17444,148 +20649,63 @@ "items": { "type": "object", "properties": { - "factory": { + "last_update": { "type": "string", - "description": "Filter by factory address", - "example": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f" + "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "pool": { - "description": "Filter by pool address", + "last_update_block_num": { + "type": "number" + }, + "last_update_timestamp": { + "type": "number" + }, + "contract": { "type": "string", - "example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", + "description": "Filter by contract address", + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" + }, + "decimals": { "anyOf": [ { - "type": "string" + "type": "number" }, { - "type": "string" + "type": "null" } ] }, - "input_token": { - "type": "object", - "properties": { - "address": { - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - }, - { - "type": "null" - } - ] - }, - "symbol": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] + "name": { + "anyOf": [ + { + "type": "string" }, - "decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] + { + "type": "null" } - }, - "required": [ - "address", - "symbol", - "decimals" ] }, - "output_token": { - "type": "object", - "properties": { - "address": { - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" - }, - { - "type": "null" - } - ] - }, - "symbol": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] + "symbol": { + "anyOf": [ + { + "type": "string" }, - "decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] - } - }, - "required": [ - "address", - "symbol", - "decimals" - ] - }, - "fee": { - "type": "number" - }, - "protocol": { - "description": "Protocol name", - "example": "uniswap_v3", - "type": "string", - "enum": [ - "uniswap_v1", - "uniswap_v2", - "uniswap_v3", - "uniswap_v4", - "bancor", - "curvefi", - "balancer" + { + "type": "null" + } ] }, "network": { - "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", - "example": "mainnet", - "type": "string", - "enum": [ - "arbitrum-one", - "avalanche", - "base", - "bsc", - "mainnet", - "optimism", - "polygon", - "unichain" - ] + "type": "string" } }, "required": [ - "factory", - "pool", - "input_token", - "output_token", - "fee", - "protocol", + "last_update", + "last_update_block_num", + "last_update_timestamp", + "contract", + "decimals", + "name", + "symbol", "network" ] } @@ -17648,20 +20768,13 @@ "value": { "data": [ { - "pool": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE", - "factory": "TXk8rQSAvPvBBNtqSoY6nCfsXWCSSpTVQF", - "protocol": "uniswap_v1", - "input_token": { - "address": "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb", - "symbol": "TRX", - "decimals": 6 - }, - "output_token": { - "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", - "symbol": "USDT", - "decimals": 6 - }, - "fee": 3000, + "last_update": "2026-01-25 14:47:15", + "last_update_block_num": 79562822, + "last_update_timestamp": 1769352435, + "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", + "name": "Tether USD", + "symbol": "USDT", + "decimals": 6, "network": "tron" } ] @@ -18010,161 +21123,24 @@ }, { "in": "query", - "name": "factory", - "schema": { - "type": "string", - "example": "TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY", - "anyOf": [ - { - "type": "string", - "description": "Filter by factory address", - "example": "TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by factory address", - "example": "TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY" - } - } - ] - }, - "description": "Filter by factory address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "pool", - "schema": { - "type": "string", - "example": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ", - "anyOf": [ - { - "type": "string", - "description": "Filter by pool address", - "example": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by pool address", - "example": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ" - } - } - ] - }, - "description": "Filter by pool address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "input_token", - "schema": { - "type": "string", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", - "anyOf": [ - { - "type": "string", - "description": "Filter by contract address", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by contract address", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" - } - } - ] - }, - "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "output_token", - "schema": { - "type": "string", - "example": "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR", - "anyOf": [ - { - "type": "string", - "description": "Filter by contract address", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by contract address", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" - } - } - ] - }, - "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "protocol", + "name": "contract", "schema": { - "example": "uniswap_v2", - "default": "", "type": "string", - "enum": [ - "uniswap_v1", - "uniswap_v2", - "uniswap_v3", - "uniswap_v4", - "sunpump" - ] - }, - "description": "Protocol name" - }, - { - "in": "query", - "name": "limit", - "schema": { - "default": 10, - "type": "integer", - "minimum": 1, - "maximum": 1000 - }, - "description": "Number of items* returned in a single request.
*Plan restricted." - }, - { - "in": "query", - "name": "page", - "schema": { - "default": 1, - "type": "integer", - "minimum": 1, - "maximum": 767465558638 + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" }, - "description": "Page number to fetch.
Empty `data` array signifies end of results." + "required": true, + "description": "Filter by contract address" } ] } }, - "/v1/tvm/pools/ohlc": { + "/v1/tvm/tokens/native": { "get": { - "operationId": "getV1TvmPoolsOhlc", - "summary": "Pool OHLCV", - "description": "Returns OHLCV price data for liquidity pools.\n\nOHLCV historical depth is subject to plan restrictions.", + "operationId": "getV1TvmTokensNative", + "summary": "Native Metadata", + "description": "Provides Native metadata.", "tags": [ - "TVM DEXs" + "TVM Tokens (Native)" ], "security": [ { @@ -18184,59 +21160,57 @@ "items": { "type": "object", "properties": { - "datetime": { + "last_update": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "ticker": { - "type": "string" - }, - "pool": { - "type": "string", - "description": "Filter by pool address", - "example": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ" - }, - "open": { - "type": "number" - }, - "high": { - "type": "number" - }, - "low": { - "type": "number" - }, - "close": { + "last_update_block_num": { "type": "number" }, - "volume": { + "last_update_timestamp": { "type": "number" }, - "uaw": { - "type": "number" + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] }, - "transactions": { - "type": "number" + "name": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] }, - "network": { - "description": "The Graph Network ID for TVM networks https://thegraph.com/networks", - "example": "tron", - "type": "string", - "enum": [ - "tron" + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } ] + }, + "network": { + "type": "string" } }, "required": [ - "datetime", - "ticker", - "pool", - "open", - "high", - "low", - "close", - "volume", - "uaw", - "transactions", + "last_update", + "last_update_block_num", + "last_update_timestamp", + "decimals", + "name", + "symbol", "network" ] } @@ -18299,16 +21273,12 @@ "value": { "data": [ { - "datetime": "2025-11-05 00:00:00", - "ticker": "WTRXUSDT", - "pool": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ", - "open": 0.2858162052159799, - "high": 0.2880636266155062, - "low": 0.28099080983643465, - "close": 0.2880636266155062, - "volume": 15584135805763, - "uaw": 10, - "transactions": 102081, + "last_update": "2026-01-25 14:51:18", + "last_update_block_num": 79562903, + "last_update_timestamp": 1769352678, + "name": "Tron", + "symbol": "TRX", + "decimals": 6, "network": "tron" } ] @@ -18654,71 +21624,6 @@ }, "required": true, "description": "The Graph Network ID for TVM networks https://thegraph.com/networks" - }, - { - "in": "query", - "name": "pool", - "schema": { - "type": "string", - "example": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ" - }, - "required": true, - "description": "Filter by pool address" - }, - { - "in": "query", - "name": "interval", - "schema": { - "type": "string", - "enum": [ - "1h", - "4h", - "1d", - "1w" - ], - "default": "1d" - }, - "description": "The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).
*Plan restricted." - }, - { - "in": "query", - "name": "start_time", - "schema": { - "type": "string", - "default": "2025-12-08" - }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." - }, - { - "in": "query", - "name": "end_time", - "schema": { - "type": "string", - "default": "2050-01-01" - }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." - }, - { - "in": "query", - "name": "limit", - "schema": { - "default": 10, - "type": "integer", - "minimum": 1, - "maximum": 1000 - }, - "description": "Number of items* returned in a single request.
*Plan restricted." - }, - { - "in": "query", - "name": "page", - "schema": { - "default": 1, - "type": "integer", - "minimum": 1, - "maximum": 767465558638 - }, - "description": "Page number to fetch.
Empty `data` array signifies end of results." } ] } @@ -19632,18 +22537,13 @@ ] } }, - "/v1/tvm/tokens": { + "/v1/tvm/dexes": { "get": { - "operationId": "getV1TvmTokens", - "summary": "Token Metadata", - "description": "Provides TVM token contract metadata.", + "operationId": "getV1TvmDexes", + "summary": "Supported DEXs", + "description": "Returns all supported TVM DEXs.", "tags": [ - "TVM Tokens" - ], - "security": [ - { - "bearerAuth": [] - } + "TVM DEXs" ], "responses": { "200": { @@ -19658,63 +22558,48 @@ "items": { "type": "object", "properties": { - "last_update": { + "factory": { "type": "string", - "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" + "description": "Filter by address", + "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" }, - "last_update_block_num": { + "protocol": { + "description": "Protocol name", + "example": "uniswap_v2", + "type": "string", + "enum": [ + "uniswap_v1", + "uniswap_v2", + "uniswap_v3", + "uniswap_v4", + "sunpump" + ] + }, + "transactions": { "type": "number" }, - "last_update_timestamp": { + "uaw": { "type": "number" }, - "contract": { + "last_activity": { "type": "string", - "description": "Filter by contract address", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" - }, - "decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] - }, - "name": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "symbol": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] + "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, "network": { - "type": "string" + "description": "The Graph Network ID for TVM networks https://thegraph.com/networks", + "example": "tron", + "type": "string", + "enum": [ + "tron" + ] } }, "required": [ - "last_update", - "last_update_block_num", - "last_update_timestamp", - "contract", - "decimals", - "name", - "symbol", + "factory", + "protocol", + "transactions", + "uaw", + "last_activity", "network" ] } @@ -19777,13 +22662,11 @@ "value": { "data": [ { - "last_update": "2025-11-05 14:57:51", - "last_update_block_num": 77231165, - "last_update_timestamp": 1762354671, - "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", - "decimals": 6, - "name": "Tether USD", - "symbol": "USDT", + "protocol": "uniswap_v1", + "factory": "TXk8rQSAvPvBBNtqSoY6nCfsXWCSSpTVQF", + "last_activity": "2025-12-16 05:16:18", + "transactions": 48269088, + "uaw": 2848148, "network": "tron" } ] @@ -20130,16 +23013,6 @@ "required": true, "description": "The Graph Network ID for TVM networks https://thegraph.com/networks" }, - { - "in": "query", - "name": "contract", - "schema": { - "type": "string", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" - }, - "required": true, - "description": "Filter by contract address" - }, { "in": "query", "name": "limit", @@ -20165,13 +23038,13 @@ ] } }, - "/v1/tvm/transfers": { + "/v1/tvm/pools": { "get": { - "operationId": "getV1TvmTransfers", - "summary": "TRC-20 Transfers", - "description": "Returns TRC-20 transfers with transaction and block data.", + "operationId": "getV1TvmPools", + "summary": "Liquidity Pools", + "description": "Returns DEX pool metadata including tokens, fees and protocol.", "tags": [ - "TVM Tokens" + "TVM DEXs" ], "security": [ { @@ -20191,106 +23064,148 @@ "items": { "type": "object", "properties": { - "block_num": { - "type": "number" - }, - "datetime": { - "type": "string", - "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" - }, - "timestamp": { - "type": "number" - }, - "transaction_id": { - "type": "string", - "description": "Filter by transaction hash", - "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" - }, - "transaction_index": { - "type": "number" - }, - "log_index": { - "type": "number" - }, - "log_ordinal": { - "type": "number" - }, - "contract": { - "type": "string", - "description": "Filter by contract address", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" - }, - "from": { - "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" - }, - "to": { - "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" - }, - "amount": { - "type": "string" - }, - "value": { - "type": "number" + "factory": { + "type": "string", + "description": "Filter by factory address", + "example": "0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f" }, - "name": { + "pool": { + "description": "Filter by pool address", + "type": "string", + "example": "0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640", "anyOf": [ { "type": "string" }, { - "type": "null" + "type": "string" } ] }, - "symbol": { - "anyOf": [ - { - "type": "string" + "input_token": { + "type": "object", + "properties": { + "address": { + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "null" + } + ] }, - { - "type": "null" + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] } + }, + "required": [ + "address", + "symbol", + "decimals" ] }, - "decimals": { - "anyOf": [ - { - "type": "number" + "output_token": { + "type": "object", + "properties": { + "address": { + "anyOf": [ + { + "type": "string", + "description": "Filter by address", + "example": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045" + }, + { + "type": "null" + } + ] }, - { - "type": "null" + "symbol": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "decimals": { + "anyOf": [ + { + "type": "number" + }, + { + "type": "null" + } + ] } + }, + "required": [ + "address", + "symbol", + "decimals" + ] + }, + "fee": { + "type": "number" + }, + "protocol": { + "description": "Protocol name", + "example": "uniswap_v3", + "type": "string", + "enum": [ + "uniswap_v1", + "uniswap_v2", + "uniswap_v3", + "uniswap_v4", + "bancor", + "curvefi", + "balancer" ] }, "network": { - "description": "The Graph Network ID for TVM networks https://thegraph.com/networks", - "example": "tron", + "description": "The Graph Network ID for EVM networks https://thegraph.com/networks", + "example": "mainnet", "type": "string", "enum": [ - "tron" + "arbitrum-one", + "avalanche", + "base", + "bsc", + "mainnet", + "optimism", + "polygon", + "unichain" ] } }, "required": [ - "block_num", - "datetime", - "timestamp", - "transaction_id", - "transaction_index", - "log_index", - "log_ordinal", - "contract", - "from", - "to", - "amount", - "value", - "name", - "symbol", - "decimals", + "factory", + "pool", + "input_token", + "output_token", + "fee", + "protocol", "network" ] } @@ -20353,21 +23268,20 @@ "value": { "data": [ { - "block_num": 77231165, - "datetime": "2025-11-05 14:57:51", - "timestamp": 1762354671, - "transaction_id": "46c608cd66c873753f7d86a3dc6b46453052505730cc5f6e951533083b1d40ab", - "transaction_index": 273, - "log_index": 0, - "log_ordinal": 1020, - "contract": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", - "from": "TAYtGZzxZf1GhPfGwZKskWQnz7Qj3rwLDh", - "to": "THWuviP5wEiPBLZ1g1iPPiH4kV7FRXWFP1", - "amount": "19600000000", - "value": 19600, - "name": "Tether USD", - "symbol": "USDT", - "decimals": 6, + "pool": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE", + "factory": "TXk8rQSAvPvBBNtqSoY6nCfsXWCSSpTVQF", + "protocol": "uniswap_v1", + "input_token": { + "address": "T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb", + "symbol": "TRX", + "decimals": 6 + }, + "output_token": { + "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", + "symbol": "USDT", + "decimals": 6 + }, + "fee": 3000, "network": "tron" } ] @@ -20716,42 +23630,15 @@ }, { "in": "query", - "name": "transaction_id", - "schema": { - "type": "string", - "example": "46c608cd66c873753f7d86a3dc6b46453052505730cc5f6e951533083b1d40ab", - "anyOf": [ - { - "type": "string", - "description": "Filter by transaction hash", - "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by transaction hash", - "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" - } - } - ] - }, - "description": "Filter by transaction hash
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "contract", + "name": "factory", "schema": { "type": "string", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", + "example": "TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY", "anyOf": [ { "type": "string", - "description": "Filter by contract address", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" + "description": "Filter by factory address", + "example": "TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY" }, { "type": "string" @@ -20760,25 +23647,25 @@ "type": "array", "items": { "type": "string", - "description": "Filter by contract address", - "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" + "description": "Filter by factory address", + "example": "TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY" } } ] }, - "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "Filter by factory address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "from_address", + "name": "pool", "schema": { "type": "string", - "example": "TAYtGZzxZf1GhPfGwZKskWQnz7Qj3rwLDh", + "example": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ", "anyOf": [ { "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" + "description": "Filter by pool address", + "example": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ" }, { "type": "string" @@ -20787,25 +23674,25 @@ "type": "array", "items": { "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" + "description": "Filter by pool address", + "example": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ" } } ] }, - "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "Filter by pool address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "to_address", + "name": "input_token", "schema": { "type": "string", - "example": "THWuviP5wEiPBLZ1g1iPPiH4kV7FRXWFP1", + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t", "anyOf": [ { "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" + "description": "Filter by contract address", + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" }, { "type": "string" @@ -20814,53 +23701,57 @@ "type": "array", "items": { "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" + "description": "Filter by contract address", + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" } } ] }, - "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "start_time", - "schema": { - "type": "string", - "default": "2015-01-01" - }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." - }, - { - "in": "query", - "name": "end_time", - "schema": { - "type": "string", - "default": "2050-01-01" - }, - "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." + "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "start_block", + "name": "output_token", "schema": { - "default": 0, - "type": "integer", - "minimum": 0, - "maximum": 9007199254740991 + "type": "string", + "example": "TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR", + "anyOf": [ + { + "type": "string", + "description": "Filter by contract address", + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" + }, + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string", + "description": "Filter by contract address", + "example": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t" + } + } + ] }, - "description": "Filter by block number" + "description": "Filter by contract address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." }, { "in": "query", - "name": "end_block", + "name": "protocol", "schema": { - "default": 9999999999, - "type": "integer", - "minimum": 0, - "maximum": 9007199254740991 + "example": "uniswap_v2", + "default": "", + "type": "string", + "enum": [ + "uniswap_v1", + "uniswap_v2", + "uniswap_v3", + "uniswap_v4", + "sunpump" + ] }, - "description": "Filter by block number" + "description": "Protocol name" }, { "in": "query", @@ -20887,13 +23778,13 @@ ] } }, - "/v1/tvm/transfers/native": { + "/v1/tvm/pools/ohlc": { "get": { - "operationId": "getV1TvmTransfersNative", - "summary": "Native Transfers", - "description": "Returns Native transfers with transaction and block data.", + "operationId": "getV1TvmPoolsOhlc", + "summary": "Pool OHLCV", + "description": "Returns OHLCV price data for liquidity pools.\n\nOHLCV historical depth is subject to plan restrictions.", "tags": [ - "TVM Tokens" + "TVM DEXs" ], "security": [ { @@ -20913,69 +23804,38 @@ "items": { "type": "object", "properties": { - "block_num": { - "type": "number" - }, "datetime": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$" }, - "timestamp": { - "type": "number" + "ticker": { + "type": "string" }, - "transaction_id": { + "pool": { "type": "string", - "description": "Filter by transaction hash", - "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" + "description": "Filter by pool address", + "example": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ" }, - "transaction_index": { + "open": { "type": "number" }, - "from": { - "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" - }, - "to": { - "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" + "high": { + "type": "number" }, - "amount": { - "type": "string" + "low": { + "type": "number" }, - "value": { + "close": { "type": "number" }, - "name": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] + "volume": { + "type": "number" }, - "symbol": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] + "uaw": { + "type": "number" }, - "decimals": { - "anyOf": [ - { - "type": "number" - }, - { - "type": "null" - } - ] + "transactions": { + "type": "number" }, "network": { "description": "The Graph Network ID for TVM networks https://thegraph.com/networks", @@ -20987,18 +23847,16 @@ } }, "required": [ - "block_num", "datetime", - "timestamp", - "transaction_id", - "transaction_index", - "from", - "to", - "amount", - "value", - "name", - "symbol", - "decimals", + "ticker", + "pool", + "open", + "high", + "low", + "close", + "volume", + "uaw", + "transactions", "network" ] } @@ -21061,18 +23919,16 @@ "value": { "data": [ { - "block_num": 77231160, - "datetime": "2025-11-05 14:57:36", - "timestamp": 1762354656, - "transaction_id": "7504152368a31f51dc0128f07b01815a4f1033c8247a7c2f415a55d59cfe4351", - "transaction_index": 260, - "from": "TAYtGZzxZf1GhPfGwZKskWQnz7Qj3rwLDh", - "to": "TMXZAySpsog7WtaeKb8WotoHepNsD1jjTc", - "amount": "4821375", - "value": 4.821375, - "name": "Tron", - "symbol": "TRX", - "decimals": 6, + "datetime": "2025-11-05 00:00:00", + "ticker": "WTRXUSDT", + "pool": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ", + "open": 0.2858162052159799, + "high": 0.2880636266155062, + "low": 0.28099080983643465, + "close": 0.2880636266155062, + "volume": 15584135805763, + "uaw": 10, + "transactions": 102081, "network": "tron" } ] @@ -21421,84 +24277,28 @@ }, { "in": "query", - "name": "transaction_id", - "schema": { - "type": "string", - "example": "7504152368a31f51dc0128f07b01815a4f1033c8247a7c2f415a55d59cfe4351", - "anyOf": [ - { - "type": "string", - "description": "Filter by transaction hash", - "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by transaction hash", - "example": "daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a" - } - } - ] - }, - "description": "Filter by transaction hash
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." - }, - { - "in": "query", - "name": "from_address", + "name": "pool", "schema": { "type": "string", - "example": "TAYtGZzxZf1GhPfGwZKskWQnz7Qj3rwLDh", - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" - } - } - ] + "example": "TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ" }, - "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "required": true, + "description": "Filter by pool address" }, { "in": "query", - "name": "to_address", + "name": "interval", "schema": { "type": "string", - "example": "TMXZAySpsog7WtaeKb8WotoHepNsD1jjTc", - "anyOf": [ - { - "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" - }, - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string", - "description": "Filter by address", - "example": "TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX" - } - } - ] + "enum": [ + "1h", + "4h", + "1d", + "1w" + ], + "default": "1d" }, - "description": "Filter by address
Single value or array of values* (separate multiple values with `,`)
*Plan restricted." + "description": "The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).
*Plan restricted." }, { "in": "query", @@ -21518,28 +24318,6 @@ }, "description": "UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)." }, - { - "in": "query", - "name": "start_block", - "schema": { - "default": 0, - "type": "integer", - "minimum": 0, - "maximum": 9007199254740991 - }, - "description": "Filter by block number" - }, - { - "in": "query", - "name": "end_block", - "schema": { - "default": 9999999999, - "type": "integer", - "minimum": 0, - "maximum": 9007199254740991 - }, - "description": "Filter by block number" - }, { "in": "query", "name": "limit", @@ -22113,9 +24891,9 @@ "examples": { "example": { "value": { - "version": "3.7.2", - "commit": "8e84108", - "date": "2026-01-07", + "version": "3.8.0", + "commit": "bbff1ca", + "date": "2026-01-29", "repo": "pinax-network/token-api" } } diff --git a/website/src/pages/en/token-api/_meta-titles.json b/website/src/pages/en/token-api/_meta-titles.json index f4eee8a07f29..a71b862d739e 100644 --- a/website/src/pages/en/token-api/_meta-titles.json +++ b/website/src/pages/en/token-api/_meta-titles.json @@ -1,10 +1,13 @@ { - "evm-tokens": "EVM Token Endpoints", - "evm-dexs": "EVM DEX Endpoints", - "evm-nfts": "EVM NFT Endpoints", "svm-tokens": "SVM Token Endpoints", + "svm-tokens-native": "SVM Token Endpoints (Native)", "svm-dexs": "SVM DEX Endpoints", - "tvm-tokens": "TVM Token Endpoints", + "evm-tokens": "EVM Token Endpoints (ERC-20)", + "evm-tokens-native": "EVM Token Endpoints (Native)", + "evm-dexs": "EVM DEX Endpoints", + "evm-nfts": "EVM NFT Endpoints", + "tvm-tokens": "TVM Token Endpoints (ERC-20)", + "tvm-tokens-native": "TVM Token Endpoints (Native)", "tvm-dexs": "TVM DEX Endpoints", "monitoring": "Monitoring Endpoints", "endpoints": "Endpoints", diff --git a/website/src/pages/en/token-api/_meta.js b/website/src/pages/en/token-api/_meta.js index e9f3ca1f8b16..f52d00b61712 100644 --- a/website/src/pages/en/token-api/_meta.js +++ b/website/src/pages/en/token-api/_meta.js @@ -3,11 +3,14 @@ import titles from './_meta-titles.json' export default { 'quick-start': '', 'svm-tokens': titles['svm-tokens'] ?? '', + 'svm-tokens-native': titles['svm-tokens-native'] ?? '', 'svm-dexs': titles['svm-dexs'] ?? '', 'evm-tokens': titles['evm-tokens'] ?? '', + 'evm-tokens-native': titles['evm-tokens-native'] ?? '', 'evm-dexs': titles['evm-dexs'] ?? '', 'evm-nfts': titles['evm-nfts'] ?? '', 'tvm-tokens': titles['tvm-tokens'] ?? '', + 'tvm-tokens-native': titles['tvm-tokens-native'] ?? '', 'tvm-dexs': titles['tvm-dexs'] ?? '', monitoring: titles['monitoring'] ?? '', endpoints: titles['endpoints'] ?? '', diff --git a/website/src/pages/en/token-api/endpoints/pricing.mdx b/website/src/pages/en/token-api/endpoints/pricing.mdx index 77636d4180d7..e8d3bb972bca 100644 --- a/website/src/pages/en/token-api/endpoints/pricing.mdx +++ b/website/src/pages/en/token-api/endpoints/pricing.mdx @@ -33,9 +33,12 @@ 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/tokens/native +GET /v1/tvm/tokens/native GET /v1/evm/transfers GET /v1/svm/transfers GET /v1/tvm/transfers +GET /v1/evm/transfers/native GET /v1/tvm/transfers/native GET /v1/evm/balances GET /v1/svm/balances @@ -76,11 +79,13 @@ Provide summarized, ranked, and time-series blockchain data for analytical use ``` GET /v1/evm/holders GET /v1/svm/holders +GET /v1/evm/holders/native 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 +GET /v1/evm/balances/historical/native ``` ## Monitoring Endpoints - Free diff --git a/website/src/pages/en/token-api/evm-tokens-native/_meta.js b/website/src/pages/en/token-api/evm-tokens-native/_meta.js new file mode 100644 index 000000000000..39a6cee60e64 --- /dev/null +++ b/website/src/pages/en/token-api/evm-tokens-native/_meta.js @@ -0,0 +1,7 @@ +export default { + 'tokens-native': '', + 'transfers-native': '', + 'holders-native': '', + 'balances-native': '', + 'balances-historical-native': '', +} diff --git a/website/src/pages/en/token-api/evm-tokens-native/balances-historical-native.mdx b/website/src/pages/en/token-api/evm-tokens-native/balances-historical-native.mdx new file mode 100644 index 000000000000..9f96a0a4fb51 --- /dev/null +++ b/website/src/pages/en/token-api/evm-tokens-native/balances-historical-native.mdx @@ -0,0 +1,11 @@ +--- +title: Historical Native Balances +template: + type: openApi + apiId: tokenApi + operationId: getV1EvmBalancesHistoricalNative +--- + +Returns wallet Native balance changes over time in OHLCV format. + +OHLCV historical depth is subject to plan restrictions. diff --git a/website/src/pages/en/token-api/evm-tokens/balances-native.mdx b/website/src/pages/en/token-api/evm-tokens-native/balances-native.mdx similarity index 100% rename from website/src/pages/en/token-api/evm-tokens/balances-native.mdx rename to website/src/pages/en/token-api/evm-tokens-native/balances-native.mdx diff --git a/website/src/pages/en/token-api/evm-tokens-native/holders-native.mdx b/website/src/pages/en/token-api/evm-tokens-native/holders-native.mdx new file mode 100644 index 000000000000..cb52af1d7cd9 --- /dev/null +++ b/website/src/pages/en/token-api/evm-tokens-native/holders-native.mdx @@ -0,0 +1,9 @@ +--- +title: Native Holders +template: + type: openApi + apiId: tokenApi + operationId: getV1EvmHoldersNative +--- + +Returns top token holders ranked by Native balance. diff --git a/website/src/pages/en/token-api/evm-tokens-native/tokens-native.mdx b/website/src/pages/en/token-api/evm-tokens-native/tokens-native.mdx new file mode 100644 index 000000000000..30964e7458ad --- /dev/null +++ b/website/src/pages/en/token-api/evm-tokens-native/tokens-native.mdx @@ -0,0 +1,9 @@ +--- +title: Native Metadata +template: + type: openApi + apiId: tokenApi + operationId: getV1EvmTokensNative +--- + +Returns Native metadata including supply and holder count. diff --git a/website/src/pages/en/token-api/evm-tokens-native/transfers-native.mdx b/website/src/pages/en/token-api/evm-tokens-native/transfers-native.mdx new file mode 100644 index 000000000000..c59e2d3f6355 --- /dev/null +++ b/website/src/pages/en/token-api/evm-tokens-native/transfers-native.mdx @@ -0,0 +1,9 @@ +--- +title: Native Transfers +template: + type: openApi + apiId: tokenApi + operationId: getV1EvmTransfersNative +--- + +Returns Native transfers with transaction and block data. 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 a350a8e8b23f..14eed3bf8a84 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,7 @@ export default { + tokens: '', transfers: '', holders: '', - tokens: '', balances: '', - 'balances-native': '', 'balances-historical': '', } diff --git a/website/src/pages/en/token-api/guides/_meta-titles.json b/website/src/pages/en/token-api/guides/_meta-titles.json deleted file mode 100644 index 31dc2ecb665f..000000000000 --- a/website/src/pages/en/token-api/guides/_meta-titles.json +++ /dev/null @@ -1,3 +0,0 @@ -{ - "gpt": "Create Custom GPTS" -} diff --git a/website/src/pages/en/token-api/svm-tokens-native/_meta.js b/website/src/pages/en/token-api/svm-tokens-native/_meta.js new file mode 100644 index 000000000000..c409ed0aa5c9 --- /dev/null +++ b/website/src/pages/en/token-api/svm-tokens-native/_meta.js @@ -0,0 +1,3 @@ +export default { + 'balances-native': '', +} diff --git a/website/src/pages/en/token-api/svm-tokens/balances-native.mdx b/website/src/pages/en/token-api/svm-tokens-native/balances-native.mdx similarity index 100% rename from website/src/pages/en/token-api/svm-tokens/balances-native.mdx rename to website/src/pages/en/token-api/svm-tokens-native/balances-native.mdx 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 001e2d43341a..e0581d18315a 100644 --- a/website/src/pages/en/token-api/svm-tokens/_meta.js +++ b/website/src/pages/en/token-api/svm-tokens/_meta.js @@ -1,8 +1,7 @@ export default { - transfers: '', tokens: '', - balances: '', - 'balances-native': '', + transfers: '', holders: '', + balances: '', owner: '', } diff --git a/website/src/pages/en/token-api/tvm-tokens-native/_meta.js b/website/src/pages/en/token-api/tvm-tokens-native/_meta.js new file mode 100644 index 000000000000..da61d9d7b744 --- /dev/null +++ b/website/src/pages/en/token-api/tvm-tokens-native/_meta.js @@ -0,0 +1,4 @@ +export default { + 'tokens-native': '', + 'transfers-native': '', +} diff --git a/website/src/pages/en/token-api/tvm-tokens-native/tokens-native.mdx b/website/src/pages/en/token-api/tvm-tokens-native/tokens-native.mdx new file mode 100644 index 000000000000..0ffe966b0974 --- /dev/null +++ b/website/src/pages/en/token-api/tvm-tokens-native/tokens-native.mdx @@ -0,0 +1,9 @@ +--- +title: Native Metadata +template: + type: openApi + apiId: tokenApi + operationId: getV1TvmTokensNative +--- + +Provides Native metadata. diff --git a/website/src/pages/en/token-api/tvm-tokens/transfers-native.mdx b/website/src/pages/en/token-api/tvm-tokens-native/transfers-native.mdx similarity index 100% rename from website/src/pages/en/token-api/tvm-tokens/transfers-native.mdx rename to website/src/pages/en/token-api/tvm-tokens-native/transfers-native.mdx diff --git a/website/src/pages/en/token-api/tvm-tokens/_meta.js b/website/src/pages/en/token-api/tvm-tokens/_meta.js index 9bf85775e9f9..f873e98bea0e 100644 --- a/website/src/pages/en/token-api/tvm-tokens/_meta.js +++ b/website/src/pages/en/token-api/tvm-tokens/_meta.js @@ -1,5 +1,4 @@ export default { tokens: '', - 'transfers-native': '', transfers: '', }