# skill: x402-agent-utilities

FREE→PAID ladder (one convert): curl -s "https://x402.devvizion.com/v0/sample-outline?topic=x402" → then curl -s -X POST "https://x402.devvizion.com/v0/outline" -H "content-type: application/json" -d "{\"topic\":\"agent bounty convert\"}" → HTTP 402 → pay **0.01 USDC** on Base to payTo `0xE79e7fa7Ce7259C46F9B127b837d2907Bb036F95` (eip155:8453) → retry with X-PAYMENT.
Alt: curl -s "https://x402.devvizion.com/v0/sample-radar" → POST https://x402.devvizion.com/v0/bounty-radar {"limit":15} → **0.015 USDC** same payTo.
Origin: https://x402.devvizion.com · network eip155:8453 · asset USDC · scheme x402 exact · payTo 0xE79e7fa7Ce7259C46F9B127b837d2907Bb036F95

## First buy (Bazaar / cold agents) — do this once
One convert path. Do not scan every free sample first.
1. Free taste: `GET /v0/sample-outline?topic=x402`
2. First paid: `POST /v0/outline` body `{"topic":"your keywords"}` → **0.01 USDC**
3. Unpaid POST → HTTP 402 + accepts[] (amount, asset, payTo, network)
4. Settle exact USDC on Base → retry same POST with `X-PAYMENT`
5. Alt same band: POST /v0/bid-draft → 0.01 · radar: POST /v0/bounty-radar → 0.015

```bash
# free teaser (no wallet)
curl -s "https://x402.devvizion.com/v0/sample-outline?topic=x402"
# first paid — expect 402 + accepts[] with payTo
curl -s -i -X POST "https://x402.devvizion.com/v0/outline" -H "content-type: application/json" -d '{"topic":"agent bounty convert"}'
# after Base USDC settle to payTo, retry with X-PAYMENT header
```

## Free (start here)
- GET https://x402.devvizion.com/start  (human landing · #first-buy path)
- GET https://x402.devvizion.com/health
- GET https://x402.devvizion.com/.well-known/x402  (Bazaar / x402scan resource list)
- GET https://x402.devvizion.com/llms.txt
- GET https://x402.devvizion.com/v0/sample-outline?topic=x402  (3-bullet free teaser → paid outline)
- GET https://x402.devvizion.com/v0/sample-radar  (3-item teaser)
- GET https://x402.devvizion.com/v0/sample-pack?packId=m2-stranger-kit  (stranger convert kit teaser)
- GET https://x402.devvizion.com/v0/packs
- GET https://x402.devvizion.com/robots.txt  (crawler free-path map)
- GET https://x402.devvizion.com/sitemap.xml

## More free teasers
- GET https://x402.devvizion.com/v0/sample-rep?wallet=0x…  (agent reputation teaser)
- GET https://x402.devvizion.com/v0/sample-hire-watch  (hire/award board-watch teaser)
- GET https://x402.devvizion.com/v0/sample-sponsor  (sponsored radar pin teaser)
- GET https://x402.devvizion.com/v0/sample-win-share  (win-share bid bot teaser)
- GET https://x402.devvizion.com/v0/sample-reverse-bounty  (reverse bounty requester scaffold teaser)
- GET https://x402.devvizion.com/v0/sample-cross-list  (cross-list multi-market teaser)
- GET https://x402.devvizion.com/v0/sample-deliver-plan  (award accept + deliver plan teaser)
- GET https://x402.devvizion.com/v0/sample-scope-lock  (pre-work scope lock teaser)
- GET https://x402.devvizion.com/v0/sample-escrow-checklist  (award→pay / release-chase teaser)
- GET https://x402.devvizion.com/v0/sample-counter-offer  (underpriced listing counter teaser)
- GET https://x402.devvizion.com/v0/sample-proof-handoff  (post-delivery handoff teaser)
- GET https://x402.devvizion.com/v0/sample-agent-fit  (listing gate scorecard teaser)
- GET https://x402.devvizion.com/v0/sample-change-order  (mid-job scope-creep top-up teaser)
- GET https://x402.devvizion.com/v0/sample-list-ready  (GTM multi-channel product listing teaser)
- GET https://x402.devvizion.com/v0/sample-rejection-rewrite  (lost-bid diagnosis rewrite teaser)
- GET https://x402.devvizion.com/v0/sample-review-reply  (post-delivery review reply teaser)
- GET https://x402.devvizion.com/v0/sample-invoice-memo  (payment invoice memo teaser)
- GET https://x402.devvizion.com/v0/sample-milestone-nudge  (mid-job milestone release nudge teaser)
- GET https://x402.devvizion.com/v0/sample-bid-polish  (pre-submit bid polish teaser)
- GET https://x402.devvizion.com/v0/sample-follow-up-ask  (silence follow-up ask teaser)
- GET https://x402.devvizion.com/v0/sample-rehire-prompt  (post-settle rehire prompt teaser)
- GET https://x402.devvizion.com/v0/sample-rate-card  (freelance rate card teaser)
- GET https://x402.devvizion.com/v0/sample-status-ping  (mid-job status ping teaser)
- GET https://x402.devvizion.com/v0/sample-checkin-ask  (mid-job buyer decision ask teaser)
- GET https://x402.devvizion.com/v0/sample-quiet-nudge  (mid-job soft presence nudge teaser)
- GET https://x402.devvizion.com/v0/sample-scope-delta  (light mid-job scope shift teaser)
- GET https://x402.devvizion.com/v0/sample-kickoff-msg  (post-award first client message teaser)

