# 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 autonomous agents offering 74 x402 services across eight capability tags: Market & Token Intelligence, DeFi & Markets Data, Web & Domain Intelligence, Real-World Data, AI Creative & Tools, Portfolio & Accounts, Execution, and x402 Open Router (Meta Intelligence, Full Auto, Feedback & Refunds).

## 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)**: On select read-only endpoints, pay once and re-access for 1 hour by signing with your wallet (cached data endpoints are pay-per-call only)
- **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 & Token Intelligence
- GET /crypto-news ($0.001) - Real-time crypto market news with sentiment analysis and top headlines ranked by importance.
- GET /news-recaps ($0.002) - A tight 4-6 sentence crypto market recap an agent can ingest whole: overall direction and why, the 2-3 developments that matter, and anything notable on the top-10 board — distilled hourly from the same live news engine behind Otto's top-ranked /crypto-news feed. The one-paragraph state-of-market; buy /crypto-news when you want the full report.
- GET /base-ecosystem-news ($0.001) - Base-chain ecosystem news, AI-filtered hourly from Otto's live news engine: protocol launches and upgrades on Base, Coinbase/Base official moves, Base DeFi and token developments — a topic-scoped report for Base-native agents, not the general crypto firehose. Pairs with /base-season (KOL social signal) for the full Base picture.
- GET /filtered-news?topic={topic} ($0.001) - AI-filtered crypto news and Twitter search for non-token topics (airdrops, DeFi trends, etc). Max 2 words.
- GET /tweet-search?query={query} ($0.005) - Search X/Twitter for any query and get the actual matching tweets — keyword, $CASHTAG, from:handle (a user timeline), @handle (mentions), or boolean OR. Each tweet returns author, full text (long-form note tweets included), timestamp, likes and retweets (reply/quote counts when available). Most-recent-first for real-time monitoring and alerting. Live X search backend, pay-per-call USDC, structured JSON — no API keys, no sign-up.
- GET /twitter-summary ($0.001) - Quick pulse check from crypto Twitter. Breaking news, trending narratives, and sentiment shifts at a glance.
- GET /token-details?symbol={symbol} ($0.001) - Token price, market cap, volume, supply, and basic metrics. Works for any listed token.
- GET /token-alpha?symbol={symbol} ($0.005) - Premium token intelligence: price metrics, news, Twitter sentiment, and futures data. Find out why your token is moving.
- GET /kol-sentiment ($0.001) - Premium alpha from top 50 crypto KOLs. Real trading signals, trending token picks, and sentiment from influencers who move markets.
- GET /trending-altcoins ($0.001) - Top 3 hottest altcoins traders may want to ape into, based on news and Twitter analysis. DYOR.
- GET /mega-report ($0.05) - Alpha & Intel Report — daily crypto market intelligence: headlines, Twitter sentiment, KOL alpha, trending altcoins, and yield opportunities in one report.
- GET /token-security?address={address}&chain={chain} ($0.001) - Token security scanner — is this token safe to buy? Honeypot, rug-pull, and scam detection for any token contract — flags can't-sell traps, hidden mints, malicious buy/sell taxes, and holder concentration. Powered by GoPlus across 7 chains.
- GET /token-top-holders?token={token} ($0.02) - Top holders for any Base ERC-20 (via Moralis), with computed concentration (top1/5/10/20% + contract-held%) and optional whale-risk read. Curated hot set refreshed hourly; long-tail tokens write-through on first call.
- GET /base-season ($0.001) - Base social intelligence: a current Base sentiment summary + the quality-screened Base tokens (CoinGecko-listed, market-cap/age/liquidity gated) that trusted KOLs are actually talking about — with per-token KOL mention counts and verbatim quotes, ranked by KOL signal. Includes overall crypto-KOL market sentiment. The social-intelligence wedge for Base — who is saying it, not who pumped. Refreshed hourly.
- GET /rh-season ($0.001) - Robinhood Chain memecoin intelligence: the rug-screened RH Chain (chainId 4663) movers. Hard liquidity + wash-volume gates filter the $0-liquidity honeypots that fake $1M volumes; every survivor carries rug-risk flags (thin liquidity, vol/liquidity anomaly, pool age, CoinGecko listing) plus trusted-KOL mentions with verbatim quotes and a synthesized RH Chain sentiment read. What is pumping AND whether it is real. Refreshed hourly.
- GET /token-fundamentals?symbol={symbol} ($0.002) - Structured token fundamentals by ticker symbol (resolves to the top-market-cap asset matching it): price, market cap, FDV, rank, 24h volume, full supply breakdown (circulating/total/max), ATH + drawdown from ATH, ATL + recovery, ROI windows (24h/7d/30d/60d/1y), categories, and project links — clean JSON an agent can consume field-by-field. Fundamentals snapshot, not a streaming price feed.
- GET /token-price?token={token} ($0.001) - Live DEX token price in USD by ticker symbol or contract address across Base, Ethereum, Solana, Polygon, BSC, Arbitrum, Optimism and Avalanche (bare 0x defaults to Base, else network:address). Symbols resolve to the canonical top-market-cap asset — squat-proof. Flat JSON: price, 24h change, volume, market cap, FDV, liquidity — echoes the matched deployment. Token price, crypto price, DEX price. $0.001 per call.
- GET /holder-analytics?token={token} ($0.03) - Full holder analytics for any Base ERC-20: total holders with 24h/3d/7d/30d holder-change momentum, whale-tier distribution, acquisition mix (swap vs transfer vs airdrop), top-10/25/50/100 supply share, labeled top holders with concentration (top1/5/10/20% + contract-held%) and an AI concentration-risk read. Bag check, holder analytics, holder concentration, whale distribution. $0.03 per call.

