# TokenBrief – Base ERC-20 Token Analysis

> TokenBrief – Base ERC-20 Token Analysis is a paid API for AI agents from agent-research-api.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-03).

Analyzes a Base ERC-20 token address returning block-linked supply data, owner/proxy observations, scoped Uniswap v3 pool inventory, and spot quotes with optional AI narration

## Facts

- Endpoint: POST https://agent-research-api.onrender.com/v1/token-brief?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenbrief-base-erc-20-token-analysis-07365797
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kd0f5Ugn-kEfwYJ1m6P0m

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 tokenbrief-base-erc-20-token-analysis-07365797 -d '<json body>'
```

Example prompt: Give me a TokenBrief on the Base ERC-20 at 0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed — include AI narration so I get the commentary alongside the supply data and Uniswap v3 pool quotes.

## When to prefer this

Choose this endpoint when you need a fast, consolidated on-chain snapshot of a Base network ERC-20 token — supply, ownership, proxy status, and Uniswap v3 liquidity — in a single call. Prefer it over generic block explorers when you need structured, agent-consumable output with optional AI narrative framing. Not suitable when you need security scoring, holder concentration analysis, rugpull detection, or multi-chain token data.

## Known failure modes

- Invalid or non-Base ERC-20 address returns validation error
- Token not found on Base chain returns empty or error response
- Uniswap v3 pool not found for USDC/WETH pair returns missing pool data
- OpenAI narration failure when narration=ai returns partial result or falls back to rules
- Rate limiting or upstream RPC failures may return 5xx errors
- Cached stale data (up to 60s) may not reflect the most recent on-chain state
- Render.com cold start may cause initial latency spike

## How this service works

TokenBrief: Analyze a Base ERC-20 address with block-linked supply, owner/proxy observations and Uniswap v2/v3 + Aerodrome Slipstream pools (USDC/WETH). Returns spot quotes, pool inventory and evidence; wallet checkout and PNG cards at /tokenbrief. Optional narration=ai adds OpenAI commentary; default rules. No security verdict, holder concentration or sellability test. Cache up to 60s, disclosed. Source or AI failures are not settled.

## Output

Returns a structured brief containing: block-linked token supply, owner and proxy contract observations, scoped Uniswap v3 pool data (USDC/WETH pairs), spot price quotes, pool inventory figures, and supporting evidence. If narration=ai, also includes OpenAI-generated commentary. A share-card viewer is available at /tokenbrief. Response is cached up to 60 seconds. Does not include security verdict, holder concentration analysis, or sellability assessment.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "address": {
   "type": "string",
   "pattern": "^0x[0-9a-fA-F]{40}$"
  },
  "narration": {
   "enum": [
    "rules",
    "ai"
   ],
   "type": "string",
   "default": "rules"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenbrief-base-erc-20-token-analysis-07365797/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-research-api.onrender.com](https://www.zero.xyz/host/agent-research-api.onrender.com/llms.txt)