{"uid":"cap_8Ty6jLXP0F_t2Ax5_Ah3X","slug":"bounty-engineer-agent-commerce-plan-1f1fd1d4","name":"Bounty Engineer Agent Commerce Plan","description":"Machine-buyable infrastructure for autonomous agents: API cost routing, margin optimization, funding-rate data, webpage extraction, result verification, spend controls, retry planning, state, tender search and GitHub bounty intelligence.","url":"https://bounty-engineer-x402-prod.onrender.com/v1/agent-commerce-plan?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"policy":{"type":"string"},"budget_usd":{"type":"number"},"candidates":{"type":"array","maxItems":50,"minItems":1},"constraints":{"type":"object"},"expected_calls":{"type":"integer","minimum":1}}},"responseSchema":{"type":"json","example":{"ok":true,"mode":"agent_commerce_plan","decision":"ready","selected":{"price_usd":0.01,"fits_budget":true,"provider_id":"alpha","expected_calls":100,"projected_spend_usd":1,"max_calls_with_budget":200},"budget_usd":2,"route_plan":{"ok":true,"mode":"provider_route_plan","policy":"balanced","decision":"route","rejected":[],"selected":{"id":"alpha","price_usd":0.01,"trust_score":0.9,"success_rate":0.99,"balanced_score":0.8255,"p95_latency_ms":500,"freshness_seconds":null},"limitations":["Balanced scoring uses fixed transparent weights: reliability 45%, trust 20%, latency 20%, cost 15%. Inputs are supplied by the caller and are not independently verified."],"fallback_order":[{"id":"alpha","price_usd":0.01,"trust_score":0.9,"success_rate":0.99,"balanced_score":0.8255,"p95_latency_ms":500,"freshness_seconds":null},{"id":"beta","price_usd":0.005,"trust_score":0.8,"success_rate":0.95,"balanced_score":0.7375,"p95_latency_ms":800,"freshness_seconds":null}]},"limitations":["Combines caller-supplied provider measurements with a deterministic budget check. It does not make payments or guarantee service quality."],"affordability":[{"price_usd":0.01,"fits_budget":true,"provider_id":"alpha","expected_calls":100,"projected_spend_usd":1,"max_calls_with_budget":200},{"price_usd":0.005,"fits_budget":true,"provider_id":"beta","expected_calls":100,"projected_spend_usd":0.5,"max_calls_with_budget":400}],"expected_calls":100}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","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.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_q_0BbM9izJW4nkifPUqy_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Routes autonomous agent API spend across candidate providers by optimizing for policy, budget, trust, and latency, returning a ranked plan with affordability checks and fallback ordering.","exampleAgentPrompt":"I have 2 providers — 'alpha' at $0.01/call with 99% success and 'beta' at $0.005/call with 95% success — and a $2 budget for 100 expected calls. Use the balanced policy to pick the best one and give me a fallback order.","exampleUseCases":[{"title":"Budget-constrained multi-provider routing","prompt":"I'm running an agent that needs to call an external API 200 times. I have two provider options: 'fastpro' at $0.008/call with 98% success and 'cheapone' at $0.003/call with 92% success. My total budget is $3. Use balanced policy to pick the best provider and give me a fallback plan."},{"title":"Spend projection for agent fleet planning","prompt":"Before I scale my agent fleet, can you check whether my $10 budget covers 500 API calls spread across these three providers — 'nodeA' at $0.02, 'nodeB' at $0.015, and 'nodeC' at $0.01 — and tell me the maximum calls I could make with each?"},{"title":"Reliability-first provider selection","prompt":"My agent is doing critical ops and I need the most reliable provider. I have 'surefire' at $0.025 with 99.5% success and 'budget' at $0.008 with 88% success. Budget is $5 for 150 calls — use the reliability policy and show me the ranked fallback order."}],"resultDescription":"Returns a JSON object with a top-level decision ('ready' or otherwise), the selected best-fit provider including its price, trust score, success rate, balanced score, and latency, plus an affordability array for all candidates showing projected spend and max calls within budget, a full route plan with fallback ordering, and any limitations or caveats about the computation.","failureModes":["Empty or missing candidates array causes validation error","budget_usd not provided or zero leads to all candidates failing affordability check","Unknown or unsupported policy string may produce unexpected scoring","If all candidates exceed budget, no provider is selected and decision may not be 'ready'","Caller-supplied metrics are not independently verified, so incorrect inputs produce unreliable routing decisions"],"whenToPreferThis":"Use this endpoint when an autonomous agent needs to deterministically select among multiple API providers given a fixed budget and call volume, especially when policy-driven trade-offs between cost, reliability, trust, and latency are required. Prefer this over manual routing logic when you need a structured fallback order and affordability projection in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T18:47:35.656Z","isFirstParty":false,"canonicalSlug":"bounty-engineer-agent-commerce-plan-1f1fd1d4"}