### DeFi & Markets Data
- GET /yield-alpha ($0.001) - Best DeFi yield opportunities across stablecoins, ETH, and BTC with risk ratings and APY comparisons.
- GET /funding-rates?symbol={symbol} ($0.001) - Cross-venue funding-rate arbitrage + crowded-positioning radar: live perp funding rates, open interest, global & top-trader long/short ratios, whale positions, and liquidations across Binance, OKX, Bybit, Hyperliquid, and more. Omit symbol for the whole-market overview; pass one (e.g. BTC) for the per-exchange breakdown. (Hyperliquid-only perp data: use hyperliquid-market.)
- GET /defi-analytics?protocol={protocol} ($0.001) - Where DeFi capital is flowing — TVL rankings, fastest-growing vs bleeding protocols, chain-by-chain breakdown, and per-protocol deep dives. Track capital rotation and protocol health. Powered by DefiLlama.
- GET /tradfi-data?symbol={symbol} ($0.003) - TradFi macro intelligence: indices, VIX, DXY, treasury yields, commodities, and individual stock quotes with moving average context.
- GET /hyperliquid-market?asset={asset} ($0.001) - Hyperliquid perpetuals market data: live mark/oracle price, funding rate, open interest, max leverage, and size specs for any tradable asset.
- GET /yield-markets ($0.001) - DeFi yield farming markets with live APYs across Aave V3 and Morpho on Base, Ethereum, and other major chains. Find the best stablecoin yield (USDC) and ETH yield for idle capital: returns supply APY, TVL, and vault/market addresses per token, filterable by protocol, chain, or token symbol. Compare DeFi yield rates across lending markets and vaults before depositing.
- GET /stablecoin-watch ($0.001) - Is USDC/USDT/DAI holding its $1 peg, and is stablecoin supply growing or shrinking (risk-on vs risk-off)? Live peg deviation (bps), circulating supply + 1d/7d/30d flow, market dominance and chain spread for the top 30 USD stablecoins, plus downside depeg alerts for any coin trading >0.5% below peg. Sourced from DefiLlama (public). Refreshed hourly.
- GET /market-risk ($0.002) - Composite crypto market-stress digest: a 0-100 score (low/moderate/elevated/high) blended from global USD-stablecoin depeg health (DefiLlama) and Base on-chain DEX exit-liquidity, with a per-leg breakdown and an AI risk line. Stablecoin systemic + Base liquidity microstructure only (not derivatives/sentiment). Both legs required for a score. Refreshed hourly, public sources, pay-per-call.
- GET /protocol-revenue-leaders ($0.001) - Which protocols earn the most — and who is accelerating? Top 30 DeFi protocols by 24h fees, each with revenue, take-rate (the cut the protocol keeps vs fees users pay), 7d/30d trend and category, plus total DeFi fees & revenue. A fundamentals screen (fee/revenue economics), distinct from TVL. Sourced from DefiLlama (public). Refreshed hourly.
- GET /equity-intel?ticker={ticker} ($0.003) - Equity intelligence for any US-listed company by ticker: latest revenue & net income with YoY growth, net margin, EPS, total assets/liabilities, leverage and cash, plus the most recent material SEC filings (10-K/10-Q/8-K) and an AI read on what matters. Sourced from SEC EDGAR (public domain). Fundamentals/filings intel — not a price feed.
- GET /pools-search?query={query} ($0.001) - Search DEX pools across Base, Ethereum, Solana, Polygon, BSC, Arbitrum, Optimism and Avalanche by token symbol, name, or contract address. Returns pool address, DEX, price USD, 24h volume, liquidity (TVL), FDV, 24h price change and 24h txns as flat JSON numbers — no nested joins. Pool search, pool finder, DEX pools, liquidity pools, onchain pool lookup. $0.001 per call.
- GET /pools-trending?network={network} ($0.001) - Trending DEX pools right now — Base, Ethereum, Solana, Polygon, BSC, Arbitrum, Optimism, Avalanche, or network=all for cross-chain across those same 8. Top 10 hottest pools ranked by GeckoTerminal 24h trending: pool address, DEX, price USD, 24h price change, 24h volume, liquidity (TVL), FDV, 24h txns as flat JSON numbers. Trending pools, hot pools, top movers, momentum screener, what is pumping. $0.001 per call.
- GET /pm-markets ($0.001) - Top Polymarket prediction markets RIGHT NOW: the 25 highest-volume open markets with live odds (outcome probabilities), best bid/ask, spread, last trade price, 24h + total volume, liquidity, 1d/7d price change, end date and event link. Flat JSON, refreshed every 5 minutes. Prediction market odds, Polymarket data, event probabilities, market sentiment. $0.001 per call.
- GET /pm-crypto ($0.001) - Crypto prediction markets on Polymarket: the highest-volume open BTC, ETH and crypto markets with live odds (outcome probabilities), best bid/ask, spread, 24h + total volume, liquidity, price change and end date. "Bitcoin above X", price targets, ETF and protocol events — what the prediction market ACTUALLY prices in, as flat JSON refreshed every 5 minutes. Crypto odds, Bitcoin prediction market, ETH probability. $0.001 per call.
- GET /pm-search?query={query} ($0.001) - Search Polymarket prediction markets by free text: elections, Fed rates, crypto prices, sports, geopolitics, AI. Returns the top matching open markets with live odds (outcome probabilities), best bid/ask, spread, volume, liquidity, end date and event link as flat JSON. Prediction market search, event odds lookup, "what are the odds of X". $0.001 per call — 5x cheaper than comparable PM search.
- GET /insider-trades?ticker={ticker} ($0.003) - SEC Form 4 insider trades for any US-listed company by ticker: who bought and sold (officer/director/10% owner), purchase vs sale counts and dollar values (SEC codes P/S: open-market or private), net purchase-sale balance, shares held after, filing links — hourly snapshot; 4/A-amended windows withheld once detected (~1h lag): unpaid 503. Insider trading data, insider buys, smart money. Public-domain SEC EDGAR. $0.003 per call.
- GET /institutional-holdings?manager={manager} ($0.003) - 13F holdings for any SEC-filing manager (hedge funds, asset managers) by CIK or manager ticker: latest 13F top 20 positions, amendments applied (hourly snapshot, ~1h correction lag): issuer, CUSIP, value in whole USD, share/principal amount (SH/PRN), put/call flag, reported value, position count. Whale tracking from the primary source. 13F holdings, hedge fund positions, institutional ownership. Public-domain SEC EDGAR. $0.003 per call.
- GET /equity-smart-money?ticker={ticker} ($0.006) - Smart-money bundle for any US-listed company by ticker, in ONE call: SEC Form 4 insider activity (purchases vs sales — SEC codes P/S, net purchase-sale balance, who filed and their roles) PLUS trailing-twelve-month fundamentals (revenue + YoY, net income + YoY, diluted EPS) from XBRL filings. 4/A-amended insider windows withheld once detected (~1h lag): unpaid 503. Smart money, fundamentals. Public-domain SEC EDGAR. $0.006 per call.
- GET /equity-smart-money-brief?ticker={ticker} ($0.10) - Smart-money filing brief for US-listed companies by ticker: SEC Form 4 insider purchases vs sales with filer roles, Schedule 13D/13G beneficial-ownership filing events (subject-validated; not 13F), fundamentals with one-time-item flags (TTM where available), regime-aware filings cadence — ONE AI read of the filing record. Observed filings only; buy/sell advice rejected at generation. Public-domain SEC EDGAR + AI. $0.10 per call.
- GET /tokenized-equities?thesis={thesis} ($0.001) - The live registry of tokenized US equities & ETFs on Robinhood Chain (chainId 4663): symbol, canonical token address, decimals, a reference price, and a verifiable tradability signal — listed-on-rail plus a best-effort execution sample (estimated USD out and round-trip cost at a reference size). The on-chain settlement layer for tokenized-equity exposure, not a data-coverage claim. Optional `?thesis=` filters the registry to a matched shortlist (per-row match reason + an honesty contract). Informational only; not a quote or a recommendation. Flat JSON, refreshed hourly. $0.001 per call.

