Otto AI x402 V2 API Reference

# Example: Requesting crypto news
curl -i "https://x402.ottoai.services/crypto-news"

# Server Responds:
HTTP/1.1 402 Payment Required
PAYMENT-REQUIRED: eyJ4NDAyVmVyc2lvbiI6Mi4uLg==  # Base64-encoded payment options

{
  "x402Version": 2,
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "amount": "1000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "payTo": "0x..."
    },
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "extra": { "assetTransferMethod": "permit2" },
      "payTo": "0x..."
    },
    {
      "scheme": "exact",
      "network": "eip155:137",
      "payTo": "0x..."
    },
    {
      "scheme": "exact",
      "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
      "payTo": "..."
    }
  ],
  "extensions": {
    "offer-receipt": { "...signed EIP-712 offer..." },
    "sign-in-with-x": { "...SIWX challenge..." },
    "bazaar": { "...discovery metadata..." }
  }
}

# V2 header (recommended):
curl "https://x402.ottoai.services/crypto-news" \
     -H "PAYMENT-SIGNATURE: eyJ4NDAy..." # Base64-encoded signed payment

# V1 header (backward compatible):
curl "https://x402.ottoai.services/crypto-news" \
     -H "PAYMENT-SIGNATURE: eyJ..." # Legacy V1 payment

# Server Responds:
HTTP/1.1 200 OK
PAYMENT-RESPONSE: eyJ...  # Contains signed EIP-712 receipt
Content-Type: application/json

{
  "status": "success",
  "data": { "report": "Your Crypto News Brief..." }
}

curl "https://x402.ottoai.services/crypto-news" \
     -H "SIGN-IN-WITH-X: eyJ..." # Base64-encoded wallet signature

import { wrapAxiosWithPayment, x402Client } from '@x402/axios';
import { ExactEvmScheme } from '@x402/evm/exact/client';
import { toClientEvmSigner } from '@x402/evm';
import axios from 'axios';
import { createPublicClient, http } from 'viem';
import { base } from 'viem/chains';
import { privateKeyToAccount } from 'viem/accounts';

// SECURITY WARNING: Never hardcode private keys in your source code!
const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const publicClient = createPublicClient({ chain: base, transport: http() });
const signer = toClientEvmSigner(account, publicClient);

// Create x402 V2 client
const client = new x402Client();
client.register('eip155:*', new ExactEvmScheme(signer));

const api = wrapAxiosWithPayment(
  axios.create({ baseURL: 'https://x402.ottoai.services' }),
  client
);

// Automatic payment — SDK handles 402 → sign → retry
const response = await api.get('/crypto-news');
console.log(response.data);

curl "https://x402.ottoai.services/crypto-news" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "report": "Your Crypto News Brief\n\nOverview: Cryptocurrency markets experienced increased activity today, driven by easing macroeconomic conditions, regulatory developments, and notable shifts in market structure and technology.\n\nMarket Sentiment:\nOverall Bull/Bear Score: 78\n\nKey Developments:\n* Crypto M&A activity reached a record $10 billion in Q3 2025, fueled by easing macroeconomic conditions boosting demand for both Bitcoin and gold as alternative assets.\n* News regarding a potential end to the US-China trade war has influenced global market sentiment, contributing to a crypto market rally.\n* Speculation around a potential pardon by Trump has spurred plans for Binance to re-enter the U.S. market, potentially reshaping the competitive landscape.\n* Hong Kong approved Asia's first Solana ETF, signaling growing institutional acceptance, while Russia and Kyrgyzstan are integrating crypto into their national financial systems.\n\n[Powered by $OTTO AI | @OttoWallet]"
}

curl "https://x402.ottoai.services/filtered-news?topic=AI%20Agents" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "report": "FILTERED CRYPTO NEWS: AI AGENTS\nConfidence Score: High\nSources: Twitter (Yes), News (Yes), Historical (Yes)\nGenerated: Oct 26, 06:14 PM\n\nFellow traders and DeFi users, the 'AI Agents' narrative is undeniably heating up, and we're seeing tangible signs of capital flowing into this nascent but rapidly evolving sector.\n\n**Coinbase x402 transactions are up a staggering 10,000% as AI agents go live.** This explosion in transaction volume for a micro-transaction layer token directly linked to AI agent operations indicates real-world utility and increasing adoption on the blockchain.\n\n[Powered by $OTTO AI | @OttoWallet]",
  "topic": "AI Agents",
  "source_count": 15
}

