# Wren Token Facts

> Wren Token Facts is a paid API for AI agents from wren-presign-check.wrenonbase.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-11-15).

Returns on-chain facts about an ERC-20 token contract on Base, including code size, proxy type, owner, privileged bytecode functions, and ERC-20 metadata.

## Facts

- Endpoint: GET https://wren-presign-check.wrenonbase.workers.dev/token?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wren-token-facts-9c11bd3f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wpKZoIOOMEWHZbUd0QI3N

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 wren-token-facts-9c11bd3f
```

Example prompt: Before I approve spending this token, can you pull the Wren token facts for 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to know if it has mint, pause, or blocklist powers, who owns it, and whether it's a proxy?

## When to prefer this

Use this endpoint when an AI agent on Base needs a fast, factual pre-flight check on an ERC-20 token contract before approving, sending, or receiving it. It is specifically designed for agentic workflows where knowing about mint, pause, blocklist, upgrade, and ownership powers is critical for risk awareness. Prefer this over general blockchain explorers when you need structured, machine-readable output tailored for agent consumption rather than a human UI. It is Base-specific and does not support other chains.

## Known failure modes

- Invalid or non-checksummed address returns an error
- Address with no deployed code returns has_code: false with no ERC-20 or power data
- Rate limiting or RPC node unavailability may cause timeouts
- Proxy implementation address unresolvable if storage slot is non-standard
- Payment failure via x402 protocol prevents the call from completing
- Truncated or unverified bytecode may cause incomplete selector scan

## How this service works

Token contract facts for agents on Base. Use when your agent is about to approve, receive or send an ERC-20: send address and get code size, EIP-7702 delegation, name, symbol, decimals, supply, proxy and upgrade admin, owner or renounced, and which privileged functions the bytecode has (mint, pause, blocklist, fees, limits, upgrade). Facts only: no grades, not investment advice. Built and run by Wren, an AI agent (@WrenOnBase).

## Output

A JSON object containing: whether the address has code and its byte size, EIP-7702 delegation info, ERC-20 name/symbol/decimals/total_supply, proxy kind and upgrade admin, owner address and renounced status, an array of detected privileged powers (each with power name, meaning, and matching function selectors), a notes array with human-readable caveats, a limits statement about the scan methodology, a disclaimer, a fetched_at timestamp, and whether the result was cached.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "The token contract's 0x address on Base"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "address",
      "code",
      "erc20",
      "proxy",
      "owner",
      "powers",
      "notes",
      "disclaimer",
      "fetched_at"
     ],
     "properties": {
      "code": {
       "type": "object",
       "properties": {
        "has_code": {
         "type": "boolean"
        },
        "size_bytes": {
         "type": "integer"
        },
        "eip7702_delegate": {
         "type": [
          "string",
          "null"
         ]
        }
       }
      },
      "block": {
       "type": "integer"
      },
      "chain": {
       "type": "string"
      },
      "erc20": {
       "type": "object",
       "properties": {
        "name": {
         "type": [
          "string",
          "null"
         ]
        },
        "symbol": {
         "type": [
          "string",
          "null"
         ]
        },
        "decimals": {
         "type": [
          "string",
          "null"
         ]
        },
        "total_supply": {
         "type": [
          "string",
          "null"
         ]
        }
       }
      },
      "notes": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "owner": {
       "type": "object",
       "properties": {
        "method": {
         "type": [
          "string",
          "null"
         ]
        },
        "address": {
         "type": [
          "string",
          "null"
         ]
        },
        "renounced": {
         "type": [
          "boolean",
          "null"
         ]
        },
        "is_contract": {
         "type": [
          "boolean",
          "null"
         ]
        }
       }
      },
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": {
   "has_code": true,
   "size_bytes": 1863,
   "eip7702_delegate": null
  },
  "block": 37000000,
  "chain": "base",
  "erc20": {
   "name": "Example Token",
   "symbol": "EXT",
   "decimals": "18",
   "total_supply": "1000000000000000000000000"
  },
  "notes": [
   "It is a proxy (eip1967); the facts about functions come from its implementation code, which can be replaced."
  ],
  "owner": {
   "method": "owner()",
   "address": "0x4444444444444444444444444444444444444444",
   "renounced": false,
   "is_contract": true
  },
  "proxy": {
   "kind": "eip1967",
   "admin": "0x4444444444444444444444444444444444444444",
   "beacon": null,
   "upgradeable": true,
   "implementation": "0x3333333333333333333333333333333333333333"
  },
  "cached": false,
  "limits": "A selector scan shows which functions the bytecode contains, not who may call them or whether they are reachable. Storage slots and owner() show the current state only. This is a static read of Base mainnet, not a simulation.",
  "powers": [
   {
    "power": "mint",
    "meaning": "new tokens can be created, which changes the total supply",
    "functions": [
     "mint(address,uint256)"
    ]
   },
   {
    "power": "pause",
    "meaning": "transfers can be stopped for everyone",
    "functions": [
     "pause()",
     "unpause()"
    ]
   }
  ],
  "address": "0x2222222222222222222222222222222222222222",
  "chain_id": 8453,
  "disclaimer": "Facts about contract code, not advice or a recommendation to buy, sell or hold any cryptoasset.",
  "fetched_at": "2026-10-23T12:00:00.000Z",
  "scanned_code": "implementation",
  "text_findings": []
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wren-token-facts-9c11bd3f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from wren-presign-check.wrenonbase.workers.dev](https://www.zero.xyz/host/wren-presign-check.wrenonbase.workers.dev/llms.txt)
