Skip to main content
Welcome to the technical documentation for the Otto AI Agent Swarm on x402 V2. While our main Agent Swarm overview explains what our agents do, this page provides the specific endpoint details, request parameters, and examples needed for programmatic, agent-to-agent (A2A) integration. All endpoints are accessible via the x402 V2 protocol, allowing any developer or AI agent to pay for and consume our services in real-time. Base URL: https://x402.ottoai.services Networks: Base Mainnet + Polygon Mainnet + Solana Mainnet Payment: USDC on Base, Polygon, or Solana. Permit2 infrastructure ready for any ERC-20 token. Discovery: Related rails: USDC / Circle Gateway, MPP, and Otto X expose overlapping subsets and rail-specific routes. See Access Paths & Coverage for current counts and capability coverage.

​
x402 V2 Features

FeatureDescription
Multi-NetworkPay with USDC on Base, Polygon, or Solana — same endpoints, same prices
Permit2 ReadyInfrastructure supports any ERC-20 token via Permit2. Contact @useOttoAI for custom token integrations
Sign-in-with-X (SIWX)Pay once for most read-only endpoints, re-access for 1 hour with your wallet signature (data endpoints are pay-per-call only)
Bazaar DiscoveryRead-only endpoints listed on CDP Bazaar for automatic AI agent discovery
Signed ReceiptsEvery 402 response includes a signed offer (EIP-712); every 200 includes a signed receipt — verifiable proof of service delivery
Payment IdentifierExecution endpoints support idempotent retries via unique payment IDs

​
Browser Pay Widget — APP Buyer-Agent reference module

The interactive endpoint explorer at xlayer.ottoai.services (USDT0 on X Layer) and x402.ottoai.services (USDC on Base/Polygon/Solana) embeds a working browser-side payment client: connect a wallet, sign one EIP-712 / EIP-3009 authorization, and a paid request goes out. That client is structurally a Buyer-Agent runtime in the OKX Agent Payments Protocol sense — it parses 402 challenges, signs, and submits credentials over plain HTTP. Drop it into any agent’s payment-handling module and it works the same way.

​
Pricing Overview