curl "https://x402.ottoai.services/twitter-summary" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "digest": "CRYPTO TWITTER DIGEST - Oct 26, 06:16 PM\n\nCRITICAL ALERTS\nVitalik warns off-chain security not guaranteed even with blockchain's 51% attack protection.\n\nDEFI ECOSYSTEM\nAdvisor adds $10K of $VALOR to Meteora liquidity pool.\n\nOTHER NEWS\nSmart trader with 100% win rate increases $BTC and $ETH long positions.\nBinance paid $450k for lobbying the White House in September.\nKraken's Q3 revenue hits all-time high, driven by 2025 acquisitions and IPO prep.\nWhale accumulated 3,195 $BTC in 3 hours.\n\n[Powered by $OTTO AI | @OttoWallet]",
  "timestamp": "2025-10-26T18:16:19.356Z"
}

curl "https://x402.ottoai.services/token-details?symbol=SOL" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "details": "=== TOKEN DATA INTELLIGENCE: SOL ===\nGenerated: Sat, 26 Oct 2025 18:00:00 GMT\n\nToken Overview\n- Name: Solana (SOL)\n- Rank: #5\n- Price: $145.20\n- Market Cap: $65.00B\n- FDV: $82.15B\n\nPrice Performance\n- 1h: 0.50%\n- 24h: 2.10%\n- 7d: -3.40%\n- 30d: 12.50%\n\nVolume Review\n- Volume (24h): $1.20B\n- Volume/MCap Ratio: 1.85%\n- Liquidity Score: Excellent\n\nMomentum Signal\n- Momentum: Building Momentum (DYOR)\n\n[Powered by $OTTO AI | @OttoWallet]"
}

curl "https://x402.ottoai.services/token-alpha?symbol=ETH" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "alpha_report": "=== OTTO TOKEN ALPHA: ETH ===\nGenerated: Sat, 26 Oct 2025 18:00:00 GMT\n\nMARKET DATA\n- Price: $2,847.32\n- Market Cap: $342.00B\n- 24h Change: +1.80%\n- 7d Change: +4.20%\n\nDERIVATIVES CONTEXT (Coinglass)\n- Funding Rate: 0.0045%\n- Open Interest: $12.5B\n- Long/Short Ratio: 1.15\n- Fear & Greed: 72 (Greed)\n\nNEWS SENTIMENT\nEthereum's 'supercycle' thesis is gaining traction, with projections of ETH reaching $21,000 anchored in institutional RWA tokenization...\n\nTWITTER PULSE\nKOLs are predominantly bullish on ETH, citing institutional adoption and L2 scaling success...\n\nALPHA SIGNAL: BULLISH\nConfidence: 78%\n\n[Powered by $OTTO AI | @OttoWallet]"
}

curl "https://x402.ottoai.services/kol-sentiment" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "report": "=== OTTO KOL ALPHA ===\nGenerated: 2025-10-26T18:48:48.495Z\n\nOVERALL SENTIMENT\nBULLISH\nScore: 78%\n\nKEY NARRATIVES\n1. The Resurgence of Privacy: Zcash Leads the Charge in a Post-Surveillance World\n2. Base Layering Up: x402 Protocol Catalyzing Mainstream Adoption\n3. Ethereum's Supercycle Thesis: Institutional Tokenization Fuels a $21K Vision\n\nTRENDING TOKENS\n- Hottest Major: BTC\n- Trending Altcoins: ZEC, SEDA, PAYAI, ARB, GRNY, BMNR, IWM\n\nTOP KOL INSIGHTS\n- @fundstrat (1623 engagement)\n  \"Positive development USA - China trade relations\n  - Up for equities $SPY $QQQ $IWM\n  - Up for supercycle Ethereum $ETH\n  - Up for Bitcoin $BTC\"\n\nSUMMARY\nThe crypto market intelligence gathered from recent KOL activity points towards a distinctly bullish sentiment, underscored by a blend of macro catalysts, significant institutional interest, and emerging narratives driving specific altcoin rallies.\n\n[Powered by $OTTO AI | @OttoWallet]"
}

curl "https://x402.ottoai.services/yield-alpha" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "opportunities": "=== OTTO YIELD ALPHA OPPORTUNITIES ===\nUpdated: October 26, 6:37 PM GMT\n\n=== BLUE-CHIP YIELDS (Low Risk, Best of the Best) ===\nFiltered for highest quality DeFi: High TVL, Pendle Prime, Blue Chip Protocols\n\nBest Stablecoin: Morpho - USDC (Arbitrum)\n   * APY: 10.40%\n   * TVL: $13,528,117\n   * Blue chip crypto + RWA collateral strategy\n   * Market: https://app.morpho.org/arbitrum/vault/0x5c0C306Aaa9F877de636f4d5822cA9F2E81563BA/steakhouse-high-yield-usdc\n\nBest ETH: Morpho - WETH (Ethereum)\n   * APY: 3.81%\n   * TVL: $17,480,478\n   * Morpho vault with $17M TVL\n\nBest BTC: Pendle Prime - eBTC (Ethereum)\n   * APY: 1.78%\n   * TVL: $1,731,713\n   * Pendle Prime PT market (expires Dec 18, 2025)\n\n[Powered by $OTTO AI | @OttoWallet]"
}

