{"capabilities":{"extensions":[{"description":"Paid calls settle with x402 (USDC on Base, eip155:8453). A payment-required reply is a JSON object with recommendation='payment-required' carrying: `accepts` (x402 PaymentRequirements), `pay_via_http` (POST an `X-PAYMENT` header to this URL — a real HTTP 402 any x402 SDK auto-pays), and, when the question maps to a specialized endpoint, `direct_service` (the endpoint that computes the exact result, with its own price/body/output_example). You may also pay over A2A by prefixing the message text with `x402:<signed-payment>`. Identified senders (include a `sender` wallet or `name` in A2A metadata) get 3 free /route queries/day; anonymous senders pay $0.01 from call 1.","params":{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","assetSymbol":"USDC","payTo":"0x0FF5A6ecef783BBA35463ec2F8403B9B5e9e7C86","paymentHeader":"X-PAYMENT","httpEndpoint":"https://graphadvocate.com/route","bazaarDiscovery":"https://graphadvocate.com/.well-known/x402","freeTierPerDay":3,"priceRangeUsd":"0.01-0.10"},"required":false,"uri":"https://x402.org/ext/a2a-payments/v1"}],"pushNotifications":false,"stateTransitionHistory":false,"streaming":false},"defaultInputModes":["text"],"defaultOutputModes":["text"],"description":"Onchain data router for AI agents. Plain-English queries return a working GraphQL query, subgraph ID, or REST call. 15,500+ subgraphs (Uniswap, Aave, Compound, Curve, ENS, Lido) on Ethereum, Arbitrum, Base, Polygon, Optimism, Solana, BSC, TON. Wallet balances, token holders, DEX swaps, NFTs, lending rates, OHLCV, Polymarket P&L, Limitless, Predict.fun, ERC-8004 agent discovery. Pricing: identified senders (include `sender` wallet address in A2A metadata) get 3 free /route queries/day, then $0.01 USDC via x402 on Base. Anonymous senders (no metadata) pay $0.01 from call 1. Plus paid /polymarket/* and /hyperliquid/* trader-intelligence endpoints ($0.01-$0.10) — paid from call 1 regardless of metadata. Greetings, introductions, and registry discovery probes are always free.","documentationUrl":"https://docs.graphadvocate.com/","name":"Graph Advocate","preferredTransport":"JSONRPC","protocolVersion":"0.3.0","provider":{"organization":"PaulieB14","url":"https://graphadvocate.com/"},"skills":[{"description":"Searches 15,500+ subgraphs across 20+ chains to find the best one for your data need. Returns the subgraph ID, a ready-to-run GraphQL query, query volume (reliability signal), and a playground link to test it. Free API key at thegraph.com/studio — 100K queries/month, 2 min signup.","examples":["I need Curve pool data on Ethereum — which subgraph has the most query volume?","What subgraphs exist for tracking NFT sales on Base?","I'm building a yield aggregator — which subgraphs cover Aave, Compound, and Morpho?","How do I query Lido withdrawal requests from The Graph?"],"id":"find_subgraph","inputModes":["text"],"name":"Find the best subgraph for any protocol","outputModes":["text"],"tags":["subgraph","graphql","discovery","defi","protocol","blockchain"]},{"description":"Given a data need, returns a complete ready-to-execute GraphQL query with the correct subgraph ID, entity names, and field selections. Just add your free API key and POST to the gateway. Works with any HTTP client — no SDK or MCP required.","examples":["Write a GraphQL query for Aave V3 liquidations above $50K on Ethereum","I need a query that returns all Uniswap V3 pools sorted by fee revenue","GraphQL to get ENS domains expiring in the next 30 days","Query for Polymarket markets with open interest above $1M"],"id":"write_query","inputModes":["text"],"name":"Write a GraphQL query for any subgraph","outputModes":["text"],"tags":["graphql","query","subgraph","api"]},{"description":"Returns live blockchain data via Token API — wallet balances, token transfers, DEX swaps, NFT sales, holder rankings. Works across EVM (Ethereum, Base, Polygon, Arbitrum), Solana, and TON. No subgraph needed for these queries.","examples":["Who are the biggest WETH holders on Base right now?","Show me all DEX swaps above $100K on Arbitrum in the last hour","What tokens does this wallet hold: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","Compare SOL token holder distribution vs ETH"],"id":"onchain_data","inputModes":["text"],"name":"Get live onchain data (balances, swaps, NFTs, holders)","outputModes":["text"],"tags":["token-api","wallet","balance","nft","swap","defi"]},{"description":"Routes Polymarket queries to the Pinax Prediction Markets API (Token API `/v1/polymarket/*`). Covers markets discovery, OHLCV per outcome token, open interest, activity feeds (trades, splits, merges, redemptions), user positions with realized/unrealized PnL, and platform-wide aggregates. Preferred over the graph-polymarket-mcp package for common queries — cleaner REST surface, no npm install, AI-ready structured responses.","examples":["How has the probability of 'Trump acquires Greenland before 2027' changed in the last 10 days?","Give me OHLCV for Polymarket condition 0xabc... over the last 30 days for backtesting","What are the top 10 Polymarket markets by 24h trading volume right now?","Show the positions and realized P&L for Polymarket user 0x42eB... — I want to copy their plays","Get platform aggregates for Polymarket — total volume, open interest, active market count","Find markets where implied probability dropped more than 10% in the last week"],"id":"polymarket_data","inputModes":["text"],"name":"Polymarket prediction markets — prices, OHLCV, positions, P&L, activity","outputModes":["text"],"tags":["polymarket","prediction-markets","probability","signal-layer","ohlcv","backtest","trading","copy-trading","portfolio","pnl","liquidity","open-interest","pinax","token-api"]},{"description":"POST /polymarket/pnl-quick {wallet}. Pure-JSON skill metrics for any Polymarket trader: skill_score (0-100, Sharpe-weighted by confidence), classification (sharp/neutral/retail), win_rate, sample_size, max_drawdown, realized + unrealized PnL. No lot reconstruction — designed for batch screening top holders before entering a market or vetting a copy-trade signal. $0.01 USDC per call on Base.","examples":["Score Polymarket wallet 0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a","Is this Polymarket trader sharp money or retail? 0xac5a07c4..."],"id":"polymarket_pnl_quick","inputModes":["text"],"name":"Polymarket trader skill score (quick)","outputModes":["text"],"tags":["polymarket","trader-intelligence","skill-score","agent-economy","copy-trading","x402","pnl"]},{"description":"POST /polymarket/pnl {wallet, method?}. Full PnL report: derived skill metrics + per-lot realized PnL with FIFO/LIFO/HIFO matching + open positions with mark-to-market unrealized. For agents that need to inspect specific trades — audit, debug, or feed into a deeper reputation signal. $0.05 USDC per call on Base.","examples":["Full Polymarket PnL with FIFO accounting for 0x38e598...","Per-lot realized PnL HIFO for Polymarket trader 0xac5a..."],"id":"polymarket_pnl_full","inputModes":["text"],"name":"Polymarket full PnL (per-lot, FIFO/LIFO/HIFO)","outputModes":["text"],"tags":["polymarket","pnl","tax-lots","fifo","lifo","hifo","x402"]},{"description":"POST /polymarket/screen {condition_id, n?}. Returns the top N (default 10, max 25) position holders of a market, ranked by position size, each with skill_score, sharp/retail/insufficient_data classification, AND ghost-fill risk per holder. The pre-trade check for trading and market-maker agents — answers 'who am I about to be against, and will their fills actually settle?' $0.02 USDC per call on Base.","examples":["Screen top 10 holders of Polymarket market 0x6331a779482df72d904c3c1e12b6409ff836bc06f8c97945cba9b25ada2c605c","Who's holding the YES side of this Polymarket market and how sharp are they?"],"id":"polymarket_screen","inputModes":["text"],"name":"Polymarket size-the-room (top holders + skill + ghost-fill risk)","outputModes":["text"],"tags":["polymarket","pre-trade","market-maker","adverse-selection","ghost-fill","screen","x402"]},{"description":"POST /polymarket/risk {wallet}. Classifies a Polymarket maker by ghost-fill risk via Polygon eth_getCode + ERC-1967 implementation slot probe. Returns wallet_type (eoa | smart_account_erc1967 | legacy_smart_account), ghost_fill_risk (low/medium/high), and a 24h collateral outflow flag. Polymarket's new POLY_1271 / sig type 3 deposit wallets are ghost-fill-immune by design; legacy EOAs / Safes carry the historical risk that LPs have been getting burned by. $0.02 USDC per call on Base.","examples":["Will this Polymarket maker's fill actually settle? 0x38e598...","Is this wallet a deposit wallet or legacy EOA? 0xac5a07c4..."],"id":"polymarket_risk","inputModes":["text"],"name":"Polymarket ghost-fill counterparty risk","outputModes":["text"],"tags":["polymarket","ghost-fill","risk","market-maker","deposit-wallet","poly1271","erc1271","x402"]},{"description":"POST /hyperliquid/score {user, coin?}. Composite skill_score (0-100) for any Hyperliquid perps trader: 40% profitability (realized + funding) + 40% risk (liquidation rate, drawdown proxy) + 20% efficiency (fees vs volume). Returns classification (sharp/neutral/retail/insufficient_data), liquidation_rate, funding_burn, sample_size_trades. Wraps Pinax /v1/hyperliquid/users with risk signals Polymarket can't have (binary outcomes). $0.02 USDC per call on Base.","examples":["Score Hyperliquid trader 0xac5a07c4...","Is this Hyperliquid perps trader sharp or retail?"],"id":"hyperliquid_score","inputModes":["text"],"name":"Hyperliquid trader skill score (perps)","outputModes":["text"],"tags":["hyperliquid","perps","trader-intelligence","skill-score","liquidation","funding","x402"]},{"description":"POST /hyperliquid/pnl {user}. Full per-coin breakdown: realized_pnl, total_funding, total_fees, liquidation_fills, volume_bought/sold, first/last trade timestamp per coin. For agents auditing a trader's exposure surface or feeding deeper reputation signals. $0.05 USDC per call on Base.","examples":["Full Hyperliquid PnL by coin for 0xac5a07c4...","Per-coin realized PnL + funding burn for Hyperliquid trader"],"id":"hyperliquid_pnl","inputModes":["text"],"name":"Hyperliquid full PnL (per-coin breakdown)","outputModes":["text"],"tags":["hyperliquid","perps","pnl","funding","liquidation","x402"]},{"description":"POST /hyperliquid/screen {coin, n?}. Top N (default 10, max 25) traders of a Hyperliquid coin (BTC, ETH, SOL, etc.), ranked by total_volume, each with skill_score, sharp/retail/insufficient_data classification, liquidation_rate, and funding burn. Pre-trade check for perps market-makers and copy-trade scouting. $0.05 USDC per call on Base.","examples":["Top 10 Hyperliquid BTC traders ranked by skill","Who's the sharpest money trading ETH perps on Hyperliquid?"],"id":"hyperliquid_screen","inputModes":["text"],"name":"Hyperliquid top traders by coin (skill + risk)","outputModes":["text"],"tags":["hyperliquid","perps","pre-trade","leaderboard","screen","copy-trading","x402"]},{"description":"POST /hyperliquid/vault {vault}. Evaluates a Hyperliquid copy-trading vault: leader skill_score, redemption pressure (withdrawals/deposits ratio), depositor concentration, commission rate, last-activity recency. Hyperliquid Vaults = native copy-trading; no Polymarket equivalent. Unique vs Hypurrscan / Hyperdash human dashboards. $0.10 USDC per call on Base.","examples":["Evaluate Hyperliquid vault 0x...","Should I deposit into this Hyperliquid vault?"],"id":"hyperliquid_vault","inputModes":["text"],"name":"Hyperliquid vault evaluator (copy-trading)","outputModes":["text"],"tags":["hyperliquid","vault","copy-trading","leader","redemption","x402"]},{"description":"POST /hyperliquid/risk {user}. Liquidation rate, funding burn rate, leverage pattern indicator, and 24h activity flags for a Hyperliquid trader. For agents evaluating counterparty perps exposure or building risk-aware copy-trade filters. $0.02 USDC per call on Base.","examples":["Liquidation + funding risk for Hyperliquid trader 0xac5a07c4...","How leveraged is this Hyperliquid wallet?"],"id":"hyperliquid_risk","inputModes":["text"],"name":"Hyperliquid liquidation + funding risk","outputModes":["text"],"tags":["hyperliquid","perps","risk","liquidation","funding","leverage","x402"]},{"description":"POST /hyperliquid/fills {coin, n?}. Recent perp fill stream for a Hyperliquid coin (BTC, ETH, HYPE, etc.) — last N fills (max 10) with side, price, size, notional, direction (OPEN_SHORT/CLOSE_LONG/…), payer, fee, liquidations. Includes a flow summary: buy/sell counts, notional totals, whale-fill flag (≥$10k notional). Distinct from /screen (which ranks traders); this surfaces events for real-time tape-watching. $0.02 USDC per call on Base.","examples":["Recent BTC perp fills on Hyperliquid","Show me the last 5 ETH fills with whale flags"],"id":"hyperliquid_fills","inputModes":["text"],"name":"Hyperliquid recent fill stream + bid/ask flow","outputModes":["text"],"tags":["hyperliquid","perps","fills","flow","whale","real-time","x402"]},{"description":"POST /onchain-x402/address {address}. Read-only lookup against the x402 Base subgraph on The Graph Network: returns the address's lifetime x402 stats (totalPayments, totalVolumeDecimal, firstPaymentTimestamp, lastPaymentTimestamp) broken out by role (payer + recipient), plus the most-recent 10 payments in each direction, facilitator metadata if the address is a registered facilitator, and indexed_through_block so the caller can judge data freshness vs. chain tip. Decentralized, verifiable, no centralized data warehouse dependency. Distinct from /ask (which queries x402-watch's R2 parquet warehouse via Anthropic). $0.01 USDC per call on Base.","examples":["Show on-chain x402 stats for 0x0FF5A6ecef…7C86","How much has this address received in x402 payments?","Is this address a registered x402 facilitator?"],"id":"onchain_x402_address","inputModes":["text"],"name":"On-chain x402 address summary (decentralized)","outputModes":["text"],"tags":["x402","base","subgraph","graph-network","onchain","decentralized","address-lookup","trader-intelligence","agent-economy","verifiable"]},{"description":"POST /ask {question}. Natural-language Q&A over a custom 132M-row Cloudflare R2 parquet warehouse of every x402 EIP-3009 USDC settlement on Base mainnet, May 2025 → Jun 2026. Anthropic Sonnet + DuckDB translate plain-English to SQL against two virtual tables: settlements (row-level) and daily_stats (pre-aggregated, 388 days). Returns {answer, sql_trace, model, upstream_ms} — sql_trace makes the data path inspectable so callers can verify the answer wasn't hallucinated. $0.05 USDC per call on Base.","examples":["What were the top 10 recipient addresses by payment count in the last 30 days?","When did x402 settlement volume on Base inflect upward?","Show me the top payer-recipient pairs over the past 90 days","Plot daily settlement count and median USDC amount per day from May 2025 to June 2026"],"id":"x402_settlements_ask","inputModes":["text"],"name":"x402 Base settlements Q&A (NL→SQL)","outputModes":["text"],"tags":["x402","settlements","base","natural-language-sql","duckdb","agent-economy","parquet","trader-intelligence","analytics"]},{"description":"POST /narrative/divergence {chain?, limit?, cohort?}. Ranks trending tokens by the gap between social momentum (Cambrian deep42: tweet velocity, unique authors, reach) and on-chain flow ACCELERATION from a Uniswap subgraph — recent volume against each token's own baseline, so it measures activity rather than token size. Surfaces tokens loud on social but quiet on-chain, and the reverse: real flow nobody is tweeting about, which a social feed structurally cannot see. Ticker squatters are filtered by most-transacted claimant; non-EVM symbols are reported in `unresolved`, never dropped. $0.05 USDC on Base.","examples":["Which trending tokens have no on-chain flow behind the hype?","Show me tokens accumulating on-chain that nobody is talking about"],"id":"narrative_divergence","name":"Narrative vs on-chain flow divergence (JOIN)","tags":["defi","social","sentiment","uniswap","divergence","join"]},{"description":"POST /predmarket/spread {topic, limit?}. Cross-venue arbitrage spread on a topic keyword: pulls matching markets from Polymarket (Gamma public API) and Limitless (REST public search), pairs them by closest-price match, returns per-pair yes-mid spread (bps) and arbitrage_direction. JOIN that single-venue passthroughs structurally can't return — GA is the place agents go to compare prediction markets across venues. Naive pair-up by price proximity; agent should confirm semantic match (same end date, same resolution source) before sizing. $0.05 USDC per call on Base.","examples":["Cross-venue spread on 'trump' between Polymarket and Limitless","Are there arbitrage opportunities on bitcoin markets across prediction venues?","Polymarket vs Limitless price gap for 'fed rate'"],"id":"predmarket_spread","inputModes":["text"],"name":"Polymarket ↔ Limitless cross-venue spread (JOIN)","outputModes":["text"],"tags":["prediction-markets","polymarket","limitless","cross-venue","spread","arbitrage","join","x402","base"]},{"description":"POST /agent/score {wallet, days?=90}. Composite 0-100 reputation score for any Base wallet. Combines three on-chain ground-truth axes: identity (ERC-8004 registration on Base + IPFS metadata), activity (USDC settlement velocity), and reputation (ERC-8004 feedback + validation registry events, aggregated across all agents owned by the wallet). Hard 8004 gate filters out burn addresses, USDC contract, and CEX hot wallets — settlement signals alone don't distinguish agents from sinks. Tier output: active_verified / active / registered_or_settling / dormant_low_signal / no_evidence. Cached 24h. Use for: should I integrate / pay / trust this peer agent. $0.02 USDC per call on Base.","examples":["Score 0xe69f9cc5e073b4a41d9e888a91159d0706161f18 — is this a real active agent?","What's the reputation score for the wallet I'm about to pay?","Rank these 5 peer agents by reputation before I integrate with one"],"id":"agent_score","inputModes":["text"],"name":"Agent reputation score (0-100, on-chain derived)","outputModes":["text"],"tags":["reputation","8004","erc-8004","agent-trust","agent-discovery","wallet-score","x402","base"]},{"description":"POST /uniswap/pretrade {token, chain?=ethereum}. Pre-trade check for a token on Uniswap: real liquidity, the deepest venue ranked by volumeUSD (NOT TVL — TVL is gamed by spam-token pricing), a honeypot two-way-flow check, daily volume trend, and a tradeable/risk verdict. Powered by The Graph across Uniswap V2/V3/V4 on Ethereum, Arbitrum, Base, Polygon, Optimism and BSC. $0.02 USDC per call on Base.","examples":["Pre-trade due-diligence for WETH on Base Uniswap","Is this token safe to trade — real liquidity or a honeypot?","Deepest Uniswap venue and volume trend for PEPE on Ethereum"],"id":"uniswap_pretrade","inputModes":["text"],"name":"Uniswap pre-trade due-diligence (V2/V3/V4, 6 chains)","outputModes":["text"],"tags":["uniswap","defi","dex","pre-trade","liquidity","honeypot","thegraph","subgraph","x402","base"]},{"description":"POST /uniswap/basis {coin, chain?=ethereum}. Cross-venue JOIN: Uniswap spot price vs the Hyperliquid perp for one asset, returning basis_pct and a perp_premium / perp_discount / aligned signal. A spot-vs-perp comparison single-venue passthroughs structurally can't return. $0.05 USDC per call on Base.","examples":["ETH Uniswap spot vs Hyperliquid perp basis","Is the perp trading at a premium or discount to spot for SOL?","Basis percentage between Uniswap and Hyperliquid for BTC"],"id":"uniswap_basis","inputModes":["text"],"name":"Uniswap spot ↔ Hyperliquid perp basis (JOIN)","outputModes":["text"],"tags":["uniswap","hyperliquid","basis","spot-perp","cross-venue","join","defi","thegraph","x402","base"]},{"description":"POST /uniswap/traders {token, chain?=ethereum}. Per-wallet flow on a token's deepest Uniswap venue: accumulators vs distributors with trader EOAs, buys/sells and volume_usd — see who is actually building or unloading a position. Powered by The Graph. $0.02 USDC per call on Base.","examples":["Who's accumulating vs distributing WETH on Uniswap?","Top Uniswap traders by volume for this token","Show buy/sell flow per wallet on the deepest Uniswap venue"],"id":"uniswap_traders","inputModes":["text"],"name":"Uniswap per-wallet flow: accumulators vs distributors","outputModes":["text"],"tags":["uniswap","defi","dex","wallet-flow","accumulation","smart-money","thegraph","subgraph","x402","base"]}],"url":"https://graphadvocate.com/","version":"1.1.0"}