# Graph Advocate API

**Canonical:** https://apis.io/apis/graphadvocate-com/graph-advocate-api/  
**Provider:** PaulieB14 — https://apis.io/providers/graphadvocate-com/  
**Base URL:** https://graphadvocate.com  
**Documentation:** https://docs.graphadvocate.com/

Graph Advocate API is one of 2 APIs that [PaulieB14](https://apis.io/providers/graphadvocate-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Blockchain, On-Chain Data, The Graph, GraphQL, and x402. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and rate-limit docs.

Routing and trader-intelligence API at graphadvocate.com. POST / speaks A2A JSON-RPC 2.0 (message/send) and is the free tier (3 routed queries/day per wallet-identified sender); POST /route and 22 further POST endpoints (/hyperliquid/*, /polymarket/*, /kalshi/*, /uniswap/*, /predmarket/spread, /narrative/divergence, /ask, /onchain-x402/address, /agent/score) are x402-gated at $0.01-$0.10 USDC on Base and answer 402 with x402 v2 PaymentRequirements until an X-PAYMENT header is presented. All 23 operations in the published OpenAPI 3.1.0 are read-style queries; there is no API key, OAuth or signup.

## Operations (23)

| Method | Path | Summary |
|---|---|---|
| POST | `/route` | Route an onchain data request |
| POST | `/agent/score` | Composite 0-100 reputation score for any Base wallet |
| POST | `/ask` | Natural-language Q&A over the x402 Base settlements warehouse |
| POST | `/hyperliquid/fills` | Recent Hyperliquid perp fill stream |
| POST | `/hyperliquid/pnl` | Full Hyperliquid trader dossier |
| POST | `/hyperliquid/risk` | Hyperliquid counterparty risk |
| POST | `/hyperliquid/score` | Composite skill_score 0-100 for a Hyperliquid perps trader |
| POST | `/hyperliquid/screen` | Top N traders of a Hyperliquid coin, each scored sharp/neutral/retail. |
| POST | `/hyperliquid/vault` | Hyperliquid vault evaluator |
| POST | `/kalshi-polymarket/spread` | Where Kalshi and Polymarket disagree on a topic — matched by wording where possible, and by aligning the two venues' full outcome distributions where they fr... |
| POST | `/kalshi/consensus-trend` | Kalshi consensus-probability trajectory |
| POST | `/kalshi/sports-live-edge` | Live sports mispricing detector |
| POST | `/onchain-x402/address` | On-chain x402 settlement profile for an address |
| POST | `/polymarket/pnl` | Full Polymarket trader dossier |
| POST | `/polymarket/pnl-quick` | Fast derived skill metrics for a Polymarket wallet |
| POST | `/polymarket/risk` | Polymarket ghost-fill risk |
| POST | `/polymarket/screen` | Top holders of a Polymarket market, each with skill score and ghost-fill risk. |
| POST | `/polymarket/leaders` | Top Polymarket traders leaderboard ranked by PnL or volume over a window — the discovery/copy-trade counterpart to the per-wallet skill endpoints. |
| POST | `/predmarket/spread` | Polymarket vs Limitless cross-venue spread on a topic — JOIN that single-venue APIs cannot return; arbitrage direction included. |
| POST | `/narrative/divergence` | Narrative-vs-flow divergence |
| POST | `/uniswap/basis` | Uniswap spot vs Hyperliquid perp basis for one asset — a cross-venue JOIN returning basis_pct and a perp_premium/perp_discount/aligned signal. |
| POST | `/uniswap/pretrade` | Uniswap pre-trade due-diligence for a token |
| POST | `/uniswap/traders` | Per-wallet Uniswap flow on a token's deepest venue |

## Machine-readable artifacts (12)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/graphadvocate-com/refs/heads/main/openapi/graphadvocate-com-openapi.yml
- **OpenAPI** — https://graphadvocate.com/openapi.json
- **Documentation** — https://docs.graphadvocate.com/
- **APIReference** — https://docs.graphadvocate.com/route
- **GettingStarted** — https://docs.graphadvocate.com/quickstart
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/graphadvocate-com/refs/heads/main/overlays/graphadvocate-com-openapi-overlay.yaml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/graphadvocate-com/refs/heads/main/errors/graphadvocate-com-problem-types.yml
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/graphadvocate-com/refs/heads/main/authentication/graphadvocate-com-authentication.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/graphadvocate-com/refs/heads/main/conventions/graphadvocate-com-conventions.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/graphadvocate-com/refs/heads/main/rate-limits/graphadvocate-com-rate-limits.yml
- **Plans** — https://raw.githubusercontent.com/api-evangelist/graphadvocate-com/refs/heads/main/plans/graphadvocate-com-plans-pricing.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/graphadvocate-com/refs/heads/main/apis.yml

## Other PaulieB14 APIs (1)

- [Graph Advocate MCP Server](https://apis.io/apis/graphadvocate-com/graph-advocate-mcp-server/)

## Tags

Blockchain, On-Chain Data, The Graph, GraphQL, x402, A2A, Prediction Markets, Trader Intelligence

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/graphadvocate-com/graph-advocate-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/graphadvocate-com/.