curl "https://x402.ottoai.services/trending-altcoins" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "report": "=== OTTO TOP 3 TRENDING ALTCOINS ===\nGenerated: Sun, 26 Oct 2025 18:05:00 GMT\n\n**1. HYPE (Hyperliquid) - CMC Rank #11**\nWHY IT'S TRENDING:\n* A 'digital Nasdaq' disrupting derivatives by listing equity and commodity perps - a true game-changer!\n* A 'Giant Company' is pursuing a monumental $1 Billion acquisition, mirroring MicroStrategy's Bitcoin strategy for altcoins!\n* Explosive rally with a 143.79% surge in 24h volume and 'insane' monthly candles, signaling massive retail and institutional FOMO.\nKEY METRICS: Price: $47.50 | Market Cap: $15.99B | 24h Volume: $635.52M | 24h Change: 13.56%\nBULLISH THESIS: HYPE is a crypto powerhouse at the nexus of institutional validation and a rapidly expanding derivatives market.\n\n**2. ZEC (Zcash) - CMC Rank #24**\nWHY IT'S TRENDING:\n* Leading the charge in the \"Q4: ZEC szn\" narrative, as privacy coins make a dramatic resurgence!\n* Rapidly surging with a 531.85% gain in 30 days and a stunning 26.06% increase today, nearing an all-time high!\nKEY METRICS: Price: $347.89 | Market Cap: $5.66B | 24h Volume: $1.08B | 24h Change: 26.91%\n\n**3. AAVE (Aave) - CMC Rank #32**\nWHY IT'S TRENDING:\n* Aave V4 is set to unify liquidity, positioning the protocol to bring \"the next trillion dollars onchain\"!\n* Commanding leadership in Real-World Assets (RWAs) with over $350 million in net deposits.\nKEY METRICS: Price: $236.60 | Market Cap: $3.61B | 24h Volume: $240.03M | 24h Change: 4.90%\n\n[Powered by $OTTO AI | @OttoWallet]"
}

curl "https://x402.ottoai.services/mega-report" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "summary": "=== OTTO MEGA REPORT ===\nYour Daily Market Intelligence Briefing\n\nMARKET OVERVIEW\nOverall Sentiment: BULLISH (Score: 78%)\nFear & Greed Index: 72 (Greed)\n\nTOP HEADLINES\n- Crypto M&A activity hits record $10B in Q3 2025\n- Hong Kong approves Asia's first Solana ETF\n- JPMorgan now accepting BTC/ETH as loan collateral\n\nTRENDING TOKENS\nHYPE, ZEC, AAVE leading altcoin momentum\n\nTOP YIELD: 10.40% APY on USDC (Morpho)\n\nFull report: See report_url for complete analysis\n\n[Powered by $OTTO AI | @OttoWallet]",
  "report_url": "https://market-alpha-agent.up.railway.app/reports/mega-1730000000000.html"
}

curl "https://x402.ottoai.services/token-security?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&chain=8453" \
     -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "report": "=== TOKEN SECURITY AUDIT ===\nPowered by GoPlus Security\n\nToken: USD Coin (USDC)\nChain: Base (8453)\n\n🟢 RISK SCORE: 5/100 (LOW)\n\n✅ No critical security issues detected\n...",
  "security": {
    "riskScore": 5,
    "riskLevel": "LOW",
    "flags": [],
    "buyTax": "0%",
    "sellTax": "0%"
  }
}

curl "https://x402.ottoai.services/funding-rates?symbol=BTC" -H "PAYMENT-SIGNATURE: eyJ..."

curl "https://x402.ottoai.services/funding-rates" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "report": "=== OTTO AI DERIVATIVES INTELLIGENCE ===\nSymbol: BTC\n\n📊 FUNDING RATES BY EXCHANGE\n  🟢 Binance: 0.0100%\n  🟢 OKX: 0.0095%\n  🔴 Bybit: -0.0050%\n\n📈 OPEN INTEREST BY EXCHANGE\n  Binance: $5.20B\n  OKX: $2.10B\n...\n\n[Powered by $OTTO AI | @useOttoAI]"
}

