# Blockchain Money Map x402 Agent Commerce Digital Twin

> Blockchain Money Map x402 Agent Commerce Digital Twin is a paid API for AI agents from api.blockchainmoneymap.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-18).

Analyzes, audits, or checks an agent commerce transaction definition against a structured digital twin schema to validate mission parameters, roles, payment caps, and compliance rules for x402-paid agent interactions.

## Facts

- Endpoint: POST https://api.blockchainmoneymap.com/api/x402/x402-agent-commerce-digital-twin?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockchain-money-map-x402-agent-commerce-digital-twin-51161535
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wRIzOVTluy54BuFbw2XL4

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-digital-twin-51161535 -d '<json body>'
```

Example prompt: Audit my x402 agent commerce mission called 'Token Swap Execution' where the buyer is a treasury agent, the seller is a DEX aggregator agent, the agent role is executor, the intended outcome is a completed token swap, the allowed task is swap-only, amount cap is 50 USDC on Base network, the MCP tool is 'dex-swap', x402 amount is 0.01, receiver label is 'DEX-Aggregator', expected output is a swap receipt, receipt requirement is on-chain, and rollback contact is ops@myprotocol.com — run it in analyze mode.

## When to prefer this

Choose this endpoint when you need to pre-validate or audit a structured agent commerce mission definition before execution, especially in x402-paid autonomous agent workflows involving defined buyer/seller/agent roles, MCP tool bindings, payment caps, and receipt requirements. It is distinct from generic wallet audit or transaction decode endpoints on the same platform — those inspect historical on-chain data, while this endpoint validates a prospective agent mission specification against a digital twin schema for compliance and completeness.

## Known failure modes

- Missing required fields in the facts object returns a validation error listing absent properties
- Invalid mode enum value (not analyze/audit/check) returns a 400 bad request
- Malformed agent_card_hash not matching sha256 hex pattern returns schema validation failure
- amount_cap or x402_amount type mismatch (non-numeric) causes a parse error
- allowed_payees or agent_skill_ids exceeding 10 items triggers array limit error
- Payment failure or x402 authentication error returns 402 with payment requirements
- Network or currency values that are unrecognized may return an unknown-field warning in the audit

## How this service works

Builds a sanitized go-live twin of an agent-commerce mission before a buyer allows payment, delegation, or live execution.

## Output

Returns a JSON report evaluating the submitted agent commerce digital twin specification, including validation status of all required fields, role consistency checks, payment cap compliance, x402 parameter correctness, identified gaps or misconfigurations, and any compliance flags related to receipt requirements, idempotency policy, or rollback provisions.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "analyze",
    "audit",
    "check"
   ]
  },
  "facts": {
   "type": "object",
   "required": [
    "mission_label",
    "buyer_role",
    "seller_role",
    "agent_role",
    "intended_outcome",
    "allowed_task",
    "amount_cap",
    "currency",
    "network",
    "mcp_tool_name",
    "x402_amount",
    "x402_receiver_label",
    "expected_output",
    "receipt_requirement",
    "rollback_contact"
   ],
   "properties": {
    "expiry": {
     "type": "string",
     "maxLength": 500
    },
    "network": {
     "type": "string",
     "maxLength": 500
    },
    "currency": {
     "type": "string",
     "maxLength": 500
    },
    "agent_role": {
     "type": "string",
     "maxLength": 500
    },
    "amount_cap": {
     "type": "number"
    },
    "buyer_role": {
     "type": "string",
     "maxLength": 500
    },
    "known_gaps": {
     "type": "string",
     "maxLength": 500
    },
    "recurrence": {
     "type": "string",
     "maxLength": 500
    },
    "route_path": {
     "type": "string",
     "maxLength": 500
    },
    "max_retries": {
     "type": "number"
    },
    "seller_role": {
     "type": "string",
     "maxLength": 500
    },
    "x402_amount": {
     "type": "number"
    },
    "allowed_task": {
     "type": "string",
     "maxLength": 500
    },
    "retry_policy": {
     "type": "string",
     "maxLength": 500
    },
    "support_path": {
     "type": "string",
     "maxLength": 500
    },
    "mcp_tool_name": {
     "type": "string",
     "maxLength": 500
    },
    "mission_label": {
     "type": "string",
     "maxLength": 500
    },
    "allowed_payees": {
     "type": "array",
     "maxItems": 10
    },
    "provider_label": {
     "type": "string",
     "maxLength": 500
    },
    "agent_card_hash": {
     "type": "string",
     "pattern": "^sha256:[a-fA-F0-9]{64}$"
    },
    "agent_skill_ids": {
     "type": "array",
     "maxItems": 10
    },
    "expected_output": {
     "type": "string",
     "maxLength": 500
    },
    "intended_outcome": {
     "type": "string",
     "maxLength": 500
    },
    "rollback_contact": {
     "type": "string",
     "maxLength": 500
    },
    "facilitator_label": {
     "type": "string",
     "maxLength": 500
    },
    "idempotency_policy": {
     "type": "string",
     "maxLength": 500
    },
    "human_presence_mode": {
     "type": "string",
     "maxLength": 500
    },
    "receipt_requirement": {
     "type": "stri
… (truncated)
```

## 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-digital-twin-51161535/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)