Graph Advocate

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.

Skills

• Find the best subgraph for any protocol
  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.
  subgraphgraphqldiscoverydefiprotocolblockchain
• Write a GraphQL query for any subgraph
  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.
  graphqlquerysubgraphapi
• Get live onchain data (balances, swaps, NFTs, holders)
  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.
  token-apiwalletbalancenftswapdefi
• Polymarket prediction markets — prices, OHLCV, positions, P&L, activity
  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.
  polymarketprediction-marketsprobabilitysignal-layerohlcvbacktesttradingcopy-tradingportfoliopnlliquidityopen-interestpinaxtoken-api
• Polymarket trader skill score (quick)
  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.
  polymarkettrader-intelligenceskill-scoreagent-economycopy-tradingx402pnl
• Polymarket full PnL (per-lot, FIFO/LIFO/HIFO)
  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.
  polymarketpnltax-lotsfifolifohifox402
• Polymarket size-the-room (top holders + skill + ghost-fill risk)
  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.
  polymarketpre-trademarket-makeradverse-selectionghost-fillscreenx402
• Polymarket ghost-fill counterparty risk
  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.
  polymarketghost-fillriskmarket-makerdeposit-walletpoly1271erc1271x402
• Hyperliquid trader skill score (perps)
  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.
  hyperliquidperpstrader-intelligenceskill-scoreliquidationfundingx402
• Hyperliquid full PnL (per-coin breakdown)
  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.
  hyperliquidperpspnlfundingliquidationx402
• Hyperliquid top traders by coin (skill + risk)
  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.
  hyperliquidperpspre-tradeleaderboardscreencopy-tradingx402
• Hyperliquid vault evaluator (copy-trading)
  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.
  hyperliquidvaultcopy-tradingleaderredemptionx402
• Hyperliquid liquidation + funding risk
  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.
  hyperliquidperpsriskliquidationfundingleveragex402
• Hyperliquid recent fill stream + bid/ask flow
  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.
  hyperliquidperpsfillsflowwhalereal-timex402

How to call

https://graphadvocate.com/