Graph Advocate

• 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.

  subgraph graphql discovery defi protocol blockchain
  4 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?

  In: text · Out: text

• Write 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.

  graphql query subgraph api
  4 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

  In: text · Out: text

• Get 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-api wallet balance nft swap defi
  4 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

  In: text · Out: text

• Polymarket 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.

  polymarket prediction-markets probability signal-layer ohlcv backtest trading copy-trading portfolio pnl liquidity open-interest pinax token-api
  6 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

  In: text · Out: text

• Polymarket 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.

  polymarket trader-intelligence skill-score agent-economy copy-trading x402 pnl
  2 examples

  • Score Polymarket wallet 0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a
  • Is this Polymarket trader sharp money or retail? 0xac5a07c4...

  In: text · Out: text

• Polymarket 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.

  polymarket pnl positions mark-to-market x402
  2 examples

  • Full Polymarket PnL for 0x38e598...
  • Per-position realized and unrealized PnL for Polymarket trader 0xac5a...

  In: text · Out: text

• Polymarket 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.

  polymarket leaderboard traders skill-score x402
  2 examples

  • Top Polymarket traders right now with skill scores
  • Who are the sharpest wallets on Polymarket this week?

  In: text · Out: text

• Kalshi 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.

  kalshi prediction-markets consensus trend x402
  2 examples

  • Is Kalshi consensus accelerating on the Fed decision market?
  • Consensus slope for a Kalshi market over its forecast history

  In: text · Out: text

• Kalshi ↔ 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.

  kalshi polymarket spread arbitrage cross-venue x402
  2 examples

  • Spread between Kalshi and Polymarket on the same election market
  • Where do Kalshi and Polymarket disagree most right now?

  In: text · Out: text

• Kalshi 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.

  kalshi sports live mispricing x402
  2 examples

  • Live edge on Kalshi sports markets right now
  • Which in-play Kalshi market is furthest from the game state?

  In: text · Out: text

• Polymarket 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.

  polymarket pre-trade market-maker adverse-selection ghost-fill screen x402
  2 examples

  • Screen top 10 holders of Polymarket market 0x6331a779482df72d904c3c1e12b6409ff836bc06f8c97945cba9b25ada2c605c
  • Who's holding the YES side of this Polymarket market and how sharp are they?

  In: text · Out: text

• Polymarket 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.

  polymarket ghost-fill risk market-maker deposit-wallet poly1271 erc1271 x402
  2 examples

  • Will this Polymarket maker's fill actually settle? 0x38e598...
  • Is this wallet a deposit wallet or legacy EOA? 0xac5a07c4...

  In: text · Out: text

• Hyperliquid 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.

  hyperliquid perps trader-intelligence skill-score liquidation funding x402
  2 examples

  • Score Hyperliquid trader 0xac5a07c4...
  • Is this Hyperliquid perps trader sharp or retail?

  In: text · Out: text

• Hyperliquid 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.

  hyperliquid perps pnl funding liquidation x402
  2 examples

  • Full Hyperliquid PnL by coin for 0xac5a07c4...
  • Per-coin realized PnL + funding burn for Hyperliquid trader

  In: text · Out: text

• Hyperliquid 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.

  hyperliquid perps pre-trade leaderboard screen copy-trading x402
  2 examples

  • Top 10 Hyperliquid BTC traders ranked by skill
  • Who's the sharpest money trading ETH perps on Hyperliquid?

  In: text · Out: text

• Hyperliquid 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.

  hyperliquid vault copy-trading leader redemption x402
  2 examples

  • Evaluate Hyperliquid vault 0x...
  • Should I deposit into this Hyperliquid vault?

  In: text · Out: text

• Hyperliquid 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.

  hyperliquid perps risk liquidation funding leverage x402
  2 examples

  • Liquidation + funding risk for Hyperliquid trader 0xac5a07c4...
  • How leveraged is this Hyperliquid wallet?

  In: text · Out: text

• Hyperliquid 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.

  hyperliquid perps fills flow whale real-time x402
  2 examples

  • Recent BTC perp fills on Hyperliquid
  • Show me the last 5 ETH fills with whale flags

  In: text · Out: text

• On-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.

  x402 base subgraph graph-network onchain decentralized address-lookup trader-intelligence agent-economy verifiable
  3 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?

  In: text · Out: text

• x402 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.

  x402 settlements base natural-language-sql duckdb agent-economy parquet trader-intelligence analytics
  4 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

  In: text · Out: text

• Narrative 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.

  defi social sentiment uniswap divergence join
  2 examples

  • Which trending tokens have no on-chain flow behind the hype?
  • Show me tokens accumulating on-chain that nobody is talking about
• Polymarket ↔ 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-markets polymarket limitless cross-venue spread arbitrage join x402 base
  3 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'

  In: text · Out: text

• Agent 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.

  reputation 8004 erc-8004 agent-trust agent-discovery wallet-score x402 base
  3 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

  In: text · Out: text

• Uniswap 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.

  uniswap defi dex pre-trade liquidity honeypot thegraph subgraph x402 base
  3 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

  In: text · Out: text

• Uniswap 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.

  uniswap hyperliquid basis spot-perp cross-venue join defi thegraph x402 base
  3 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

  In: text · Out: text

• Uniswap 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.

  uniswap defi dex wallet-flow accumulation smart-money thegraph subgraph x402 base
  3 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

  In: text · Out: text

Interfaces

Capabilities

Streaming

No

Push notifications

No

Extended card for signed-in callers

Not declared

• https://x402.org/ext/a2a-payments/v1

Security and formats

Requires

Not declared

Schemes

Not declared

Accepts

text

Returns

text