# GraphAdvocate /route — Plain-English to GraphQL/REST Onchain Data Router

> GraphAdvocate /route — Plain-English to GraphQL/REST Onchain Data Router is a paid API for AI agents from graphadvocate.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Converts plain-English queries into working GraphQL or REST calls across 15,500+ blockchain subgraphs on 8 chains, covering protocols like Uniswap, Aave, Compound, ENS, Polymarket, and more

## Facts

- Endpoint: POST https://graphadvocate.com/route
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/graphadvocate-com-278d9aef
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dto3sN4ZYdIeGj9V7GKbl

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability graphadvocate-com-278d9aef -d '<json body>'
```

Example prompt: Translate this into a working query and fetch the result for me: 'what are the top 10 Uniswap v3 pools by total value locked on Ethereum right now?' — route it through the onchain subgraph network.

## When to prefer this

Use this endpoint when an agent needs to query onchain blockchain data across multiple protocols and chains without knowing the specific GraphQL schema or subgraph URL. It is ideal for agents that receive natural language instructions about DeFi, NFTs, prediction markets, or ENS data and need to retrieve live onchain data without hardcoding protocol-specific queries. Prefer this over building raw GraphQL queries when breadth of protocol coverage (15.5K+ subgraphs, 8 chains) matters.

## Known failure modes

- No matching subgraph found for the described protocol or chain — returns an error or empty result
- Ambiguous plain-English input that cannot be resolved to a specific subgraph schema
- Rate limit exceeded for anonymous or identified sender — requires $0.01 USDC payment via x402 on Base
- Unsupported chain or protocol not indexed in the 15.5K+ subgraph catalog
- Malformed or incomplete natural language query that cannot be parsed into valid GraphQL/REST
- Subgraph indexing lag causing stale or missing data for recent blocks

## How this service works

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

## Output

Returns the working GraphQL or REST query generated from the plain-English input, along with the actual onchain data response fetched from the matched subgraph across the relevant chain and protocol.

## Example request

```json
{
 "request": "What are the top 10 Uniswap v3 pools by total value locked on Ethereum?"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "request": {
   "type": "string",
   "description": "Plain-English onchain data question"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "reason": "wallet balance query on an EVM chain",
  "confidence": "high",
  "query_ready": {
   "args": {
    "address": "0x...",
    "network": "base"
   },
   "tool": "getV1EvmBalances"
  },
  "alternatives": [],
  "recommendation": "token-api"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/graphadvocate-com-278d9aef/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from graphadvocate.com](https://www.zero.xyz/host/graphadvocate.com/llms.txt)