--- name: x402.ottoai.services description: x402.ottoai.services provides read-only crypto market intelligence across three domains: perpetual market data on Hyperliquid, DeFi yield discovery across major protocols and chains, and social/sentiment analysis including KOL signals and trending altcoins. All endpoints are informational; none support trade execution or deposits. Data is a mix of on-demand structured feeds and pre-generated daily reports. host: x402.ottoai.services --- # x402.ottoai.services Otto AI operates as a crypto research and discovery host targeting agents that need market context before acting. It covers Hyperliquid perp markets, multi-chain DeFi yield rankings, and social sentiment from KOLs and trending altcoin signals. It is distinct in combining structured on-chain data (yield markets, perp specs) with synthesized social intelligence (KOL sentiment, altcoin momentum) in a single host, though it does not offer execution, real-time streaming, or per-token historical data. ## When to use this host Use this host when an agent needs read-only crypto market research: DeFi yield discovery across Aave, Morpho, Pendle, and similar protocols; Hyperliquid perpetual market specs; or social sentiment from KOLs and trending altcoins. The daily mega-report is useful for macro briefings but is not a substitute for real-time price feeds. Do not use this host for trade execution, order placement, deposit instructions, or real-time streaming data — those require a DEX/CEX execution API or a live price oracle. For per-token historical price data or OHLCV candles, use a dedicated market data provider such as CoinGecko or Binance APIs. For on-chain transaction construction, use a wallet or DeFi execution host instead. ## Capabilities ### Perpetual Market Discovery Provides structured data on tradable perpetual markets on Hyperliquid, including current prices, leverage limits, and asset availability for both crypto and stock perps. - **`fetch-hyperliquid-market-data`** — Returns perpetual market data for a given asset on Hyperliquid, including current price, max leverage, isolation mode, and availability counts for crypto and stock perps. ### DeFi Yield Discovery Returns ranked DeFi yield opportunities across protocols and chains, covering both structured market listings and risk-tiered (blue-chip vs. degen) breakdowns for stablecoins, ETH, and BTC. - **`fetch-yield-markets`** — Returns a ranked list of DeFi yield-bearing markets across protocols and chains, including supply APY, total liquidity in USD, token metadata, chain info, and vault identifiers. - **`fetch-defi-yield-opportunities`** — Returns ranked DeFi yield opportunities across stablecoins, ETH, and BTC, split into blue-chip (low-risk) and degen (high-APY) categories with TVL, APY, and protocol links. ### Social Sentiment and KOL Intelligence Aggregates crypto market sentiment from the top 50 KOLs and surfaces the top 3 trending altcoins by social momentum, providing bullish/bearish scores, key narratives, and trade idea signals. - **`fetch-kol-sentiment-report`** — Returns a synthesized sentiment report from the top 50 crypto KOLs, including overall sentiment score, key narratives, trending tokens, and individual KOL insights. - **`fetch-trending-altcoins`** — Returns the top 3 trending altcoins ranked by news and Twitter analysis, including price performance, bullish thesis, and KOL signals. ### Daily Market Briefing Delivers a pre-generated daily crypto market intelligence report covering headlines, sentiment, key price levels, institutional flow signals, and yield opportunities in a single JSON plus hosted HTML output. - **`fetch-mega-market-report`** — Returns a daily crypto market intelligence report covering headlines, Twitter sentiment, KOL alpha, trending altcoins, yield opportunities, and key price levels, delivered as a JSON summary plus a hosted HTML report URL. ## Workflows ### DeFi Yield Research Stack *Use when an agent needs to build a comprehensive view of current DeFi yield opportunities, combining broad protocol/chain coverage with risk-tiered recommendations.* 1. **`fetch-yield-markets`** — Retrieve the full ranked list of yield markets across protocols and chains to identify the highest APY opportunities by token and chain. 2. **`fetch-defi-yield-opportunities`** — Cross-reference with risk-tiered yield data (blue-chip vs. degen) for stablecoins, ETH, and BTC to add risk context before making a recommendation. ### Crypto Market Context Briefing *Use when an agent needs a full-spectrum market context snapshot combining macro sentiment, social signals, and trending token ideas before generating a research summary or trade thesis.* 1. **`fetch-mega-market-report`** — Fetch the daily macro briefing for directional stance, key asset prices, institutional flow signals, and support/resistance levels. 2. **`fetch-kol-sentiment-report`** — Layer in aggregated KOL sentiment score and key narratives to validate or contrast the macro report's directional view. 3. **`fetch-trending-altcoins`** — Identify the top 3 trending altcoins by social momentum to surface specific token ideas consistent with the prevailing sentiment. ### Altcoin Idea Validation with Perp Availability *Use when an agent needs to check whether a trending altcoin identified via social signals is actually tradable as a perpetual on Hyperliquid.* 1. **`fetch-trending-altcoins`** — Retrieve the current top 3 trending altcoins by news and Twitter momentum. 2. **`fetch-hyperliquid-market-data`** — For each trending token, confirm perpetual availability, current price, and max leverage on Hyperliquid before surfacing as an actionable trade idea. ## Skill reference ### `fetch-hyperliquid-market-data` **Hyperliquid Perpetual Market Data** — Returns perpetual market data for a given asset on Hyperliquid, including current price, max leverage, isolation mode, and availability counts for crypto and stock perps. *Use when:* Use when an agent needs to discover tradable perpetual markets on Hyperliquid, check current prices, leverage limits, or confirm whether a specific crypto or stock asset is available for perpetual trading. *Not for:* Do not use for executing trades or placing orders; this is a read-only market data endpoint. Not suitable for spot market data or non-perpetual instruments. **Inputs:** - `asset` (string, required) — Asset symbol to query perpetual market data for (e.g., BTC, ETH, SOL). **Returns:** Returns status='success' plus a market object containing top crypto perp tokens with prices and leverage limits, total crypto perp count (230), stock perp count (71) with sample symbols, and a butler recommendations summary. **Example:** `GET https://x402.ottoai.services/hyperliquid-market?asset=BTC` --- ### `fetch-yield-markets` **Otto Yield Markets API** — Returns a ranked list of DeFi yield-bearing markets across protocols and chains, including supply APY, total liquidity in USD, token metadata, chain info, and vault identifiers. *Use when:* Use when an agent needs to discover or compare DeFi yield opportunities across protocols (e.g., Aave, Syrup) and chains (Ethereum, Base, Avalanche, Arbitrum, Polygon), ranked by supply APY. *Not for:* Do not use for executing deposits or swaps into yield vaults; this endpoint is read-only discovery. Not suitable for real-time price feeds or token spot prices. **Returns:** Returns status='success' and a markets array with objects containing protocol, tokenSymbol, tokenAddress, supplyApy, totalLiquidityUsd, chainId, chainName, and vaultAddress for each available DeFi yield market. **Example:** `GET https://x402.ottoai.services/yield-markets` --- ### `fetch-mega-market-report` **MegaReport Pro** — Returns a daily crypto market intelligence report covering headlines, Twitter sentiment, KOL alpha, trending altcoins, yield opportunities, and key price levels, delivered as a JSON summary plus a hosted HTML report URL. *Use when:* Use when an agent or user needs a comprehensive daily crypto market briefing including directional market stance, key asset prices (BTC, ETH, SOL, XRP), institutional flow signals, and actionable support/resistance levels. *Not for:* Do not use for real-time streaming price feeds or on-demand token-specific lookups; this is a fixed daily report and does not return structured per-chain or per-token data beyond the narrative summary. **Returns:** Returns status='success' with a narrative summary of daily crypto market conditions and a URL to the full hosted HTML report. **Example:** `GET https://x402.ottoai.services/mega-report` --- ### `fetch-trending-altcoins` **Altcoin Trend Radar** — Returns the top 3 trending altcoins ranked by news and Twitter analysis, including price performance, bullish thesis, and KOL signals. *Use when:* Use when an agent needs a quick snapshot of the current top trending altcoins based on social signals and market momentum, for discovery, research, or trade idea generation. *Not for:* Do not use for real-time price feeds, portfolio tracking, or historical trend data; this is a single-shot report of the top 3 trending tokens at call time. **Returns:** Returns status='success' and a data object containing a plain-text report of the top 3 trending altcoins (with rationale, price stats, KOL mentions, bullish thesis) and a URL to the formatted HTML report. **Example:** `GET https://x402.ottoai.services/trending-altcoins` --- ### `fetch-defi-yield-opportunities` **YieldAlpha Pro – DeFi Yield Opportunities** — Returns ranked DeFi yield opportunities across stablecoins, ETH, and BTC, split into blue-chip (low-risk) and degen (high-APY) categories with TVL, APY, and protocol links. *Use when:* Use when an agent needs current DeFi yield data to recommend where to deploy stablecoins, ETH, or BTC, including risk-tiered options from established protocols like Aave, Morpho, and Pendle. *Not for:* Do not use for executing swaps or deposits — this endpoint returns informational yield signals only, not transaction instructions. Not suitable for non-EVM or CEX yield products. **Returns:** Returns status='success' and a formatted text block listing blue-chip yields (best stablecoin, ETH, BTC APYs with TVL and Morpho/Aave/Pendle links) and degen high-APY opportunities, plus market context and risk notes. **Example:** `GET https://x402.ottoai.services/yield-alpha` --- ### `fetch-kol-sentiment-report` **KOL Sentiment IQ** — Returns a synthesized sentiment report from the top 50 crypto KOLs, including overall sentiment score, key narratives, trending tokens, and individual KOL insights. *Use when:* Use when an agent needs a current read on crypto market sentiment from influential KOLs, including bullish/bearish score, trending tokens, and notable social media signals from market movers. *Not for:* Do not use for real-time price feeds or on-chain trading data; use a market data or DEX quote API instead. Not suitable for sentiment on a specific token or KOL — this returns an aggregated top-50 report only. **Returns:** Returns status='success' and a data.report string containing overall sentiment (e.g. BULLISH 80%), key narratives, trending tokens (e.g. ETH, ZEC), and top KOL quotes with engagement counts. **Example:** `GET https://x402.ottoai.services/kol-sentiment` ---