# Rooms by Aurmada – ERC-20 Token Contract Facts

> Rooms by Aurmada – ERC-20 Token Contract Facts is a paid API for AI agents from rooms.aurmada.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-11).

Returns on-chain facts about an ERC-20 token contract on Base or Ethereum, including name, symbol, decimals, total supply, proxy detection, bytecode size, selector presence, and risk flags.

## Facts

- Endpoint: GET https://rooms.aurmada.com/x402/v1/onchain/token?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/rooms-by-aurmada-erc-20-token-contract-facts-d27c521a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_74q7s1lGLIhJ5q30-0h4t

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 rooms-by-aurmada-erc-20-token-contract-facts-d27c521a
```

Example prompt: Can you pull the on-chain facts for the token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base — I want to see its name, symbol, total supply, whether it's upgradeable, and any risk flags like mint or blacklist selectors?

## When to prefer this

Choose this endpoint when you need factual, structured on-chain data about a specific ERC-20 token contract on Base or Ethereum — especially when you want proxy/upgrade detection, selector presence (mint/pause/blacklist), or risk flag enumeration without relying on a third-party token list or subjective safety score. Prefer it over generic block explorers when you need machine-readable structured output suitable for agent pipelines.

## Known failure modes

- Invalid or malformed contract address returns a 400 validation error
- Address is not an ERC-20 contract (EOA or non-token contract) returns incomplete or empty fields
- Unsupported chain value returns a 400 error
- Contract not deployed on the specified chain returns an error or empty result
- Network RPC issues may cause intermittent 5xx errors
- Rate limiting or payment failure returns 402 or 429

## How this service works

Rooms is one shared space for you, your people, and everyone's AI.

## Output

Returns on-chain facts about the specified ERC-20 contract: token name, symbol, decimals, total supply, owner address, proxy/upgrade pattern detected (EIP-1967, legacy OpenZeppelin, EIP-1167 minimal proxy), bytecode size in bytes, which function selectors such as mint/pause/blacklist are present in the bytecode, and plain risk flags. Does not provide a safety rating — only raw factual data.

## 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": {
      "chain": {
       "enum": [
        "base",
        "ethereum"
       ],
       "type": "string",
       "description": "Chain (default base)."
      },
      "address": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Token contract address."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "erc20": {
   "name": "USD Coin",
   "symbol": "USDC",
   "decimals": 6,
   "total_supply": "4404885742.127613"
  },
  "proxy": {
   "is_proxy": true,
   "standard": "OpenZeppelin legacy (zos)",
   "implementation": "0x2ce6311ddae708829bc0784c967b7d77d19fd779"
  },
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "risk_flags": [
   {
    "flag": "upgradeable_proxy",
    "detail": "An implementation or beacon storage slot is set: the logic can be changed by its admin."
   }
  ],
  "is_contract": true,
  "selectors_found": [
   "mint(address,uint256)",
   "pause()"
  ],
  "bytecode_size_bytes": 1852
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/rooms-by-aurmada-erc-20-token-contract-facts-d27c521a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from rooms.aurmada.com](https://www.zero.xyz/host/rooms.aurmada.com/llms.txt)