# Bounty Engineer Agent Commerce Plan

> Bounty Engineer Agent Commerce Plan is a paid API for AI agents from bounty-engineer-x402-prod.onrender.com, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-12).

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.

## Facts

- Endpoint: POST https://bounty-engineer-x402-prod.onrender.com/v1/agent-commerce-plan?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bounty-engineer-agent-commerce-plan-1f1fd1d4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8Ty6jLXP0F_t2Ax5_Ah3X

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 bounty-engineer-agent-commerce-plan-1f1fd1d4 -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bounty-engineer-agent-commerce-plan-1f1fd1d4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bounty-engineer-x402-prod.onrender.com](https://www.zero.xyz/host/bounty-engineer-x402-prod.onrender.com/llms.txt)