# EVM Token/Value Canonicalization

> EVM Token/Value Canonicalization is a paid API for AI agents from evm-canon-base.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Normalizes a raw EVM token or value payload into a schema-validated, deterministic JSON representation with honest nulls for missing fields

## Facts

- Endpoint: POST https://evm-canon-base.onrender.com/canonicalize
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/evm-token-value-canonicalization-0ccc4f23
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9s-SMXBKMTQXX6LPbdc5K

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 evm-token-value-canonicalization-0ccc4f23 -d '<json body>'
```

Example prompt: Canonicalize this raw EVM token payload for USDC on Base — address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, amount 1500000, decimals 6 — and give me back a clean, schema-validated JSON with honest nulls for anything missing.

## When to prefer this

Choose this endpoint when you need a single, deterministic, schema-validated JSON representation of an EVM token or value payload — especially when inputs may be inconsistent, partial, or sourced from heterogeneous chains. It is ideal for data pipeline normalization steps, pre-storage cleaning, or ensuring honest null handling for missing fields before downstream processing. Prefer it over ad-hoc client-side normalization when determinism and schema compliance are required.

## Known failure modes

- Invalid or malformed token payload returns a 400-level error with validation details
- Unrecognized token address or chain ID may result in null fields but not an error
- Payment not received or insufficient USDC results in 402 Payment Required
- Malformed JSON body returns a parse error
- Network or server timeout returns a 5xx error

## How this service works

Canonicalize one EVM token/value payload into schema-validated JSON (deterministic, honest nulls)

## Output

A deterministic, schema-validated JSON object representing the canonical form of the submitted EVM token or value payload. Missing or unresolvable fields are returned as explicit nulls rather than omitted, ensuring downstream consumers always receive a complete, predictable structure.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {
      "time": {
       "description": "unix seconds/millis or ISO-8601"
      },
      "chain": {
       "type": "string",
       "description": "name, alias or chainId"
      },
      "token": {
       "type": "string",
       "description": "contract address"
      },
      "amount": {
       "type": "string",
       "description": "raw integer or human decimal string"
      },
      "symbol": {
       "type": "string"
      },
      "decimals": {
       "type": "integer"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/evm-token-value-canonicalization-0ccc4f23/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from evm-canon-base.onrender.com](https://www.zero.xyz/host/evm-canon-base.onrender.com/llms.txt)