Graph Advocate

{
  "capabilities": {
    "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) \u2014 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 \u2014 100K queries/month, 2 min signup.",
      "examples": [
        "I need Curve pool data on Ethereum \u2014 which subgraph has the most query volume?",
        "What subgraphs exist for tracking NFT sales on Base?",
        "I'm building a yield aggregator \u2014 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 \u2014 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 \u2014 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 \u2014 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... \u2014 I want to copy their plays",
        "Get platform aggregates for Polymarket \u2014 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 \u2014 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 \u2014 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 \u2014 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 \u2014 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"
      ]
    }
  ],
  "url": "https://graphadvocate.com/",
  "version": "1.1.0"
}