Graph Advocate

Endpoints (47 live)

• POST /uniswap/pretrade — Uniswap pre-trade due-diligence. POST {token, chain?, version?}. Returns real_liquidity + deepest venue (ranked by volumeUSD, NEVER TVL — Uniswap subgraph TVL is inflated by spam pools), alternate fee-tier venues, a two-way-flow honeypot check over recent swaps, daily volume trend, and a composed verdict {tradeable, risk, reasons}. Covers Uniswap V2/V3/V4 on Ethereum, Arbitrum, Base, Polygon, Optimism, BSC. For agents sizing or vetting a spot position before they touch a token. (0.02 USDC on Base)
• POST /hyperliquid/screen — Size-the-room for a Hyperliquid market. POST {coin, n?}. Returns the top N (default 10, max 10) traders on a coin ranked by volume, each with skill_score + classification + liquidation_count. Pre-trade check for MM agents: 'who am I about to be against on this perp, and have they been liquidated before?' Coin format: BTC, @107 (spot), xyz:SILVER. (0.05 USDC on Base)
• POST /kalshi/consensus-trend — Kalshi consensus-probability trajectory. POST {event}. Wraps Kalshi's unique /events/{ticker}/forecast_history (no other PM exposes formatted forecast percentile history). Returns slope-per-hour over 24h and 3d, acceleration signal (regime change indicator), volatility band, days to resolve, and a stable/accelerating-up/accelerating-down interpretation. (0.05 USDC on Base)
• POST /ask — Natural-language Q&A over the x402 Base settlements warehouse. POST {question}. Backed by 132M settlement rows on Cloudflare R2 + pre-aggregated daily_stats (388 days, May 2025 - Jun 2026), queried via Anthropic Sonnet + DuckDB. Returns {answer, sql_trace, model, upstream_ms}; sql_trace lets the caller verify the data path is real, not hallucinated. $0.05 USDC on Base. (0.05 USDC on Base)
• POST /polymarket/screen — Size-the-room: top N holders of a Polymarket market ranked by skill_score, with per-holder ghost-fill risk. POST {condition_id, n?}. 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 on Base)
• POST /polymarket/pnl — Polymarket full PnL report. POST {wallet}. Returns 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 to audit, debug, or feed into a deeper reputation signal. (0.05 USDC on Base)
• POST /onchain-x402/address — On-chain x402 settlement summary for an address from the decentralized x402 Base subgraph on The Graph Network. POST {address}. Returns lifetime stats as payer + recipient (totalPayments, totalVolume, first/last seen), recent 10 payments each direction, facilitator metadata if applicable, plus indexed_through_block for freshness. Decentralized, verifiable. Distinct from /ask. $0.01 USDC on Base. (0.01 USDC on Base)
• POST /agent/score — Composite 0-100 reputation score for any Base wallet. POST {wallet, days?=90}. Combines ERC-8004 registration (Agent0 subgraph), USDC settlement velocity (Base RPC scan), and ERC-8004 feedback+validation registry events aggregated across all of the owner's agents. Hard-gates on 8004 registration to filter burn addresses + CEX wallets. Cached 24h. Use for: should I integrate/pay/trust this peer agent. (0.02 USDC on Base)
• POST /route — Onchain data router for AI agents. Plain-English → working GraphQL or REST. 15.5K+ subgraphs on 8 chains. Uniswap, Aave, Compound, ENS, Polymarket, Limitless, Predict.fun, ERC-8004 discovery. Identified senders (include `sender` wallet in A2A metadata): 3 free /route /day, then $0.01 USDC via x402 on Base. Anonymous senders pay $0.01 from call 1. /polymarket + /hyperliquid trader-intel paid from call 1 ($0.01-$0.10). (0.01 USDC on Base)
• POST /polymarket/pnl-quick — Returns a fast Polymarket profit and loss snapshot for positions. (0.01 USDC on Base)
• POST /predmarket/spread — Returns prediction market spread data for a given market or set of markets. (0.05 USDC on Base)
• POST /hyperliquid/risk — Returns risk insights and exposure data for Hyperliquid accounts or positions. (0.02 USDC on Base)
• POST /hyperliquid/vault — Returns Hyperliquid vault information for paid access. (0.1 USDC on Base)
• POST /hyperliquid/fills — Fetches Hyperliquid trade fill data for analysis and tracking. (0.02 USDC on Base)
• POST /hyperliquid/score — Scores Hyperliquid activity or performance on request. (0.02 USDC on Base)
• POST /polymarket/risk — Analyzes Polymarket market risk and flags potential issues. (0.02 USDC on Base)
• POST /kalshi-polymarket/spread — Cross-source arbitrage spread between Kalshi and Polymarket on a topic. POST {topic, limit?}. Pulls matching markets from both venues (Politics + Elections overlap heavily), computes price mid-spread + arbitrage direction. JOIN that single-source passthrough APIs (incl. Pinax Token API) structurally can't return — this is what survives Pinax shipping Kalshi support later. (0.05 USDC on Base)
• POST /kalshi/sports-live-edge — Live sports-market mispricing detector. POST {milestone, market?}. Combines Kalshi's public play-by-play game_stats (Football/Basketball/Soccer/Hockey/Baseball/WNBA) with market candlesticks over the last hour to flag latency-arb windows when in-game momentum and market price diverge. Returns momentum_score, market_reaction_pct, and a directional latency-arb signal. (0.05 USDC on Base)
• POST /narrative/divergence — Narrative-vs-flow divergence. POST {chain?, limit?, cohort?}. JOINs Cambrian deep42 social momentum (tweet velocity, unique authors, reach) against on-chain flow ACCELERATION from a Uniswap subgraph - recent volume vs each token's own baseline, so it measures activity, not 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, never dropped. (0.05 USDC on Base)
• POST /uniswap/traders — Who is trading a token on Uniswap, and which way. POST {token, chain?, limit?}. Aggregates a recent swap sample on the deepest venue by trader EOA and returns per-wallet buys/sells/volume_usd/net_token plus a stance (accumulator / distributor / accumulating / distributing). Wallets are profiling input — feed them to /agent/score to find out who is on the other side. (0.02 USDC on Base)

+27 more endpoints.

MCP tools (3)

graph-advocate-mcp https://graphadvocate.com/mcp

• compare_graph_services — Compare all Graph Protocol services for a specific use case. Returns a ranked list with confidence scores.
• recommend_npm_package — Recommend the right @paulieb npm MCP package for a specific protocol. Returns package name, install command, and what it covers.
• route_data_request — Route an onchain data request to the right Graph Protocol service. Returns the exact tool + args to use. Call this FIRST for any blockchain data need.