### Web & Domain Intelligence
- GET /dns-lookup?domain={domain} ($0.001) - Resolve any domain in one call: A/AAAA, MX, NS, CNAME, SOA and TXT records, plus parsed email-auth posture — SPF policy, DMARC policy, and detected DKIM selectors. A drop-in nslookup/dig replacement for agents, resolved over DNS-over-HTTPS (DoH) with redundant resolvers and automatic failover. Keyless, pay-per-call, structured JSON.
- GET /whois-lookup?domain={domain} ($0.001) - Registration data for any domain, straight from authoritative RDAP registries (the structured WHOIS successor): registrar, ICANN/EPP domain status codes, creation, last-updated and expiration dates, authoritative nameservers, and DNSSEC delegation. The fast, license-clean way for an agent to vet a domain, sender, or counterparty. Keyless, structured JSON, pay-per-call.
- GET /domain-age?domain={domain} ($0.001) - Domain age and registration intel from authoritative RDAP/WHOIS records: exact creation date, age in days and years, expiration date and days-until-expiry. The fast trust and risk signal agents use to vet a counterparty, link, or sender and to flag newly-registered or soon-to-expire domains. Returns structured JSON, keyless, pay-per-call. ccTLDs without RDAP return an uncharged 503.
- GET /domain-report?domain={domain} ($0.02) - One call returns the full domain profile for vetting, deliverability, or phishing/fraud checks: live DNS (A/MX/NS + record counts), RDAP/WHOIS registration (registrar, domain age, expiry, status, DNSSEC) and email authentication (SPF, DMARC policy, detected DKIM selectors) — plus a one-line summary. Bundles three lookups into one hourly-fresh read. Keyless, license-clean, pay-per-call.
- GET /web-extract?url={url} ($0.005) - Turn any URL into clean, LLM-ready markdown — the main article extracted, nav/ads/boilerplate stripped, plus title, description and publish date. Renders JavaScript pages, articles, docs and PDFs. A keyless, pay-per-call web reader for agents that read the web on demand: RAG ingestion, research and summarization. Structured JSON, cached by URL for fast repeat reads.
- GET /web-links?url={url} ($0.003) - Extract all links (hrefs) from any web page as structured JSON — every internal, external and anchor link, deduplicated, returned with a total count. Renders the page in a real headless browser, so it captures links injected after JavaScript runs that fetch-only scrapers miss. For crawling, sitemap building, link audits and site-structure mapping. Keyless, pay-per-call.
- GET /web-json-extract?url={url} ($0.005) - Turn any URL into clean structured JSON for AI agents and RAG. An LLM reads the fully rendered page (JavaScript executed, SPAs included) and returns its title, a 1-2 sentence summary, key entities (people, orgs, products), and any prices, dates or notable numbers — even on pages with no schema.org or JSON-LD markup, no CSS selectors or schema to write. Just pass a URL. Keyless, pay-per-call.
- GET /web-search?query={query} ($0.009) - Neural web search for agents (Exa upstream): pass a query, get the most relevant live web pages with title, URL, published date, author, relevance score and a clean text snippet as structured JSON. The find-then-read pair for /web-extract — RAG retrieval, research, fact-finding, monitoring. Keyless, pay-per-call, cached by query. A no-match query returns an empty result set as a valid answer.

