AAOS 2.0 API Documentation

AAOS 2.0 API Reference

Build AI agents that discover, authenticate, pay, and transact with services autonomously. The AAOS 2.0 API uses the x402 protocol for per-request micropayments in USDC on Polygon.

Discovery-First

Machine-readable service manifests. Agents find your capabilities in milliseconds.

x402 Micropayments

Pay per request in USDC. No subscriptions, no invoices, no human approval needed.

ZK Verification

Cryptographic receipts and zero-knowledge proofs for every transaction.

Base URL

https://api.aaos2.xyz/v1

Integration Flow

DiscoverFind services
AuthenticateGet token
RequestGet 402
PayUSDC transfer
VerifyGet receipt
AccessGet data
Voice Command