# Bounty Engineer Revenue API

## Autonomous agent entry point
- Free machine offer: POST https://bounty-engineer-x402-prod.onrender.com/v1/agent-offer with {"goal":"...","max_price_usd":0.05,"preferred_rail":"x402"}
- MCP: POST https://bounty-engineer-x402-prod.onrender.com/mcp · use quote_autonomous_purchase then get_product_proof
- ARD discovery: GET https://bounty-engineer-x402-prod.onrender.com/.well-known/ard.json
- Agent capability discovery: GET https://bounty-engineer-x402-prod.onrender.com/agents.txt · GET https://bounty-engineer-x402-prod.onrender.com/agents.json
- Prefer x402 for autonomous no-human purchases; PayPal prepaid is an operator fallback.

Machine-readable funding-rate market data, agent security, sponsored distribution, x402 trust and GitHub bounty intelligence for autonomous agents and developers.

## Non-x402 Sponsor Exchange
- Self-service sponsor catalog: GET https://bounty-engineer-x402-prod.onrender.com/sponsor/catalog
- Live sponsored feed: GET https://bounty-engineer-x402-prod.onrender.com/sponsor/listings
- PayPal checkout: POST https://bounty-engineer-x402-prod.onrender.com/sponsor/paypal/start
- Direct Solana USDC invoice: POST https://bounty-engineer-x402-prod.onrender.com/sponsor/solana/start then POST https://bounty-engineer-x402-prod.onrender.com/sponsor/solana/confirm
- Paid placements are labelled Sponsored or Featured and expire automatically.

## Paid x402 endpoint
- GET https://bounty-engineer-x402-prod.onrender.com/v1/audit?url=https://example.com
- Price: $0.01 per successful request
- Settlement: x402 V2 exact, Solana mainnet USDC
- An unpaid request returns HTTP 402 with PAYMENT-REQUIRED metadata.

## Deterministic x402 utilities
- POST https://bounty-engineer-x402-prod.onrender.com/v1/json-contract-check · $0.005 · Validate generated JSON against an explicit supported schema subset with precise error pointers; no guessed repairs.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/json-change-set · $0.005 · Compare JSON snapshots and return only changed fields with hashes, exact counts and configurable ignored paths.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/evidence-pack · $0.02 · Build an auditable quote packet: verify exact quote presence, source hashes, character offsets and caller-declared freshness.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/context-pack · $0.01 · Select query-relevant verbatim excerpts under a character budget, deduplicate chunks and preserve source offsets for retrieval workflows.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/data-quality-gate · $0.02 · Accept or reject batches of up to 200 records using schema validation and composite uniqueness checks before data enters a workflow.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/provider-route-plan · $0.01 · Choose the cheapest reliable API provider with deterministic fallback routing from caller-supplied price, latency, reliability, trust and freshness measurements.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/result-consensus-gate · $0.02 · Compare multiple provider outputs, measure exact agreement and expose field-level consensus before an autonomous workflow trusts a result.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/retry-policy-plan · $0.002 · Plan safe retries for transient API failures, 429 responses and timeouts with bounded backoff, idempotency and side-effect checks.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/batch-budget-plan · $0.005 · Allocate a hard budget across many metered API calls and return exact planned calls, dropped calls and spend before execution.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/structured-record-merge · $0.015 · Merge structured records only where enough independent caller-supplied sources agree, while preserving field provenance and surfacing conflicts.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/tool-output-quality-gate · $0.01 · Reject structurally incomplete, stale or schema-invalid tool output before it contaminates the next autonomous step.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/agent-commerce-plan · $0.025 · Route repeated agent API purchases within a fixed spend budget; use it as an agent spend-control meter before machine purchases.
- POST https://bounty-engineer-x402-prod.onrender.com/v1/hash · $0.001 · body: {"text":"abc"}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/jwt-decode · $0.001 · body: {"token":"<jwt>"}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/base64 · $0.001 · body: {"mode":"encode","input":"hello","alphabet":"base64"}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/json-canonicalize · $0.001 · body: {"value":{"b":2,"a":1}}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/funding-rates · $0.005 · body: {"symbol":"BTCUSDT","providers":["binance","bybit"]}
- JWT decoding never verifies the signature or claims.