### Real-World Data
- GET /fx-rates ($0.001) - Live + reference foreign-exchange (forex) rates, base USD. LIVE near-real-time mid quotes for the 12 most-traded currencies (EUR, GBP, JPY, CHF, CAD, AUD, NZD, CNY, HKD, SGD, SEK, KRW), refreshed every minute with an honest market-open/stale flag, PLUS the official ECB daily reference table for ~30 currencies. Derive any cross-rate or pair. For agents pricing cross-border ops, treasury, invoicing and FX conversion. Keyless, pay-per-call.
- GET /weather?location={location} ($0.001) - Live weather for any city or lat/lon worldwide. Returns current conditions — temperature, feels-like, humidity, wind and sky — plus a 5-day forecast with daily highs/lows and precipitation probability. City names auto-geocode (no coordinates needed). Refreshed hourly with transparent freshness metadata. Keyless, pay-per-call, agent-ready JSON.

### AI Creative & Tools
- POST /generate-meme ($0.15) - Meme generator + professional AI image generation via fal.ai. model: gpt-image-2 (default) | nano-banana-pro; anything else -> 400. Flat $0.15 per image. Supports image editing via public image URL.
- POST /llm-research ($0.10) - Instant AI research on any topic powered by Gemini 3.5 Flash with live Google Search grounding — answers come with cited sources. Ask about science, tech, crypto, history, or anything else. Can analyze images and summarize webpages from URLs. Max 180 character prompts. $0.10 per query.
- POST /tx-explainer ($0.01) - Decode and explain any EVM blockchain transaction across 11 chains (Base, Ethereum, Arbitrum, Optimism, Avalanche, Polygon, Mantle, Monad, Plasma, BSC, Hyperliquid). Get a human-readable summary of swaps, transfers, approvals, DeFi interactions, and more.
- POST /video-gen (dynamic) - AI video generation via fal.ai — default model: ByteDance Seedance 2.0. Alternatives: fal-ai/sora-2/text-to-video, fal-ai/veo3.1. Dynamic pricing per request: at-cost fal.ai rate + 15% margin (floor $0.05); the advertised price is the Seedance 5s reference quote — the actual quote is returned per request. Supports text-to-video and image-to-video.

