{"version":1,"resources":["GET /crypto-news","GET /filtered-news","GET /twitter-summary","GET /token-details","GET /token-alpha","GET /kol-sentiment","GET /yield-alpha","GET /trending-altcoins","GET /mega-report","GET /token-security","GET /funding-rates","GET /defi-analytics","GET /tradfi-data","POST /generate-meme","POST /llm-research","POST /tx-explainer","POST /video-gen","GET /portfolio","GET /transaction-history","GET /supported-tokens","GET /hyperliquid-account","GET /hyperliquid-market","GET /hl-transaction-history","GET /yield-markets","GET /yield-farming-active","GET /yield-farming-historical","GET /idle-capital","GET /yield-recommendations","POST /swap","POST /bridge","POST /withdraw","POST /deposit","POST /trade-perpetuals","POST /close-position","POST /modify-hl-order","POST /update-position-margin","POST /hl-deposit-withdraw","GET /token-top-holders","GET /stablecoin-watch","GET /protocol-revenue-leaders","GET /equity-intel","GET /base-season","GET /news-recaps","GET /base-ecosystem-news","GET /token-fundamentals","GET /pools-search","GET /token-price","GET /pools-trending","GET /holder-analytics","GET /wallet-holdings"],"instructions":"# Otto AI x402 V2 Agent Swarm\n\nAI-powered services accessible via x402 V2 micropayments. No API keys needed — pay with any ERC-20 token.\n\n## For AI Agents\n- **LLM-readable docs**: https://x402.ottoai.services/llm.txt\n- **Base MCP skill**: https://x402.ottoai.services/otto.md (catalog: /otto-x402-catalog.json) — payable from a Base Account via Base MCP\n- **Bazaar Discovery**: Listed on CDP Bazaar for automatic AI agent discovery\n- **OpenClaw Skills**: https://github.com/useOttoAI/openclaw-skills\n- **ERC-8004 Identity**: Registered on Ethereum mainnet\n\n## Payment Options\n- **USDC** on Base (eip155:8453), Polygon (eip155:137), or Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp)\n- EIP-3009 (zero-approval) and Permit2 transfer methods supported\n- Permit2 infrastructure ready for any ERC-20 — contact @useOttoAI for custom token integrations\n\n## x402 V2 Features\n- **Sign-in-with-X (SIWX)**: Read-only endpoints support pay-once, re-access via wallet signature (1hr)\n- **Signed Offers & Receipts**: Cryptographic proof of service delivery (EIP-712)\n- **Payment Identifier**: Idempotent retries on execution endpoints\n- **Bazaar Discovery**: Machine-readable schemas for AI agent auto-discovery\n\n## Available Services\n\n### Market & Token Intelligence\n- **/crypto-news** ($0.001) - Real-time crypto market news with sentiment analysis and top headlines ranked by importance.\n- **/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.\n- **/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.\n- **/filtered-news?topic={topic}** ($0.001) - AI-filtered crypto news and Twitter search for non-token topics (airdrops, DeFi trends, etc). Max 2 words.\n- **/twitter-summary** ($0.01) - Quick pulse check from crypto Twitter. Breaking news, trending narratives, and sentiment shifts at a glance.\n- **/token-details?symbol={symbol}** ($0.001) - Token price, market cap, volume, supply, and basic metrics. Works for any listed token.\n- **/token-alpha?symbol={symbol}** ($0.001) - Premium token intelligence: price metrics, news, Twitter sentiment, and futures data. Find out why your token is moving.\n- **/kol-sentiment** ($0.001) - Premium alpha from top 50 crypto KOLs. Real trading signals, trending token picks, and sentiment from influencers who move markets.\n- **/trending-altcoins** ($0.001) - Top 3 hottest altcoins traders may want to ape into, based on news and Twitter analysis. DYOR.\n- **/mega-report** ($0.05) - Alpha & Intel Report — daily crypto market intelligence: headlines, Twitter sentiment, KOL alpha, trending altcoins, and yield opportunities in one report.\n- **/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.\n- **/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.\n- **/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.\n- **/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.\n- **/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.\n- **/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.\n\n### DeFi & Markets Data\n- **/yield-alpha** ($0.001) - Best DeFi yield opportunities across stablecoins, ETH, and BTC with risk ratings and APY comparisons.\n- **/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.)\n- **/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.\n- **/tradfi-data?symbol={symbol}** ($0.001) - TradFi macro intelligence: indices, VIX, DXY, treasury yields, commodities, and individual stock quotes with moving average context.\n- **/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.\n- **/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.\n- **/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.\n- **/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.\n- **/equity-intel?ticker={ticker}** ($0.001) - 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.\n- **/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.\n- **/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.\n\n### AI Creative & Tools\n- **/generate-meme** ($0.15, POST) - Meme generator + professional AI image generation via fal.ai. Default model: OpenAI GPT Image 2 (typography, realism). Alternative: Google Nano Banana Pro (memes, stylized compositions). Flat $0.15 per image. Supports image editing via public image URL.\n- **/llm-research** ($0.10, POST) - 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.\n- **/tx-explainer** ($0.01, POST) - 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.\n- **/video-gen** (dynamic, POST) - 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.\n\n### Portfolio & Accounts\n- **/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.\n- **/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.\n- **/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.\n- **/hyperliquid-account?address={address}** ($0.001) - Hyperliquid perpetual trading account snapshot with open positions, margin, collateral, and active trigger orders (TP/SL/limit).\n- **/hl-transaction-history?address={address}** ($0.001) - Hyperliquid perpetual trading history: fills, funding payments, and realized PnL per position.\n- **/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.\n- **/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.\n- **/idle-capital?userAddress={userAddress}** ($0.001) - Detect undeployed tokens sitting in a user's Safe wallets that could be earning yield. Highlights best Aave / Morpho / Compound / Syrup opportunities per token. Powered by vaults.fyi.\n- **/yield-recommendations?userAddress={userAddress}** ($0.001) - Personalized yield vault recommendations based on a user's token holdings across 80+ DeFi protocols. Ranks vaults by APY, TVL, and risk. Powered by vaults.fyi.\n- **/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.\n\n### Execution\n- **/swap** ($0.01, POST) - 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.\n- **/bridge** ($0.01, POST) - 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.\n- **/withdraw** ($0.01, POST) - 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.\n- **/deposit** (dynamic, POST) - 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.\n- **/trade-perpetuals** ($0.01, POST) - 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.\n- **/close-position** ($0.01, POST) - Close an open perpetual position on Hyperliquid (full or partial). Cancels all attached TP/SL trigger orders automatically.\n- **/modify-hl-order** ($0.01, POST) - 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.\n- **/update-position-margin** ($0.01, POST) - Modify leverage, or add/remove margin on an open Hyperliquid position. Lets you de-risk without closing.\n- **/hl-deposit-withdraw** ($0.01, POST) - 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.\n\n## Quick Start for Agents\n1. Fetch endpoint -> receive 402 with PAYMENT-REQUIRED header\n2. Choose payment method: USDC (EIP-3009), any ERC-20 (Permit2), or Solana USDC\n3. Sign payment and retry with PAYMENT-SIGNATURE header\n4. Receive JSON response + signed receipt in PAYMENT-RESPONSE header\n5. For read-only data: use SIGN-IN-WITH-X header on repeat requests (1hr free access)\n\n## Documentation\nhttps://docs.useotto.xyz/acp-swarm/x402\n\n## Support\nTwitter: @useOttoAI","ownershipProofs":["0x143123422fc25e357261578cb01dad50bcdcf8f9507f18a9ee9e7c6e27dfa7ce79a46bdc0331ab8725ff3b38e04b0faa54d62a0b9ff10decd72039a65604acc01c"]}