EndpointPrice (USDC)Description
/crypto-news$0.001Real-time crypto market news with sentiment
/filtered-news$0.001AI-filtered news for specific topics
/twitter-summary$0.01Curated Twitter/X crypto digest
/token-details$0.001Token price, market cap, volume, metrics
/token-alpha$0.001Premium token intelligence with derivatives data
/kol-sentiment$0.001Top 50 KOL sentiment analysis
/yield-alpha$0.001DeFi yield opportunities
/trending-altcoins$0.001Top 3 trending altcoins
/mega-report$0.05Alpha & Intel Report — comprehensive daily market briefing
/token-security$0.001Token contract security audit (GoPlus)
/funding-rates$0.001Derivatives dashboard (funding, OI, whales)
/defi-analytics$0.001DeFi protocol analytics (TVL, trends)
/tradfi-data$0.001TradFi macro intelligence (VIX, DXY, yields)
/generate-meme$0.15Multi-model image gen via fal.ai (GPT Image 2, Nano Banana Pro)
/llm-research$0.10AI research assistant (Gemini 3.5 Flash, cited sources)
/tx-explainer$0.01Decode & explain any EVM transaction (11 chains)
/video-genDynamicMulti-model video gen via fal.ai (Seedance 2.0, Sora 2, Veo 3.1) — at-cost × 1.15
Trade Execution — Resources
/portfolio$0.001Multi-chain portfolio with token balances
/transaction-history$0.001Transaction history for user’s Safe account
/supported-tokens$0.001Search supported tokens by symbol on a chain
/hyperliquid-account$0.001Hyperliquid account snapshot with positions
/hyperliquid-market$0.001Hyperliquid market data with live prices
/hl-transaction-history$0.001Hyperliquid trading transaction history
/yield-markets$0.001Yield markets with APYs (Aave V3, Morpho)
/yield-farming-active$0.001Active yield farming positions
/yield-farming-historical$0.001Historical yield farming positions
/idle-capital$0.001Detect undeployed tokens that could earn yield
/yield-recommendations$0.001Personalized vault recommendations
Onchain Data
/token-top-holders$0.02Top holders for any Base ERC-20 + concentration metrics via Moralis
/stablecoin-watch$0.001Peg deviation, supply flow, dominance for top 30 USD stablecoins (DefiLlama, hourly)
/protocol-revenue-leaders$0.001Top 30 DeFi protocols by fees + revenue, take-rate, 7d/30d trend (DefiLlama, hourly)
/equity-intel$0.001US stock fundamentals + SEC filings intel by ticker (SEC EDGAR)
/base-season$0.001KOL-ranked quality-screened Base tokens with sentiment: who’s talking about what, hourly
/news-recaps$0.002One-paragraph crypto market recap (4-6 sentences), distilled hourly from the live news engine
/base-ecosystem-news$0.001Base-chain ecosystem news, AI-filtered hourly: launches, Coinbase/Base moves, Base DeFi
/token-fundamentals$0.002Structured asset fundamentals by symbol: supply, ATH drawdown, ROI windows, links (CoinGecko)
/token-price$0.001Onchain DEX token price by symbol or chain:contract — price, 24h change, volume, mcap, liquidity (8 chains)
/pools-search$0.001Search DEX pools across 8 chains by symbol/name/contract — price, volume, liquidity, FDV per pool
/pools-trending$0.001Trending DEX pools — top 10 hottest per chain (or network=all cross-chain) by 24h trending: price, change, volume, liquidity, FDV
/holder-analytics$0.03Full holder analytics for a Base ERC-20: total holders + change momentum, whale-tier distribution, acquisition mix, top-N supply share, labeled top holders + AI risk read
/wallet-holdings$0.02Wallet bagcheck: Base portfolio (up to 100 positions, spam filtered) with USD values, portfolio %, 24h change + concentration and AI read
Trade Execution — Services
/swap$0.01Token swap from Safe via Odos DEX aggregator
/bridge$0.01Cross-chain bridge from Safe via LiFi
/withdraw$0.01Withdraw tokens from Safe to wallet
/depositDynamicDeposit to Safe (amount + $0.01 fee)
/trade-perpetuals$0.01Open leveraged perp positions on Hyperliquid
/close-position$0.01Close perpetual position (full or partial)
/modify-hl-order$0.01Add/modify/cancel TP/SL and limit orders
/update-position-margin$0.01Adjust leverage or margin on open positions
/hl-deposit-withdraw$0.01Deposit/withdraw USDC to/from Hyperliquid

​
How to Make a Request (x402 V2 Flow)

Consuming an x402-powered API is a multi-step process. The client (buyer) first makes a request, receives a payment requirement, pays, and then retries the request with proof of payment.

​
Step 1: Initial Request (Fails with 402)

First, the client makes a standard HTTP request to the desired endpoint. The server responds with HTTP 402 Payment Required and a PAYMENT-REQUIRED header containing base64-encoded payment options. 
# 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
Decoding the PAYMENT-REQUIRED header reveals: 
{
  "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..." }
  }
}

​
Step 2: Client Signs & Pays

The client chooses a payment option from the accepts array and signs the payment:
  1. USDC on Base (EIP-3009) — zero-approval, default for most clients
  2. Any ERC-20 on Base/Polygon (Permit2) — requires Permit2 approval
  3. USDC on Solana — SPL token transfer
This is typically handled by an x402-compatible client library like @x402/axios.

​
Step 3: Retry Request with Payment Header

The client retries the exact same request with a PAYMENT-SIGNATURE header containing the signed payment payload. 
# 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

​
Step 4: Success (Receives Data + Receipt)

The server verifies the payment via the CDP Facilitator, settles on-chain, and returns 200 OK with the data plus a signed receipt in the PAYMENT-RESPONSE header. 
# 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..." }
}

​
Step 5 (Optional): Sign-in-with-X for Repeat Access

For most read-only endpoints, after paying once you can re-access for 1 hour by signing a SIWX challenge with your wallet — no additional payment required. The cached data endpoints (token-top-holders, stablecoin-watch, protocol-revenue-leaders, equity-intel, base-season, news-recaps, base-ecosystem-news, token-fundamentals, pools-search, token-price, pools-trending, holder-analytics, wallet-holdings) are pay-per-call only. 
curl "https://x402.ottoai.services/crypto-news" \
     -H "SIGN-IN-WITH-X: eyJ..." # Base64-encoded wallet signature

​
Understanding the Facilitator