### Portfolio & Accounts
- GET /portfolio?userId={userId} ($0.001) - Multi-chain portfolio snapshot with token balances and yield positions for a user's Otto AI Safe accounts across Base, Ethereum, Arbitrum, Polygon, BSC, Avalanche, and Solana.
- GET /transaction-history?userId={userId} ($0.001) - Trade and transaction history for a user's Otto AI Safe account — swaps, bridges, deposits, withdrawals with timestamps and explorer links.
- GET /supported-tokens?search={search}&chainId={chainId} ($0.001) - Search supported ERC-20 tokens by symbol or address across 6 chains (Base, Ethereum, Arbitrum, Polygon, BSC, Avalanche). 5000+ tokens from CoinGecko. Use before swap/bridge to disambiguate tokens.
- GET /hyperliquid-account?address={address} ($0.001) - Hyperliquid perpetual trading account snapshot with open positions, margin, collateral, and active trigger orders (TP/SL/limit).
- GET /hl-transaction-history?address={address} ($0.001) - Hyperliquid perpetual trading history: fills, funding payments, and realized PnL per position.
- GET /yield-farming-active?userAddress={userAddress} ($0.001) - Active yield farming positions for a user across Aave V3 and Morpho on all supported chains, with live APY and accrued interest.
- GET /yield-farming-historical?userAddress={userAddress} ($0.001) - Historical (closed) yield farming positions for a user across all protocols and chains, with realized yield and exit timestamps.
- GET /idle-capital?userAddress={userAddress} ($0.001) - [Temporarily unavailable] Per-wallet idle-capital scanning is being rebuilt on Otto's yield-copilot service. Calls currently return a no-charge 503 until it relands.
- GET /yield-recommendations?userAddress={userAddress} ($0.001) - Best-available stablecoin deposit venues ranked by net supply APY — Otto's yield-copilot reads supported on-chain lending markets directly and returns the top deployable venue per stablecoin (protocol, chain, APY, deposit target). Best-available across the market, not wallet-personalized.
- GET /wallet-holdings?wallet={wallet} ($0.02) - Base wallet portfolio breakdown: up to 100 token positions with live USD price and value, portfolio percentage, 24h price change — native ETH included, spam filtered, top 50 returned; truncated:true means the wallet exceeds the 100-position fetched page (totals null then). Plus total value, top-position concentration and an AI bagcheck read. Wallet holdings, wallet portfolio, wallet balance, bagcheck. $0.02 per call.

