# TokenIntel On-Chain Token Intelligence

> TokenIntel On-Chain Token Intelligence is a paid API for AI agents from tokenintel-api.onrender.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-23).

Fetches evidence-based ERC-20 token metadata from Base blockchain including identity, supply, ownership, pause status, proxy type, and EIP-1967 proxy-slot evidence via live RPC data.

## Facts

- Endpoint: GET https://tokenintel-api.onrender.com/v1/token/%7Btoken_address%7D?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tokenintel-on-chain-token-intelligence-ca868e80
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_T9pjHTzTo-MPkzGw-WvjE

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 tokenintel-on-chain-token-intelligence-ca868e80
```

Example prompt: Can you pull the on-chain intelligence report for the Base token at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I want to see its identity, total supply, who owns it, whether it's paused, and whether it's an EIP-1967 proxy?

## When to prefer this

Choose this endpoint when you need raw, evidence-grounded on-chain data about a Base ERC-20 token without opinionated SAFE/SCAM labels — ideal for due diligence, smart contract auditing, proxy detection, or building risk scoring on top of raw observable facts. Prefer it over generic blockchain explorers when you need structured JSON with explicit confidence states (OBSERVED/UNKNOWN/FAILED) and EIP-1967 proxy slot inspection in a single call.

## Known failure modes

- Invalid or non-ERC-20 contract address returns FAILED state for relevant fields
- Contract not deployed on Base returns error or all-UNKNOWN response
- RPC node unavailability causes FAILED states across fields
- Malformed address format may result in 4xx error
- Token with non-standard ABI may return UNKNOWN for specific fields like pause status

## How this service works

Evidence-first on-chain token intelligence for Base. Query ERC-20 identity, total supply, ownership, pause status, owner code type, and EIP-1967 proxy-slot evidence from live RPC data. Responses distinguish OBSERVED, UNKNOWN, and FAILED states instead of making unsupported SAFE/SCAM verdicts.

## Output

A JSON response (schema version 0.2) containing evidence-tagged fields for: token name/symbol/decimals, total supply, contract owner address, pause status, owner code type classification, EIP-1967 proxy implementation slot data, and per-field observation states (OBSERVED, UNKNOWN, or FAILED) indicating data confidence from live RPC queries on Base.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "mode": {
       "type": "string",
       "default": "full",
       "description": "Optional analysis mode."
      },
      "since_block": {
       "type": "integer",
       "minimum": 0,
       "description": "Optional earlier Base block for control snapshot comparison; not event history."
      },
      "token_address": {
       "type": "string",
       "description": "ERC-20 contract address on Base. Not required for the /v1/token/usdc convenience route."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "schema_version"
     ],
     "properties": {
      "schema_version": {
       "type": "string",
       "description": "TokenIntel response schema version"
      }
     },
     "additionalProperties": true
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "schema_version": "0.2"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tokenintel-on-chain-token-intelligence-ca868e80/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tokenintel-api.onrender.com](https://www.zero.xyz/host/tokenintel-api.onrender.com/llms.txt)