# Blockchain Money Map X402 Response Provenance Notary

> Blockchain Money Map X402 Response Provenance Notary 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-14).

Creates or verifies cryptographic notary records that attest to the provenance and integrity of x402-paid API responses on public blockchains.

## Facts

- Endpoint: POST https://api.blockchainmoneymap.com/api/x402/x402-response-provenance-notary
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockchain-money-map-x402-response-provenance-notary-83ea3f5a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E2VS8BzzyVMBYgARu4Fc6

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-response-provenance-notary-83ea3f5a -d '<json body>'
```

Example prompt: Create a provenance notary record for the response we just got from the blockchain money map tool — use mode 'create', tool ID 'wallet-flow-analyzer', operation ID 'op-20240601-001', response hash 'sha256:ab12...', receipt hash 'sha256:cd34...', currency USDC, amount '0.01', and set retention class to 'standard'.

## When to prefer this

Use this endpoint when you need tamper-evident, cryptographically verifiable proof that an x402-paid API response is authentic and has not been altered — especially for compliance, audit trails, multi-agent pipelines where downstream agents must trust upstream results, or any scenario where the integrity of a paid blockchain data response must be independently verified. Prefer this over generic hash storage when you need provenance tied specifically to x402 payment receipts and blockchain money map service calls.

## Known failure modes

- Invalid or malformed SHA-256 hash patterns return a 400 validation error
- notary_id not found in verify mode returns a 404 not found response
- lookup_secret mismatch in verify mode returns a 403 forbidden error
- idempotency_key collision with different payload returns a 409 conflict
- Missing required fields for the selected mode return a 422 unprocessable entity
- Payment not received or insufficient payment triggers a 402 Payment Required response
- Expired or out-of-retention notary record returns a 410 Gone response

## How this service works

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

## Output

A JSON object containing a notary record with a unique notary_id, timestamp, cryptographic hashes attesting to response integrity (response_hash, receipt_hash, metadata_hash), verification status, retention class, and provenance metadata. In 'verify' mode, returns a pass/fail integrity result with details on any mismatch.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "create",
    "verify"
   ]
  },
  "amount": {
   "type": "string",
   "maxLength": 32
  },
  "tool_id": {
   "type": "string",
   "maxLength": 120
  },
  "currency": {
   "enum": [
    "USDC"
   ],
   "type": "string"
  },
  "notary_id": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{24,120}$",
   "maxLength": 120,
   "minLength": 24
  },
  "generated_at": {
   "type": "string",
   "format": "date-time"
  },
  "operation_id": {
   "type": "string",
   "maxLength": 120
  },
  "receipt_hash": {
   "type": "string",
   "pattern": "^sha256:[a-fA-F0-9]{64}$"
  },
  "endpoint_path": {
   "type": "string",
   "maxLength": 160
  },
  "lookup_secret": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{43,160}$",
   "maxLength": 160,
   "minLength": 43
  },
  "mcp_tool_name": {
   "type": "string",
   "maxLength": 120
  },
  "metadata_hash": {
   "type": "string",
   "pattern": "^sha256:[a-fA-F0-9]{64}$"
  },
  "response_hash": {
   "type": "string",
   "pattern": "^sha256:[a-fA-F0-9]{64}$"
  },
  "service_label": {
   "type": "string",
   "maxLength": 200
  },
  "challenge_hash": {
   "type": "string",
   "pattern": "^sha256:[a-fA-F0-9]{64}$"
  },
  "schema_version": {
   "type": "string",
   "maxLength": 40
  },
  "idempotency_key": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{32,160}$",
   "maxLength": 160,
   "minLength": 32
  },
  "payment_network": {
   "type": "string",
   "maxLength": 64
  },
  "retention_class": {
   "enum": [
    "short",
    "standard",
    "support"
   ],
   "type": "string"
  },
  "idempotency_scope_token": {
   "type": "string",
   "pattern": "^[A-Za-z0-9_-]{43,160}$",
   "maxLength": 160,
   "minLength": 43
  }
 }
}
```

## Response schema (JSON Schema)

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

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/blockchain-money-map-x402-response-provenance-notary-83ea3f5a/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)