# Blockchain Money Map x402 Agent Commerce Error Taxonomy Normalizer

> Blockchain Money Map x402 Agent Commerce Error Taxonomy Normalizer is a paid API for AI agents from api.blockchainmoneymap.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Classifies and normalizes blockchain/x402 agent commerce errors into a standard taxonomy given protocol, status code, error code, and message facts.

## Facts

- Endpoint: POST https://api.blockchainmoneymap.com/api/x402/x402-agent-commerce-error-taxonomy-normalizer
- 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/blockchain-money-map-x402-agent-commerce-error-taxonomy-normalizer-0119dc42
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7QKtPifTIx5VaCeCIiK4X

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 blockchain-money-map-x402-agent-commerce-error-taxonomy-normalizer-0119dc42 -d '<json body>'
```

Example prompt: I just got an error from an x402 payment attempt — the protocol was 'x402', status code was 402, error code was 'INSUFFICIENT_FUNDS', and the message said 'balance too low to cover fee' — can you classify this into the standard agent commerce error taxonomy?

## When to prefer this

Choose this endpoint when your AI agent needs to deterministically normalize and classify errors received from x402 blockchain payment flows, especially when working across multiple providers that return inconsistent error codes and messages. It is ideal for agent commerce orchestration layers that need to route error handling logic based on a canonical error taxonomy rather than raw, provider-specific codes.

## Known failure modes

- Missing required fields (protocol, status_code, error_code, message_excerpt) returns a validation error
- Unrecognized error codes or protocols may return an unknown/unclassified taxonomy result
- Malformed input schema results in a 400-class error
- x402 payment failure if USDC balance is insufficient to cover the $0.01 fee
- Mode must be set to 'classify' or the request will be rejected

## How this service works

Choose Blockchain Money Map for human-readable public blockchain reports or x402-paid agent API services.

## Output

A JSON response containing the normalized error taxonomy classification for the provided error facts, including the canonical error category, potentially a severity or retry hint, and normalized labels that are consistent across x402 providers and protocols.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "classify"
   ]
  },
  "facts": {
   "type": "object",
   "required": [
    "protocol",
    "status_code",
    "error_code",
    "message_excerpt"
   ],
   "properties": {
    "protocol": {
     "type": "string",
     "maxLength": 500
    },
    "error_code": {
     "type": "string",
     "maxLength": 500
    },
    "retry_after": {
     "type": "string",
     "maxLength": 500
    },
    "status_code": {
     "type": "number"
    },
    "payment_state": {
     "type": "string",
     "maxLength": 500
    },
    "provider_label": {
     "type": "string",
     "maxLength": 500
    },
    "message_excerpt": {
     "type": "string",
     "maxLength": 500
    },
    "authorization_state": {
     "type": "string",
     "maxLength": 500
    }
   },
   "additionalProperties": false
  },
  "policy": {
   "type": "object",
   "additionalProperties": true
  },
  "reference_facts": {
   "type": "object",
   "required": [
    "protocol",
    "status_code",
    "error_code",
    "message_excerpt"
   ],
   "properties": {
    "protocol": {
     "type": "string",
     "maxLength": 500
    },
    "error_code": {
     "type": "string",
     "maxLength": 500
    },
    "retry_after": {
     "type": "string",
     "maxLength": 500
    },
    "status_code": {
     "type": "number"
    },
    "payment_state": {
     "type": "string",
     "maxLength": 500
    },
    "provider_label": {
     "type": "string",
     "maxLength": 500
    },
    "message_excerpt": {
     "type": "string",
     "maxLength": 500
    },
    "authorization_state": {
     "type": "string",
     "maxLength": 500
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockchain-money-map-x402-agent-commerce-error-taxonomy-normalizer-0119dc42/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.blockchainmoneymap.com](https://www.zero.xyz/host/api.blockchainmoneymap.com/llms.txt)