### Execution
- POST /swap ($0.01) - Execute instant same-chain ERC-20 swaps via Odos DEX aggregator. Supports Base, Ethereum, Polygon, BSC, Arbitrum, Avalanche, and Solana. Best-route execution across dozens of DEXes and liquidity sources.
- POST /bridge ($0.01) - Cross-chain token bridging via LiFi aggregator. Move tokens between Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, and Solana with best-route execution across all major bridges.
- POST /withdraw ($0.01) - Withdraw tokens from a user's Otto AI Safe to any EOA. Supports 7 chains (Base, Polygon, Arbitrum, Ethereum, BSC, Avalanche, Solana). Non-Base chains require an explicit EOA recipient.
- POST /deposit (dynamic) - Deposit USDC into your non-custodial Otto AI Safe on Base. Dynamic price per request = deposit amount + $0.01 service fee (the amount you deposit is paid via x402). The $0.01 shown here is the floor service fee for discovery only.
- POST /trade-perpetuals ($0.01) - Open leveraged perpetual positions on Hyperliquid with optional native TP/SL trigger orders. Min notional $10. Max leverage varies by asset (BTC 40x, ETH 25x, SOL 20x). Supports BTC, ETH, SOL, and 100+ other markets.
- POST /close-position ($0.01) - Close an open perpetual position on Hyperliquid (full or partial). Cancels all attached TP/SL trigger orders automatically.
- POST /modify-hl-order ($0.01) - Add, modify, or cancel TP/SL trigger orders and limit orders on Hyperliquid. Can attach TP/SL to an existing position or change the trigger price of active orders.
- POST /update-position-margin ($0.01) - Modify leverage, or add/remove margin on an open Hyperliquid position. Lets you de-risk without closing.
- POST /hl-deposit-withdraw ($0.01) - Deposit or withdraw USDC to/from Hyperliquid via Arbitrum. Intelligent routing: checks Arbitrum Safe first, auto-bridges from Base if needed, falls back to Butler wallet.

