{"service":"Otto X","description":"x402-paywalled DeFi API on X Layer","chain":"X Layer (196)","network":"eip155:196","endpoints":[{"route":"POST /swap","price":"$0.01","description":"Get swap quote + calldata on X Layer via OKX DEX (V1: not broadcast)"},{"route":"GET /market-alpha","price":"$0.005","description":"X Layer token market intelligence — live pricing for curated tokens"},{"route":"GET /price","price":"$0.002","description":"Single token USD price via OKX DEX quote"},{"route":"GET /all-tokens","price":"$0.002","description":"Full list of all tokens supported on X Layer DEX"},{"route":"GET /approve","price":"$0.005","description":"ERC-20 approval calldata for DEX router (needed before swap)"},{"route":"GET /crypto-news","price":"$0.001","description":"Real-time crypto news with sentiment analysis"},{"route":"GET /token-alpha","price":"$0.001","description":"Premium token intelligence — news, Twitter sentiment, futures data"},{"route":"GET /kol-sentiment","price":"$0.003","description":"Aggregated sentiment from top 50 crypto KOLs"},{"route":"GET /trending-altcoins","price":"$0.001","description":"Top 3 trending altcoins with analysis"},{"route":"GET /mega-report","price":"$0.05","description":"Alpha & Intel Report — comprehensive daily market briefing — headlines, sentiment, KOL alpha, trending, yield"},{"route":"GET /token-security","price":"$0.001","description":"Token contract security audit — honeypot detection, rug pull risk, tax analysis"},{"route":"GET /funding-rates","price":"$0.001","description":"Derivatives dashboard — funding rates, open interest, long/short ratios"},{"route":"GET /defi-analytics","price":"$0.001","description":"DeFi protocol analytics — TVL rankings, chain breakdown, gainers/losers"},{"route":"GET /filtered-news","price":"$0.001","description":"AI-filtered news by topic (DeFi, NFTs, Layer2, etc.)"},{"route":"GET /twitter-summary","price":"$0.001","description":"Curated crypto Twitter/X digest from top KOLs"},{"route":"GET /token-details","price":"$0.001","description":"Token price, market cap, 24h change"},{"route":"GET /yield-alpha","price":"$0.001","description":"Top DeFi yield opportunities across chains"},{"route":"GET /tradfi-data","price":"$0.001","description":"TradFi macro intelligence — indices, VIX, DXY, yields, commodities"},{"route":"GET /vet-token","price":"$0.01","description":"Token Safety & Tradeability Vetting — one-call X Layer token check: GoPlus contract security (honeypot, tax, mint/ownership flags) + holder concentration + live OKX DEX tradeability & price. Refuses (unpaid) if the security scan is empty."},{"route":"GET /token-deep-dive","price":"$0.05","description":"Token Deep-Dive — full-picture briefing for a major token: price & market cap + contract security + derivatives funding/OI + market KOL context + OKX DEX price. Unresolved legs labelled unavailable, never faked. Refuses (unpaid) if core token details are missing."},{"route":"GET /rwa-pulse","price":"$0.05","description":"RWA Market Pulse — a pulse on the real-world-asset market: TradFi macro (indices, VIX, DXY, yields, commodities) + live tokenized-RWA perps (equities like AAPL/TSLA/NVDA, commodities, FX) from Hyperliquid + crypto market news. Live legs only; any reading that would fabricate is omitted and named. Refuses (unpaid) if the macro core is empty."},{"route":"GET /generate-meme","price":"$0.15","description":"AI image generation via fal.ai (gpt-image-2 default, nano-banana-pro alt)"},{"route":"GET /llm-research","price":"$0.10","description":"AI research assistant with web search via Gemini 3.1 Flash-Lite"},{"route":"GET /tx-explainer","price":"$0.01","description":"Decode & explain EVM transactions across 11 chains"},{"route":"GET /portfolio","price":"$0.001","description":"Multi-chain token balances for your Otto X sub-wallet (or ?address=0x...)"},{"route":"GET /supported-tokens","price":"$0.001","description":"Search tokens by symbol on chain"},{"route":"GET /hyperliquid-account","price":"$0.001","description":"Hyperliquid perpetual futures account info — defaults to your Otto X sub-wallet"},{"route":"GET /hyperliquid-market","price":"$0.001","description":"Perpetual market data & funding rates"},{"route":"GET /hl-transaction-history","price":"$0.001","description":"Hyperliquid trade history — defaults to your Otto X sub-wallet"},{"route":"GET /yield-markets","price":"$0.001","description":"Blue-chip supply APYs from each protocol's authoritative source — Aave V3 + Compound V3 (on-chain), Morpho (official GraphQL), Syrup (ERC-4626 trailing)"},{"route":"GET /yield-farming-active","price":"$0.001","description":"Active yield positions for a wallet — Otto-allowlisted lending positions also get a rebalance recommendation (current APY vs. the highest-rated allowlisted protocol alternative + the action calls to switch) and a portfolio yield summary"},{"route":"GET /yield-farming-historical","price":"$0.001","description":"Yield op history for a wallet — deposit/redeem timeline with exact Otto fees and a totals summary"},{"route":"GET /idle-capital","price":"$0.001","description":"Detect undeployed tokens that could earn yield"},{"route":"GET /yield-recommendations","price":"$0.001","description":"Personalized yield vault recommendations"},{"route":"POST /auto-swap","price":"$0.05","description":"Execute an in-chain swap on your Otto X sub-wallet via OKX DEX aggregator"},{"route":"POST /auto-bridge","price":"$0.05","description":"Execute a cross-chain bridge from your Otto X sub-wallet (17 chains supported)"},{"route":"POST /auto-defi-invest","price":"$0.05","description":"Deposit into a whitelisted DeFi protocol (Aave V3, Lido, Compound V3, Morpho) from your Otto X sub-wallet"},{"route":"POST /auto-defi-withdraw","price":"$0.05","description":"Redeem an active DeFi position from your Otto X sub-wallet"},{"route":"POST /yield-copilot","price":"$0.05","description":"One-call yield: deploy your idle stablecoins into the highest-APY Otto-allowlisted lending venue (Aave V3 / Compound V3 / Morpho) on Base, Arbitrum, Optimism, Ethereum, or X Layer — accepts principalAuth; returns a before/after APY + projected yield artifact"},{"route":"POST /auto-withdraw","price":"$0.05","description":"Escape hatch — sweep funds from your Otto X sub-wallet to any external address"},{"route":"GET /sub-wallet","price":"$0.01","description":"Resolve (or auto-provision) your Otto X sub-wallet — bound to the verified x402 payer"},{"route":"POST /yield-watch","price":"$0.001","description":"Register or update a yield-watch subscription. mode=auto: signed EIP-712 30-day delegation authorizing Otto to auto-rebalance between Aave V3 and Compound V3 (Morpho ships v1.1). mode=notify: free observation alerts only."},{"route":"DELETE /yield-watch","price":"$0.001","description":"Revoke an active yield-watch subscription — requires a signed YieldWatchRevocation typed-data note (different primaryType from the registration delegation)"},{"route":"GET /yield-watch","price":"$0.001","description":"Read the caller's current yield-watch subscription state (mode, scope, policy knobs, move counter, next nonce)"},{"route":"GET /yield-watch/audit","price":"$0.001","description":"Read the caller's yield-watch audit trail — registrations, revocations, observation starts/resets, auto-move attempts/results"},{"route":"GET /stablecoin-watch","price":"$0.001","description":"Is USDC/USDT/DAI holding its $1 peg, and is stablecoin supply growing or shrinking (risk-on vs risk-off)? Live peg deviation (bps), circulating supply + 1d/7d/30d flow, market dominance and chain spread for the top 30 USD stablecoins, plus downside depeg alerts for any coin trading >0.5% below peg. Sourced from DefiLlama (public). Refreshed hourly."},{"route":"GET /protocol-revenue-leaders","price":"$0.001","description":"Which protocols earn the most — and who is accelerating? Top 30 DeFi protocols by 24h fees, each with revenue, take-rate (the cut the protocol keeps vs fees users pay), 7d/30d trend and category, plus total DeFi fees & revenue. A fundamentals screen (fee/revenue economics), distinct from TVL. Sourced from DefiLlama (public). Refreshed every 6 hours."},{"route":"GET /market-risk","price":"$0.002","description":"Composite crypto market-stress digest: a 0-100 score (low/moderate/elevated/high) blended from global USD-stablecoin depeg health (DefiLlama) and Base on-chain DEX exit-liquidity, with a per-leg breakdown and an AI risk line. Both legs required for a score. Refreshed hourly. Fresh-or-refuse: if a current score can't be computed, the call refuses (uncharged) rather than return an older reading."},{"route":"GET /news-recaps","price":"$0.003","description":"A tight 4-6 sentence crypto market recap an agent can ingest whole: overall direction and why, the 2-3 developments that matter, and anything notable on the top-10 board — distilled hourly from the same live news engine behind Otto's top-ranked /crypto-news feed. The one-paragraph state-of-market; buy /crypto-news when you want the full report."},{"route":"GET /fx-rates","price":"$0.001","description":"Live + reference foreign-exchange (forex) rates, base USD. LIVE near-real-time mid quotes for the 12 most-traded currencies (EUR, GBP, JPY, CHF, CAD, AUD, NZD, CNY, HKD, SGD, SEK, KRW), refreshed every minute with an honest market-open/stale flag, PLUS the official ECB daily reference table for ~30 currencies. Derive any cross-rate or pair. Keyless, pay-per-call."},{"route":"GET /pm-markets","price":"$0.001","description":"Top Polymarket prediction markets right now: the 25 highest-volume open markets with live odds (outcome probabilities), best bid/ask, spread, last trade, 24h + total volume, liquidity, 1d/7d price change, end date and event link. Flat JSON, refreshed every 5 minutes."},{"route":"GET /pm-crypto","price":"$0.001","description":"Crypto prediction markets on Polymarket: the highest-volume open BTC, ETH and crypto markets with live odds (outcome probabilities), best bid/ask, spread, 24h + total volume, liquidity, price change and end date. 'Bitcoin above X', price targets, ETF and protocol events — what the market actually prices in, as flat JSON refreshed every 5 minutes."},{"route":"GET /rh-season","price":"$0.001","description":"Robinhood Chain memecoin intelligence: the rug-screened RH Chain (chainId 4663) movers. Hard liquidity + wash-volume gates filter $0-liquidity honeypots faking $1M volumes; every survivor carries rug-risk flags (thin liquidity, vol/liquidity anomaly, pool age, CoinGecko listing) plus trusted-KOL mentions with verbatim quotes and a synthesized RH sentiment read. What is pumping AND whether it is real. Refreshed hourly."},{"route":"GET /tokenized-equities","price":"$0.001","description":"The live registry of tokenized US equities & ETFs on Robinhood Chain (chainId 4663): symbol, canonical token address, decimals, a reference price, and a verifiable tradability signal — listed-on-rail plus a best-effort execution sample (estimated USD out and round-trip cost at a reference size). The on-chain settlement layer for tokenized-equity exposure, not a data-coverage claim. Refreshed hourly."},{"route":"GET /earnings-calendar","price":"$0.003","description":"Earnings calendar + surprise history for a vendor-resolved equity or ETF: next report date and session (before-open / after-close) with EPS & revenue estimates, latest reported EPS versus estimate with surprise %, and a four-quarter history. Licensed Finnhub feed; monetary values keep vendor payload units. Event-window price drift is marked unavailable, never inferred. Pass ?ticker= (e.g. AAPL). Refreshed daily."},{"route":"GET /analyst-ratings","price":"$0.003","description":"Analyst consensus for a vendor-resolved equity: the latest buy/hold/sell distribution (strong buy · buy · hold · sell · strong sell counts, total, and a deterministic consensus label) plus up to six months of the same distribution so an agent can read the drift — is the street moving toward or away from the name. Vendor counts (Finnhub), label rule stated in the payload. No price targets and no per-analyst grade actions are served."},{"route":"GET /equity-news","price":"$0.003","description":"Company news for a vendor-resolved equity: licensed Finnhub headlines from the trailing 7 days with publish time, source and summary. Only articles that name the company are served — labelled primary (headline names it) or mentioned (only the summary does) — so a symbol-tagged story about another company never fills the list. No sentiment is fabricated. Pass ?ticker= (e.g. TSLA). Refreshed hourly."},{"route":"GET /dividend-intel","price":"$0.003","description":"Cash-dividend intelligence for a vendor-resolved equity from the licensed Tiingo end-of-day feed: TTM dividend/share and yield against the latest close, latest dividend, split-adjusted complete-year growth, the last eight payments, split events, and a cut-detection checklist with explicit coverage. Payout ratio, forward ex-dates and declaration/record/payment dates are not served (not in the Tiingo feed); non-payers return status no-cash-dividen…"},{"route":"GET /macro-regime","price":"$0.003","description":"Daily US macro-regime snapshot from licensed Alpha Vantage series: 10-year Treasury yield, effective federal funds rate, 3-month rate changes, CPI index and YoY inflation, plus a mechanical rate-direction / inflation-direction label with disclosed thresholds. Scanner context, no query param. Refreshed daily."},{"route":"GET /technical-signals","price":"$0.003","description":"Daily technical snapshot for a vendor-resolved equity from licensed Tiingo adjusted closes: Wilder RSI-14 with state, 20-session momentum, SMA-20 / SMA-50, price distance from each average, above / below / mixed trend state, and the latest observed golden / death cross. Price and averages keep vendor payload units. Pass ?ticker= (e.g. MSFT). Refreshed daily."},{"route":"GET /insider-trades","price":"$0.003","description":"SEC Form 4 insider trades for any US-listed company: who bought and sold (officer / director / 10% owner), purchase vs sale counts and dollar values (SEC codes P/S), net purchase-sale balance, shares held after each transaction, and filing links. An hourly snapshot straight from the primary source — public-domain SEC EDGAR. Pass ?ticker= (e.g. AAPL). Refreshed hourly."},{"route":"GET /institutional-holdings","price":"$0.003","description":"Latest 13F-HR holdings for any SEC-filing manager (hedge funds, asset managers): top 20 positions by value with issuer, CUSIP, value in whole USD, share / principal amount (SH/PRN), put/call flag and position count, amendments applied. Whale-tracking straight from the primary source — public-domain SEC EDGAR. Pass ?manager= a CIK or manager ticker (e.g. 1067983 for Berkshire, or BLK). Refreshed hourly."},{"route":"GET /pm-search","price":"$0.001","description":"Search Polymarket prediction markets by free text — elections, Fed rates, crypto prices, sports, geopolitics, AI. Returns the top matching open markets with live odds (outcome probabilities), best bid/ask, spread, volume, liquidity, end date and event link as flat JSON. Pass ?query= (e.g. \"fed rate cut\"). Live odds on a ~10-minute cadence."},{"route":"GET /equity-smart-money","price":"$0.006","description":"Smart-money bundle for any US-listed company in ONE call: SEC Form 4 insider activity (purchases vs sales, SEC codes P/S, net purchase-sale balance, who filed and their roles) PLUS trailing-twelve-month fundamentals — revenue + YoY, net income + YoY, diluted EPS — from XBRL filings. Insider conviction and the financials behind it, together. Public-domain SEC EDGAR. Pass ?ticker= (e.g. NVDA). Refreshed hourly."},{"route":"GET /tweet-search","price":"$0.005","description":"Search X / Twitter for any query and get the actual matching tweets — keyword, $CASHTAG, from:handle, @handle mentions, or boolean OR. Each tweet returns author, full text (long-form notes included), timestamp, likes and retweets. Most-recent-first for real-time monitoring. Structured JSON, pay-per-call. Pass ?query= (e.g. $BTC). Live X search, ~5-minute recency."}],"freeEndpoints":[{"route":"GET /","description":"This page / service discovery"},{"route":"GET /health","description":"Service health check"},{"route":"GET /tokens","description":"Curated X Layer token registry"},{"route":"GET /llm.txt","description":"AI-readable service catalog"},{"route":"GET /.well-known/x402","description":"x402 discovery document"},{"route":"GET /recipes","description":"Recipes catalog — composed workflows (HTML)"},{"route":"GET /api/recipes","description":"Recipes index (JSON)"}],"links":{"github":"https://github.com/useOttoAI/otto-x","docs":"https://docs.useotto.xyz"}}