{ "openapi": "3.0.3", "info": { "title": "Agent Utilities API (x402)", "version": "0.3.51", "description": "Micropay agent utilities on Base: research outline/brief, multi-shot storyboard, bounty radar, bid drafts, ready research packs. Free discovery; paid POSTs when X402_ENFORCE=1.", "contact": { "name": "money-engine x402-sell", "url": "https://x402.devvizion.com", "email": "x402@devvizion.com" } }, "servers": [ { "url": "https://x402.devvizion.com" } ], "paths": { "/": { "get": { "summary": "Human landing (Open Graph + free CTA)", "security": [], "responses": { "200": { "description": "text/html landing" } } } }, "/health": { "get": { "summary": "Liveness + pricing snapshot", "security": [], "responses": { "200": { "description": "ok" } } } }, "/robots.txt": { "get": { "summary": "Crawler free-path map (Allow list + Sitemap)", "description": "Unauthenticated. Lists free GET discovery routes for web/agent crawlers. No paid SKU spam.", "operationId": "robotsTxt", "security": [], "responses": { "200": { "description": "text/plain robots.txt" } } } }, "/sitemap.xml": { "get": { "summary": "Sitemap of free discovery paths", "description": "Unauthenticated. Free teasers + skill.md + openapi + llms. Paid POSTs omitted.", "operationId": "sitemapXml", "security": [], "responses": { "200": { "description": "application/xml sitemap" } } } }, "/.well-known/x402": { "get": { "summary": "x402 discovery (resources + atomic accepts)", "security": [], "responses": { "200": { "description": "x402Version + resources[]" } } } }, "/llms.txt": { "get": { "summary": "Agent-readable endpoint list", "security": [], "responses": { "200": { "description": "text/plain" } } } }, "/openapi.json": { "get": { "summary": "This document", "security": [], "responses": { "200": { "description": "OpenAPI 3" } } } }, "/v0/sample-outline": { "get": { "summary": "Free 3-bullet outline teaser (no payment)", "description": "Unauthenticated teaser. Query ?topic=x402 (default). Drives paid POST /v0/outline.", "operationId": "sampleOutline", "security": [], "parameters": [ { "name": "topic", "in": "query", "required": false, "schema": { "type": "string", "default": "x402" }, "description": "Topic for the free teaser bullets" } ], "responses": { "200": { "description": "text/markdown 3-bullet sample + upgrade CTA" } } } }, "/v0/outline": { "post": { "summary": "Compact bullet outline (0.01 USDC)", "description": "x402-gated. Unpaid POST returns HTTP 402 with accepts[] (exact USDC on Base). Body required only after payment. Free teaser: GET /v0/sample-outline?topic=...", "operationId": "researchOutline", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "topic": { "type": "string", "description": "Research topic or question", "example": "x402 micropay research for agents" }, "url": { "type": "string", "description": "Optional URL to analyze (alias for topic)" } }, "anyOf": [ { "required": [ "topic" ] }, { "required": [ "url" ] } ] } } } }, "responses": { "200": { "description": "text/markdown outline" }, "400": { "description": "missing topic (after payment)" }, "402": { "description": "payment required (enforce mode)" } } } }, "/v0/brief": { "post": { "summary": "Full research scaffold (0.02 USDC)", "description": "x402-gated Taskmarket-shaped brief. Unpaid POST returns HTTP 402 with accepts[].", "operationId": "researchBrief", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "topic": { "type": "string", "description": "Research topic or question", "example": "x402 micropay research for agents" }, "url": { "type": "string", "description": "Optional URL to analyze (alias for topic)" } }, "anyOf": [ { "required": [ "topic" ] }, { "required": [ "url" ] } ] } } } }, "responses": { "200": { "description": "text/markdown brief" }, "400": { "description": "missing topic (after payment)" }, "402": { "description": "payment required (enforce mode)" } } } }, "/v0/storyboard": { "post": { "summary": "Multi-shot video storyboard (0.02 USDC)", "description": "x402-gated multi-shot markdown storyboard for video/agent content. Body: scene or topic. No external video gen.", "operationId": "videoStoryboard", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "scene": { "type": "string", "description": "Scene or creative premise", "example": "agent pays for research brief in 30s" }, "topic": { "type": "string", "description": "Alias for scene" }, "url": { "type": "string", "description": "Optional URL as creative seed" } }, "anyOf": [ { "required": [ "scene" ] }, { "required": [ "topic" ] }, { "required": [ "url" ] } ] } } } }, "responses": { "200": { "description": "text/markdown multi-shot storyboard" }, "400": { "description": "missing scene/topic (after payment)" }, "402": { "description": "payment required (enforce mode)" } } } }, "/v0/bounty-radar": { "post": { "summary": "Multi-source open bounty radar (0.015 USDC)", "description": "Live ranked open work from Superteam, Arena42, GitHub bounty issues, Taskmarket.", "operationId": "bountyRadar", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "limit": { "type": "number" }, "sources": { "type": "array", "items": { "type": "string" } }, "agentOnly": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "text/markdown radar table + JSON" }, "402": { "description": "payment required" } } } }, "/v0/sample-rep": { "get": { "summary": "Free agent reputation teaser (no payment)", "description": "Unauthenticated. Query ?wallet=0x… optional. Full report: paid POST /v0/agent-rep.", "operationId": "sampleAgentRep", "security": [], "parameters": [ { "name": "wallet", "in": "query", "required": false, "schema": { "type": "string" }, "description": "0x wallet to teaser-score" } ], "responses": { "200": { "description": "text/markdown score teaser + upgrade CTA" } } } }, "/v0/agent-rep": { "post": { "summary": "Agent reputation mirror (0.015 USDC)", "description": "x402-gated. Score a wallet from public Taskmarket task sample + Base chain (nonce, ETH, USDC). Unpaid POST → 402.", "operationId": "agentReputation", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "wallet": { "type": "string", "description": "0x Base address to score", "example": "0x2eA66FD758669B6F8B3173ae238A19AE6e2c7250" }, "address": { "type": "string", "description": "Alias for wallet" }, "agent": { "type": "string", "description": "Alias for wallet" } }, "anyOf": [ { "required": [ "wallet" ] }, { "required": [ "address" ] }, { "required": [ "agent" ] } ] } } } }, "responses": { "200": { "description": "text/markdown reputation report" }, "400": { "description": "missing/invalid wallet" }, "402": { "description": "payment required" } } } }, "/v0/bid-draft": { "post": { "summary": "Freelance bid draft (0.01 USDC)", "description": "Generate a structured bid/application from a job brief.", "operationId": "bidDraft", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string" }, "topic": { "type": "string" }, "skills": { "type": "string" }, "tone": { "type": "string" } } } } } }, "responses": { "200": { "description": "text/markdown bid draft" }, "400": { "description": "missing brief" }, "402": { "description": "payment required" } } } }, "/v0/sample-win-share": { "get": { "summary": "Free win-share bid bot teaser", "description": "Unauthenticated. Demo EV scorecard + truncated bid. Full bot: paid POST /v0/win-share-bid.", "operationId": "sampleWinShareBid", "security": [], "responses": { "200": { "description": "text/markdown win-share teaser" } } } }, "/v0/sample-reverse-bounty": { "get": { "summary": "Free reverse bounty scaffold teaser", "description": "Unauthenticated. Demo requester EV gate + task snippet. Full scaffold: paid POST /v0/reverse-bounty.", "operationId": "sampleReverseBounty", "security": [], "responses": { "200": { "description": "text/markdown reverse-bounty teaser" } } } }, "/v0/reverse-bounty": { "post": { "summary": "Reverse bounty scaffold (0.015 USDC)", "description": "x402-gated. Requester EV gate (post/skip) + paste-ready task title/description/acceptance + platform post checklist.", "operationId": "reverseBounty", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "need": { "type": "string", "description": "What work you need done" }, "goal": { "type": "string", "description": "Alias for need" }, "topic": { "type": "string", "description": "Alias for need" }, "valueUsd": { "type": "number", "description": "Estimated value of received work (USDC)" }, "maxBounty": { "type": "number", "description": "Planned bounty/budget (USDC)" }, "platform": { "type": "string", "description": "taskmarket|near|dealwork|molt|ugig|generic" }, "quality": { "type": "number", "description": "Prior on delivery quality 0–1" }, "turnaroundHours": { "type": "number" }, "deliverable": { "type": "string" } }, "anyOf": [ { "required": [ "need" ] }, { "required": [ "goal" ] }, { "required": [ "topic" ] }, { "required": [ "brief" ] } ] } } } }, "responses": { "200": { "description": "text/markdown reverse bounty pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-cross-list": { "get": { "summary": "Free cross-list broker teaser", "description": "Unauthenticated. One-market truncated listing. Full 5-market pack: paid POST /v0/cross-list.", "operationId": "sampleCrossList", "security": [], "responses": { "200": { "description": "text/markdown cross-list teaser" } } } }, "/v0/cross-list": { "post": { "summary": "Cross-list broker (0.02 USDC)", "description": "x402-gated. One brief → paste-ready title/description/budget for Taskmarket, NEAR, Dealwork, Moltjobs, uGig.", "operationId": "crossList", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Work brief to multi-list" }, "need": { "type": "string", "description": "Alias for brief" }, "topic": { "type": "string", "description": "Alias for brief" }, "title": { "type": "string" }, "reward": { "type": "number", "description": "Base budget USDC (tilted per market)" }, "category": { "type": "string" }, "skills": { "type": "string" }, "deliverable": { "type": "string" }, "platforms": { "type": "array", "items": { "type": "string" }, "description": "Subset of taskmarket|near|dealwork|molt|ugig" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "need" ] }, { "required": [ "topic" ] }, { "required": [ "title" ] } ] } } } }, "responses": { "200": { "description": "text/markdown multi-market listing pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-deliver-plan": { "get": { "summary": "Free deliver-plan teaser", "description": "Unauthenticated. Truncated award-accept snippet. Full milestones + settle: paid POST /v0/deliver-plan.", "operationId": "sampleDeliverPlan", "security": [], "responses": { "200": { "description": "text/markdown deliver-plan teaser" } } } }, "/v0/deliver-plan": { "post": { "summary": "Deliver plan (0.012 USDC)", "description": "x402-gated. Post-award convert: paste-ready accept message, 3 milestones, scope lock, verify checklist, settle memo.", "operationId": "deliverPlan", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Awarded job brief" }, "job": { "type": "string", "description": "Alias for brief" }, "title": { "type": "string" }, "reward": { "type": "number", "description": "USDC budget" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|generic" }, "deadlineDays": { "type": "number", "description": "ETA days (default 5)" }, "wallet": { "type": "string", "description": "0x payTo for settle memo" }, "skills": { "type": "string" }, "deliverable": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "topic" ] } ] } } } }, "responses": { "200": { "description": "text/markdown deliver plan pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-scope-lock": { "get": { "summary": "Free scope-lock teaser", "description": "Unauthenticated. Truncated acceptance criteria. Full in/out scope + change-order + sign-off: paid POST /v0/scope-lock.", "operationId": "sampleScopeLock", "security": [], "responses": { "200": { "description": "text/markdown scope-lock teaser" } } } }, "/v0/scope-lock": { "post": { "summary": "Scope lock (0.012 USDC)", "description": "x402-gated. Pre-work convert: paste-ready acceptance criteria, in/out of scope, change-order policy, buyer sign-off block.", "operationId": "scopeLock", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job brief to freeze" }, "job": { "type": "string", "description": "Alias for brief" }, "title": { "type": "string" }, "reward": { "type": "number", "description": "USDC budget" }, "days": { "type": "number", "description": "ETA days (default 5)" }, "platform": { "type": "string" }, "deliverable": { "type": "string" }, "constraints": { "type": "string", "description": "Hard constraints (newline/semicolon list)" }, "outOfScope": { "type": "string", "description": "Extra out-of-scope items" }, "revisions": { "type": "number", "description": "Included revision passes (default 1)" }, "wallet": { "type": "string", "description": "0x payTo for sign-off" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "topic" ] } ] } } } }, "responses": { "200": { "description": "text/markdown scope lock pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-escrow-checklist": { "get": { "summary": "Free escrow-checklist teaser", "description": "Unauthenticated. Gate + verify snippet. Full release/chase pack: paid POST /v0/escrow-checklist.", "operationId": "sampleEscrowChecklist", "security": [], "responses": { "200": { "description": "text/markdown escrow-checklist teaser" } } } }, "/v0/sample-counter-offer": { "get": { "summary": "Free counter-offer teaser", "description": "Unauthenticated. Truncated underpriced-listing counter. Full pricing math + A/B options + walk rules: paid POST /v0/counter-offer.", "operationId": "sampleCounterOffer", "security": [], "responses": { "200": { "description": "text/markdown counter-offer teaser" } } } }, "/v0/counter-offer": { "post": { "summary": "Counter-offer (0.012 USDC)", "description": "x402-gated. Bid convert when listed reward is thin: pricing math, paste-ready counter, Option A/B, walk-away floor.", "operationId": "counterOffer", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job brief to counter" }, "job": { "type": "string", "description": "Alias for brief" }, "title": { "type": "string" }, "offered": { "type": "number", "description": "Listed / offered USDC" }, "reward": { "type": "number", "description": "Alias for offered" }, "ask": { "type": "number", "description": "Optional target ask USDC" }, "hours": { "type": "number", "description": "Effort hours estimate (default 3)" }, "complexity": { "type": "string", "description": "low|medium|high|expert" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|generic" }, "leverage": { "type": "string", "description": "Why-you edge line" }, "deliverable": { "type": "string" }, "wallet": { "type": "string", "description": "0x payTo for off-platform" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "topic" ] } ] } } } }, "responses": { "200": { "description": "text/markdown counter-offer pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-proof-handoff": { "get": { "summary": "Free proof-handoff teaser", "description": "Unauthenticated. Artifact index snippet. Full evidence matrix + review message + settle: paid POST /v0/proof-handoff.", "operationId": "sampleProofHandoff", "security": [], "responses": { "200": { "description": "text/markdown proof-handoff teaser" } } } }, "/v0/proof-handoff": { "post": { "summary": "Proof handoff (0.012 USDC)", "description": "x402-gated. Post-delivery convert: artifact index, acceptance evidence matrix, ready-for-review message, settle memo.", "operationId": "proofHandoff", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Finished job brief" }, "job": { "type": "string", "description": "Alias for brief" }, "title": { "type": "string" }, "reward": { "type": "number", "description": "USDC amount" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "wallet": { "type": "string", "description": "0x payTo for settle memo" }, "deliverableUrl": { "type": "string" }, "artifacts": { "type": "string", "description": "Links (array or newline list)" }, "criteria": { "type": "string" }, "revisions": { "type": "number" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "topic" ] } ] } } } }, "responses": { "200": { "description": "text/markdown proof handoff pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-agent-fit": { "get": { "summary": "Free agent-fit gate teaser", "description": "Unauthenticated. Scorecard snippet for Superteam-style access gates. Full submit body + human-bridge + pivot: paid POST /v0/agent-fit.", "operationId": "sampleAgentFit", "security": [], "responses": { "200": { "description": "text/markdown agent-fit teaser" } } } }, "/v0/agent-fit": { "post": { "summary": "Agent-fit gate map (0.012 USDC)", "description": "x402-gated. Score a listing for autonomous agent work: access gate, EV score, Superteam submit body or human-bridge, fit0 pivot path.", "operationId": "agentFit", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "description": "Listing title" }, "brief": { "type": "string", "description": "Alias for title/brief" }, "agentAccess": { "type": "string", "description": "AGENT_ALLOWED|AGENT_ONLY|HUMAN_ONLY" }, "access": { "type": "string", "description": "Alias for agentAccess" }, "reward": { "type": "number", "description": "USDC reward" }, "deadline": { "type": "string", "description": "ISO deadline" }, "submissions": { "type": "number" }, "type": { "type": "string" }, "sponsor": { "type": "string" }, "region": { "type": "string" }, "slug": { "type": "string" }, "listingId": { "type": "string" }, "link": { "type": "string", "description": "Deliverable URL for submit body" }, "skills": { "type": "string" }, "description": { "type": "string" } }, "anyOf": [ { "required": [ "title" ] }, { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "topic" ] } ] } } } }, "responses": { "200": { "description": "text/markdown agent-fit map" }, "402": { "description": "payment required" } } } }, "/v0/sample-change-order": { "get": { "summary": "Free change-order teaser", "description": "Unauthenticated. Delta table snippet. Full top-up math + accept/reject + escrow memo: paid POST /v0/change-order.", "operationId": "sampleChangeOrder", "security": [], "responses": { "200": { "description": "text/markdown change-order teaser" } } } }, "/v0/change-order": { "post": { "summary": "Change order (0.012 USDC)", "description": "x402-gated. Mid-job scope-creep convert: delta table, top-up math, accept/reject paste, escrow top-up memo.", "operationId": "changeOrder", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Original awarded brief" }, "job": { "type": "string", "description": "Alias for brief" }, "title": { "type": "string" }, "change": { "type": "string", "description": "Requested extra scope (semicolon list ok)" }, "delta": { "type": "string", "description": "Alias for change" }, "reward": { "type": "number", "description": "Original award USDC" }, "hours": { "type": "number", "description": "Extra hours estimate" }, "rate": { "type": "number", "description": "Hourly rate USDC" }, "topUp": { "type": "number", "description": "Explicit top-up USDC" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "wallet": { "type": "string", "description": "0x payTo for top-up memo" }, "complexity": { "type": "string" }, "urgency": { "type": "string" }, "deliverable": { "type": "string" } }, "anyOf": [ { "required": [ "change" ] }, { "required": [ "delta" ] }, { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] } ] } } } }, "responses": { "200": { "description": "text/markdown change-order pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-list-ready": { "get": { "summary": "Free list-ready GTM teaser", "description": "Unauthenticated. Demo multi-channel product listing. Full custom pack: paid POST /v0/list-ready.", "operationId": "sampleListReady", "security": [], "responses": { "200": { "description": "text/markdown list-ready teaser" } } } }, "/v0/list-ready": { "post": { "summary": "List-ready GTM pack (0.015 USDC)", "description": "x402-gated. Multi-channel product listing pack for AgentWorld/x402scout/bazaar/skill/social + stranger convert ladder. Not freelance job cross-list.", "operationId": "listReady", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "Product / service name" }, "title": { "type": "string", "description": "Alias for name" }, "url": { "type": "string", "description": "Public origin HTTPS URL" }, "origin": { "type": "string" }, "endpoint": { "type": "string" }, "priceUsdc": { "type": "string", "description": "First-buy tier" }, "price": { "type": "string" }, "angle": { "type": "string", "description": "One-line value prop" }, "description": { "type": "string" }, "freeSample": { "type": "string" }, "paidPath": { "type": "string" }, "category": { "type": "string" }, "payTo": { "type": "string" } }, "anyOf": [ { "required": [ "name" ] }, { "required": [ "title" ] } ] } } } }, "responses": { "200": { "description": "text/markdown list-ready GTM pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-rejection-rewrite": { "get": { "summary": "Free rejection-rewrite teaser", "description": "Unauthenticated. Diagnosis snippet for lost bids. Full rewrite + short rebid + pivot: paid POST /v0/rejection-rewrite.", "operationId": "sampleRejectionRewrite", "security": [], "responses": { "200": { "description": "text/markdown rejection-rewrite teaser" } } } }, "/v0/rejection-rewrite": { "post": { "summary": "Rejection rewrite (0.012 USDC)", "description": "x402-gated. After a no/silence: diagnose rejection signals, paste-ready full rewrite + short rebid + soft feedback ask + pivot rule. Distinct from bid-draft (cold first bid) and counter-offer (price push).", "operationId": "rejectionRewrite", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Listing brief / job title" }, "job": { "type": "string" }, "title": { "type": "string" }, "bid": { "type": "string", "description": "Prior bid / proposal text that was rejected" }, "draft": { "type": "string", "description": "Alias for bid" }, "feedback": { "type": "string", "description": "Buyer feedback or reject reason" }, "reason": { "type": "string" }, "skills": { "type": "string" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "reward": { "type": "number" }, "hours": { "type": "number" }, "nextBrief": { "type": "string", "description": "Optional pivot listing brief" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "bid" ] }, { "required": [ "feedback" ] }, { "required": [ "job" ] }, { "required": [ "title" ] } ] } } } }, "responses": { "200": { "description": "text/markdown rejection rewrite pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-review-reply": { "get": { "summary": "Free review-reply teaser", "description": "Unauthenticated. Diagnosis snippet for buyer reviews. Full primary + short + bump replies: paid POST /v0/review-reply.", "operationId": "sampleReviewReply", "security": [], "responses": { "200": { "description": "text/markdown review-reply teaser" } } } }, "/v0/review-reply": { "post": { "summary": "Review reply (0.012 USDC)", "description": "x402-gated. After delivery when a buyer posts a review/rating: diagnose sentiment, paste-ready primary + short + 24h bump replies, soft release ask or bounded fix plan. Distinct from proof-handoff (artifact pack) and rejection-rewrite (lost bid).", "operationId": "reviewReply", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job / delivery title" }, "job": { "type": "string" }, "title": { "type": "string" }, "review": { "type": "string", "description": "Buyer review / comment text" }, "comment": { "type": "string", "description": "Alias for review" }, "rating": { "type": "number", "description": "1-5 star rating" }, "sentiment": { "type": "string", "description": "positive|neutral|negative|revision (optional override)" }, "artifacts": { "description": "Deliverable URL(s) — string or string[]" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "reward": { "type": "number" }, "wallet": { "type": "string" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "review" ] }, { "required": [ "comment" ] }, { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] } ] } } } }, "responses": { "200": { "description": "text/markdown review reply pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-invoice-memo": { "get": { "summary": "Free invoice-memo teaser", "description": "Unauthenticated. Diagnosis snippet for payment invoices. Full formal invoice + chase + settle memo: paid POST /v0/invoice-memo.", "operationId": "sampleInvoiceMemo", "security": [], "responses": { "200": { "description": "text/markdown invoice-memo teaser" } } } }, "/v0/invoice-memo": { "post": { "summary": "Invoice memo (0.012 USDC)", "description": "x402-gated. When work/milestone is done and you need pay: formal invoice, short memo, soft/firm chase, settle memo with payTo + Base USDC. Distinct from proof-handoff (artifacts), escrow-checklist (release path), review-reply (rating replies).", "operationId": "invoiceMemo", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job / delivery title" }, "job": { "type": "string" }, "title": { "type": "string" }, "amount": { "type": "number", "description": "Amount due in USDC" }, "reward": { "type": "number", "description": "Alias for amount" }, "items": { "description": "Line items — string[] or {desc,amount,qty}[]" }, "wallet": { "type": "string", "description": "0x payTo wallet on Base" }, "payTo": { "type": "string", "description": "Alias for wallet" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "artifacts": { "description": "Deliverable URL(s) — string or string[]" }, "daysOutstanding": { "type": "number", "description": "Days since invoice / delivery" }, "buyer": { "type": "string" }, "invoiceId": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "amount" ] }, { "required": [ "reward" ] }, { "required": [ "items" ] } ] } } } }, "responses": { "200": { "description": "text/markdown invoice memo pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-milestone-nudge": { "get": { "summary": "Free milestone-nudge teaser", "description": "Unauthenticated. Diagnosis snippet for mid-job milestone release. Full primary + short + 48h bump: paid POST /v0/milestone-nudge.", "operationId": "sampleMilestoneNudge", "security": [], "responses": { "200": { "description": "text/markdown milestone-nudge teaser" } } } }, "/v0/sample-bid-polish": { "get": { "summary": "Free bid-polish teaser", "description": "Unauthenticated. Diagnosis snippet for pre-submit bid polish. Full polished + short bid + checklist: paid POST /v0/bid-polish.", "operationId": "sampleBidPolish", "security": [], "responses": { "200": { "description": "text/markdown bid-polish teaser" } } } }, "/v0/bid-polish": { "post": { "summary": "Bid polish (0.012 USDC)", "description": "x402-gated. Pre-submit polish of an existing draft bid: weakness diagnosis, polished paste body, short bid, checklist. Distinct from bid-draft (cold first draft), rejection-rewrite (after a no), win-share-bid (EV+draft).", "operationId": "bidPolish", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job text" }, "job": { "type": "string" }, "title": { "type": "string" }, "bid": { "type": "string", "description": "Your draft bid to polish" }, "draft": { "type": "string" }, "priorBid": { "type": "string" }, "skills": { "type": "string" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "reward": { "type": "number" }, "amount": { "type": "number" }, "maxWords": { "type": "number" }, "hours": { "type": "number" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "bid" ] }, { "required": [ "draft" ] }, { "required": [ "priorBid" ] }, { "required": [ "text" ] } ] } } } }, "responses": { "200": { "description": "text/markdown bid polish pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-follow-up-ask": { "get": { "summary": "Free follow-up-ask teaser", "description": "Unauthenticated. Diagnosis snippet for post-bid silence. Full soft / value-add / last-look ladder: paid POST /v0/follow-up-ask.", "operationId": "sampleFollowUpAsk", "security": [], "responses": { "200": { "description": "text/markdown follow-up-ask teaser" } } } }, "/v0/follow-up-ask": { "post": { "summary": "Follow-up ask (0.012 USDC)", "description": "x402-gated. After bid silence (no award, no explicit reject): paste-ready soft check-in, value-add bump, last-look, cadence. Distinct from rejection-rewrite (after a no), bid-polish (pre-submit), hire-watch (board pulse).", "operationId": "followUpAsk", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job text" }, "job": { "type": "string" }, "title": { "type": "string" }, "bid": { "type": "string", "description": "Optional prior bid for context" }, "priorBid": { "type": "string" }, "silentDays": { "type": "number", "description": "Days since bid with no reply" }, "days": { "type": "number" }, "skills": { "type": "string" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "reward": { "type": "number" }, "amount": { "type": "number" }, "proof": { "type": "string" }, "valueAdd": { "type": "string", "description": "New proof or update since bid" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "bid" ] }, { "required": [ "priorBid" ] } ] } } } }, "responses": { "200": { "description": "text/markdown follow-up-ask pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-rehire-prompt": { "get": { "summary": "Free rehire-prompt teaser", "description": "Unauthenticated. Timing snippet for post-settle rehire. Full primary/short/referral/7d bump: paid POST /v0/rehire-prompt.", "operationId": "sampleRehirePrompt", "security": [], "responses": { "200": { "description": "text/markdown rehire-prompt teaser" } } } }, "/v0/rehire-prompt": { "post": { "summary": "Rehire prompt (0.012 USDC)", "description": "x402-gated. After job settle/close: paste-ready rehire primary, short DM, referral ask, 7d bump, next-brief offer card. Distinct from review-reply (rating response), invoice-memo (pay chase), change-order (mid-job expand).", "operationId": "rehirePrompt", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Closed job title" }, "job": { "type": "string" }, "title": { "type": "string" }, "outcome": { "type": "string", "description": "What shipped / settled" }, "done": { "type": "string" }, "nextWork": { "type": "string", "description": "Proposed next deliverable" }, "next": { "type": "string" }, "artifacts": { "type": "array", "items": { "type": "string" } }, "skills": { "type": "string" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "reward": { "type": "number" }, "amount": { "type": "number" }, "daysSinceClose": { "type": "number" }, "buyer": { "type": "string" }, "tone": { "type": "string" }, "wallet": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "outcome" ] } ] } } } }, "responses": { "200": { "description": "text/markdown rehire prompt pack" }, "402": { "description": "payment required" } } } }, "/v0/sample-rate-card": { "get": { "summary": "Free rate-card teaser", "description": "Unauthenticated. Package floors + stranger CTA (price, payTo Base USDC, numbered buy steps). Full paste card + DM + profile + rails: paid POST /v0/rate-card (0.012 USDC). Unpaid paid route → HTTP 402.", "operationId": "sampleRateCard", "security": [], "responses": { "200": { "description": "text/markdown rate-card teaser with price/payTo/next-step CTA" } } } }, "/v0/sample-status-ping": { "get": { "summary": "Free status-ping teaser", "description": "Unauthenticated. Mid-job progress-only status snippet. Full paste + DM + cadence: paid POST /v0/status-ping.", "operationId": "sampleStatusPing", "security": [], "responses": { "200": { "description": "text/markdown status-ping teaser" } } } }, "/v0/sample-checkin-ask": { "get": { "summary": "Free checkin-ask teaser", "description": "Unauthenticated. Mid-job buyer decision ask snippet. Full paste + short + DM + cadence: paid POST /v0/checkin-ask.", "operationId": "sampleCheckinAsk", "security": [], "responses": { "200": { "description": "text/markdown checkin-ask teaser" } } } }, "/v0/sample-quiet-nudge": { "get": { "summary": "Free quiet-nudge teaser", "description": "Unauthenticated. Mid-job soft presence snippet. Full paste + short + DM + cadence: paid POST /v0/quiet-nudge.", "operationId": "sampleQuietNudge", "security": [], "responses": { "200": { "description": "text/markdown quiet-nudge teaser" } } } }, "/v0/sample-scope-delta": { "get": { "summary": "Free scope-delta teaser", "description": "Unauthenticated. Mid-job scope shift matrix snippet. Full confirm paste + escalate table: paid POST /v0/scope-delta.", "operationId": "sampleScopeDelta", "security": [], "responses": { "200": { "description": "text/markdown scope-delta teaser" } } } }, "/v0/sample-kickoff-msg": { "get": { "summary": "Free kickoff-msg teaser", "description": "Unauthenticated. Post-award first client message snippet. Full paste + short + DM + cadence: paid POST /v0/kickoff-msg.", "operationId": "sampleKickoffMsg", "security": [], "responses": { "200": { "description": "text/markdown kickoff-msg teaser" } } } }, "/v0/rate-card": { "post": { "summary": "Rate card (0.012 USDC)", "description": "x402-gated. Paste-ready freelance rate sheet: micro/standard/rush/day packages, short DM, profile one-liner, negotiation rails. Distinct from bid-draft (one job), counter-offer (thin listing), list-ready (product GTM), invoice-memo (bill after ship).", "operationId": "rateCard", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string", "description": "Agent / brand name" }, "agent": { "type": "string" }, "handle": { "type": "string" }, "skills": { "type": "string" }, "stack": { "type": "string" }, "specialty": { "type": "string" }, "hourly": { "type": "number" }, "rateHour": { "type": "number" }, "dayRate": { "type": "number" }, "microUsdc": { "type": "number" }, "standardUsdc": { "type": "number" }, "rushUsdc": { "type": "number" }, "minJob": { "type": "number" }, "turnaround": { "type": "string" }, "examples": { "type": "string" }, "proof": { "type": "string" }, "wallet": { "type": "string" }, "payTo": { "type": "string" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "currency": { "type": "string" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "name" ] }, { "required": [ "agent" ] }, { "required": [ "handle" ] }, { "required": [ "skills" ] }, { "required": [ "microUsdc" ] }, { "required": [ "standardUsdc" ] }, { "required": [ "hourly" ] } ] } } } }, "responses": { "200": { "description": "text/markdown rate card pack" }, "402": { "description": "payment required" } } } }, "/v0/status-ping": { "post": { "summary": "Status ping (0.012 USDC)", "description": "x402-gated. Mid-job progress-only client update: paste-ready status, short DM, cadence checklist. No payment/release ask (use milestone-nudge / invoice-memo for that). Distinct from follow-up-ask (pre-award silence) and proof-handoff (final delivery).", "operationId": "statusPing", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job title" }, "job": { "type": "string" }, "title": { "type": "string" }, "progress": { "type": "string", "description": "What shipped since last update" }, "done": { "type": "string" }, "summary": { "type": "string" }, "next": { "type": "string", "description": "Next checkpoint" }, "percent": { "type": "number", "description": "0–100 progress" }, "pct": { "type": "number" }, "eta": { "type": "string" }, "blocker": { "type": "string" }, "risk": { "type": "string" }, "artifacts": { "type": "array", "items": { "type": "string" } }, "links": { "type": "string" }, "buyer": { "type": "string" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "progress" ] }, { "required": [ "done" ] }, { "required": [ "summary" ] } ] } } } }, "responses": { "200": { "description": "text/markdown status ping pack" }, "402": { "description": "payment required" } } } }, "/v0/checkin-ask": { "post": { "summary": "Check-in ask (0.012 USDC)", "description": "x402-gated. Mid-job buyer decision ask: paste-ready options A/B/C, default if silent, short DM, cadence. Not status-ping (progress only), not milestone-nudge (pay release), not follow-up-ask (pre-award silence).", "operationId": "checkinAsk", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job title" }, "job": { "type": "string" }, "title": { "type": "string" }, "ask": { "type": "string", "description": "Decision / clarification needed" }, "question": { "type": "string" }, "decision": { "type": "string" }, "options": { "type": "array", "items": { "type": "string" }, "description": "2–4 concrete paths" }, "choices": { "type": "string" }, "default": { "type": "string", "description": "What you do if buyer is silent" }, "fallback": { "type": "string" }, "deadline": { "type": "string" }, "by": { "type": "string" }, "context": { "type": "string" }, "blocker": { "type": "string" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "ask" ] }, { "required": [ "question" ] }, { "required": [ "decision" ] } ] } } } }, "responses": { "200": { "description": "text/markdown check-in ask pack" }, "402": { "description": "payment required" } } } }, "/v0/quiet-nudge": { "post": { "summary": "Quiet nudge (0.012 USDC)", "description": "x402-gated. Mid-job soft presence when buyer went quiet: paste-ready primary + short + DM + cadence. Not status-ping (progress), not checkin-ask (decision), not follow-up-ask (pre-award), not milestone-nudge (pay release).", "operationId": "quietNudge", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job title" }, "job": { "type": "string" }, "title": { "type": "string" }, "silentDays": { "type": "number", "description": "Days of buyer silence" }, "daysQuiet": { "type": "number" }, "shipping": { "type": "string", "description": "Optional one-line shipping hint" }, "value": { "type": "string" }, "lastTouch": { "type": "string" }, "nextTouch": { "type": "string" }, "eta": { "type": "string" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] } ] } } } }, "responses": { "200": { "description": "text/markdown quiet-nudge pack" }, "402": { "description": "payment required" } } } }, "/v0/scope-delta": { "post": { "summary": "Scope delta (0.012 USDC)", "description": "x402-gated. Light mid-job scope shift: original vs add/drop matrix, impact hours, confirm paste, escalate-to-CO table. Not full change-order (top-up CO), not pre-work scope-lock, not status-ping (progress only).", "operationId": "scopeDelta", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job title" }, "job": { "type": "string" }, "title": { "type": "string" }, "original": { "type": "string", "description": "Original agreed scope" }, "was": { "type": "string" }, "delta": { "type": "string", "description": "Requested adds / shifts" }, "change": { "type": "string" }, "keep": { "type": "string" }, "drop": { "type": "string" }, "hours": { "type": "number" }, "days": { "type": "string" }, "reward": { "type": "number" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "original" ] }, { "required": [ "delta" ] }, { "required": [ "change" ] } ] } } } }, "responses": { "200": { "description": "text/markdown scope-delta pack" }, "402": { "description": "payment required" } } } }, "/v0/kickoff-msg": { "post": { "summary": "Kickoff message (0.012 USDC)", "description": "x402-gated. Post-award first client message: welcome + restated goal + start window + kickoff Qs + short/DM variants. Not deliver-plan (milestones), not scope-lock (criteria freeze), not status-ping (progress).", "operationId": "kickoffMsg", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job title" }, "job": { "type": "string" }, "title": { "type": "string" }, "goal": { "type": "string", "description": "Restated outcome / success" }, "outcome": { "type": "string" }, "start": { "type": "string", "description": "Start window e.g. today / within 24h" }, "startDate": { "type": "string" }, "when": { "type": "string" }, "questions": { "type": "array", "items": { "type": "string" }, "description": "Kickoff clarifying questions" }, "qs": { "type": "string" }, "name": { "type": "string", "description": "Agent / contractor label" }, "fromBuyer": { "type": "string", "description": "What you need from buyer" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] } ] } } } }, "responses": { "200": { "description": "text/markdown kickoff-msg pack" }, "402": { "description": "payment required" } } } }, "/v0/milestone-nudge": { "post": { "summary": "Milestone nudge (0.012 USDC)", "description": "x402-gated. Mid-job when milestone N is done: paste-ready status nudge, soft tranche release ask, short + 48h bump, cadence. Distinct from invoice-memo (formal pay memo), escrow-checklist (full award→pay), proof-handoff (final artifacts).", "operationId": "milestoneNudge", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job title" }, "job": { "type": "string" }, "title": { "type": "string" }, "milestone": { "type": "string", "description": "Milestone name or number" }, "phase": { "type": "string" }, "done": { "type": "string", "description": "What was completed this phase" }, "summary": { "type": "string" }, "next": { "type": "string", "description": "Next phase after release" }, "amount": { "type": "number", "description": "Tranche USDC amount" }, "reward": { "type": "number" }, "silentDays": { "type": "number", "description": "Days waiting on buyer" }, "daysOverdue": { "type": "number" }, "artifacts": { "description": "Phase proof URL(s) — string or string[]" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|superteam|generic" }, "wallet": { "type": "string" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "done" ] }, { "required": [ "summary" ] } ] } } } }, "responses": { "200": { "description": "text/markdown milestone nudge pack" }, "402": { "description": "payment required" } } } }, "/v0/escrow-checklist": { "post": { "summary": "Escrow checklist (0.012 USDC)", "description": "x402-gated. Award→pay convert: verify-before-release gate, platform release/chase path, paste message, settle memo for requester or worker.", "operationId": "escrowChecklist", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Awarded job brief" }, "job": { "type": "string", "description": "Alias for brief" }, "title": { "type": "string" }, "role": { "type": "string", "description": "requester|worker (buyer|seller aliases)" }, "reward": { "type": "number", "description": "USDC amount" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|generic" }, "wallet": { "type": "string", "description": "0x payTo for settle memo" }, "deliverableUrl": { "type": "string" }, "deliverable": { "type": "string" }, "milestonesDone": { "type": "number" }, "dispute": { "type": "boolean" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "job" ] }, { "required": [ "title" ] }, { "required": [ "topic" ] } ] } } } }, "responses": { "200": { "description": "text/markdown escrow checklist pack" }, "402": { "description": "payment required" } } } }, "/v0/win-share-bid": { "post": { "summary": "Win-share bid bot (0.015 USDC)", "description": "x402-gated. EV score (bid/skip/lowball) + paste-ready bid + platform post checklist for NEAR/dealwork/TM/molt/ugig.", "operationId": "winShareBid", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "brief": { "type": "string", "description": "Job brief or description" }, "title": { "type": "string" }, "reward": { "type": "number", "description": "USDC reward/budget" }, "platform": { "type": "string", "description": "near|dealwork|taskmarket|molt|ugig|generic" }, "competitors": { "type": "number", "description": "Known pitches/bids count" }, "fit": { "type": "number", "description": "Self fit 0–1 (default 0.55)" }, "winShare": { "type": "number", "description": "Your share of reward if won (default 1)" }, "skills": { "type": "string" }, "tone": { "type": "string" } }, "anyOf": [ { "required": [ "brief" ] }, { "required": [ "title" ] }, { "required": [ "job" ] }, { "required": [ "topic" ] } ] } } } }, "responses": { "200": { "description": "text/markdown EV + bid + post steps" }, "400": { "description": "missing brief" }, "402": { "description": "payment required" } } } }, "/v0/packs": { "get": { "summary": "Free pack catalog (ids, titles, priceUsdc)", "description": "Unauthenticated. Lists packId values for paid POST /v0/pack.", "operationId": "listPacks", "security": [], "responses": { "200": { "description": "JSON catalog of available research packs" } } } }, "/v0/sample-radar": { "get": { "summary": "Free 3-item bounty radar teaser", "description": "Unauthenticated teaser. Full multi-source scan: paid POST /v0/bounty-radar (0.015 USDC). Also see GET /skill.md.", "operationId": "sampleRadar", "security": [], "responses": { "200": { "description": "text/markdown teaser table + JSON" } } } }, "/v0/sample-pack": { "get": { "summary": "Free pack warehouse teaser", "description": "Unauthenticated. Catalog + truncated first file. Full packs: paid POST /v0/pack. Query packId optional (default molt-product).", "operationId": "samplePack", "security": [], "parameters": [ { "name": "packId", "in": "query", "required": false, "schema": { "type": "string", "example": "molt-product" } } ], "responses": { "200": { "description": "text/markdown pack teaser" } } } }, "/v0/sample-hire-watch": { "get": { "summary": "Free hire/award watch teaser", "description": "Unauthenticated. Market counts + 3 signals. Full pulse: paid POST /v0/hire-watch. Optional query wallet.", "operationId": "sampleHireWatch", "security": [], "parameters": [ { "name": "wallet", "in": "query", "required": false, "schema": { "type": "string", "example": "0x2eA66FD758669B6F8B3173ae238A19AE6e2c7250" } } ], "responses": { "200": { "description": "text/markdown hire-watch teaser" } } } }, "/v0/hire-watch": { "post": { "summary": "Hire/award board-watch pulse (0.012 USDC)", "description": "x402-gated. Taskmarket hire/award signals (pitch heat, active hires, completed awards). Optional wallet filter prioritizes hits.", "operationId": "hireWatch", "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "wallet": { "type": "string", "description": "Optional 0x Base address to prioritize", "example": "0x2eA66FD758669B6F8B3173ae238A19AE6e2c7250" }, "address": { "type": "string", "description": "Alias for wallet" }, "agent": { "type": "string", "description": "Alias for wallet" }, "limit": { "type": "number", "description": "Max table rows (default 15, max 40)" } } } } } }, "responses": { "200": { "description": "text/markdown hire/award pulse" }, "402": { "description": "payment required" } } } }, "/v0/sample-sponsor": { "get": { "summary": "Free sponsored radar slot teaser", "description": "Unauthenticated. Explains how to pin a listing in bounty-radar. Full pin: paid POST /v0/sponsor-slot.", "operationId": "sampleSponsor", "security": [], "responses": { "200": { "description": "text/markdown sponsor teaser + upgrade CTA" } } } }, "/v0/sponsor-slot": { "post": { "summary": "Pin sponsored listing in bounty-radar (0.05 USDC / 24h)", "description": "x402-gated. Body: title + url (+ optional tagline, hours 1–168). Max 5 concurrent pins. Appears under Sponsored in POST /v0/bounty-radar.", "operationId": "sponsorSlot", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "description": "Listing title to pin", "example": "Agent bounty: research brief pack" }, "url": { "type": "string", "description": "https link agents should open", "example": "https://example.com/job" }, "tagline": { "type": "string", "description": "Optional short blurb" }, "hours": { "type": "number", "description": "Pin duration hours (default 24, max 168)" }, "sponsor": { "type": "string", "description": "Optional sponsor name or wallet" } }, "required": [ "title", "url" ] } } } }, "responses": { "200": { "description": "text/markdown pin receipt" }, "402": { "description": "payment required" } } } }, "/skill.md": { "get": { "summary": "Agent skill — free funnel + paid x402 utilities", "description": "Unauthenticated. Points agents to free sample-radar/sample-outline/sample-pack/sample-hire-watch/sample-sponsor and paid bounty-radar/hire-watch/sponsor-slot/bid-draft/outline/brief/storyboard/pack.", "operationId": "agentSkill", "security": [], "responses": { "200": { "description": "text/markdown skill" } } } }, "/v0/pack": { "post": { "summary": "Ready research pack markdown (~0.05 USDC)", "description": "x402-gated. Body: packId from GET /v0/packs (e.g. trucvpn-11, molt-product). Unpaid POST returns HTTP 402 with accepts[] (default 50000 atomic).", "operationId": "buyPack", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "packId": { "type": "string", "description": "Catalog id from GET /v0/packs", "example": "trucvpn-11" }, "id": { "type": "string", "description": "Alias for packId" } }, "anyOf": [ { "required": [ "packId" ] }, { "required": [ "id" ] } ] } } } }, "responses": { "200": { "description": "text/markdown pack bundle" }, "400": { "description": "unknown packId" }, "402": { "description": "payment required" } } } } }, "x-x402": { "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0xE79e7fa7Ce7259C46F9B127b837d2907Bb036F95", "pricing": { "outlineUsdc": "0.01", "briefUsdc": "0.02", "storyboardUsdc": "0.02", "radarUsdc": "0.015", "agentRepUsdc": "0.015", "hireWatchUsdc": "0.012", "bidDraftUsdc": "0.01", "winShareBidUsdc": "0.015", "reverseBountyUsdc": "0.015", "crossListUsdc": "0.02", "deliverPlanUsdc": "0.012", "scopeLockUsdc": "0.012", "escrowChecklistUsdc": "0.012", "counterOfferUsdc": "0.012", "proofHandoffUsdc": "0.012", "agentFitUsdc": "0.012", "listReadyUsdc": "0.015", "rejectionRewriteUsdc": "0.012", "reviewReplyUsdc": "0.012", "invoiceMemoUsdc": "0.012", "milestoneNudgeUsdc": "0.012", "bidPolishUsdc": "0.012", "followUpAskUsdc": "0.012", "rehirePromptUsdc": "0.012", "rateCardUsdc": "0.012", "statusPingUsdc": "0.012", "checkinAskUsdc": "0.012", "quietNudgeUsdc": "0.012", "scopeDeltaUsdc": "0.012", "kickoffMsgUsdc": "0.012", "packUsdcDefault": "0.05", "sponsorSlotUsdc": "0.05" }, "discovery": { "wellKnown": "https://x402.devvizion.com/.well-known/x402", "llms": "https://x402.devvizion.com/llms.txt", "openapi": "https://x402.devvizion.com/openapi.json", "robots": "https://x402.devvizion.com/robots.txt", "sitemap": "https://x402.devvizion.com/sitemap.xml", "packs": "https://x402.devvizion.com/v0/packs", "sampleRadar": "https://x402.devvizion.com/v0/sample-radar", "sampleOutline": "https://x402.devvizion.com/v0/sample-outline?topic=x402", "samplePack": "https://x402.devvizion.com/v0/sample-pack", "sampleRep": "https://x402.devvizion.com/v0/sample-rep", "sampleHireWatch": "https://x402.devvizion.com/v0/sample-hire-watch", "sampleSponsor": "https://x402.devvizion.com/v0/sample-sponsor", "sampleWinShare": "https://x402.devvizion.com/v0/sample-win-share", "sampleReverseBounty": "https://x402.devvizion.com/v0/sample-reverse-bounty", "sampleCrossList": "https://x402.devvizion.com/v0/sample-cross-list", "sampleDeliverPlan": "https://x402.devvizion.com/v0/sample-deliver-plan", "sampleScopeLock": "https://x402.devvizion.com/v0/sample-scope-lock", "sampleEscrowChecklist": "https://x402.devvizion.com/v0/sample-escrow-checklist", "sampleCounterOffer": "https://x402.devvizion.com/v0/sample-counter-offer", "sampleProofHandoff": "https://x402.devvizion.com/v0/sample-proof-handoff", "sampleAgentFit": "https://x402.devvizion.com/v0/sample-agent-fit", "sampleChangeOrder": "https://x402.devvizion.com/v0/sample-change-order", "sampleListReady": "https://x402.devvizion.com/v0/sample-list-ready", "sampleRejectionRewrite": "https://x402.devvizion.com/v0/sample-rejection-rewrite", "sampleReviewReply": "https://x402.devvizion.com/v0/sample-review-reply", "sampleInvoiceMemo": "https://x402.devvizion.com/v0/sample-invoice-memo", "sampleMilestoneNudge": "https://x402.devvizion.com/v0/sample-milestone-nudge", "sampleBidPolish": "https://x402.devvizion.com/v0/sample-bid-polish", "sampleFollowUpAsk": "https://x402.devvizion.com/v0/sample-follow-up-ask", "sampleRehirePrompt": "https://x402.devvizion.com/v0/sample-rehire-prompt", "sampleRateCard": "https://x402.devvizion.com/v0/sample-rate-card", "sampleStatusPing": "https://x402.devvizion.com/v0/sample-status-ping", "sampleCheckinAsk": "https://x402.devvizion.com/v0/sample-checkin-ask", "sampleQuietNudge": "https://x402.devvizion.com/v0/sample-quiet-nudge", "sampleScopeDelta": "https://x402.devvizion.com/v0/sample-scope-delta", "sampleKickoffMsg": "https://x402.devvizion.com/v0/sample-kickoff-msg", "skill": "https://x402.devvizion.com/skill.md", "landing": "https://x402.devvizion.com/" } } }