curl "https://x402.ottoai.services/defi-analytics?protocol=aave" -H "PAYMENT-SIGNATURE: eyJ..."

curl "https://x402.ottoai.services/defi-analytics" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "report": "=== OTTO AI DEFI INTELLIGENCE ===\n\n📊 TOTAL DEFI TVL: $180.50B\n\n🏆 TOP 20 PROTOCOLS BY TVL\n1. Lido (LDO) — $30.50B | 7d: +2.30% | Liquid Staking\n2. AAVE (AAVE) — $18.20B | 7d: +1.50% | Lending\n...\n\n[Powered by $OTTO AI | @useOttoAI]"
}

curl "https://x402.ottoai.services/tradfi-data?symbol=AAPL" -H "PAYMENT-SIGNATURE: eyJ..."

curl "https://x402.ottoai.services/tradfi-data" -H "PAYMENT-SIGNATURE: eyJ..."

{
  "status": "success",
  "report": "=== OTTO AI MACRO INTELLIGENCE ===\n\n📊 MAJOR INDICES\n  🟢 S&P 500: 5,850.25 (+0.85%)\n  🟢 Nasdaq: 18,420.50 (+1.20%)\n\n📈 VOLATILITY & DOLLAR\n  VIX: 15.30 (-2.50%)\n  DXY: 103.45 (-0.30%)\n\n🔗 CRYPTO CONTEXT\nVIX below 20 — low fear, risk-on environment supportive for crypto.\n...\n\n[Powered by $OTTO AI | @useOttoAI]"
}

curl -X POST "https://x402.ottoai.services/llm-research" \
     -H "Content-Type: application/json" \
     -H "PAYMENT-SIGNATURE: eyJ..." \
     -d '{"prompt": "Explain Base Chain in simple terms.", "confirm_180_char_limit": true}'

curl -X POST "https://x402.ottoai.services/llm-research" \
     -H "Content-Type: application/json" \
     -H "PAYMENT-SIGNATURE: eyJ..." \
     -d '{"url": "https://some-crypto-news-site.com/article", "confirm_180_char_limit": true}'

{
  "status": "success",
  "result": "Base Chain is a Layer 2 (L2) blockchain built on Ethereum, developed by Coinbase. It offers faster and cheaper transactions compared to Ethereum's main network while inheriting Ethereum's security. Base is designed to make decentralized applications more accessible and affordable for everyday users."
}

curl -X POST "https://x402.ottoai.services/generate-meme" \
     -H "Content-Type: application/json" \
     -H "PAYMENT-SIGNATURE: eyJ..." \
     -d '{"prompt": "A photorealistic golden Bitcoin rocket launching into space with the text TO THE MOON in bold letters at the top", "model": "gpt-image-2", "aspect_ratio": "16:9"}'

{
  "status": "success",
  "imageUrl": "https://images.useotto.xyz/1761442152697.png",
  "model": "gpt-image-2",
  "expiresAt": "2025-11-02T18:00:00.000Z"
}

curl -X POST "https://x402.ottoai.services/video-gen" \
     -H "Content-Type: application/json" \
     -H "PAYMENT-SIGNATURE: eyJ..." \
     -d '{"prompt": "A futuristic cityscape with flying cars and neon signs, slow drone flyover at dusk", "model": "seedance-2.0", "duration": 5, "aspect_ratio": "16:9"}'

{
  "status": "success",
  "videoUrl": "https://images.useotto.xyz/videos/1761442152697.mp4",
  "model": "seedance-2.0",
  "duration": 5,
  "resolution": "720p",
  "price": 1.75,
  "expiresAt": "2025-11-02T18:00:00.000Z"
}

curl "https://x402.ottoai.services/tx-explainer?txHash=0x1234...&chain=base&outputLevel=summary" \
     -H "PAYMENT-SIGNATURE: eyJ..."

curl -X POST "https://x402.ottoai.services/tx-explainer" \
     -H "Content-Type: application/json" \
     -H "PAYMENT-SIGNATURE: eyJ..." \
     -d '{"txHash": "0x1234...", "chain": "ethereum", "outputLevel": "detailed"}'

{
  "status": "success",
  "explanation": "This transaction is a token swap on Uniswap V3. The sender swapped 1,000 USDC for 0.42 ETH ($1,000 worth) via the USDC/WETH pool on Ethereum. Gas cost: $2.14.",
  "chain": "ethereum",
  "txHash": "0x1234...",
  "explorerUrl": "https://etherscan.io/tx/0x1234..."
}

{
  "proofOfPayment": {
    "txHash": "0xabc123...",
    "chainId": "8453",
    "fromAddress": "0xYourWallet...",
    "toAddress": "0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808"
  }
}