# Blockchain Money Map | x402 Paid Tool Upsell Path Optimizer

> Blockchain Money Map | x402 Paid Tool Upsell Path Optimizer 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-13).

Analyzes a buyer task and tool catalog to recommend an optimal upsell path from a starting tool to a premium tool, given price ladder and stop conditions.

## Facts

- Endpoint: POST https://api.blockchainmoneymap.com/api/x402/x402-paid-tool-upsell-path-optimizer?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/blockchain-money-map-x402-paid-tool-upsell-path-optimizer-185316c2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_bEZoIOoeOHTC5f1AShO6P

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-paid-tool-upsell-path-optimizer-185316c2 -d '<json body>'
```

Example prompt: Analyze the upsell path for an agent trying to trace wallet funding sources — it starts with the free address-lookup tool, the premium target is the full transaction-graph tool, the price ladder goes $0.01, $0.05, $0.25, and stop if confidence is already above 90%.

## When to prefer this

Use this endpoint when you are operating an agentic marketplace or tiered API catalog and need to programmatically determine the optimal sequence of tool upgrades to offer an agent buyer. Prefer it over manual catalog logic when the upsell decision depends on dynamic factors like buyer task specifics, risk appetite, evidence requirements, and a defined price ladder. It is especially suited for x402-enabled agent commerce flows where each tool call is itself monetized.

## Known failure modes

- Missing required fields (catalog_summary, buyer_task, starting_tool, premium_tool, price_ladder, stop_condition) result in validation error
- Mode not set to 'analyze' causes rejection
- Malformed price_ladder string may produce nonsensical path recommendations
- Payment failure via x402 returns HTTP 402 and no response body
- Overly vague buyer_task or catalog_summary may produce generic or low-confidence path recommendations

## How this service works

Orders caller-supplied paid agent tools into a clear, trust-preserving upsell path.

## Output

A JSON response containing the recommended upsell path — an ordered sequence of tools the agent should be offered, with rationale for each step, estimated stopping point, and a recommendation on whether to proceed to the premium tool given the buyer task, risk appetite, and stop condition.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "analyze"
   ]
  },
  "facts": {
   "type": "object",
   "required": [
    "catalog_summary",
    "buyer_task",
    "starting_tool",
    "premium_tool",
    "price_ladder",
    "stop_condition"
   ],
   "properties": {
    "buyer_task": {
     "type": "string",
     "maxLength": 500
    },
    "premium_tool": {
     "type": "string",
     "maxLength": 500
    },
    "price_ladder": {
     "type": "string",
     "maxLength": 500
    },
    "risk_appetite": {
     "type": "string",
     "maxLength": 500
    },
    "starting_tool": {
     "type": "string",
     "maxLength": 500
    },
    "stop_condition": {
     "type": "string",
     "maxLength": 500
    },
    "catalog_summary": {
     "type": "string",
     "maxLength": 500
    },
    "evidence_requirement": {
     "type": "string",
     "maxLength": 500
    }
   },
   "additionalProperties": false
  },
  "policy": {
   "type": "object",
   "additionalProperties": true
  },
  "reference_facts": {
   "type": "object",
   "required": [
    "catalog_summary",
    "buyer_task",
    "starting_tool",
    "premium_tool",
    "price_ladder",
    "stop_condition"
   ],
   "properties": {
    "buyer_task": {
     "type": "string",
     "maxLength": 500
    },
    "premium_tool": {
     "type": "string",
     "maxLength": 500
    },
    "price_ladder": {
     "type": "string",
     "maxLength": 500
    },
    "risk_appetite": {
     "type": "string",
     "maxLength": 500
    },
    "starting_tool": {
     "type": "string",
     "maxLength": 500
    },
    "stop_condition": {
     "type": "string",
     "maxLength": 500
    },
    "catalog_summary": {
     "type": "string",
     "maxLength": 500
    },
    "evidence_requirement": {
     "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-paid-tool-upsell-path-optimizer-185316c2/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)