# Axiom Works ERC20 Token Metadata Lookup

> Axiom Works ERC20 Token Metadata Lookup is a paid API for AI agents from api.axiomworks.co.uk, paid per call via x402, $0.001/call, status unknown (last checked 2026-11-12).

Returns the name, symbol, decimals, and total supply (formatted and raw) for an ERC20 token contract on Base, Ethereum, Arbitrum, Optimism, or Polygon.

## Facts

- Endpoint: GET https://api.axiomworks.co.uk/token?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/axiom-works-erc20-token-metadata-lookup-2d268b48
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wmHVHaUrqqmB0jq-TNEmX

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 axiom-works-erc20-token-metadata-lookup-2d268b48
```

Example prompt: What's the name, symbol, and decimals for the ERC20 token at 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum?

## When to prefer this

Use this endpoint when you only need the basic ERC20 metadata fields (name, symbol, decimals, total supply) and want the cheapest possible call. It is cheaper than the full /token-check endpoint and ideal for pre-formatting amounts, building token display cards, or quickly verifying a contract is ERC20-compatible. Supports Base, Ethereum, Arbitrum, Optimism, and Polygon.

## Known failure modes

- Invalid or non-existent contract address returns null fields or is_erc20_like: false
- Unsupported chain value returns a validation error
- Contract exists but is not ERC20-compliant may return partial nulls with is_erc20_like: false
- Network RPC errors may cause timeouts or 5xx responses
- Missing required address parameter returns a 400 bad request

## How this service works

Use this for just an ERC20's name, symbol, decimals and total supply (formatted + raw) on Base/Ethereum/Arbitrum/Optimism/Polygon — e.g. before formatting amounts. Cheaper than /token-check. Example: {address:"0x…", chain:"base"}. $0.001.

## Output

Returns a JSON object containing the token's name (string or null), symbol (string or null), decimals (integer or null), total_supply in both human-readable formatted form and raw form (strings), and an is_erc20_like boolean indicating whether the contract implements the ERC20 interface.

## 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",
        "arbitrum",
        "optimism",
        "polygon"
       ],
       "type": "string",
       "description": "EVM chain (default base)"
      },
      "wallet": {
       "type": "string",
       "description": "Alias for address"
      },
      "address": {
       "type": "string",
       "description": "0x ERC20 token contract"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "name": {
       "type": [
        "string",
        "null"
       ]
      },
      "symbol": {
       "type": [
        "string",
        "null"
       ]
      },
      "decimals": {
       "type": [
        "integer",
        "null"
       ]
      },
      "total_supply": {
       "type": [
        "string",
        "null"
       ]
      },
      "is_erc20_like": {
       "type": "boolean"
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/axiom-works-erc20-token-metadata-lookup-2d268b48/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.axiomworks.co.uk](https://www.zero.xyz/host/api.axiomworks.co.uk/llms.txt)
