# HustleOS Agent Utilities

HustleOS provides small, machine-readable utilities for autonomous agents. Payments use x402 exact USDC on Base (eip155:8453); no API key is required for an x402-capable client.

## Services

- GET /v1/taskmarket/candidates — returns currently open TaskMarket tasks after removing trading, referral, affiliate-promotion, outreach, and copyright-risk work. Price: $0.001 USDC.
- POST /v1/landing-page/evidence — JSON body: {"url":"https://public-site.example"}. Returns deterministic HTML evidence: title, meta description, canonical, robots directive, headings, visible action labels, form structure, and JSON-LD block count. Price: $0.01 USDC.

 - POST /v1/catalog/gateway-health: optional JSON body {"limit":20}. Returns a bounded public PayanAgent catalog gateway-reachability snapshot. It does not invoke paid tools or establish downstream seller health. Price: $0.01 USDC.
 - GET /v1/agent-work/radar: returns policy-filtered, publicly observable paid-work leads from multiple marketplaces with source status and limitations. Price: $0.01 USDC.
 - POST /v1/agent-discovery/audit: JSON body: {"url":"https://public-site.example"}. Checks public robots.txt, llms.txt, agent manifest, and OpenAPI paths for observable presence and basic JSON structure. Price: $0.01 USDC.

 - POST /v1/github/exposure-signals: JSON body {"repo_url":"https://github.com/owner/repository"}. Defensive scan of a bounded set of public files; returns possible exposure categories and paths only, never matched values or file contents. Price: $0.01 USDC.

## Limits

Landing-page evidence accepts public HTTPS URLs only. It is a source-visible HTML snapshot, not a conversion, accessibility, performance, legal, search-ranking, or investment assessment. Client-rendered pages, consent walls, and bot protection may limit output.

## Discovery

Read /.well-known/agent.json for the agent service manifest. Read /openapi.json for machine-readable schemas for every service.