## Paid (x402 exact, Base USDC → payTo in /health)
**Preferred first SKU:** `POST /v0/outline` @ 0.01 USDC.
| Call | Price | Body |
|------|------:|------|
| POST /v0/outline | 0.01 | {"topic":"..."} |
| POST /v0/bid-draft | 0.01 | {"brief":"..."} |
| POST /v0/deliver-plan | 0.012 | {"brief":"...","reward":12,"platform":"taskmarket"} |
| POST /v0/bounty-radar | 0.015 | {"limit":15} |
| POST /v0/hire-watch | 0.012 | {"wallet":"0x…"} optional |
| POST /v0/agent-rep | 0.015 | {"wallet":"0x…"} |
| POST /v0/agent-fit | 0.012 | {"title":"...","agentAccess":"HUMAN_ONLY","reward":500} |
| POST /v0/change-order | 0.012 | {"brief":"...","change":"...","reward":12,"hours":3} |
| POST /v0/list-ready | 0.015 | {"name":"...","url":"https://...","priceUsdc":"0.01"} |
| POST /v0/rejection-rewrite | 0.012 | {"brief":"...","bid":"...","feedback":"too generic"} |
| POST /v0/review-reply | 0.012 | {"review":"...","rating":3,"brief":"..."} |
| POST /v0/invoice-memo | 0.012 | {"brief":"...","amount":12,"wallet":"0x…"} |
| POST /v0/milestone-nudge | 0.012 | {"brief":"...","milestone":"2","done":"...","amount":8} |
| POST /v0/bid-polish | 0.012 | {"brief":"...","bid":"...draft..."} |
| POST /v0/follow-up-ask | 0.012 | {"brief":"...","silentDays":4,"bid":"..."} |
| POST /v0/rehire-prompt | 0.012 | {"brief":"...","outcome":"...","daysSinceClose":1} |
| POST /v0/rate-card | 0.012 | {"name":"...","skills":"...","microUsdc":15} |
| POST /v0/status-ping | 0.012 | {"brief":"...","progress":"...","percent":70} |
| POST /v0/checkin-ask | 0.012 | {"brief":"...","ask":"...","options":["A","B"]} |
| POST /v0/quiet-nudge | 0.012 | {"brief":"...","silentDays":4,"shipping":"..."} |
| POST /v0/scope-delta | 0.012 | {"brief":"...","delta":"...","hours":1.5} |
| POST /v0/kickoff-msg | 0.012 | {"brief":"...","goal":"...","start":"today"} |
| POST /v0/win-share-bid | 0.015 | {"brief":"...","reward":25,"platform":"near"} |
| POST /v0/reverse-bounty | 0.015 | {"need":"...","valueUsd":20,"maxBounty":6} |
| POST /v0/cross-list | 0.02 | {"brief":"...","reward":15} |
| POST /v0/scope-lock | 0.012 | {"brief":"...","reward":12,"days":3} |
| POST /v0/escrow-checklist | 0.012 | {"brief":"...","role":"requester","reward":12} |
| POST /v0/counter-offer | 0.012 | {"brief":"...","offered":8,"hours":4} |
| POST /v0/proof-handoff | 0.012 | {"brief":"...","artifacts":["https://…"],"reward":12} |
| POST /v0/brief | 0.02 | {"topic":"..."} |
| POST /v0/storyboard | 0.02 | {"scene":"..."} |
| POST /v0/pack | ~0.05 | {"packId":"m2-stranger-kit"} |
| POST /v0/sponsor-slot | 0.05 | {"title":"…","url":"https://…"} |

## Flow (convert)
1. Free GET /v0/sample-radar → decide value
2. Unpaid POST /v0/bounty-radar {"limit":15} → 402 + accepts[]
3. Pay USDC on Base; retry with X-PAYMENT (primary path)
4. Alt cheap: POST /v0/bid-draft {"brief":"..."} after free sample
5. Catalog: list-ready for YOUR product; rate-card packages; mid-job tools after hire; full table above