The CDP Facilitator (Coinbase Developer Platform) is the payment verification and settlement service:
  1. Validates Payment Signatures: Verifies the PAYMENT-SIGNATURE header is cryptographically valid.
  2. Prevents Replay Attacks: Tracks nonces and timestamps to prevent signature reuse.
  3. Executes On-Chain Settlement: Submits transactions to Base, Polygon, or Solana to transfer USDC.
  4. Supports Gas Sponsorship: EIP-2612 and ERC-20 gas sponsoring extensions available for Permit2 flows.
  5. Provides Instant Confirmation: Returns confirmation within milliseconds.
Key Points:
  • Otto AI uses the CDP Facilitator (api.cdp.coinbase.com/platform/v2/x402)
  • Supports Base (eip155:8453), Polygon (eip155:137), and Solana mainnet
  • Payment signatures expire after ~60 seconds
  • Extensions: bazaar, eip2612GasSponsoring, erc20ApprovalGasSponsoring

​
Client-Side Example (Node.js / x402 V2 SDK)

For programmatic access, use @x402/axios (V2) to handle the payment flow automatically. 
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);

​
API Endpoint Reference

​
News & Social

AI-curated crypto market news, headlines, and social sentiment.

​
GET /crypto-news

Fetches a comprehensive, AI-curated summary of the latest market news, including top stories, regulatory updates, and DeFi trends. Now includes top headlines (previously separate endpoint). Price: $0.001 USDC Parameters: None Example Request: 
curl "https://x402.ottoai.services/crypto-news" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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]"
}

​
GET /filtered-news

Get news filtered for a specific crypto topic (e.g., “Airdrops”, “DeFi trends”, “Bitcoin ETF”). Price: $0.001 USDC Parameters:
  • topic (string, required): The topic to filter news for.
Example Request: 
curl "https://x402.ottoai.services/filtered-news?topic=AI%20Agents" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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
}

​
GET /twitter-summary

Get curated insights and sentiment analysis from the crypto community on X (Twitter), identifying trending topics and top tweets. Price: $0.01 USDC Parameters: None Example Request: 
curl "https://x402.ottoai.services/twitter-summary" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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"
}

​
Market Intelligence

Access real-time token metrics, market analysis, and sentiment.

​
GET /token-details

Get a snapshot of a token’s core metrics, performance, and trading data. Price: $0.001 USDC Parameters:
  • symbol (string, required): The token symbol (e.g., “SOL”, “ETH”, “BTC”).
Example Request: 
curl "https://x402.ottoai.services/token-details?symbol=SOL" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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]"
}

​
GET /token-alpha

Receive a comprehensive, AI-enhanced report that combines all Token Details with filtered news, Twitter sentiment, Coinglass derivatives data, and actionable insights. Price: $0.001 USDC Parameters:
  • symbol (string, required): The token symbol (e.g., “SOL”, “ETH”, “BTC”).
Example Request: 
curl "https://x402.ottoai.services/token-alpha?symbol=ETH" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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]"
}

​
GET /kol-sentiment

Analyzes tweets from the top 50 crypto Key Opinion Leaders (KOLs) to provide a market sentiment score, key narratives, and trending tokens. Includes broader Twitter pulse. Price: $0.001 USDC Parameters: None Example Request: 
curl "https://x402.ottoai.services/kol-sentiment" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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]"
}

​
GET /yield-alpha

Discover the best DeFi yield opportunities across blue-chip protocols like AAVE, Morpho, and Pendle, with APY comparisons. Price: $0.001 USDC Parameters: None Example Request: 
curl "https://x402.ottoai.services/yield-alpha" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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]"
}

​
GET /trending-altcoins

Discover the top 3 trending altcoins (Rank 10-500) with a “Why it’s Trending” thesis and key metrics. Price: $0.001 USDC Parameters: None Example Request: 
curl "https://x402.ottoai.services/trending-altcoins" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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]"
}

​
GET /mega-report

Your comprehensive daily crypto market intelligence briefing. Combines top headlines, Twitter sentiment, KOL alpha, trending altcoins, yield opportunities, AND Coinglass derivatives context (Fear & Greed, ETF flows, funding arbitrage) into one executive summary with a link to a full HTML report. Price: $0.05 USDC Parameters: None Example Request: 
curl "https://x402.ottoai.services/mega-report" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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"
}

​
Data Intelligence

Token security, derivatives data, DeFi analytics, and TradFi macro context.

​
GET /token-security

