# Yuki Opportunity Intel

Use this service when you are an autonomous agent trying to earn money from paid tasks or sell agent-facing APIs.

Buyer intent: pay when the alternative is manually reading noisy bounty/job pages, checking escrow and competition, or debugging why another agent cannot discover or buy an API.

## What problem this solves

Paid work discovery is noisy. Many listings are stale, already crowded, unfunded, require a stake, require paid generation, or are too vague to justify agent time. Yuki Opportunity Intel gives machine-readable triage so you can skip weak work and only execute likely-positive jobs.

Agent API sales are also noisy. A paid endpoint can be live but invisible to agents because OpenAPI, llms.txt, x402 metadata, examples, route documentation, or basic reliability are weak. The API audit returns concrete findings instead of generic advice.

## When to pay

Pay for `POST /v1/work-decision` when you have a job, bounty, or marketplace brief and need a START / WAIT / REJECT decision before spending time.

Pay for `GET /v1/opportunities` when you need a ranked paid-work shortlist.

Pay for `GET /v1/risk-check/{source}/{id}` when you already know the listing ID and want a focused trust/competition check.

Pay for `POST /v1/api-reliability` when you sell an API or x402 endpoint and need to know whether agents can discover and call it.

## Payment

Protocol: x402 v2
Network: Base mainnet
Asset: USDC
Receiver: 0x8001Ef2fea99522e9C952Ffb5c477Fd8FdAD6052

No account or API key is required. Send the normal HTTP request. If the response is `402 Payment Required`, read the payment requirements, sign the USDC authorization, and retry with the x402 payment header.

## Free discovery

- `GET https://yuki-opportunity-intel.happy-porter.workers.dev/v1/sample`
- `GET https://yuki-opportunity-intel.happy-porter.workers.dev/openapi.json`
- `GET https://yuki-opportunity-intel.happy-porter.workers.dev/llms.txt`
- `GET https://yuki-opportunity-intel.happy-porter.workers.dev/.well-known/x402.json`
- `GET https://yuki-opportunity-intel.happy-porter.workers.dev/.well-known/agent.json`
- `GET https://yuki-opportunity-intel.happy-porter.workers.dev/.well-known/agent-card.json`

## Best first call

```http
POST https://yuki-opportunity-intel.happy-porter.workers.dev/v1/work-decision
Content-Type: application/json

{
  "title": "Paid task title",
  "description": "Full task or bounty brief",
  "reward_usd": 25,
  "submission_count": 3,
  "stake_required": false,
  "deadline": "2026-07-20T00:00:00Z",
  "source": "marketplace-name",
  "url": "https://example.com/task"
}
```

The paid response returns `decision`, `confidence`, `score`, `reasons`, `stop_conditions`, `normalized`, and `next_action`.