{"uid":"cap_Dto3sN4ZYdIeGj9V7GKbl","slug":"graphadvocate-com-278d9aef","name":"GraphAdvocate /route — Plain-English to GraphQL/REST Onchain Data Router","description":"Onchain data router for AI agents. Plain-English → working GraphQL or REST. 15.5K+ subgraphs on 8 chains. Uniswap, Aave, Compound, ENS, Polymarket, Limitless, Predict.fun, ERC-8004 discovery. Identified senders (include `sender` wallet in A2A metadata): 3 free /route /day, then $0.01 USDC via x402 on Base. Anonymous senders pay $0.01 from call 1. /polymarket + /hyperliquid trader-intel paid from call 1 ($0.01-$0.10).","url":"https://graphadvocate.com/route","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"request":{"type":"string","description":"Plain-English onchain data question"}}},"responseSchema":{"type":"json","example":{"reason":"wallet balance query on an EVM chain","confidence":"high","query_ready":{"args":{"address":"0x...","network":"base"},"tool":"getV1EvmBalances"},"alternatives":[],"recommendation":"token-api"}},"example":{"request":{"request":"What are the top 10 Uniswap v3 pools by total value locked on Ethereum?"},"response":{"reason":"The Uniswap V3 Ethereum subgraph (5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV) is the best match — 25M+ queries in the last 30 days, 0.98 reliability score, 6 active indexers. The Pool entity has totalValueLockedUSD which can be sorted directly.","feedback":{"url":"https://graphadvocate.com/feedback","method":"POST","example":{"comment":"(optional) any notes","request":"What are the top 10 Uniswap v3 pools by total value locked on Ethereum?","agent_id":"<your wallet or agent name>","was_useful":true,"actual_result":"success or error message","tool_executed":"execute_query_by_subgraph_id","service_recommended":"subgraph-registry"},"instructions":"After trying the recommendation, POST a thumbs-up/down so Graph Advocate learns."},"confidence":"high","get_started":"Free API key: https://thegraph.com/studio/ — 100K queries/month, 2 min signup. Replace YOUR_API_KEY in the curl above and you're live.","query_ready":{"args":{"gql":"{\n  _meta { block { number timestamp } } pools(first: 10, orderBy: totalValueLockedUSD, orderDirection: desc) { id token0 { symbol name id } token1 { symbol name id } feeTier totalValueLockedUSD totalValueLockedETH volumeUSD feesUSD txCount } }","subgraph_id":"5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV"},"tool":"execute_query_by_subgraph_id"},"alternatives":[{"reason":"Token API's getV1EvmPools endpoint can also return Uniswap V3 pool data with TVL, but the subgraph gives you richer pool-level fields (feeTier, txCount, collected fees) in a single query.","service":"token-api","confidence":"medium"}],"curl_example":"curl -X POST 'https://gateway.thegraph.com/api/subgraphs/id/5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV' \\\n  -H 'Content-Type: application/json' \\\n  -H 'Authorization: Bearer YOUR_API_KEY' \\\n  -d '{\"query\": \"{ pools(first: 10, orderBy: totalValueLockedUSD, orderDirection: desc) { id token0 { symbol name } token1 { symbol name } feeTier totalValueLockedUSD totalValueLockedETH volumeUSD feesUSD txCount } }\"}'","recommendation":"subgraph-registry","promoted_skills":[{"for":"Score any Polymarket trader (sharp/retail) in one call before mirroring or fading","service":"polymarket-token-api","endpoint":"POST https://graphadvocate.com/polymarket/pnl-quick","price_usd":0.01},{"for":"Ghost-fill counterparty risk via on-chain wallet-type detection (deposit wallet vs legacy EOA)","service":"polymarket-token-api","endpoint":"POST https://graphadvocate.com/polymarket/risk","price_usd":0.02},{"for":"Top-N market holders with skill scores + ghost-fill risk per holder (size-the-room pre-trade)","service":"polymarket-token-api","endpoint":"POST https://graphadvocate.com/polymarket/screen","price_usd":0.02},{"for":"Score any Hyperliquid perps trader (skill, liquidation rate, funding burn) before mirroring or fading","service":"hyperliquid-token-api","endpoint":"POST https://graphadvocate.com/hyperliquid/score","price_usd":0.02},{"for":"Hyperliquid vault evaluator: leader skill + redemption pressure + commission. No equivalent on Hypurrscan/Hyperdash","service":"hyperliquid-token-api","endpoint":"POST https://graphadvocate.com/hyperliquid/vault","price_usd":0.1},{"for":"Top traders of any Hyperliquid coin (BTC/ETH/SOL/etc.) ranked by skill — pre-trade for perps market-makers","service":"hyperliquid-token-api","endpoint":"POST https://graphadvocate.com/hyperliquid/screen","price_usd":0.05}],"execution_result":{"data":{"data":{"_meta":{"block":{"number":25342174,"timestamp":1781758271}},"pools":[{"id":"0x277667eb3e34f134adf870be9550e9f323d0dc24","token0":{"id":"0x160de4468586b6b2f8a92feb0c260fc6cfc743b1","name":"Ease Fun Token","symbol":"ease.org"},"token1":{"id":"0xea5edef1c6ed1be1bcba4617a1c5a994e9018a43","name":"cvxsteCRV Ease Vault","symbol":"ez-cvxsteCRV"},"feeTier":"100","feesUSD":"0","txCount":"4","volumeUSD":"0","totalValueLockedETH":"834419413.0127326409251168468344917","totalValueLockedUSD":"1110167010695.785900004139211677005"},{"id":"0x8c0411f2ad5470a66cb2e9c64536cfb8dcd54d51","token0":{"id":"0x160de4468586b6b2f8a92feb0c260fc6cfc743b1","name":"Ease Fun Token","symbol":"ease.org"},"token1":{"id":"0xea5edef1fcf717327440646e7302ca058dde844f","name":"yvCurve-IronBank Ease Vault","symbol":"ez-yvCurve-IronBank"},"feeTier":"100","feesUSD":"0","txCount":"3","volumeUSD":"0","totalValueLockedETH":"1083228.800687387627621293623129844","totalValueLockedUSD":"1432077483.208630196467118329099649"},{"id":"0x055284a4ca6532ecc219ac06b577d540c686669d","token0":{"id":"0x160de4468586b6b2f8a92feb0c260fc6cfc743b1","name":"Ease Fun Token","symbol":"ease.org"},"token1":{"id":"0xea5edef10f8255cd03541e8ff163a2836e0d7bd3","name":"WBTC-WETH SLP Ease Vault","symbol":"ez-SLP-WBTC-WETH"},"feeTier":"100","feesUSD":"0","txCount":"2","volumeUSD":"0","totalValueLockedETH":"999904.1667228817098887900783950108","totalValueLockedUSD":"1322031013.848042060988788389158996"},{"id":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","token0":{"id":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","name":"USD Coin","symbol":"USDC"},"token1":{"id":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","name":"Wrapped Ether","symbol":"WETH"},"feeTier":"500","feesUSD":"299402968.6827468427596333412240388","txCount":"11621263","volumeUSD":"598805937365.4936855192666824480257","totalValueLockedETH":"199271.0205302822035879200237242167","totalValueLockedUSD":"345560416.9985847908240265900397868"},{"id":"0x8ad599c3a0ff1de082011efddc58f1908eb6e6d8","token0":{"id":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","name":"USD Coin","symbol":"USDC"},"token1":{"id":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","name":"Wrapped Ether","symbol":"WETH"},"feeTier":"3000","feesUSD":"266822199.0697171271599494164384594","txCount":"1167943","volumeUSD":"88940733023.23904238664980547949957","totalValueLockedETH":"144063.825717021744228320289573021","totalValueLockedUSD":"249824362.6027912336403429092360696"},{"id":"0x4e68ccd3e89f51c3074ca5072bbac773960dfa36","token0":{"id":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","name":"Wrapped Ether","symbol":"WETH"},"token1":{"id":"0xdac17f958d2ee523a2206206994597c13d831ec7","name":"Tether USD","symbol":"USDT"},"feeTier":"3000","feesUSD":"185124193.800173568400298478067865","txCount":"1492763","volumeUSD":"61708064600.05785613343282602261817","totalValueLockedETH":"131089.6362362132366643238071149711","totalValueLockedUSD":"227325525.0132806916467010653611136"},{"id":"0xcbcdf9626bc03e24f779434178a73a0b4bad62ed","token0":{"id":"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599","name":"Wrapped BTC","symbol":"WBTC"},"token1":{"id":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","name":"Wrapped Ether","symbol":"WETH"},"feeTier":"3000","feesUSD":"102269297.0606976442307603611759257","txCount":"490056","volumeUSD":"34089765686.89921474358678705864665","totalValueLockedETH":"92084.83163240230786114962933880485","totalValueLockedUSD":"159828697.0823411186189225105593472"},{"id":"0x99ac8ca7087fa4a2a1fb6357269965a2014abc35","token0":{"id":"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599","name":"Wrapped BTC","symbol":"WBTC"},"token1":{"id":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","name":"USD Coin","symbol":"USDC"},"feeTier":"3000","feesUSD":"88765355.99612770011627151002462843","txCount":"473870","volumeUSD":"29588451998.70923337209050334154329","totalValueLockedETH":"74357.93391749629673530974854235253","totalValueLockedUSD":"128945787.4170844088142465451546072"},{"id":"0x4585fe77225b41b697c938b018e2ac67ac5a20c0","token0":{"id":"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599","name":"Wrapped BTC","symbol":"WBTC"},"token1":{"id":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","name":"Wrapped Ether","symbol":"WETH"},"feeTier":"500","feesUSD":"48519080.65008548008758518774760954","txCount":"2293138","volumeUSD":"97038161300.17096017517037549521769","totalValueLockedETH":"58665.87011291839599574355749386735","totalValueLockedUSD":"101733822.0372297898622513979165019"},{"id":"0x11b815efb8f581194ae79006d24e0d814b7697f6","token0":{"id":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","name":"Wrapped Ether","symbol":"WETH"},"token1":{"id":"0xdac17f958d2ee523a2206206994597c13d831ec7","name":"Tether USD","symbol":"USDT"},"feeTier":"500","feesUSD":"66865934.54155815111282984478052493","txCount":"6776561","volumeUSD":"133731869083.1163022256596895610653","totalValueLockedETH":"39566.82675979270367341555441995865","totalValueLockedUSD":"68629209.17078453244464615464754633"}]}},"note":"Live data from The Graph. Get your own free API key at thegraph.com/studio for unlimited access.","source":"subgraph-gateway","status":200,"subgraph_id":"5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV"},"query_validation":{"ok":true,"errors":[],"subgraph_id":"5zvR82QoaXYFyDEKLZ9t6v9adgnptxYpKpSbxtgVENFV"}}},"exampleRequest":{"request":"What are the top 10 Uniswap v3 pools by total value locked on Ethereum?"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_auS-hIf2TmqbrbV2ZceF3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts plain-English queries into working GraphQL or REST calls across 15,500+ blockchain subgraphs on 8 chains, covering protocols like Uniswap, Aave, Compound, ENS, Polymarket, and more","exampleAgentPrompt":"Translate this into a working query and fetch the result for me: 'what are the top 10 Uniswap v3 pools by total value locked on Ethereum right now?' — route it through the onchain subgraph network.","exampleUseCases":null,"resultDescription":"Returns the working GraphQL or REST query generated from the plain-English input, along with the actual onchain data response fetched from the matched subgraph across the relevant chain and protocol.","failureModes":["No matching subgraph found for the described protocol or chain — returns an error or empty result","Ambiguous plain-English input that cannot be resolved to a specific subgraph schema","Rate limit exceeded for anonymous or identified sender — requires $0.01 USDC payment via x402 on Base","Unsupported chain or protocol not indexed in the 15.5K+ subgraph catalog","Malformed or incomplete natural language query that cannot be parsed into valid GraphQL/REST","Subgraph indexing lag causing stale or missing data for recent blocks"],"whenToPreferThis":"Use this endpoint when an agent needs to query onchain blockchain data across multiple protocols and chains without knowing the specific GraphQL schema or subgraph URL. It is ideal for agents that receive natural language instructions about DeFi, NFTs, prediction markets, or ENS data and need to retrieve live onchain data without hardcoding protocol-specific queries. Prefer this over building raw GraphQL queries when breadth of protocol coverage (15.5K+ subgraphs, 8 chains) matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:34:07.980Z","isFirstParty":false}