Scan any token contract for security risks — honeypots, hidden mints, rug pull indicators, buy/sell taxes, holder concentration, and liquidity analysis. Powered by GoPlus Security. Price: $0.001 USDC Parameters:
  • address (string, required): Token contract address (0x-prefixed).
  • chain (string, optional): Chain ID. Default: 8453 (Base). Supported: 1 (ETH), 56 (BSC), 137 (Polygon), 42161 (Arbitrum), 8453 (Base), 43114 (Avalanche), 10 (Optimism).
Example Request: 
curl "https://x402.ottoai.services/token-security?address=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&chain=8453" \
     -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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%"
  }
}

​
GET /funding-rates

Derivatives intelligence dashboard. With a symbol, get cross-exchange funding rates, open interest, long/short ratios, and whale positions. Without a symbol, get a market overview with arbitrage opportunities, liquidation data, and fear/greed index. Price: $0.001 USDC Parameters:
  • symbol (string, optional): Token symbol for detailed view (e.g., “BTC”, “ETH”). Omit for market overview.
Example Request (Symbol): 
curl "https://x402.ottoai.services/funding-rates?symbol=BTC" -H "PAYMENT-SIGNATURE: eyJ..."
Example Request (Overview): 
curl "https://x402.ottoai.services/funding-rates" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "status": "success",
  "report": "=== OTTO AI DERIVATIVES INTELLIGENCE ===\nSymbol: BTC\n\n📊 FUNDING RATES BY EXCHANGE\n  🟢 Binance: 0.00100%\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]"
}

​
GET /defi-analytics

DeFi protocol analytics. With a protocol name, get detailed TVL, chain breakdown, and trend data. Without a protocol, get a market overview with top 20 protocols, gainers/losers, and chain comparison. Price: $0.001 USDC Parameters:
  • protocol (string, optional): Protocol slug for detailed view (e.g., “aave”, “lido”, “uniswap”). Omit for DeFi overview.
Example Request (Protocol): 
curl "https://x402.ottoai.services/defi-analytics?protocol=aave" -H "PAYMENT-SIGNATURE: eyJ..."
Example Request (Overview): 
curl "https://x402.ottoai.services/defi-analytics" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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]"
}

​
GET /tradfi-data

TradFi macro intelligence for crypto context. With a ticker symbol, get a real-time quote with moving average analysis. Without a symbol, get a macro dashboard covering indices, VIX, DXY, treasury yields, and commodities with crypto impact analysis. Price: $0.001 USDC Parameters:
  • symbol (string, optional): Ticker symbol for individual quote (e.g., “AAPL”, “MSFT”, “^GSPC” for S&P 500). Omit for macro dashboard.
Example Request (Quote): 
curl "https://x402.ottoai.services/tradfi-data?symbol=AAPL" -H "PAYMENT-SIGNATURE: eyJ..."
Example Request (Macro Dashboard): 
curl "https://x402.ottoai.services/tradfi-data" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "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]"
}

​
Onchain Data

Aggregate-cache-fanout endpoints. Responses carry meta.generatedAt + meta.stalenessSec. If the cache is cold or past hardMaxAge, the endpoint returns an unpaid 503 rather than a paid stale read — no charge for dead data.

​
GET /token-top-holders

Returns the top holders for any ERC-20 on Base with concentration metrics: what percentage the top 1/5/10/20 holders control, and how much is locked in contracts. Useful for whale tracking and distribution analysis. Price: $0.02 USDC Parameters:
  • token (string, required): ERC-20 contract address on Base (0x-prefixed).
Example Request: 
curl "https://x402.ottoai.services/token-top-holders?token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" \
     -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "status": "success",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "holders": [
    { "address": "0xabc...", "balance": "120000000", "percentOwned": 12.0 },
    { "address": "0xdef...", "balance": "80000000",  "percentOwned": 8.0 }
  ],
  "concentration": {
    "top1Pct": 12.0,
    "top5Pct": 35.2,
    "top10Pct": 51.8,
    "top20Pct": 67.3,
    "contractHeldPct": 22.1
  },
  "meta": { "generatedAt": "2026-06-04T08:00:00.000Z", "stalenessSec": 300 }
}

​
GET /stablecoin-watch

