# agent-services Paid microservices for AI agents. x402/USDC on Base. Payment mode right now: live. Discovery: /.well-known/x402.json (prices), /openapi.json (spec). Attribution: add ?ref= to any request (or X-Ref header) so we know which directory/agent brought you. E.g. ?ref=bazaar, ?ref=agent402. ## Pricing (per call, USDC) - POST /v1/snapshot: $0.005 - POST /v1/utils: $0.001 - POST /v1/extract: $0.01 - POST /v1/batch: $0.02 - GET /v1/dossiers/{topic}: $0.03 - POST /v1/grade: $0.01 - POST /v1/watch: $0.05 - POST /v1/preflight: $0.005 - POST /v1/receipt: $0.002 - POST /v1/monitor: $0.03 - POST /v1/codegen: $0.1 - POST /v1/passport/issue: $0.02 - POST /v1/passport/review: $0.0 - POST /v1/hook/register: $0.02 - POST /v1/memory/write: $0.01 - POST /v1/schedule: $0.03 - POST /v1/brief: $0.03 - POST /v1/discover: $0.005 - POST /v1/netrev: $0.002 - POST /v1/embeddings: $0.002 ## POST /v1/snapshot — $0.005 One cached call: BTC/ETH/SOL USD prices, ETH gas (gwei), FX per USD, crypto fear/greed. Cache 60s; stale served on upstream failure. curl -X POST $BASE/v1/snapshot ## POST /v1/utils — $0.001 Body: {"op": "", "params": {...}}. Pure functions, no network. Ops: b64decode, b64encode, convert_length, convert_temp, convert_weight, cron_next, hash, jsonschema_validate, regex_test, slugify, time_now, time_to_iso, time_to_unix, urldecode, urlencode, uuid curl -X POST $BASE/v1/utils -d '{"op":"time_now","params":{}}' curl -X POST $BASE/v1/utils -d '{"op":"cron_next","params":{"expr":"0 9 * * 1"}}' curl -X POST $BASE/v1/utils -d '{"op":"hash","params":{"algo":"sha256","text":"hi"}}' ## POST /v1/extract — $0.01 Body: {"url": "https://..."} -> {title, markdown, word_count}. 15s timeout, 5MB cap, SSRF-guarded (public IPs only). curl -X POST $BASE/v1/extract -d '{"url":"https://example.com/article"}' ## POST /v1/batch — $0.02 flat Up to 100 sub-requests, one payment. Item: {method: snapshot|utils|extract, params}. curl -X POST $BASE/v1/batch -d '{"requests":[{"method":"snapshot","params":{}}, {"method":"utils","params":{"op":"uuid","params":{}}}]}' ## GET /v1/dossiers[/{topic}] — $0.03 Precomputed research dossiers, served from local files. List: curl $BASE/v1/dossiers Fetch: curl $BASE/v1/dossiers/base-gas-fees-explained ## Paying (when live) Unpaid calls return HTTP 402 with payment requirements JSON and a PAYMENT-REQUIRED header. Sign USDC on Base per x402, retry with X-PAYMENT.