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.
AgentCard object — a capabilities object, a declared protocolVersion, and a well-formed skills array.
An A2A client finds this agent by fetching the well-known path on the provider's own host. That is what makes an agent card different from every other agent artifact in this catalog: it is provider-published by construction — it cannot be derived, generated, or reconstructed on a provider's behalf.
Find the best subgraph for any protocol find_subgraph
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.
subgraphgraphqldiscoverydefiprotocolblockchainWrite a GraphQL query for any subgraph write_query
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.
graphqlquerysubgraphapiGet live onchain data (balances, swaps, NFTs, holders) onchain_data
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-apiwalletbalancenftswapdefiPolymarket prediction markets — prices, OHLCV, positions, P&L, activity polymarket_data
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-apiPolymarket trader skill score (quick) polymarket_pnl_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-tradingx402pnlPolymarket full PnL (per-position, mark-to-market) polymarket_pnl_full
POST /polymarket/pnl {wallet}. Full PnL report: derived skill metrics plus per-position aggregates — net position, average buy price, current price, realized and mark-to-market unrealized PnL per market. For agents that need position-level detail — audit, debug, or feed into a deeper reputation signal. $0.05 USDC per call on Base.
polymarketpnlpositionsmark-to-marketx402Polymarket leaderboard (derived skill metrics) polymarket_leaders
POST /polymarket/leaders. Top Polymarket traders with derived skill metrics per trader — score, classification, sample size — rather than raw volume alone. $0.02 USDC per call on Base.
polymarketleaderboardtradersskill-scorex402Kalshi consensus trend (slope + acceleration) kalshi_consensus_trend
POST /kalshi/consensus-trend. Consensus slope and acceleration for a Kalshi market from its forecast history — is the crowd moving, and is the move speeding up. $0.05 USDC per call on Base.
kalshiprediction-marketsconsensustrendx402Kalshi ↔ Polymarket cross-source spread kalshi_polymarket_spread
POST /kalshi-polymarket/spread. Shows where Kalshi and Polymarket disagree on the same event, two ways: `pairs` when the venues word a question alike, and `reconciled` when they do not — Kalshi states a threshold on the level ('upper bound above 3.75%'), Polymarket a delta ('25 bps increase'), so for macro markets like Fed rates the wording never matches and only the distribution comparison works. Differences are reported in bps AND bounded by the venues' quote widths, so you can tell signal from noise; it does not claim a tradeable edge. A JOIN neither venue can answer alone. $0.05 USDC per call on Base.
kalshipolymarketspreadarbitragecross-venuex402Kalshi live sports edge (play-by-play vs candles) kalshi_sports_live_edge
POST /kalshi/sports-live-edge. Live sports mispricing: play-by-play state against the market's own candles, surfacing where the price has not caught up with the game. $0.05 USDC per call on Base.
kalshisportslivemispricingx402Polymarket size-the-room (top holders + skill + ghost-fill risk) polymarket_screen
POST /polymarket/screen {condition_id, n?}. Returns the top N (default 10, max 10) 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-fillscreenx402Polymarket ghost-fill counterparty risk polymarket_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-walletpoly1271erc1271x402Hyperliquid trader skill score (perps) hyperliquid_score
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-scoreliquidationfundingx402Hyperliquid full PnL (per-coin breakdown) hyperliquid_pnl
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.
hyperliquidperpspnlfundingliquidationx402Hyperliquid top traders by coin (skill + risk) hyperliquid_screen
POST /hyperliquid/screen {coin, n?}. Top N (default 10, max 10) 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-tradingx402Hyperliquid vault evaluator (copy-trading) hyperliquid_vault
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-tradingleaderredemptionx402Hyperliquid liquidation + funding risk hyperliquid_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.
hyperliquidperpsriskliquidationfundingleveragex402Hyperliquid recent fill stream + bid/ask flow hyperliquid_fills
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-timex402On-chain x402 address summary (decentralized) onchain_x402_address
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.
x402basesubgraphgraph-networkonchaindecentralizedaddress-lookuptrader-intelligenceagent-economyverifiablex402 Base settlements Q&A (NL→SQL) x402_settlements_ask
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.
x402settlementsbasenatural-language-sqlduckdbagent-economyparquettrader-intelligenceanalyticsNarrative vs on-chain flow divergence (JOIN) narrative_divergence
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.
defisocialsentimentuniswapdivergencejoinPolymarket ↔ Limitless cross-venue spread (JOIN) predmarket_spread
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.
prediction-marketspolymarketlimitlesscross-venuespreadarbitragejoinx402baseAgent reputation score (0-100, on-chain derived) agent_score
POST /agent/score {wallet, days?=30}. 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.
reputation8004erc-8004agent-trustagent-discoverywallet-scorex402baseUniswap pre-trade due-diligence (V2/V3/V4, 6 chains) uniswap_pretrade
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.
uniswapdefidexpre-tradeliquidityhoneypotthegraphsubgraphx402baseUniswap spot ↔ Hyperliquid perp basis (JOIN) uniswap_basis
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.
uniswaphyperliquidbasisspot-perpcross-venuejoindefithegraphx402baseUniswap per-wallet flow: accumulators vs distributors uniswap_traders
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.
uniswapdefidexwallet-flowaccumulationsmart-moneythegraphsubgraphx402base2026-09-19 from https://graphadvocate.com/.well-known/agent-card.json,
HTTP 200. The body was saved verbatim and is the sole source for
everything on this page — no field is inferred.
View the captured card.
Providers change what they serve; if this card has moved or changed shape,
the provider profile carries the
current state as of the last build.
Work with this as data
Every agent card here is available over the APIs.io API and to AI agents over MCP. A2A Agent Cards is not yet its own endpoint on the v1 API. Reach it through catalog search and the tag graph, or the MCP server.