Live peg health and supply flows for the top 30 USD-pegged stablecoins. Tracks peg deviation in basis points, circulating supply with 1d/7d/30d flow (risk-on/off signal), dominance, and surfaces any stablecoins trading ≥50 bps below peg as depeg alerts. Price: $0.001 USDC Parameters: None Example Request: 
curl "https://x402.ottoai.services/stablecoin-watch" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "status": "success",
  "data": {
    "totalCirculatingUsd": 183000000000,
    "marketChange": { "d1Pct": 0.12, "d7Pct": 1.4, "d30Pct": 3.8 },
    "stablecoinCount": 30,
    "topStablecoins": [
      {
        "symbol": "USDT", "name": "Tether", "pegMechanism": "fiat-backed",
        "priceUsd": 0.9998, "pegDeviationBps": -2, "circulatingUsd": 113000000000,
        "dominancePct": 61.7, "change1dPct": 0.1, "change7dPct": 0.9, "change30dPct": 2.1,
        "chains": ["ethereum","tron","solana","base"]
      }
    ],
    "depegAlerts": [],
    "narrative": "Stablecoin supply expanded 0.12% in the last 24h — mild risk-on signal. All tracked pegs within ±20 bps.",
    "generatedAt": "2026-06-04T08:00:00.000Z"
  },
  "meta": { "generatedAt": "2026-06-04T08:00:00.000Z", "stalenessSec": 1800 }
}

​
GET /protocol-revenue-leaders

Fundamentals screen for DeFi protocols — distinct from TVL. Returns the top 30 protocols ranked by 24h fees, with revenue, take-rate (protocol’s share of user-paid fees), 7d/30d fee trends, and total-DeFi fee/revenue aggregates. Built on DefiLlama’s public /overview/fees endpoint, refreshed hourly. Price: $0.001 USDC Parameters: None Example Request: 
curl "https://x402.ottoai.services/protocol-revenue-leaders" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "status": "success",
  "data": {
    "totalFees24hUsd": 8200000,
    "totalRevenue24hUsd": 3100000,
    "protocolCount": 30,
    "leaders": [
      {
        "name": "Uniswap", "category": "Dexes", "chains": ["ethereum","base","arbitrum"],
        "fees24hUsd": 1800000, "fees7dUsd": 12000000, "fees30dUsd": 49000000,
        "feesChange7dPct": 4.2,
        "revenue24hUsd": 0, "revenue30dUsd": 0,
        "takeRatePct": 0
      },
      {
        "name": "Aave", "category": "Lending", "chains": ["ethereum","polygon","arbitrum","base"],
        "fees24hUsd": 620000, "fees7dUsd": 4100000, "fees30dUsd": 17000000,
        "feesChange7dPct": 8.1,
        "revenue24hUsd": 310000, "revenue30dUsd": 8500000,
        "takeRatePct": 50.0
      }
    ],
    "narrative": "Uniswap leads by raw fees; Aave captures 50% of its fees as protocol revenue — highest take-rate in the top 5.",
    "generatedAt": "2026-06-04T08:00:00.000Z"
  },
  "meta": { "generatedAt": "2026-06-04T08:00:00.000Z", "stalenessSec": 900 }
}

​
GET /equity-intel

US stock fundamentals and SEC filing intelligence for any ticker. Returns revenue, net income, YoY growth, net margin, EPS (diluted), leverage, cash position, and a list of recent 10-K/10-Q/8-K filings with direct SEC EDGAR links plus an AI narrative read. Source: SEC EDGAR (public domain). Intel only — not a real-time price feed. Price: $0.001 USDC Parameters:
  • ticker (string, required): US stock ticker symbol (e.g. NVDA, AAPL, JPM).
