{"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":"Quote + unsigned swap calldata on X Layer via OKX DEX (you broadcast). JSON body: fromToken (string, 0x address: USDT 0x779ded0c9e1022225f8e0630b35a9b54be713736 or USDG 0x4ae46a509f6b1d9056937ba4500cb143933d2dc8), toToken (string, 0x address other than fromToken, e.g. WOKB 0xe538905cf8410324e03a5a23c1c177a474d59b2b), amount (string, e.g. \"1.5\"), userWalletAddress (string, your 0x wallet); optional slippage (string, percent 0.1-50, e.g. \"1\")"},{"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":"Importance-ranked crypto headlines with per-article source links and publish times, plus a sentiment-scored market brief. Regenerated hourly; meta carries the snapshot's age and a fresh/stale verdict."},{"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 an EVM transaction on Base, Ethereum, Arbitrum, Optimism, Avalanche, Polygon, BNB Chain, Mantle, Monad, Plasma or HyperEVM (not X Layer)"},{"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":"Swap inside your Otto X sub-wallet via OKX DEX. JSON body: payer (string, 0x address that pays this call), chain (string, e.g. \"xlayer\"), fromToken (string, 0x address, e.g. USDT 0x779ded0c9e1022225f8e0630b35a9b54be713736), toToken (string, 0x address, e.g. USDG 0x4ae46a509f6b1d9056937ba4500cb143933d2dc8), amount (string, e.g. \"1\"); optional slippage (string, percent, e.g. \"0.5\"), principalAuth (EIP-3009 object)"},{"route":"POST /auto-bridge","price":"$0.05","description":"Bridge from your Otto X sub-wallet via the OKX cross-chain router. JSON body: payer (string, 0x address that pays this call), fromChain (string, e.g. \"base\"), toChain (string, another chain, e.g. \"arbitrum\"), fromToken (string, 0x address, e.g. USDC 0x833589fcd6edb6e08f4c7c32d4f71b54bda02913), toToken (string, 0x address, e.g. USDC 0xaf88d065e77c8cc2239327c5edb3a432268e5831), amount (string, e.g. \"10\"); optional receiveAddress (0x), principalAuth"},{"route":"POST /auto-defi-invest","price":"$0.05","description":"Deposit from your Otto X sub-wallet into an allowlisted lending venue (Aave V3, Compound V3, Morpho; GET /supported-protocols). JSON body: payer (string, 0x address that pays this call), protocol (string, e.g. \"aave_v3\"), chain (string, e.g. \"base\"), token (string, symbol or 0x address, e.g. \"USDC\"), amount (string, e.g. \"5\"); optional slippage (string, fraction, \"0.01\" = 1%), principalAuth (EIP-3009 object)"},{"route":"POST /auto-defi-withdraw","price":"$0.05","description":"Redeem a DeFi position held by your Otto X sub-wallet. JSON body: payer (string, 0x address that pays this call), protocol (string, e.g. \"aave_v3\"), chain (string, e.g. \"xlayer\"), token (string, symbol or 0x address, e.g. \"USDT\"), and ratio (string in (0, 1], e.g. \"1\" for all) or amount (string, e.g. \"5\"); optional slippage (string, fraction, \"0.01\" = 1%)"},{"route":"POST /auto-withdraw","price":"$0.05","description":"Escape hatch: send funds from your Otto X sub-wallet to any address. JSON body: payer (string, 0x address that pays this call), chain (string, e.g. \"xlayer\"), token (string, \"native\" or 0x address, e.g. USDT 0x779ded0c9e1022225f8e0630b35a9b54be713736), amount (string, e.g. \"1\"), toAddress (string, 0x destination 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: observation alerts only, no delegation and no moves (the same $0.001 call)."},{"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). Served from a cached snapshot while fresh (≤1h) and regenerated on demand when a read finds it stale."},{"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). Served from a cached snapshot while fresh (DefiLlama fees are daily aggregates) and regenerated on demand when a read find…"},{"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. Every read older than an hour regenerates the score inline. 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. Served from a cached snapshot while fresh (≤1…"},{"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, listed-on-rail routability, and the EXECUTABLE buy price — what a $100 buy pays per token at the route's minimum output — published next to the catalog reference price and the deviation between them. Every served address is bound to a hand-verified identity pin. The on-chain settlement layer for tokenized-equity exposur…"},{"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"}}