# Prime-Agent x402 Intelligence: Base Token Context

> Prime-Agent x402 Intelligence: Base Token Context is a paid API for AI agents from prime-agent-x402-intelligence.onrender.com, paid per call via x402, $0.009/call, status unknown (last checked 2026-10-11).

Returns comprehensive on-chain intelligence for a Base mainnet ERC-20 token address, including metadata, DEX market data, and coverage status, gated by x402 micropayment.

## Facts

- Endpoint: GET https://prime-agent-x402-intelligence.onrender.com/token/context/%7Baddress%7D?utm_source=zero.xyz
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prime-agent-x402-intelligence-base-token-context-b8505ded
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9I_DdCVx8lVELii9S0-0-

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 prime-agent-x402-intelligence-base-token-context-b8505ded
```

Example prompt: Can you pull up the full token context for the Base mainnet contract 0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa — I want to see the name, symbol, decimals, DEX liquidity, 24-hour volume, and the top trading pair?

## When to prefer this

Choose this endpoint when you need a single-call snapshot of a Base mainnet ERC-20 token combining on-chain metadata (name, symbol, decimals) with live DEX market data (liquidity, volume, top pair) and a verifiable block-level provenance hash. It is best for agents doing token research, portfolio enrichment, or DeFi screening on Base specifically — not for Ethereum mainnet, Solana, or other chains. The x402 micropayment model ($0.009 USDC) makes it suitable for per-lookup agent workflows without API key management.

## Known failure modes

- Invalid or non-contract address returns is_contract: false with empty market fields
- Token with no DEX listings returns dex_market with zero pair_count and null top_pair
- Holder data is currently unavailable (coverage.holders: false) for all tokens
- Payment not provided or invalid returns HTTP 402 Payment Required
- Address not on Base mainnet may return empty or error response
- Rate limiting or provider downtime may result in 5xx errors from the Render host

## How this service works

x402-paid Base intelligence with free machine-readable discovery.

## Output

A JSON object containing: token address, name, symbol, decimals, network (eip155:8453), a coverage map (metadata, contract, activity, liquidity, holders), a block snapshot with block number, block hash, and observed timestamp, DEX market data including 24h buys/sells, pair count, aggregate liquidity and volume in USD, and top pair details (DEX name, pair address, price in USD, DexScreener URL). Also includes evidence IDs and a note on data source limitations.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "token": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "fields": {
   "name": "Example Token",
   "symbol": "TOKEN",
   "decimals": 18
  },
  "holders": {
   "reason": "No zero-key holder indexer has passed the production reliability gate.",
   "available": false
  },
  "missing": [],
  "network": "eip155:8453",
  "coverage": {
   "holders": false,
   "activity": true,
   "contract": true,
   "metadata": true,
   "liquidity": true
  },
  "snapshot": {
   "network": "eip155:8453",
   "block_hash": "0x1111111111111111111111111111111111111111111111111111111111111111",
   "observed_at": 1760000000,
   "block_number": 12345678
  },
  "dex_market": {
   "buys_h24": 125,
   "top_pair": {
    "dex": "example-dex",
    "url": "https://dexscreener.com/base/example",
    "buys_h24": 90,
    "price_usd": "1.00",
    "sells_h24": 100,
    "pair_address": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
    "liquidity_usd": 150000,
    "volume_h24_usd": 50000
   },
   "sells_h24": 141,
   "pair_count": 2,
   "source_note": "DEX Screener-reported pool data; aggregates can overlap economically and are not independently verified onchain by Prime-Agent.",
   "sample_limited_to": 30,
   "aggregate_liquidity_usd": 250000,
   "aggregate_volume_h24_usd": 75000
  },
  "is_contract": true,
  "evidence_ids": [
   "example-evidence-id"
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/prime-agent-x402-intelligence-base-token-context-b8505ded/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from prime-agent-x402-intelligence.onrender.com](https://www.zero.xyz/host/prime-agent-x402-intelligence.onrender.com/llms.txt)