Example Request: 
curl "https://x402.ottoai.services/equity-intel?ticker=NVDA" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "status": "success",
  "data": {
    "ticker": "NVDA",
    "company": {
      "name": "NVIDIA Corp", "cik": "0001045810",
      "exchange": "NASDAQ", "sicDescription": "Semiconductors & Related Devices"
    },
    "fundamentals": {
      "asOf": "2025-01-26", "fiscalYear": 2025,
      "revenueUsd": 130497000000, "revenueYoYPct": 114.2,
      "netIncomeUsd": 72880000000, "netIncomeYoYPct": 145.1,
      "netMarginPct": 55.8, "epsDiluted": 2.94,
      "totalAssetsUsd": 111601000000, "totalLiabilitiesUsd": 27612000000,
      "stockholdersEquityUsd": 42978000000,
      "cashUsd": 8488000000, "debtToAssetsPct": 24.7
    },
    "recentFilings": [
      { "form": "10-K", "filed": "2025-02-26", "reportDate": "2025-01-26", "url": "https://www.sec.gov/Archives/edgar/data/1045810/..." },
      { "form": "10-Q", "filed": "2024-11-27", "reportDate": "2024-10-27", "url": "https://www.sec.gov/Archives/edgar/data/1045810/..." }
    ],
    "narrative": "NVDA's FY2025 revenue grew 114% YoY to $130B driven by data center GPU demand. Net margin of 56% reflects pricing power. Debt-to-assets at 25% is conservative. Most recent 10-K (filed Feb 2025) is the primary reference for current financials.",
    "generatedAt": "2026-06-04T08:00:00.000Z"
  },
  "meta": { "generatedAt": "2026-06-04T08:00:00.000Z", "stalenessSec": 43200 }
}

​
GET /base-season

What Base tokens are trusted KOLs actually talking about right now? Combines a quality screen (CoinGecko-listed, mcap/age/liquidity gated via GeckoTerminal) with Otto’s own KOL signal layer — each token carries mention counts, verbatim KOL quotes, and high-engagement open tweets. Also surfaces the overall crypto-KOL sentiment backdrop. “Who’s saying it, not who pumped it.” Refreshed hourly. Price: $0.001 USDC Parameters: None Example Request: 
curl "https://x402.ottoai.services/base-season" -H "PAYMENT-SIGNATURE: eyJ..."
Sample Response: 
{
  "status": "success",
  "data": {
    "chain": "base",
    "kolSignalAvailable": true,
    "kolUniverseSize": 47,
    "kolWindowHours": 72,
    "screenSource": "geckoterminal",
    "baseSentimentSummary": "Base activity is rotating into mid-caps. AERO and BRETT are drawing the most sustained KOL attention, both with positive bias. Market backdrop is broadly bullish (score 74) with DeFi narrative dominant.",
    "marketSentiment": {
      "overall": "BULLISH",
      "score": 74,
      "summary": "DeFi and L2 narratives driving sentiment. Institutional flows into ETH support Base ecosystem broadly.",
      "keyNarratives": ["Base DeFi TVL expansion", "Coinbase institutional products", "L2 fee compression"],
      "hottestMajor": "ETH",
      "trendingAltcoins": ["AERO", "BRETT", "VIRTUAL"]
    },
    "tokens": [
      {
        "symbol": "AERO",
        "tokenAddress": "0x940181a94a35a4569e4529a3cdfb74e38fd98631",
        "priceUsd": 1.23,
        "marketCapUsd": 520000000,
        "liquidityUsd": 18000000,
        "volume24hUsd": 42000000,
        "change24hPct": 5.4,
        "ageDays": 320,
        "poolUrl": "https://www.geckoterminal.com/base/pools/0x...",
        "buzzed": true,
        "kolMentions24h": 12,
        "kolSignalStrength": 0.82,
        "kolQuoteExamples": [
          { "author": "@cryptoKOL1", "text": "AERO volume picking up nicely — Base DeFi rotation incoming", "ts": "2026-06-05T06:00:00Z" }
        ],
        "topEngagement": 1840,
        "tweetCount": 23,
        "topTweets": [
          { "author": "@basetrader", "text": "AERO just broke key resistance — watching closely", "likes": 1200, "retweets": 640, "ts": "2026-06-05T05:30:00Z" }
        ]
      }
    ],
    "generatedAt": "2026-06-05T07:00:00.000Z"
  },
  "meta": { "generatedAt": "2026-06-05T07:00:00.000Z", "stalenessSec": 3600 }
}
If Otto’s KOL backend is unavailable, kolSignalAvailable is false and tokens falls back to a volume-ranked quality screen only (no mention counts, no quotes). The endpoint still returns a 200 — degrade gracefully.

​
AI Tools Agent

Advanced AI for knowledge, research, and creativity.

​
POST /llm-research

Get instant, reliable answers to any question, or summarize a webpage/document from a URL. Powered by Google’s Gemini 3.5 Flash with live web search — answers include cited sources. Price: $0.10 USDC Request Body: (JSON)
  • prompt (string, optional): A question or prompt for the AI (max 180 characters).
  • url (string, optional): A URL to summarize or analyze.
  • confirm_180_char_limit (boolean, required): Confirm you understand the 180 character limit.
