{"uid":"cap_bEZoIOoeOHTC5f1AShO6P","slug":"blockchain-money-map-x402-paid-tool-upsell-path-optimizer-185316c2","name":"Blockchain Money Map | x402 Paid Tool Upsell Path Optimizer","description":"Orders caller-supplied paid agent tools into a clear, trust-preserving upsell path.","url":"https://api.blockchainmoneymap.com/api/x402/x402-paid-tool-upsell-path-optimizer?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_1zvERmy0SUncigZXQAmTg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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%.","exampleUseCases":[{"title":"Agent tool upgrade path planning","prompt":"I have a blockchain analytics agent that starts with a basic balance-check tool and I want to guide it toward the deep clustering premium tool. The price ladder is $0.01, $0.10, $0.50 and the stop condition is when the agent has identified the counterparty. Can you run an upsell path analysis for that scenario?"},{"title":"Risk-aware upsell sequencing for compliance tasks","prompt":"My agent is doing AML compliance checks and needs to move from a simple OFAC-screener tool up to a full sanctions-graph tool. The buyer has low risk appetite, evidence requirement is 'court-admissible', and the price ladder is $0.01 to $0.25. Analyze the best upsell path and when to stop."},{"title":"Catalog optimization for blockchain data marketplace","prompt":"I'm building a blockchain data catalog with 8 tools at different price points. Can you analyze the optimal upsell path from our entry-level token-price tool to the premium on-chain revenue-flow tool for a buyer task of 'identify whale accumulation patterns'? Price ladder is $0.01, $0.05, $0.15, $1.00 and stop when the buyer has enough signal to trade."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-13T18:45:05.038Z","isFirstParty":false,"canonicalSlug":"blockchain-money-map-x402-paid-tool-upsell-path-optimizer-185316c2"}