# Otto AI MPP Services (Machine Payments Protocol)
# Protocol: https://paymentauth.org (IETF draft-httpauth-payment)
# SDK: npm install mppx
# Payment: Tempo pathUSD on Tempo blockchain
# Recipient: 0x0E84dDEdAaE6A779c462C22a59F301EC31B6b808

# Usage:
#   1. GET any endpoint below
#   2. Receive 402 + WWW-Authenticate: Payment challenge
#   3. Send Authorization: Payment credential with payment proof
#   4. Receive 200 + Payment-Receipt + data

# Endpoints:
# /crypto-news — $0.001 — Real-time crypto market news with sentiment analysis and top headlines ranked by importance.
# /filtered-news?topic=Topic to filter news by (max 2 words) — $0.10 — AI-filtered crypto news and Twitter search for non-token topics. Max 2 words.
# /twitter-summary — $0.001 — Quick pulse check from crypto Twitter. Breaking news, trending narratives, and sentiment shifts.
# /token-details?symbol=Token symbol (e.g., BTC, ETH, SOL) — $0.10 — Token price, market cap, volume, supply, and basic metrics for any listed token.
# /token-alpha?symbol=Token symbol (e.g., BTC, ETH, SOL) — $0.10 — Premium token intelligence: price metrics, news, Twitter sentiment, and futures data.
# /kol-sentiment — $0.10 — Premium alpha from top 50 crypto KOLs. Real trading signals and sentiment from market movers.
# /yield-alpha — $0.10 — Best DeFi yield opportunities across stablecoins, ETH, and BTC with risk ratings.
# /trending-altcoins — $0.10 — Top 3 hottest altcoins based on news and Twitter analysis. DYOR.
# /mega-report — $0.25 — Comprehensive daily crypto intelligence: headlines, sentiment, KOL alpha, trending, and yields.
# /token-security?address=Token contract address (0x-prefixed)&chain?=Chain ID: 1 (ETH), 56 (BSC), 137 (Polygon), 42161 (Arbitrum), 8453 (Base), 43114 (Avalanche), 10 (Optimism) — $0.10 — Token contract security audit. Checks honeypots, hidden mints, rug pull risks, and holder concentration.
# /funding-rates?symbol?=Token symbol for detailed view (omit for overview) — $0.10 — Derivatives intelligence: funding rates, open interest, long/short ratios, and whale positions.
# /defi-analytics?protocol?=Protocol slug for detail (e.g., aave, lido) — $0.10 — DeFi protocol analytics: TVL rankings, chain breakdown, gainers/losers, and protocol deep dives.
# /tradfi-data?symbol?=Ticker symbol for stock quote (omit for macro) — $0.10 — TradFi macro intelligence: indices, VIX, DXY, treasury yields, commodities, and stock quotes.
# /generate-meme?prompt=Description of the image to generate — $0.50 — AI image generation powered by Gemini 3 Pro.
# /llm-research?prompt=Research question or topic (max 180 chars) — $0.50 — AI research assistant with web search powered by Gemini 2.5 Pro.
# /tx-explainer?txHash=Transaction hash (0x-prefixed)&chain?=Chain name (e.g., base, ethereum, arbitrum) — $0.01 — Decode and explain EVM transactions across 11 chains.
# /portfolio?userId=Wallet address (0x-prefixed) — $0.001 — Multi-chain token balances for Safe account.
# /transaction-history?userId=Wallet address (0x-prefixed) — $0.001 — Trade history for Safe account.
# /supported-tokens?search?=Token symbol to search (e.g., USDC)&chainId?=Chain ID to search on — $0.001 — Search supported tokens by symbol on a specific chain.
# /hyperliquid-account?address=Wallet address (0x-prefixed) — $0.001 — Hyperliquid perpetual futures account info.
# /hyperliquid-market?asset=Asset symbol (e.g., BTC, ETH) — $0.001 — Hyperliquid perpetual market data and funding rates.
# /hl-transaction-history?address=Wallet address (0x-prefixed) — $0.001 — Hyperliquid perpetual trading history.
# /yield-markets — $0.001 — Available DeFi yield farming markets.
# /yield-farming-active?userAddress=Wallet address (0x-prefixed) — $0.001 — Active yield farming positions.
# /yield-farming-historical?userAddress=Wallet address (0x-prefixed) — $0.001 — Historical yield farming positions.