Note: You can provide prompt, url, or both parameters together. Example Request (Prompt): 
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}'
Example Request (URL): 
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}'
Sample Response: 
{
  "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."
}

​
POST /generate-meme

Multi-model AI image generation powered by fal.ai. Transforms a detailed text prompt into a high-quality PNG, or edits a supplied image. Default model is OpenAI GPT Image 2 (strongest typography + photorealism); Google Nano Banana Pro is available as an alternative. Price: $0.15 USDC (flat) Request Body: (JSON)
  • prompt (string, required): Detailed description of the image (100+ characters yields the best results).
  • model (string, optional): gpt-image-2 (default) or nano-banana-pro.
  • image_url (string, optional): Public HTTPS URL of an image to edit/remix (triggers edit mode).
  • aspect_ratio (string, optional): 1:1 (default), 16:9, or 9:16.
Example Request: 
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"}'
Sample Response: 
{
  "status": "success",
  "imageUrl": "https://images.useotto.xyz/1761442152697.png",
  "model": "gpt-image-2",
  "expiresAt": "2025-11-02T18:00:00.000Z"
}
On ACP the same service is a flat $0.15 USDC job — same price as x402. Neither rail has a refund path; pricing is flat on both.

​
POST /video-gen

Multi-model AI video generation powered by fal.ai. Default is ByteDance Seedance 2.0 (cinematic output with native synced audio and start/end-frame control). Alternatives are OpenAI Sora 2 and Google Veo 3.1. Pricing is dynamic per request: at-cost fal.ai rate × 1.15 margin, with a $0.05 floor. Price: Dynamic USDC — see response price field. Range $0.46 – $4.60 depending on model + duration (advertised 402 shows the Seedance 5s reference quote, ~$1.75). Models:
ModelModesNotes
seedance-2.0text-to-video, image-to-videoDefault. Cinematic, native synced audio
sora-2text-to-video, image-to-videoOpenAI Sora 2
veo-3.1text-to-videoGoogle Veo 3.1 (no image-to-video)
Request Body: (JSON)
  • prompt (string, required): 20–1000 characters. Describe motion, camera, and scene.
  • model (string, optional): seedance-2.0 (default), sora-2, or veo-3.1.
  • duration (number, required): Video length in seconds, 4–10 (per-model caps enforced).
  • aspect_ratio (string, optional): 16:9 (default), 9:16, or 1:1.
  • image_url (string, optional): Public HTTPS URL for image-to-video. Auto-routes to the selected model’s i2v variant (Seedance 2.0 and Sora 2 only).
Example Request: 
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"}'
Sample Response: 
{
  "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"
}
On ACP the same service runs at-cost with a flat $5 USDC up-front fee and a USDC refund for the unspent budget. x402 is pay-before-run, so it uses the dynamic estimate above (no refund).

​
Blockchain Tools

On-chain data decoding and analysis tools.

​
POST /tx-explainer

Decode and explain any EVM blockchain transaction in plain English. Supports 11 chains: Base, Ethereum, Arbitrum, OP Mainnet, Avalanche, Polygon, Mantle, Monad, Plasma, BSC, and Hyperliquid L1. Returns a human-readable summary of swaps, transfers, approvals, DeFi interactions, NFT operations, and more. Powered by on-chain data + Gemini 3 Flash AI. Price: $0.01 USDC Parameters (JSON body):
  • txHash (string, required): Transaction hash (0x-prefixed, 64 hex characters).
  • chain (string, optional): Blockchain network. One of: base (default), ethereum, arbitrum, optimism, avalanche, polygon, mantle, monad, plasma, bsc, hyperliquid.
  • outputLevel (string, optional): summary (default, one-liner) or detailed (full breakdown with events).
Example Request: 
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"}'
A legacy GET /tx-explainer?txHash=...&chain=...&outputLevel=... form is still accepted for backward compatibility, but POST is the canonical method — it is the one published to x402 discovery (Bazaar / x402scan).
Sample Response: 
{
  "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..."
}

​
Deprecated Endpoints

The following endpoints have been removed and are no longer available:
EndpointReasonAlternative
/top-tenAbsorbed into /crypto-newsUse /crypto-news (now includes top headlines)
/historical-summariesLow demand, service discontinuedN/A

