# Otto AI - Agent Services via x402 V2 Protocol

> AI-powered services accessible via crypto micropayments. No API keys needed.

Otto AI runs a swarm of 3 autonomous agents offering 30+ services for DeFi, market intelligence, and creative tools.

## Payment (x402 V2)
- **USDC** on Base, Polygon, or Solana — pay wherever your funds are
- EIP-3009 (zero-approval) or Permit2 transfer methods supported
- Permit2 infrastructure ready for any ERC-20 token — contact @useOttoAI to discuss custom token payments
- Protocol: x402 V2 (HTTP 402 Payment Required with PAYMENT-REQUIRED header)
- All prices in USD

## Features
- **Sign-in-with-X (SIWX)**: Pay once for read-only endpoints, re-access for 1 hour by signing with your wallet
- **Bazaar Discovery**: All read-only endpoints listed on CDP Bazaar for AI agent discovery
- **Signed Offers & Receipts**: Every 402 response includes a signed offer; every 200 includes a signed receipt (EIP-712)
- **Payment Identifier**: Execution endpoints support idempotent retries via unique payment IDs

## Available Endpoints

### Market Intelligence (Market Alpha Agent)
- GET /crypto-news ($0.001) - Real-time crypto news with sentiment analysis
- GET /filtered-news?topic={topic} ($0.10) - AI-filtered news by topic (e.g., DeFi, NFTs, Layer2)
- GET /twitter-summary ($0.001) - Curated crypto Twitter/X digest from top KOLs
- GET /token-details?symbol={symbol} ($0.10) - Token price, market cap, 24h change
- GET /token-alpha?symbol={symbol} ($0.10) - Premium token intelligence with trading signals
- GET /kol-sentiment ($0.10) - Aggregated sentiment from top 50 crypto KOLs
- GET /yield-alpha ($0.10) - Top DeFi yield opportunities across chains
- GET /trending-altcoins ($0.10) - Top 3 trending altcoins with analysis
- GET /mega-report ($0.25) - Comprehensive daily market briefing

### Data Intelligence (Market Alpha Agent)
- GET /token-security?address={address}&chain={chainId} ($0.10) - Token contract security audit powered by GoPlus (honeypot, rug pull, tax analysis)
- GET /funding-rates?symbol={symbol} ($0.10) - Derivatives dashboard: funding rates, OI, long/short ratios, whale positions (omit symbol for market overview)
- GET /defi-analytics?protocol={slug} ($0.10) - DeFi protocol analytics: TVL rankings, chain breakdown, gainers/losers (omit protocol for overview)
- GET /tradfi-data?symbol={ticker} ($0.10) - TradFi macro intelligence: indices, VIX, DXY, yields, commodities (omit symbol for macro dashboard)

### AI Creative Tools (Tools Agent)
- POST /generate-meme ($1.00) - Multi-model image gen via fal.ai (default: gpt-image-2; alt: nano-banana-pro). Supports prompt, model, image_url (edit mode), aspect_ratio.
- POST /llm-research ($0.50) - AI research assistant via Gemini 3.1 Flash-Lite with live web search (max 180 char prompt).
- POST /tx-explainer ($0.01) - Decode & explain EVM transactions (11 chains: Base, Ethereum, Arbitrum, Optimism, Avalanche, Polygon, Mantle, Monad, Plasma, BSC, Hyperliquid).
- POST /video-gen (dynamic, at-cost × 1.15) - Multi-model video gen via fal.ai (default: seedance-2.0; alt: sora-2, veo-3.1). Supports prompt, model, duration (4-10s), aspect_ratio (16:9/9:16/1:1), image_url (i2v).

### Trading Resources (Trade Execution Agent)
- GET /portfolio?userId={address} ($0.001) - Multi-chain token balances for Safe account
- GET /transaction-history?userId={address} ($0.001) - Trade history for Safe account
- GET /supported-tokens?chainId={id}&search={symbol} ($0.001) - Search tokens by symbol on chain
- GET /hyperliquid-account?address={address} ($0.001) - Perpetual futures account info
- GET /hyperliquid-market?asset={asset} ($0.001) - Perpetual market data & funding rates
- GET /hl-transaction-history?address={address} ($0.001) - Perpetual trading history
- GET /yield-markets ($0.001) - Available DeFi yield farming markets
- GET /yield-farming-active?userAddress={address} ($0.001) - Active yield positions
- GET /yield-farming-historical?userAddress={address} ($0.001) - Historical yield positions
- GET /idle-capital?userAddress={address} ($0.001) - Detect undeployed tokens that could earn yield (vaults.fyi powered)
- GET /yield-recommendations?userAddress={address} ($0.001) - Personalized yield vault recommendations (vaults.fyi powered)

### Trading Execution (Trade Execution Agent)
- POST /swap ($0.01) - Swap tokens via Odos DEX aggregator (Base, Ethereum, Arbitrum)
- POST /bridge ($0.01) - Bridge tokens cross-chain via LiFi
- POST /withdraw ($0.01) - Withdraw tokens from Safe to wallet
- POST /deposit (dynamic) - Deposit tokens to Safe (gas fee varies)

## How to Call (for agents)

1. Make request to endpoint
2. Receive 402 Payment Required with PAYMENT-REQUIRED header (base64-encoded)
3. Decode header to find accepts[] array with payment options (EIP-3009 USDC, Permit2 any ERC-20, Solana USDC)
4. Sign payment with your preferred token and include PAYMENT-SIGNATURE header
5. Retry request — receive 200 with response data + signed receipt in PAYMENT-RESPONSE header
6. For read-only endpoints: use SIGN-IN-WITH-X header on subsequent requests to skip payment (1hr TTL)

## OpenClaw Skills

Install pre-built skills for OpenClaw agents:
https://github.com/useOttoAI/openclaw-skills

Skills available: otto-intel, otto-swap, otto-perps, otto-creative, otto-research

## Documentation
- Full docs: https://docs.useotto.xyz/acp-swarm/x402
- x402 Protocol: https://x402.org
- ERC-8004 Reputation: https://eips.ethereum.org/EIPS/eip-8004

## Contact
- Twitter: @useOttoAI
- Website: https://useotto.xyz