x402 Endpoint Examples - Otto AI Docs

The sample responses on this page are illustrative — not live data. They show each endpoint’s response shape with a representative payload; prices, scores, and timestamps may be stale. The live 402 header is always the source of truth for price, and a real call returns fresh data. For pricing, the request flow, and the protocol reference, see the x402 Storefront.

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 | @useOttoAI]"
}

If the news pipeline is delayed, the report string may be prefixed with a staleness banner like ⚠️ This report is ~Xh old (refresh target 4h); the news pipeline may be delayed. If the cache is more than 12 hours old the endpoint returns an error instead of serving stale data as a fresh paid report.

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: the { "status": "success", "report": "…" } envelope (plus topic and source_count) — same shape as the canonical /crypto-news sample.

GET /tweet-search

Search X/Twitter for any query and get back the actual matching tweets (most-recent-first). Supports keyword/topic, $CASHTAG, from:handle (a user timeline), @handle (mentions), and boolean OR. Real-time monitoring and alerting for agents — not an AI summary. Price: $0.005 USDC Parameters:

query (string, required): X/Twitter search query, e.g. $BTC, from:VitalikButerin, or bitcoin ETF -is:retweet.

Example Request:

curl "https://x402.ottoai.services/tweet-search?query=%24BTC" -H "PAYMENT-SIGNATURE: eyJ..."

Sample Response:

{
  "query": "$BTC",
  "mode": "Latest",
  "count": 1,
  "tweets": [
    {
      "id": "1809123456789012345",
      "author": "@CryptoAnalyst",
      "text": "$BTC just reclaimed the 200-day MA on the daily. Watching for a retest of resistance.",
      "createdAt": "2026-06-30T13:42:00.000Z",
      "likes": 412,
      "retweets": 88,
      "replies": 37,
      "quotes": 9,
      "isLongForm": false,
      "url": "https://x.com/CryptoAnalyst/status/1809123456789012345"
    }
  ],
  "generatedAt": "2026-06-30T13:45:00.000Z"
}

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: the { "status": "success", "digest": "…", "timestamp": "…" } envelope — same shape family as /crypto-news.

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: the { "status": "success", "details": "…" } envelope — same shape as /crypto-news.

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: the { "status": "success", "alpha_report": "…" } envelope — same shape as /crypto-news.

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: the { "status": "success", "report": "…" } envelope — same shape as /crypto-news.

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: the { "status": "success", "opportunities": "…" } envelope — same shape as /crypto-news. 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: the { "status": "success", "report": "…" } envelope — same shape as /crypto-news.

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/BEARISH> (Score: <0-100%>)\nFear & Greed Index: <live>\n\nTOP HEADLINES\n- <headline>\n- <headline>\n- <headline>\n\nTRENDING TOKENS\n<symbols> leading altcoin momentum\n\nTOP YIELD: <live APY> on <token> (<protocol>)\n\nFull report: See report_url for complete analysis",
  "report_url": "<report_url>"
}

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.",
    "analysisStatus": "ok",
    "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", "balanceSheetAsOf": "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, "liabilitiesToAssetsPct": 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.",
    "analysisStatus": "ok",
    "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.

GET /rh-season

What’s actually pumping on Robinhood Chain (chainId 4663) — and is it real? The base-season analog for RH Chain’s young memecoin ecosystem, with the scam screen as the differentiator: hard liquidity + wash-volume gates filter the

0-liquidity honeypots that fake

1M daily volumes, and every surfaced token carries rug-risk flags (thin liquidity, volume/liquidity anomaly, pool age, CoinGecko listing) plus trusted-KOL mentions with verbatim quotes and a synthesized RH Chain sentiment read. Descriptive screen — never trading advice. Refreshed hourly. Price: $0.001 USDC Parameters: None Example Request:

curl "https://x402.ottoai.services/rh-season" -H "PAYMENT-SIGNATURE: eyJ..."

Sample Response:

{
  "status": "success",
  "data": {
    "chain": "robinhood",
    "chainId": 4663,
    "kolSignalAvailable": true,
    "kolUniverseSize": 43,
    "kolWindowHours": 72,
    "screenSource": "geckoterminal",
    "rhSentimentSummary": "RH Chain attention is risk-on but froth-heavy: RAXOL leads the credible board (+22% on ~$91k real liquidity, 1.4x turnover) while day-zero launches print millions in volume against sub-$60k liquidity — 24-90x ratios the screen flags as wash-suspect.",
    "disclaimer": "Informational only — not investment advice. Robinhood Chain is a weeks-old, thin-liquidity environment; most pools are hours old, so a 24h % change on a pool younger than a day (changeWindowUnreliable) reflects its entire life, not a 24h move. Check each mover's liquidityUsd and rugRisk flags and do your own research before trading. Refreshed hourly; data may be up to a few hours stale.",
    "marketSentiment": {
      "overall": "neutral",
      "score": 52,
      "summary": "KOLs rotating between majors and fresh-chain casino flow.",
      "keyNarratives": ["Robinhood Chain launch", "memecoin season"],
      "hottestMajor": "ETH",
      "trendingAltcoins": ["RAXOL", "CASHCAT"]
    },
    "screenFloors": {
      "hardMinLiquidityUsd": 10000,
      "flagMinLiquidityUsd": 50000,
      "minMarketCapUsd": 50000,
      "maxVolToLiqRatio": 20,
      "hardMaxVolToLiqRatio": 150,
      "minAgeDays": 0,
      "newPoolAgeDays": 2
    },
    "tokens": [
      {
        "symbol": "RAXOL",
        "tokenAddress": "0x6a12b58bbcd3d4a72db3ef92a7bcc9f10a4a5b1c",
        "priceUsd": 0.00074,
        "marketCapUsd": 728870,
        "liquidityUsd": 90917,
        "volume24hUsd": 124347,
        "change24hPct": 22.1,
        "ageDays": 3,
        "poolUrl": "https://www.geckoterminal.com/robinhood/pools/0x...",
        "buzzed": true,
        "kolMentions24h": 3,
        "kolSignalStrength": 2,
        "kolQuoteExamples": [
          { "author": "@kol_handle", "text": "RAXOL quietly the only RH chain chart with real liquidity behind it", "ts": "2026-07-06T09:12:00Z" }
        ],
        "kolSymbolAmbiguous": false,
        "rugRisk": {
          "liquidityBelowFloor": false,
          "liquidityDrained": false,
          "changeWindowUnreliable": false,
          "volToLiqRatioAnomaly": false,
          "newPool": false,
          "cgListed": false,
          "volToLiqRatio": 1.37,
          "level": "low"
        },
        "topEngagement": 4211,
        "tweetCount": 2,
        "topTweets": [
          { "author": "@big_account", "text": "$RAXOL first real RH chain runner", "likes": 3120, "retweets": 402, "ts": "2026-07-06T08:30:00Z" }
        ]
      }
    ],
    "generatedAt": "2026-07-06T10:00:00.000Z"
  },
  "meta": { "generatedAt": "2026-07-06T10:00:00.000Z", "stalenessSec": 3600 }
}

The rugRisk block is the “is-it-real” layer: $0-liquidity fake-volume tokens never appear at all (hard floors), while thin-but-real day-old movers appear flagged (level: low | elevated | high). kolSymbolAmbiguous: true means the symbol collides with a major asset or tokenized-equity ticker (e.g. $APE, $HOOD) so cashtag-matched social signal was suppressed — treat social fields as not-attributable rather than zero interest. If Otto’s KOL backend is unavailable, kolSignalAvailable is false and the board degrades to the volume-ranked rug-screened screen.

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:

Model	Modes	Notes
`seedance-2.0`	text-to-video, image-to-video	Default. Cinematic, native synced audio
`sora-2`	text-to-video, image-to-video	OpenAI Sora 2
`veo-3.1`	text-to-video	Google 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 (dynamic estimate above). If the request fails validation or the generation fails due to an agent-side error (fal.ai failure, timeout, or internal error), Otto refunds the full settled amount in USDC to your payer address. Safety and content-policy failures are not refundable.

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..."
}

​News & Social

​GET /crypto-news

​GET /filtered-news

​GET /tweet-search

​GET /twitter-summary

​Market Intelligence

​GET /token-details

​GET /token-alpha

​GET /kol-sentiment

​GET /yield-alpha

​GET /trending-altcoins

​GET /mega-report

​Data Intelligence

​GET /token-security

​GET /funding-rates

​GET /defi-analytics

​GET /tradfi-data

​Onchain Data

​GET /token-top-holders

​GET /stablecoin-watch

​GET /protocol-revenue-leaders

​GET /equity-intel

​GET /base-season

​GET /rh-season

​AI Tools Agent

​POST /llm-research

​POST /generate-meme

​POST /video-gen

​Blockchain Tools

​POST /tx-explainer

News & Social

GET /crypto-news

GET /filtered-news

GET /tweet-search

GET /twitter-summary

Market Intelligence

GET /token-details

GET /token-alpha

GET /kol-sentiment

GET /yield-alpha

GET /trending-altcoins

GET /mega-report

Data Intelligence

GET /token-security

GET /funding-rates

GET /defi-analytics

GET /tradfi-data

Onchain Data

GET /token-top-holders

GET /stablecoin-watch

GET /protocol-revenue-leaders

GET /equity-intel

GET /base-season

GET /rh-season

AI Tools Agent

POST /llm-research

POST /generate-meme

POST /video-gen

Blockchain Tools

POST /tx-explainer