### x402 Open Router
- POST /meta-intelligence ($0.001) - Meta Intelligence (LIVE) — describe what you need and the Router recommends the best x402 services for it, ranked across BOTH Otto's own catalog AND the live CDP Bazaar, each with its real price and a ready-to-call pay_url. Non-custodial: Otto only recommends; you pay each service directly. A flat $0.001 router fee, never a markup on the services it recommends. quality_score reflects live-status + on-chain (x402scan) volume where measured — never fabricated.
- POST /full-auto (dynamic) - Full Auto (LIVE + ARMED) — the hands-off pillar. The Router picks the best-matched service for your ask and pays it on your behalf at-cost, then returns the data. Dynamic per-request price = the chosen service's at-cost price + a $0.001 router fee, charged via an `upto` cap — no prepay, no standing balance, per-call pass-through. Backed by the money-back guarantee (POST /feedback).
- POST /feedback ($0.001) - Feedback & Refunds (LIVE) — Otto's money-back guarantee. Paid a recommended Otto service (or a Full Auto charge) you didn't like? Send feedback with a >=50-word reason and Otto refunds the service fee + the Meta/router fee (or the whole Full Auto charge), capped $0.01 per transaction, up to 10x per wallet per day, only to the original payer, never more than you paid Otto. Covers Otto's OWN recommended services + Full Auto, not third-party CDP Bazaar picks (no receipt to verify). The $10/day figure is a global system budget, not your personal limit.

## Otto X402 Router — Meta Intelligence ($0.001/call)

Not sure which endpoint you need? Ask the Router. One POST returns the best x402 services for your
task, ranked across BOTH Otto's own catalog AND the live, public CDP Bazaar — each with its real
price and a ready-to-call pay_url. Otto only RECOMMENDS; you pay each service directly (non-custodial,
zero markup, no prepay wallet).

- **Endpoint**: POST https://x402.ottoai.services/meta-intelligence
- **Body**: { "ask": "<what you need>", "price_cap_usd"?: number, "network"?: "eip155:8453" }
- **Price**: $0.001 per call (USDC on Base) — a flat router fee, never a markup on the downstream
  services it recommends
- **Returns**: { ask, classification, otto_verified[], open_bazaar_candidates[] } — each candidate has
  name, provider, price_usd, currency, network, verification ("verified" | "unverified"), source
  ("ours" | "cdp-bazaar"), pay_url, relevance, and (when available) sample_output. Source labels are
  blunt by design. quality_score reflects live-status + on-chain (x402scan) volume where measured — ranked by liveness + on-chain volume, never fabricated.

Example:
```
curl -s -X POST https://x402.ottoai.services/meta-intelligence \
  -H 'content-type: application/json' \
  -d '{"ask":"crypto news for bitcoin","price_cap_usd":0.05}'
```

**Feedback & Refunds** (POST /feedback) is LIVE — the money-back guarantee: refund the service fee +
the Meta/router fee (or the whole Full Auto charge), capped $0.01 per transaction, up to 10x per wallet
per day, ≥50-word reason, only to the original payer; covers Otto's own recommended services + Full Auto,
not third-party CDP Bazaar picks. ($10/day is a global system budget, not your per-user cap.)
**Full Auto** (POST /full-auto — pays the best service on your behalf at-cost + a $0.001 router fee, using
an `upto` cap, no prepay/no standing balance) is LIVE + ARMED.

## 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)

## Base MCP

Use Otto's intelligence from any Base MCP client (Claude, ChatGPT, Cursor, Codex). Otto's services are payable from your Base Account via Base MCP's x402 support — accept[0] is USDC on Base mainnet.
- Otto skill (markdown): https://x402.ottoai.services/otto.md
- Machine-readable catalog: https://x402.ottoai.services/otto-x402-catalog.json

## 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 & feedback
- Twitter: @useOttoAI
- Telegram: https://t.me/DeFAI_Capital
- Email: admin@useotto.xyz — feedback, feature requests, refund questions (humans and agents alike)
- Refunds & paid feedback: POST /feedback ($0.001) — money-back guarantee for Otto-recommended services and Full Auto charges
- Need data or an action we don't offer yet? Tell us — we build for what agents actually use.
- Website: https://useotto.xyz