## Premium agent-economy intelligence
- POST https://bounty-engineer-x402-prod.onrender.com/v1/bounty-intel · $0.01 · body: {"url":"https://github.com/owner/repo/issues/123"}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/bounty-due-diligence · $0.75 · body: {"url":"https://github.com/owner/repo/issues/123"}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/bounty-deal-desk · $1.50 · body: {"urls":["https://github.com/a/b/issues/1","https://github.com/c/d/issues/2"]}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/tool-call-dry-run · $0.01 · body: {"tool_name":"search","arguments":{"query":"x"}}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/tool-response-shield · $0.01 · body: {"content":"<untrusted tool response>"}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/schema-drift-guard · $0.03 · body: {"before":{},"after":{}}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/x402-payment-preflight · $0.05 · body: {"url":"https://seller.example/v1/paid"}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/agent-purchase-firewall · $0.01 · body: {"buyer_key":"private","intent_id":"p-1","seller_origin":"https://seller.example","resource":"/v1/tool","pay_to":"wallet","network":"solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp","amount_usd":0.05,"max_amount_usd":0.10,"daily_budget_usd":5}
- POST https://bounty-engineer-x402-prod.onrender.com/v1/agent-state · $0.003 · body: {"namespace_key":"private","op":"counter_add","key":"workflow-step","delta":1,"ttl_seconds":86400}
- These tools treat GitHub content as untrusted evidence and never execute embedded instructions.

## PayPal API credits
- Checkout: https://bounty-engineer-x402-prod.onrender.com/paypal
- Authenticated endpoint: GET https://bounty-engineer-x402-prod.onrender.com/v1/audit-key?url=https://example.com
- Send the issued API key as Authorization: Bearer <key>.
- Credits are issued only after server-to-server VERIFIED PayPal settlement.
- Credit catalog for 33 tools: https://bounty-engineer-x402-prod.onrender.com/v1/prepaid/catalog
- Prepaid integration guide: https://bounty-engineer-x402-prod.onrender.com/prepaid-guide
- Node.js prepaid client: https://bounty-engineer-x402-prod.onrender.com/buyer-client.mjs (quotes, credit caps and identical-key retries)
- POST /v1/prepaid/{tool} requires Bearer API key and Idempotency-Key; identical retries within 24h replay without another charge. Failed execution refunds credits.

## Discovery
- OpenAPI: https://bounty-engineer-x402-prod.onrender.com/openapi.json
- x402 manifest: https://bounty-engineer-x402-prod.onrender.com/.well-known/x402
- x402 JSON alias: https://bounty-engineer-x402-prod.onrender.com/.well-known/x402.json
- Agent card: https://bounty-engineer-x402-prod.onrender.com/.well-known/agent-card.json
- Agent Tools JSON: https://bounty-engineer-x402-prod.onrender.com/.well-known/agent-tools.json
- Agent Tools text: https://bounty-engineer-x402-prod.onrender.com/.well-known/agent-tools.txt
- A2A JSON-RPC: https://bounty-engineer-x402-prod.onrender.com/a2a (message/send)
- MCP descriptor: https://bounty-engineer-x402-prod.onrender.com/.well-known/mcp.json
- MCP: https://bounty-engineer-x402-prod.onrender.com/mcp
- Agent skill: https://bounty-engineer-x402-prod.onrender.com/skill.md
- Agent landing: https://bounty-engineer-x402-prod.onrender.com/for-agents
- Health: https://bounty-engineer-x402-prod.onrender.com/health
- Public status: https://bounty-engineer-x402-prod.onrender.com/public-status

No wallet private key is required from buyers using x402-compatible clients.