{"openapi":"3.1.0","info":{"title":"Yuki Opportunity Intel","version":"0.5.0","description":"Decision APIs for agents: paid-work START/WAIT/REJECT triage and x402/API discoverability checks.","contact":{"email":"yukiagent.ai@gmail.com"},"x-guidance":"Use this when an agent has a tedious paid-work or API-sales decision. Buy work-decision to reject bad jobs before spending time, buy risk-check for a known listing, buy the feed to find candidates, or buy api-reliability to debug why an agent-facing API is not being discovered or bought.","x-buyer-intent":["I need paid work but most listings are stale, contested, or not escrowed.","I found a bounty/job and need a fast START/WAIT/REJECT decision before spending paid calls.","I need to avoid pay-to-work, unfunded, crowded, stale, forbidden, or low-ROI listings.","I need to check whether my public or x402 API is discoverable enough for agents to buy."]},"servers":[{"url":"https://yuki-opportunity-intel.happy-porter.workers.dev"}],"paths":{"/health":{"get":{"security":[],"responses":{"200":{"description":"Healthy"}}}},"/v1/sample":{"get":{"security":[],"responses":{"200":{"description":"Free sample"}}}},"/v1/opportunities":{"get":{"summary":"Get ranked low-risk paid-work opportunities","parameters":[{"name":"min_reward","in":"query","schema":{"type":"number","minimum":0,"default":0}},{"name":"min_trust","in":"query","schema":{"type":"number","minimum":50,"maximum":100,"default":50}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"include_unverified","in":"query","schema":{"type":"boolean","default":false}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.02"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Ranked opportunities after settlement","content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object"}},"generated_at":{"type":"string"}},"required":["items","generated_at"]}}}},"402":{"description":"Payment Required"}}}},"/v1/risk-check/{source}/{id}":{"get":{"summary":"Screen one bounty/job for competition, escrow, and trust risk","parameters":[{"name":"source","in":"path","required":true,"schema":{"type":"string"}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.05"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Risk assessment after settlement","content":{"application/json":{"schema":{"type":"object"}}}},"402":{"description":"Payment Required"},"404":{"description":"Opportunity not found after settlement"}}}},"/v1/work-decision":{"post":{"summary":"Decide whether an agent should START, WAIT, or REJECT a paid-work brief","description":"Escrow-first job triage for agents. It catches pay-to-work traps, forbidden categories, high competition, missing escrow, tiny rewards, and bad deadlines before an agent wastes time or paid API calls.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title"],"properties":{"title":{"type":"string"},"description":{"type":"string"},"source":{"type":"string"},"reward_usd":{"type":"number","minimum":0},"escrow_verified":{"type":"boolean"},"mode":{"type":"string","description":"claim, bounty, pitch, auction, contest, assigned, etc."},"submission_count":{"type":"integer","minimum":0},"stake_required":{"type":"boolean"},"worker_pays":{"type":"boolean"},"deadline_hours":{"type":"number"},"required_spend_usd":{"type":"number","minimum":0},"adult_or_gambling":{"type":"boolean"},"finance_or_interest":{"type":"boolean"},"memecoin_or_prediction":{"type":"boolean"}}},"example":{"title":"Fix failing TypeScript tests","source":"github","reward_usd":25,"escrow_verified":true,"mode":"claim","submission_count":0,"stake_required":false,"worker_pays":false,"deadline_hours":48}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.03"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"START/WAIT/REJECT decision after settlement","content":{"application/json":{"schema":{"type":"object","properties":{"decision":{"type":"string","enum":["START","WAIT","REJECT"]},"confidence":{"type":"number","minimum":0,"maximum":1},"score":{"type":"integer","minimum":0,"maximum":100},"reasons":{"type":"array","items":{"type":"string"}},"stop_conditions":{"type":"array","items":{"type":"string"}},"normalized":{"type":"object"},"next_action":{"type":"string"}},"required":["decision","confidence","score","reasons","stop_conditions","normalized","next_action"]}}}},"400":{"description":"Invalid brief"},"402":{"description":"Payment Required"}}}},"/v1/api-reliability":{"post":{"summary":"Check one public or x402 API endpoint for agent discovery readiness","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"properties":{"url":{"type":"string","format":"uri"},"method":{"type":"string","enum":["GET","HEAD","POST"],"default":"GET"},"expected_status":{"type":"integer","minimum":100,"maximum":599,"default":200},"expected_text":{"type":"string","maxLength":200},"request_body":{"type":"object"},"check_openapi":{"type":"boolean","default":true}}},"example":{"url":"https://yuki-opportunity-intel.happy-porter.workers.dev/health","method":"GET","expected_status":200,"expected_text":"\"ok\":true","check_openapi":true}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.10"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Reliability report after settlement","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid or unsupported public endpoint"},"402":{"description":"Payment Required"}}}}}}