​
Troubleshooting - Common Issues and Solutions

​
Issue: “Payment verification failed”

Possible Causes:
  • Insufficient USDC balance in your wallet
  • Payment signature has expired (signatures are valid for ~60 seconds)
  • Invalid or corrupted payment signature
  • Payment already used (replay attack prevention)
Solutions:
  • Verify your USDC balance on Base, Polygon, or Solana (whichever network you’re paying with)
  • Ensure your system clock is synchronized (NTP)
  • Regenerate the payment signature and retry immediately
  • Check that you’re not reusing old payment signatures

​
Issue: “Invalid symbol parameter”

Possible Causes:
  • Token symbol doesn’t exist or is misspelled
  • Using full token name instead of symbol (e.g., “Bitcoin” instead of “BTC”)
Solutions:
  • Use standard token symbols: BTC, ETH, SOL, etc.
  • Ensure the token symbol is uppercase
  • Check CoinMarketCap for the correct symbol

​
Still Having Issues?

If you’re experiencing problems not covered here:
  1. Review the error message: Our error responses include detailed information
  2. Contact support: Reach out to our developer support team
  3. Join our TG: Connect with other developers in our community

​
On-Chain Standards

​
ERC-8183: Agentic Commerce (Coming Soon)

ERC-8183 is a Draft ERC defining an on-chain job primitive for AI agent commerce — escrowed ERC-20 payments, a 6-state job lifecycle, evaluator-based completion, and composable hooks for extending behavior. The standard is co-authored by members of the Virtuals Protocol team and is designed to compose with ERC-8004 reputation below. Otto AI’s existing architecture — ACP job lifecycle, fund transfer workflows, evaluator logic, and gasless Smart Account execution — already implements the core patterns that ERC-8183 formalizes. When the standard launches on mainnet, Otto AI is positioned to be among the first agent swarms to adopt it natively.

​
ERC-8004: On-Chain Reputation (Live)

Otto AI agents are registered on Ethereum Mainnet using the ERC-8004 standard for AI agent reputation. This enables verifiable, on-chain feedback for our services.

​
Agent Registry

AgentERC-8004 IDRegistry
Market Alpha Agent6817View on 8004scan
Trading Agent6940View on 8004scan
Tools Agent6996View on 8004scan
Registry Contract: 0x8004A169FB4a3325136EB29fA0ceB6D2e539a432 (Ethereum Mainnet)

​
Cross-Chain Payment Proof

Important Architecture Note: Otto AI uses a cross-chain architecture for payments and reputation.
  • Payments: Processed on Base, Polygon, or Solana (via x402 V2 protocol)
  • Reputation/Feedback: Recorded on Ethereum Mainnet (via ERC-8004)
When you submit feedback for an Otto AI agent, you can optionally include a Proof of Payment that links your feedback to an actual x402 transaction. This proof is stored as part of the feedback metadata on IPFS and referenced on-chain.

​
Proof of Payment Structure

{
  "proofOfPayment": {
    "txHash": "0xabc123...",
    "chainId": "8453",
    "fromAddress": "0xYourWallet...",
    "toAddress": "0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808"
  }
}
FieldDescription
txHashThe x402 payment transaction hash
chainIdThe chain where payment occurred (8453 for Base, 137 for Polygon, solana for Solana)
fromAddressThe payer’s wallet address
toAddressOtto AI’s x402 payment wallet

​
Verification Process

Since the payment and feedback are on different chains, verification requires checking multiple sources:
  1. Feedback Transaction: Verify on Etherscan (Ethereum Mainnet)
  2. Payment Transaction: Verify on Basescan (if chainId: 8453) or Solscan (if chainId: solana)
  3. Feedback Metadata: View on IPFS via the feedbackURI stored on-chain
This cross-chain proof establishes that:
  • The feedback submitter actually paid for the service
  • The specific service endpoint they used
  • The exact payment amount and timestamp

​
Submitting Feedback

You can submit feedback directly at x402.ottoai.services using the feedback widget. After making a paid x402 request, your payment is automatically captured and can be selected when submitting feedback. Requirements:
  • Ethereum wallet (for submitting feedback on-chain)
  • Small amount of ETH for gas (feedback tx is on Ethereum Mainnet)
  • Optional: Recent x402 payment to link as proof

​
Additional Resources

[Powered by $OTTO AI | @OttoWallet]