# Bounty Engineer Provider Route Plan

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

Scores and ranks a list of API provider candidates against a routing policy (balanced, lowest cost, highest reliability, or lowest latency) and returns the best-fit provider plus a fallback order.

## Facts

- Endpoint: POST https://bounty-engineer-x402-prod.onrender.com/v1/provider-route-plan?utm_source=zero.xyz
- Price: $0.01/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-provider-route-plan-ecf25a5a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_4RzOS_1_PoZYLC1NVeik3

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-provider-route-plan-ecf25a5a -d '<json body>'
```

Example prompt: I have three API providers — 'fast' at $0.02 with 99% success rate, 'cheap' at $0.005 with 96% success rate, and 'reliable' at $0.03 with 99.9% success rate — can you run them through a balanced routing policy and tell me which one to call first, plus a fallback order?

## When to prefer this

Use this endpoint when an autonomous agent must dynamically choose among multiple competing API providers at runtime and needs a transparent, policy-driven ranking with fallback order rather than a static configuration. Prefer it over hand-coded provider selection logic when policies need to be swappable (balanced vs lowest cost vs highest reliability vs lowest latency) without code changes.

## Known failure modes

- Empty or malformed candidates array returns a validation error
- Invalid policy enum value causes rejection
- Candidates array exceeding 50 items is rejected
- Missing required fields in candidate objects may produce incomplete scores
- Caller-supplied metrics are not independently verified, so scores reflect input quality

## 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 the selected provider (including id, price, trust score, success rate, balanced score, p95 latency), a ranked fallback order of all candidates, any rejected providers, the routing policy applied, and a limitations notice explaining scoring weights and caveats.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "policy": {
   "enum": [
    "balanced",
    "lowest_cost",
    "highest_reliability",
    "lowest_latency"
   ],
   "type": "string"
  },
  "candidates": {
   "type": "array",
   "maxItems": 50,
   "minItems": 1
  },
  "constraints": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "mode": "provider_route_plan",
  "policy": "balanced",
  "decision": "route",
  "rejected": [],
  "selected": {
   "id": "fast",
   "price_usd": 0.02,
   "trust_score": 0.9,
   "success_rate": 0.99,
   "balanced_score": 0.8255,
   "p95_latency_ms": 450,
   "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": "fast",
    "price_usd": 0.02,
    "trust_score": 0.9,
    "success_rate": 0.99,
    "balanced_score": 0.8255,
    "p95_latency_ms": 450,
    "freshness_seconds": null
   },
   {
    "id": "cheap",
    "price_usd": 0.005,
    "trust_score": 0.8,
    "success_rate": 0.96,
    "balanced_score": 0.742,
    "p95_latency_ms": 900,
    "freshness_seconds": null
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bounty-engineer-provider-route-plan-ecf25a5a/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)