{"openapi":"3.1.0","info":{"title":"Otto AI x402 — Market Intelligence, DeFi & Trading","version":"2.0.0","contact":{"email":"admin@useotto.xyz","url":"https://t.me/DeFAI_Capital"},"description":"Otto AI runs a swarm of autonomous agents exposing 81 pay-per-call services on x402 V2 across eight capability tags — Market & Token Intelligence, DeFi & Markets Data, Web & Domain Intelligence, Real-World Data, AI Creative & Tools, Portfolio & Accounts, Execution, and x402 Open Router. Settled in USDC on Base, Polygon, or Solana. Permit2-ready for any ERC-20. From $0.001 per call.","guidance":"Otto AI exposes 81 pay-per-call endpoints across eight capability tags — Market & Token Intelligence, DeFi & Markets Data, Web & Domain Intelligence, Real-World Data, AI Creative & Tools, Portfolio & Accounts, Execution, and x402 Open Router. All endpoints require x402 V2 payment (USDC on Base, Polygon, or Solana).\n\nHow to use:\n1. GET/POST any endpoint — receive 402 with PAYMENT-REQUIRED header (base64-encoded)\n2. Decode header to find accepts[] array with payment options (EIP-3009 USDC, Permit2 any ERC-20, Solana USDC)\n3. Sign payment and retry with PAYMENT-SIGNATURE header\n4. Receive 200 with data + signed receipt in PAYMENT-RESPONSE header\n5. Only for endpoints that advertise SIWX eligibility: use SIGN-IN-WITH-X on subsequent requests (1hr free access); cached data endpoints require payment every call\n\nEndpoint categories:\n- Market & Token Intelligence (18): News (full feed, one-paragraph recaps, Base-ecosystem vertical), KOL sentiment, token analysis/details/fundamentals/price/security, trending, top-holders, holder analytics, Base Season, RH Season, tweet-search, mega-report\n- DeFi & Markets Data (20): DeFi TVL/yield, stablecoin peg-watch, composite market-risk score (depeg + Base exit-liquidity), protocol fees/revenue, DEX pool search, trending pools, prediction-market odds (Polymarket top/crypto/search), funding rates, perp/HL market data, TradFi macro, US equities intel, tokenized-equity registry, SEC insider trades (Form 4), 13F institutional holdings, smart-money bundle + AI filing brief\n- Web & Domain Intelligence (9): DNS lookup (records + SPF/DMARC/DKIM email auth), WHOIS/RDAP registration, domain age/trust signal, one-call domain report, web-search (query → ranked live pages + snippets), web-answer (quick synthesized answer + citations for agent loops; use /llm-research for a deep report), web-extract (URL → markdown via Jina), web-links (all page links) and web-json-extract (page → structured JSON via AI) — keyless public infra (DoH, RDAP, Jina, Cloudflare Browser Rendering) plus licensed Exa search/answer\n- Real-World Data (2): live + reference fiat FX rates (Yahoo near-real-time mid for 12 majors refreshed every minute + ECB daily reference for ~30 currencies, base USD) and global current weather + 5-day forecast (Open-Meteo) — keyless public sources\n- AI Creative & Tools (4): Image gen, video gen, AI research, tx explainer\n- Portfolio & Accounts (10): Wallet balances/holdings bagcheck, positions, transaction history, yield positions, idle capital\n- Execution (9): Swap (LI.FI), bridge (LI.FI), deposit, withdraw, Hyperliquid perps (trade/close/modify/margin/deposit-withdraw)\n- x402 Open Router (3): Meta Intelligence (POST /meta-intelligence — recommends the best x402 service, non-custodial, $0.001), Full Auto (POST /full-auto — LIVE+ARMED, pays the best service on your behalf at-cost + $0.001 router fee, upto cap), Feedback & Refunds (POST /feedback — money-back guarantee, capped $0.01/tx, up to 10x/wallet/day, on Otto's own services + Full Auto)"},"servers":[{"url":"https://x402.ottoai.services"}],"paths":{"/crypto-news":{"get":{"operationId":"crypto_news","summary":"Real-time crypto news with sentiment","description":"Real-time crypto market news with sentiment analysis and top headlines ranked by importance.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/news-recaps":{"get":{"operationId":"news_recaps","summary":"One-paragraph crypto market recap","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.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/base-ecosystem-news":{"get":{"operationId":"base_ecosystem_news","summary":"Base-chain ecosystem news, AI-filtered","description":"Base-chain ecosystem news, AI-filtered hourly from Otto's live news engine: protocol launches and upgrades on Base, Coinbase/Base official moves, Base DeFi and token developments — a topic-scoped report for Base-native agents, not the general crypto firehose. Pairs with /base-season (KOL social signal) for the full Base picture.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/filtered-news":{"get":{"operationId":"filtered_news","summary":"AI-filtered news by topic","description":"AI-filtered crypto news and Twitter search for non-token topics (airdrops, DeFi trends, etc). Max 2 words.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"topic","in":"query","required":true,"description":"Topic to filter news by (max 2 words)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/tweet-search":{"get":{"operationId":"tweet_search","summary":"Search X/Twitter for any query — real matching tweets","description":"Search X/Twitter for any query and get the actual matching tweets — keyword, $CASHTAG, from:handle (a user timeline), @handle (mentions), or boolean OR. Each tweet returns author, full text (long-form note tweets included), timestamp, likes and retweets (reply/quote counts when available). Most-recent-first for real-time monitoring and alerting. Live X search backend, pay-per-call USDC, structured JSON — no API keys, no sign-up.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005"},"parameters":[{"name":"query","in":"query","required":true,"description":"X/Twitter search query — keyword, $CASHTAG, from:handle, @handle, or boolean OR (e.g. \"$BTC OR bitcoin -is:retweet\")","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/twitter-summary":{"get":{"operationId":"twitter_summary","summary":"Curated crypto Twitter digest","description":"Quick pulse check from crypto Twitter. Breaking news, trending narratives, and sentiment shifts at a glance.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/token-details":{"get":{"operationId":"token_details","summary":"Token price and metrics","description":"Token price, market cap, volume, supply, and basic metrics. Works for any listed token.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"symbol","in":"query","required":true,"description":"Token symbol (e.g., BTC, ETH, SOL)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/token-alpha":{"get":{"operationId":"token_alpha","summary":"Premium token intelligence","description":"Premium token intelligence: price metrics, news, Twitter sentiment, and futures data. Find out why your token is moving.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005"},"parameters":[{"name":"symbol","in":"query","required":true,"description":"Token symbol (e.g., BTC, ETH, SOL)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/kol-sentiment":{"get":{"operationId":"kol_sentiment","summary":"Top 50 KOL sentiment analysis","description":"Premium alpha from top 50 crypto KOLs. Real trading signals, trending token picks, and sentiment from influencers who move markets.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.002"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/yield-alpha":{"get":{"operationId":"yield_alpha","summary":"DeFi yield opportunities","description":"Best DeFi yield opportunities across stablecoins, ETH, and BTC with risk ratings and APY comparisons.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.002"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/trending-altcoins":{"get":{"operationId":"trending_altcoins","summary":"Top 3 trending altcoins","description":"Top 3 hottest altcoins traders may want to ape into, based on news and Twitter analysis. DYOR.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.002"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/mega-report":{"get":{"operationId":"mega_report","summary":"Alpha & Intel Report — daily market briefing","description":"Alpha & Intel Report — daily crypto market intelligence: headlines, Twitter sentiment, KOL alpha, trending altcoins, and yield opportunities in one report.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.05"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/token-security":{"get":{"operationId":"token_security","summary":"Honeypot & rug-pull safety check","description":"Token security scanner — is this token safe to buy? Honeypot, rug-pull, and scam detection for any token contract — flags can't-sell traps, hidden mints, malicious buy/sell taxes, and holder concentration. Powered by GoPlus across 7 chains.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"address","in":"query","required":true,"description":"Token contract address (0x-prefixed)","schema":{"type":"string"}},{"name":"chain","in":"query","required":false,"description":"Chain ID: 1 (ETH), 56 (BSC), 137 (Polygon), 42161 (Arbitrum), 8453 (Base)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/funding-rates":{"get":{"operationId":"funding_rates","summary":"Perp funding rates & positioning","description":"Cross-venue funding-rate arbitrage + crowded-positioning radar: live perp funding rates, open interest, global & top-trader long/short ratios, whale positions, and liquidations across Binance, OKX, Bybit, Hyperliquid, and more. Omit symbol for the whole-market overview; pass one (e.g. BTC) for the per-exchange breakdown. (Hyperliquid-only perp data: use hyperliquid-market.)","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Token symbol for detailed view (omit for market overview)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/defi-analytics":{"get":{"operationId":"defi_analytics","summary":"DeFi capital flows & TVL","description":"Where DeFi capital is flowing — TVL rankings, fastest-growing vs bleeding protocols, chain-by-chain breakdown, and per-protocol deep dives. Track capital rotation and protocol health. Powered by DefiLlama.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"protocol","in":"query","required":false,"description":"Protocol slug (e.g., aave, lido, uniswap)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/tradfi-data":{"get":{"operationId":"tradfi_data","summary":"TradFi macro intelligence","description":"TradFi macro intelligence: indices, VIX, DXY, treasury yields, commodities, and individual stock quotes with moving average context.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"symbol","in":"query","required":false,"description":"Ticker symbol for stock quote (omit for macro dashboard)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/generate-meme":{"post":{"operationId":"generate_meme","summary":"Multi-model image gen (fal.ai)","description":"Meme generator + professional AI image generation via fal.ai. model: gpt-image-2 (default) | nano-banana-pro; anything else -> 400. Flat $0.15 per image. Supports image editing via public image URL.","tags":["AI Creative & Tools"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.15"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"Description of the image to generate (100+ chars yields best results)"},"model":{"type":"string","enum":["gpt-image-2","nano-banana-pro"],"description":"model: gpt-image-2 (default) | nano-banana-pro; anything else -> 400"},"image_url":{"type":"string","description":"Optional: public HTTPS URL of image to edit/remix"},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16"],"description":"Aspect ratio (default: 1:1)"}},"required":["prompt"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/llm-research":{"post":{"operationId":"llm_research","summary":"AI research assistant (Gemini 3.5 Flash, cited sources)","description":"Instant AI research on any topic powered by Gemini 3.5 Flash with live Google Search grounding — answers come with cited sources. Ask about science, tech, crypto, history, or anything else. Can analyze images and summarize webpages from URLs. Max 180 character prompts. $0.10 per query.","tags":["AI Creative & Tools"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"Research question (max 180 chars)"},"url":{"type":"string","description":"Optional: URL to analyze or summarize"}},"required":["prompt"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/tx-explainer":{"post":{"operationId":"tx_explainer","summary":"Decode & explain EVM transactions","description":"Decode and explain any EVM blockchain transaction across 11 chains (Base, Ethereum, Arbitrum, Optimism, Avalanche, Polygon, Mantle, Monad, Plasma, BSC, Hyperliquid). Get a human-readable summary of swaps, transfers, approvals, DeFi interactions, and more.","tags":["AI Creative & Tools"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"txHash":{"type":"string","description":"Transaction hash (0x-prefixed, 64 hex characters)"},"chain":{"type":"string","description":"Chain name (e.g., base, ethereum, arbitrum) — optional, auto-detected if omitted"}},"required":["txHash"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/video-gen":{"post":{"operationId":"video_gen","summary":"Multi-model video gen (fal.ai)","description":"AI video generation via fal.ai — default model: ByteDance Seedance 2.0. Alternatives: fal-ai/sora-2/text-to-video, fal-ai/veo3.1. Dynamic pricing per request: at-cost fal.ai rate + 15% margin (floor $0.05); the advertised price is the Seedance 5s reference quote — the actual quote is returned per request. Supports text-to-video and image-to-video.","tags":["AI Creative & Tools"],"x-payment-info":{"protocols":["x402"],"pricingMode":"range","minPrice":"0.46","maxPrice":"4.60"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"prompt":{"type":"string","description":"Video description (20-1000 chars)"},"model":{"type":"string","enum":["seedance-2.0","sora-2","veo-3.1"],"description":"Video model (default: seedance-2.0)"},"duration":{"type":"number","description":"Duration in seconds (4-10, per-model caps enforced)"},"aspect_ratio":{"type":"string","enum":["16:9","9:16","1:1"],"description":"Aspect ratio (default: 16:9)"},"image_url":{"type":"string","description":"Optional: public HTTPS URL for image-to-video (seedance-2.0 and sora-2 only)"}},"required":["prompt","duration"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/portfolio":{"get":{"operationId":"portfolio","summary":"Multi-chain token balances","description":"Multi-chain portfolio snapshot with token balances and yield positions for a user's Otto AI Safe accounts across Base, Ethereum, Arbitrum, Polygon, BSC, Avalanche, and Solana.","tags":["Portfolio & Accounts"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"userId","in":"query","required":true,"description":"Wallet address (0x-prefixed)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/transaction-history":{"get":{"operationId":"transaction_history","summary":"Trade history","description":"Trade and transaction history for a user's Otto AI Safe account — swaps, bridges, deposits, withdrawals with timestamps and explorer links.","tags":["Portfolio & Accounts"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"userId","in":"query","required":true,"description":"Wallet address (0x-prefixed)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/supported-tokens":{"get":{"operationId":"supported_tokens","summary":"Search tokens by symbol","description":"Search supported ERC-20 tokens by symbol or address across 6 chains (Base, Ethereum, Arbitrum, Polygon, BSC, Avalanche). 5000+ tokens from CoinGecko. Use before swap/bridge to disambiguate tokens.","tags":["Portfolio & Accounts"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"search","in":"query","required":false,"description":"Token symbol to search (e.g., USDC)","schema":{"type":"string"}},{"name":"chainId","in":"query","required":false,"description":"Chain ID to search on","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/hyperliquid-account":{"get":{"operationId":"hyperliquid_account","summary":"Perpetual futures account info","description":"Hyperliquid perpetual trading account snapshot with open positions, margin, collateral, and active trigger orders (TP/SL/limit).","tags":["Portfolio & Accounts"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"address","in":"query","required":true,"description":"Wallet address (0x-prefixed)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/hyperliquid-market":{"get":{"operationId":"hyperliquid_market","summary":"Perpetual market data","description":"Hyperliquid perpetuals market data: live mark/oracle price, funding rate, open interest, max leverage, and size specs for any tradable asset.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"asset","in":"query","required":true,"description":"Asset symbol (e.g., BTC, ETH)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/hl-transaction-history":{"get":{"operationId":"hl_transaction_history","summary":"Perpetual trading history","description":"Hyperliquid perpetual trading history: fills, funding payments, and realized PnL per position.","tags":["Portfolio & Accounts"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"address","in":"query","required":true,"description":"Wallet address (0x-prefixed)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/yield-markets":{"get":{"operationId":"yield_markets","summary":"Available DeFi yield markets","description":"DeFi yield farming markets with live APYs across Aave V3 and Morpho on Base, Ethereum, and other major chains. Find the best stablecoin yield (USDC) and ETH yield for idle capital: returns supply APY, TVL, and vault/market addresses per token, filterable by protocol, chain, or token symbol. Compare DeFi yield rates across lending markets and vaults before depositing.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/yield-farming-active":{"get":{"operationId":"yield_farming_active","summary":"Active yield positions","description":"Active yield farming positions for a user across Aave V3 and Morpho on all supported chains, with live APY and accrued interest.","tags":["Portfolio & Accounts"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"userAddress","in":"query","required":true,"description":"Wallet address (0x-prefixed)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/yield-farming-historical":{"get":{"operationId":"yield_farming_historical","summary":"Historical yield positions","description":"Historical (closed) yield farming positions for a user across all protocols and chains, with realized yield and exit timestamps.","tags":["Portfolio & Accounts"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"userAddress","in":"query","required":true,"description":"Wallet address (0x-prefixed)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/idle-capital":{"get":{"operationId":"idle_capital","summary":"Idle capital detection","description":"[Temporarily unavailable] Per-wallet idle-capital scanning is being rebuilt on Otto's yield-copilot service. Calls currently return a no-charge 503 until it relands.","tags":["Portfolio & Accounts"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"userAddress","in":"query","required":true,"description":"Wallet address (0x-prefixed)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/yield-recommendations":{"get":{"operationId":"yield_recommendations","summary":"Yield recommendations","description":"Best-available stablecoin deposit venues ranked by net supply APY — Otto's yield-copilot reads supported on-chain lending markets directly and returns the top deployable venue per stablecoin (protocol, chain, APY, deposit target). Best-available across the market, not wallet-personalized.","tags":["Portfolio & Accounts"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"userAddress","in":"query","required":false,"description":"Wallet address (0x-prefixed, optional — ignored for the best-available ranking)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/swap":{"post":{"operationId":"swap","summary":"Swap tokens via LI.FI","description":"Execute instant same-chain ERC-20 swaps through DEX aggregation via LI.FI. Supports Base, Ethereum, Polygon, BSC, Arbitrum, Avalanche, and Solana. Routes across supported DEXes and liquidity sources.","tags":["Execution"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fromSymbol":{"type":"string","description":"FROM token: a known symbol (e.g. USDC) OR a 0x contract address, resolved on chainId. Ambiguous symbols → HTTP 400 with candidate addresses."},"toSymbol":{"type":"string","description":"TO token: a known symbol (e.g. WETH — use WETH, not native ETH) OR a 0x contract address."},"amount":{"type":"string","description":"Amount of the FROM token to sell (human-readable). Decimals are derived server-side — do NOT send decimals."},"chainId":{"type":"number","description":"Chain ID (8453=Base, 1=Ethereum, 42161=Arbitrum)"},"fromTokenAddress":{"type":"string","description":"Optional FROM token contract address (alternative to fromSymbol; disagreeing address+symbol is rejected)."},"toTokenAddress":{"type":"string","description":"Optional TO token contract address (alternative to toSymbol)."}},"required":["fromSymbol","toSymbol","amount"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/bridge":{"post":{"operationId":"bridge","summary":"Bridge tokens cross-chain","description":"Cross-chain token bridging via LiFi aggregator. Move tokens between Base, Ethereum, Arbitrum, Optimism, Polygon, BSC, Avalanche, and Solana with best-route execution across all major bridges.","tags":["Execution"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"fromSymbol":{"type":"string","description":"Source token: a known symbol OR a 0x contract address, resolved on the SOURCE chain. Ambiguous symbols → HTTP 400 with candidates."},"toSymbol":{"type":"string","description":"Destination token: a known symbol OR a 0x contract address, resolved on the DESTINATION chain."},"amount":{"type":"string","description":"Amount to bridge (human-readable). Decimals are derived server-side — do NOT send decimals."},"fromChainId":{"type":"number","description":"Source chain ID"},"toChainId":{"type":"number","description":"Destination chain ID"},"fromTokenAddress":{"type":"string","description":"Optional source token contract address (alternative to fromSymbol)."},"toTokenAddress":{"type":"string","description":"Optional destination token contract address (alternative to toSymbol)."}},"required":["fromSymbol","toSymbol","amount","fromChainId","toChainId"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/withdraw":{"post":{"operationId":"withdraw","summary":"Withdraw tokens from Safe","description":"Withdraw tokens from a user's Otto AI Safe to any EOA. Supports 7 chains (Base, Polygon, Arbitrum, Ethereum, BSC, Avalanche, Solana). Non-Base chains require an explicit EOA recipient.","tags":["Execution"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tokenSymbol":{"type":"string","description":"Token to withdraw: a known symbol (e.g. USDC) OR a 0x contract address, resolved on the given chain. Ambiguous symbols → HTTP 400 with candidates."},"amount":{"type":"string","description":"Amount to withdraw (human-readable). Decimals are derived server-side — do NOT send decimals."},"chainId":{"type":"number","description":"Chain ID (8453=Base default, 137, 42161, 56, 1, 43114, 1151111081099710)."},"tokenAddress":{"type":"string","description":"Optional token contract address (alternative to tokenSymbol; disagreeing address+symbol is rejected)."},"recipientAddress":{"type":"string","description":"Destination EOA. Defaults to the verified payer's own wallet; a different destination requires an EIP-712 signed withdraw intent. REQUIRED on non-Base chains."}},"required":["tokenSymbol","amount","chainId"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/deposit":{"post":{"operationId":"deposit","summary":"Deposit tokens to Safe","description":"Deposit USDC into your non-custodial Otto AI Safe on Base. Dynamic price per request = deposit amount + $0.01 service fee (the amount you deposit is paid via x402). The $0.01 shown here is the floor service fee for discovery only.","tags":["Execution"],"x-payment-info":{"protocols":["x402"],"pricingMode":"quote"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userAddress":{"type":"string","description":"User wallet address (0x-prefixed)"},"amount":{"type":"string","description":"Amount of USDC to deposit (human-readable units, 0–100000)"},"chainId":{"type":"number","description":"Chain ID (default 8453=Base)"}},"required":["userAddress","amount"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/trade-perpetuals":{"post":{"operationId":"trade_perpetuals","summary":"Open leveraged perpetual positions","description":"Open leveraged perpetual positions on Hyperliquid with optional native TP/SL trigger orders. Min notional $10. Max leverage varies by asset (BTC 40x, ETH 25x, SOL 20x). Supports BTC, ETH, SOL, and 100+ other markets.","tags":["Execution"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userAddress":{"type":"string","description":"User wallet address (0x-prefixed)"},"asset":{"type":"string","description":"Asset ticker (BTC, ETH, SOL, or HIP-3 format such as xyz:TSLA)"},"side":{"type":"string","enum":["long","short"],"description":"Position direction"},"size":{"type":"number","description":"Notional position size in USDC, not margin"},"leverage":{"type":"number","description":"Leverage multiplier (defaults to 10; asset max may be lower)"},"orderType":{"type":"string","enum":["market","limit"],"description":"Order type (default: market)"},"limitPrice":{"type":"number","description":"Required when orderType is limit"},"marginMode":{"type":"string","enum":["cross","isolated"],"description":"Margin mode (default: cross)"},"takeProfit":{"type":"object","description":"Optional take-profit trigger; provide either percentage or price","properties":{"percentage":{"type":"number","description":"Take-profit percentage from entry"},"price":{"type":"number","description":"Absolute take-profit trigger price"}}},"stopLoss":{"type":"object","description":"Optional stop-loss trigger; provide either percentage or price","properties":{"percentage":{"type":"number","description":"Stop-loss percentage from entry"},"price":{"type":"number","description":"Absolute stop-loss trigger price"}}}},"required":["userAddress","asset","side","size"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/close-position":{"post":{"operationId":"close_position","summary":"Close a perpetual position","description":"Close an open perpetual position on Hyperliquid (full or partial). Cancels all attached TP/SL trigger orders automatically.","tags":["Execution"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userAddress":{"type":"string","description":"User wallet address (0x-prefixed)"},"asset":{"type":"string","description":"Asset ticker of the open position"},"partialClosePercentage":{"type":"number","description":"Percentage of position to close (1-100, default 100)"}},"required":["userAddress","asset"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/modify-hl-order":{"post":{"operationId":"modify_hl_order","summary":"Modify Hyperliquid orders","description":"Add, modify, or cancel TP/SL trigger orders and limit orders on Hyperliquid. Can attach TP/SL to an existing position or change the trigger price of active orders.","tags":["Execution"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userAddress":{"type":"string","description":"User wallet address (0x-prefixed)"},"asset":{"type":"string","description":"Asset ticker"},"action":{"type":"string","enum":["add_tp","add_sl","modify_tp","modify_sl","modify_limit_order","cancel"],"description":"Operation to perform"},"price":{"type":"number","description":"New trigger or limit price; not required for cancel"},"orderId":{"type":"string","description":"Existing order ID; required for modify and cancel actions"},"size":{"type":"number","description":"Optional new size for modify_limit_order"}},"required":["userAddress","asset","action"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/update-position-margin":{"post":{"operationId":"update_position_margin","summary":"Update position leverage or margin","description":"Modify leverage, or add/remove margin on an open Hyperliquid position. Lets you de-risk without closing.","tags":["Execution"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userAddress":{"type":"string","description":"User wallet address (0x-prefixed)"},"asset":{"type":"string","description":"Asset ticker of the open position"},"action":{"type":"string","enum":["update_leverage","add_margin","remove_margin"],"description":"Operation to perform"},"leverage":{"type":"number","description":"Required for update_leverage"},"marginMode":{"type":"string","enum":["cross","isolated"],"description":"Optional margin mode for update_leverage"},"amount":{"type":"number","description":"USDC amount required for add_margin or remove_margin"}},"required":["userAddress","asset","action"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/hl-deposit-withdraw":{"post":{"operationId":"hl_deposit_withdraw","summary":"Deposit or withdraw Hyperliquid USDC","description":"Deposit or withdraw USDC to/from Hyperliquid via Arbitrum. Intelligent routing: checks Arbitrum Safe first, auto-bridges from Base if needed, falls back to Butler wallet.","tags":["Execution"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"userAddress":{"type":"string","description":"User wallet address (0x-prefixed)"},"action":{"type":"string","enum":["deposit","withdraw"],"description":"Direction"},"amount":{"type":"number","description":"USDC amount in human-readable units"}},"required":["userAddress","action","amount"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/token-top-holders":{"get":{"operationId":"token_top_holders","summary":"ERC-20 top holders + concentration","description":"Top holders for any Base ERC-20 (via Moralis), with computed concentration (top1/5/10/20% + contract-held%) and optional whale-risk read. Curated hot set refreshed hourly; long-tail tokens write-through on first call.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.02"},"parameters":[{"name":"token","in":"query","required":true,"description":"ERC-20 contract address on Base (0x-prefixed, 42 chars). Common symbols also accepted as shorthand: weth, usdc, cbbtc, cbxrp, cbdoge, usol.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/stablecoin-watch":{"get":{"operationId":"stablecoin_watch","summary":"Is the peg holding? Stablecoin depeg watch + supply flows","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.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/market-risk":{"get":{"operationId":"market_risk","summary":"Is anything breaking? Composite market-stress score (depeg + Base liquidity)","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. Stablecoin systemic + Base liquidity microstructure only (not derivatives/sentiment). Both legs required for a score. Refreshed hourly, public sources, pay-per-call.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.002"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/protocol-revenue-leaders":{"get":{"operationId":"protocol_revenue_leaders","summary":"Which DeFi protocols actually make money — fees & revenue leaders","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 hourly.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/equity-intel":{"get":{"operationId":"equity_intel","summary":"US stock fundamentals + filings intel for any ticker","description":"Equity intelligence for any US-listed company by ticker: latest revenue & net income with YoY growth, net margin, EPS, total assets/liabilities, leverage and cash, plus the most recent material SEC filings (10-K/10-Q/8-K) and an AI read on what matters. Sourced from SEC EDGAR (public domain). Fundamentals/filings intel — not a price feed.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"ticker","in":"query","required":true,"description":"US stock ticker, e.g. NVDA, AAPL, JPM","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/earnings-calendar":{"get":{"operationId":"earnings_calendar","summary":"Equity earnings dates, estimates, and EPS surprises","description":"Earnings calendar and surprise history for a vendor-resolved equity: next report date/session with EPS and revenue estimates, latest reported EPS versus estimate, surprise percentage, and four-quarter history. Monetary estimates retain Finnhub payload units because the captured feed does not identify a currency. Event-window price drift is explicitly unavailable rather than inferred.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"ticker","in":"query","required":true,"description":"Vendor-supported equity or ETF ticker (e.g. AAPL, NVDA, TSLA, SPY); returned monetary values use vendor payload units and are not relabeled as USD.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/analyst-ratings":{"get":{"operationId":"analyst_ratings","summary":"Equity analyst consensus, price targets, and revisions","description":"Analyst-rating snapshot for a vendor-resolved equity: consensus distribution, high/low/median/consensus price targets, target versus a timestamped reference price, recent firm-level grade actions, and transparent 90-day upgrade-minus-downgrade momentum. Price fields retain FMP payload units because the captured feeds do not identify a currency.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"ticker","in":"query","required":true,"description":"Vendor-supported equity or ETF ticker (e.g. AAPL, NVDA, TSLA, SPY); returned monetary values use vendor payload units and are not relabeled as USD.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/equity-news":{"get":{"operationId":"equity_news","summary":"Licensed company headlines for a vendor-resolved equity","description":"Latest company news for a vendor-resolved equity: licensed Finnhub headlines from the trailing seven days with publication time, source, and summary. Only articles that name the company are served — labelled `primary` when the headline names it, `mentioned` when only the summary does — so a symbol-tagged story about another company never fills the list. Redirect URLs withheld; no sentiment is fabricated.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"ticker","in":"query","required":true,"description":"Vendor-supported equity or ETF ticker (e.g. AAPL, NVDA, TSLA, SPY); returned monetary values use vendor payload units and are not relabeled as USD.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/dividend-intel":{"get":{"operationId":"dividend_intel","summary":"Equity dividend history, growth, and yield-trap checks","description":"Dividend intelligence for a vendor-resolved equity: TTM yield, payout ratio and dividend/share, next known ex-date, latest raw and adjusted dividend values, adjusted complete-year growth, recent payments, and a yield-trap checklist with explicit coverage. Monetary fields retain FMP payload units because the captured feeds do not identify a currency.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"ticker","in":"query","required":true,"description":"Vendor-supported equity or ETF ticker (e.g. AAPL, NVDA, TSLA, SPY); returned monetary values use vendor payload units and are not relabeled as USD.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/macro-regime":{"get":{"operationId":"macro_regime","summary":"US rates and inflation regime snapshot","description":"Daily US macro-regime snapshot from licensed Alpha Vantage series: 10-year Treasury yield, effective federal funds rate, three-month rate changes, CPI index and YoY inflation, plus a mechanical rates-direction/inflation-direction label with disclosed thresholds. Three upstream calls per daily refresh; scanner context only.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/technical-signals":{"get":{"operationId":"technical_signals","summary":"Equity RSI, momentum, and moving-average signals","description":"Daily technical snapshot for a vendor-resolved equity from licensed Tiingo adjusted closes: Wilder RSI-14, 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 retain Tiingo payload units because the captured feed does not identify a currency.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"ticker","in":"query","required":true,"description":"Vendor-supported equity or ETF ticker (e.g. AAPL, NVDA, TSLA, SPY); returned monetary values use vendor payload units and are not relabeled as USD.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/dns-lookup":{"get":{"operationId":"dns_lookup","summary":"Full DNS for any domain — records + email auth (SPF/DMARC/DKIM)","description":"Resolve any domain in one call: A/AAAA, MX, NS, CNAME, SOA and TXT records, plus parsed email-auth posture — SPF policy, DMARC policy, and detected DKIM selectors. A drop-in nslookup/dig replacement for agents, resolved over DNS-over-HTTPS (DoH) with redundant resolvers and automatic failover. Keyless, pay-per-call, structured JSON.","tags":["Web & Domain Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"domain","in":"query","required":true,"description":"Domain to resolve, e.g. github.com (subdomains allowed)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/whois-lookup":{"get":{"operationId":"whois_lookup","summary":"WHOIS/RDAP for any domain — registrar, status, dates, nameservers","description":"Registration data for any domain, straight from authoritative RDAP registries (the structured WHOIS successor): registrar, ICANN/EPP domain status codes, creation, last-updated and expiration dates, authoritative nameservers, and DNSSEC delegation. The fast, license-clean way for an agent to vet a domain, sender, or counterparty. Keyless, structured JSON, pay-per-call.","tags":["Web & Domain Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"domain","in":"query","required":true,"description":"Registrable domain to look up, e.g. stripe.com","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/domain-age":{"get":{"operationId":"domain_age","summary":"How old is a domain? Creation date + age + expiry trust signal","description":"Domain age and registration intel from authoritative RDAP/WHOIS records: exact creation date, age in days and years, expiration date and days-until-expiry. The fast trust and risk signal agents use to vet a counterparty, link, or sender and to flag newly-registered or soon-to-expire domains. Returns structured JSON, keyless, pay-per-call. ccTLDs without RDAP return an uncharged 503.","tags":["Web & Domain Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"domain","in":"query","required":true,"description":"Registrable domain to check, e.g. coinbase.com","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/domain-report":{"get":{"operationId":"domain_report","summary":"One-call domain profile — DNS + registration + email auth","description":"One call returns the full domain profile for vetting, deliverability, or phishing/fraud checks: live DNS (A/MX/NS + record counts), RDAP/WHOIS registration (registrar, domain age, expiry, status, DNSSEC) and email authentication (SPF, DMARC policy, detected DKIM selectors) — plus a one-line summary. Bundles three lookups into one hourly-fresh read. Keyless, license-clean, pay-per-call.","tags":["Web & Domain Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.02"},"parameters":[{"name":"domain","in":"query","required":true,"description":"Domain to profile, e.g. uniswap.org","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/web-extract":{"get":{"operationId":"web_extract","summary":"Read any URL as clean LLM-ready markdown — web reader / scrape","description":"Turn any URL into clean, LLM-ready markdown — the main article extracted, nav/ads/boilerplate stripped, plus title, description and publish date. Renders JavaScript pages, articles, docs and PDFs. A keyless, pay-per-call web reader for agents that read the web on demand: RAG ingestion, research and summarization. Structured JSON, cached by URL for fast repeat reads.","tags":["Web & Domain Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005"},"parameters":[{"name":"url","in":"query","required":true,"description":"Public http(s) URL to read, e.g. https://example.com (renders JS + PDFs)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/web-links":{"get":{"operationId":"web_links","summary":"Extract every link from a web page (JS-rendered)","description":"Extract all links (hrefs) from any web page as structured JSON — every internal, external and anchor link, deduplicated, returned with a total count. Renders the page in a real headless browser, so it captures links injected after JavaScript runs that fetch-only scrapers miss. For crawling, sitemap building, link audits and site-structure mapping. Keyless, pay-per-call.","tags":["Web & Domain Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"url","in":"query","required":true,"description":"Public http(s) URL to extract links from, e.g. https://example.com","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/web-json-extract":{"get":{"operationId":"web_json_extract","summary":"Web page → structured JSON (AI extraction)","description":"Turn any URL into clean structured JSON for AI agents and RAG. An LLM reads the fully rendered page (JavaScript executed, SPAs included) and returns its title, a 1-2 sentence summary, key entities (people, orgs, products), and any prices, dates or notable numbers — even on pages with no schema.org or JSON-LD markup, no CSS selectors or schema to write. Just pass a URL. Keyless, pay-per-call.","tags":["Web & Domain Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.005"},"parameters":[{"name":"url","in":"query","required":true,"description":"Public http(s) URL to extract structured data from, e.g. https://a-product-page.com","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/fx-rates":{"get":{"operationId":"fx_rates","summary":"Live + ECB-reference FX — 12 live majors + ~30 daily (USD base)","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. For agents pricing cross-border ops, treasury, invoicing and FX conversion. Keyless, pay-per-call.","tags":["Real-World Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/weather":{"get":{"operationId":"weather","summary":"Current weather + 5-day forecast for anywhere","description":"Live weather for any city or lat/lon worldwide. Returns current conditions — temperature, feels-like, humidity, wind and sky — plus a 5-day forecast with daily highs/lows and precipitation probability. City names auto-geocode (no coordinates needed). Refreshed hourly with transparent freshness metadata. Keyless, pay-per-call, agent-ready JSON.","tags":["Real-World Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"location","in":"query","required":true,"description":"City name (e.g. \"Tokyo\") or a \"lat,lon\" pair (e.g. \"51.5,-0.12\")","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/base-season":{"get":{"operationId":"base_season","summary":"What Base tokens are trusted KOLs talking about right now?","description":"Base social intelligence: a current Base sentiment summary + the quality-screened Base tokens (CoinGecko-listed, market-cap/age/liquidity gated) that trusted KOLs are actually talking about — with per-token KOL mention counts and verbatim quotes, ranked by KOL signal. Includes overall crypto-KOL market sentiment. The social-intelligence wedge for Base — who is saying it, not who pumped. Refreshed hourly.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/rh-season":{"get":{"operationId":"rh_season","summary":"What's pumping on Robinhood Chain — rug-screened, is-it-real","description":"Robinhood Chain memecoin intelligence: the rug-screened RH Chain (chainId 4663) movers. Hard liquidity + wash-volume gates filter the $0-liquidity honeypots that fake $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 Chain sentiment read. What is pumping AND whether it is real. Refreshed hourly.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/token-fundamentals":{"get":{"operationId":"token_fundamentals","summary":"Structured asset fundamentals — supply, ATH drawdown, ROI windows","description":"Structured token fundamentals by ticker symbol (resolves to the top-market-cap asset matching it): price, market cap, FDV, rank, 24h volume, full supply breakdown (circulating/total/max), ATH + drawdown from ATH, ATL + recovery, ROI windows (24h/7d/30d/60d/1y), categories, and project links — clean JSON an agent can consume field-by-field. Fundamentals snapshot, not a streaming price feed.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"symbol","in":"query","required":true,"description":"Token ticker symbol, e.g. BTC, ETH, SOL, LINK — resolves to the highest-market-cap exact match","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/pools-search":{"get":{"operationId":"pools_search","summary":"DEX pool search — price, liquidity, volume across 8 chains","description":"Search DEX pools across Base, Ethereum, Solana, Polygon, BSC, Arbitrum, Optimism and Avalanche by token symbol, name, or contract address. Returns pool address, DEX, price USD, 24h volume, liquidity (TVL), FDV, 24h price change and 24h txns as flat JSON numbers — no nested joins. Pool search, pool finder, DEX pools, liquidity pools, onchain pool lookup. $0.001 per call.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"query","in":"query","required":true,"description":"Token symbol, token name, or contract address to find pools for (e.g. WETH, PEPE, or a 0x… / Solana mint address)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/pools-trending":{"get":{"operationId":"pools_trending","summary":"Trending DEX pools — hottest pools per chain or cross-chain, top movers","description":"Trending DEX pools right now — Base, Ethereum, Solana, Polygon, BSC, Arbitrum, Optimism, Avalanche, or network=all for cross-chain across those same 8. Top 10 hottest pools ranked by GeckoTerminal 24h trending: pool address, DEX, price USD, 24h price change, 24h volume, liquidity (TVL), FDV, 24h txns as flat JSON numbers. Trending pools, hot pools, top movers, momentum screener, what is pumping. $0.001 per call.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"network","in":"query","required":true,"description":"Network to rank trending pools on: base, ethereum, solana, polygon, bsc, arbitrum, optimism, avalanche — or 'all' for the cross-network ranking across those same 8 chains (synonyms eth, matic, avax, op, arb, bnb accepted)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/pm-markets":{"get":{"operationId":"pm_markets","summary":"Top prediction markets right now — live Polymarket odds snapshot","description":"Top Polymarket prediction markets RIGHT NOW: the 25 highest-volume open markets with live odds (outcome probabilities), best bid/ask, spread, last trade price, 24h + total volume, liquidity, 1d/7d price change, end date and event link. Flat JSON, refreshed every 5 minutes. Prediction market odds, Polymarket data, event probabilities, market sentiment. $0.001 per call.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/pm-crypto":{"get":{"operationId":"pm_crypto","summary":"Crypto prediction markets — what the market prices in for BTC/ETH","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 prediction market ACTUALLY prices in, as flat JSON refreshed every 5 minutes. Crypto odds, Bitcoin prediction market, ETH probability. $0.001 per call.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/pm-search":{"get":{"operationId":"pm_search","summary":"Prediction-market search — free-text odds lookup across open markets","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. Prediction market search, event odds lookup, \"what are the odds of X\". $0.001 per call — 5x cheaper than comparable PM search.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"query","in":"query","required":true,"description":"Free-text search across open prediction markets (e.g. \"fed rate cut\", \"bitcoin 150k\", \"world cup\")","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/insider-trades":{"get":{"operationId":"insider_trades","summary":"SEC Form 4 insider trades — who bought, who sold, net P/S balance","description":"SEC Form 4 insider trades for any US-listed company by ticker: who bought and sold (officer/director/10% owner), purchase vs sale counts and dollar values (SEC codes P/S: open-market or private), net purchase-sale balance, shares held after, filing links — hourly snapshot; 4/A-amended windows withheld once detected (~1h lag): unpaid 503. Insider trading data, insider buys, smart money. Public-domain SEC EDGAR. $0.003 per call.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"ticker","in":"query","required":true,"description":"US-listed stock ticker symbol (e.g. NVDA, AAPL, TSLA)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/institutional-holdings":{"get":{"operationId":"institutional_holdings","summary":"13F institutional holdings — any manager, top positions from the primary source","description":"13F holdings for any SEC-filing manager (hedge funds, asset managers) by CIK or manager ticker: latest 13F top 20 positions, amendments applied (hourly snapshot, ~1h correction lag): issuer, CUSIP, value in whole USD, share/principal amount (SH/PRN), put/call flag, reported value, position count. Whale tracking from the primary source. 13F holdings, hedge fund positions, institutional ownership. Public-domain SEC EDGAR. $0.003 per call.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.003"},"parameters":[{"name":"manager","in":"query","required":true,"description":"SEC CIK number of the manager (e.g. 1067983 for Berkshire Hathaway), or the ticker of a publicly-listed manager (e.g. BLK)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/equity-smart-money":{"get":{"operationId":"equity_smart_money","summary":"Smart-money bundle — insider activity + TTM fundamentals in one call","description":"Smart-money bundle for any US-listed company by ticker, 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. 4/A-amended insider windows withheld once detected (~1h lag): unpaid 503. Smart money, fundamentals. Public-domain SEC EDGAR. $0.006 per call.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.006"},"parameters":[{"name":"ticker","in":"query","required":true,"description":"US-listed stock ticker symbol (e.g. NVDA, AAPL, TSLA)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/equity-smart-money-brief":{"get":{"operationId":"equity_smart_money_brief","summary":"Smart-money filing brief — insider flow + 13D/13G filing events + fundamentals, ONE AI read","description":"Smart-money filing brief for US-listed companies by ticker: SEC Form 4 insider purchases vs sales with filer roles, Schedule 13D/13G beneficial-ownership filing events (subject-validated; not 13F), fundamentals with one-time-item flags (TTM where available), regime-aware filings cadence — ONE AI read of the filing record. Observed filings only; buy/sell advice rejected at generation. Public-domain SEC EDGAR + AI. $0.10 per call.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.10"},"parameters":[{"name":"ticker","in":"query","required":true,"description":"US-listed stock ticker symbol (e.g. NVDA, AAPL, TSLA)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/tokenized-equities":{"get":{"operationId":"tokenized_equities","summary":"Tokenized US stocks live on Robinhood Chain — address, decimals, tradability","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. Optional `?thesis=` filters the registry to a matched shortlist (per-row match reason + an honesty contract). Informational only; not a quote or a recommendation. Flat JSON, refreshed hourly. $0.001 per call.","tags":["DeFi & Markets Data"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"thesis","in":"query","required":false,"description":"Optional natural-language thesis (e.g. \"semiconductors\", \"AI infrastructure\", \"chinese tech\"). Present → a matched shortlist (relevance-ordered, capped at shortlistCap=12) with a per-row human-readable matchReason plus an honesty contract: matched, matchedCount (score>0 rows across the WHOLE universe — it can exceed the returned rows), fellBackToUniverse, matchedTradableSampled (execution samples among the RETURNED rows). universeSize and tradableSampled keep their universe-level meaning on a thesis read. A no-match/degenerate thesis honestly browses the universe (matched:false, matchedCount:0). Omit → the full registry, byte-compatible with the pre-thesis shape.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/web-search":{"get":{"operationId":"web_search","summary":"Neural web search for agents — find the pages, then /web-extract reads them","description":"Neural web search for agents (Exa upstream): pass a query, get the most relevant live web pages with title, URL, published date, author, relevance score and a clean text snippet as structured JSON. The find-then-read pair for /web-extract — RAG retrieval, research, fact-finding, monitoring. Keyless, pay-per-call, cached by query. A no-match query returns an empty result set as a valid answer.","tags":["Web & Domain Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.009"},"parameters":[{"name":"query","in":"query","required":true,"description":"Free-text web search query (e.g. \"latest ethereum roadmap updates\", \"who founded Anthropic\"). Normalized (whitespace-collapsed, lowercased) so equivalent phrasings share one cached result.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/web-answer":{"get":{"operationId":"web_answer","summary":"Quick cited web answer for agent loops — use /llm-research for deep reports","description":"Quick web answer with citations (Exa upstream): ask one factual or current question and get a concise synthesized answer plus source URLs and publication dates. Optimized for fast lookups and agent loops; use /llm-research for a deeper multi-section research report, reasoning, image analysis, or webpage summarization. Keyless, pay-per-call, cached by query.","tags":["Web & Domain Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.01"},"parameters":[{"name":"query","in":"query","required":true,"description":"One concise factual or current question (max 96 characters), e.g. \"What is EIP-7702?\". Whitespace is collapsed and the cache key is lowercased.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/token-price":{"get":{"operationId":"token_price","summary":"Onchain DEX token price — by symbol or chain:contract address","description":"Live DEX token price in USD by ticker symbol or contract address across Base, Ethereum, Solana, Polygon, BSC, Arbitrum, Optimism and Avalanche (bare 0x defaults to Base, else network:address). Symbols resolve to the canonical top-market-cap asset — squat-proof. Flat JSON: price, 24h change, volume, market cap, FDV, liquidity — echoes the matched deployment. Token price, crypto price, DEX price. $0.001 per call.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"parameters":[{"name":"token","in":"query","required":true,"description":"Ticker symbol (e.g. ETH — resolves to the canonical top-market-cap asset; use address mode for long-tail), contract address (0x… defaults to Base), or network:address (e.g. solana:JUPyiwr…). Networks: base, ethereum, solana, polygon, bsc, arbitrum, optimism, avalanche","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/holder-analytics":{"get":{"operationId":"holder_analytics","summary":"Holder analytics — holder-base stats, whale distribution, concentration + AI risk read","description":"Full holder analytics for any Base ERC-20: total holders with 24h/3d/7d/30d holder-change momentum, whale-tier distribution, acquisition mix (swap vs transfer vs airdrop), top-10/25/50/100 supply share, labeled top holders with concentration (top1/5/10/20% + contract-held%) and an AI concentration-risk read. Bag check, holder analytics, holder concentration, whale distribution. $0.03 per call.","tags":["Market & Token Intelligence"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.03"},"parameters":[{"name":"token","in":"query","required":true,"description":"Base ERC-20 token contract address (0x...). Common symbols also accepted as shorthand: weth, usdc, cbbtc, cbxrp, cbdoge, usol.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/wallet-holdings":{"get":{"operationId":"wallet_holdings","summary":"Wallet bagcheck — Base portfolio with USD values + AI read","description":"Base wallet portfolio breakdown: up to 100 token positions with live USD price and value, portfolio percentage, 24h price change — native ETH included, spam filtered, top 50 returned; truncated:true means the wallet exceeds the 100-position fetched page (totals null then). Plus total value, top-position concentration and an AI bagcheck read. Wallet holdings, wallet portfolio, wallet balance, bagcheck. $0.02 per call.","tags":["Portfolio & Accounts"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.02"},"parameters":[{"name":"wallet","in":"query","required":true,"description":"Wallet address to analyze (0x..., Base network)","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/meta-intelligence":{"post":{"operationId":"meta_intelligence","summary":"Ask the Router — best x402 service for your task","description":"Meta Intelligence (LIVE) — describe what you need and the Router recommends the best x402 services for it, ranked across BOTH Otto's own catalog AND the live CDP Bazaar, each with its real price and a ready-to-call pay_url. Non-custodial: Otto only recommends; you pay each service directly. A flat $0.001 router fee, never a markup on the services it recommends. quality_score reflects live-status + on-chain (x402scan) volume where measured — never fabricated.","tags":["x402 Open Router"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ask":{"type":"string","description":"Natural-language description of the data or service you need"},"price_cap_usd":{"type":"number","description":"Optional: only return candidates at or below this price (USD)"},"network":{"type":"string","description":"Optional: prefer candidates on this CAIP-2 network (e.g. eip155:8453 for Base)"}},"required":["ask"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/full-auto":{"post":{"operationId":"full_auto","summary":"Full Auto — pays the best service on your behalf","description":"Full Auto (LIVE + ARMED) — the hands-off pillar. The Router picks the best-matched service for your ask and pays it on your behalf at-cost, then returns the data. Dynamic per-request price = the chosen service's at-cost price + a $0.001 router fee, charged via an `upto` cap — no prepay, no standing balance, per-call pass-through. Backed by the money-back guarantee (POST /feedback).","tags":["x402 Open Router"],"x-payment-info":{"protocols":["x402"],"pricingMode":"quote"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"ask":{"type":"string","description":"Natural-language description of the task to run end-to-end"},"price_cap_usd":{"type":"number","description":"Optional: hard `upto` cap on total spend for this call (USD)"},"network":{"type":"string","description":"Optional: prefer a CAIP-2 network (e.g. eip155:8453 for Base)"}},"required":["ask"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}},"/feedback":{"post":{"operationId":"feedback","summary":"Feedback & Refunds — the money-back guarantee","description":"Feedback & Refunds (LIVE) — Otto's money-back guarantee. Paid a recommended Otto service (or a Full Auto charge) you didn't like? Send feedback with a >=50-word reason and Otto refunds the service fee + the Meta/router fee (or the whole Full Auto charge), capped $0.01 per transaction, up to 10x per wallet per day, only to the original payer, never more than you paid Otto. Covers Otto's OWN recommended services + Full Auto, not third-party CDP Bazaar picks (no receipt to verify). The $10/day figure is a global system budget, not your personal limit.","tags":["x402 Open Router"],"x-payment-info":{"protocols":["x402"],"pricingMode":"fixed","price":"0.001"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"original_tx_hash":{"type":"string","description":"The 0x… payment tx of the call you are rating (from the X-Payment-Receipt header). Aliases: tx_hash, call_id."},"verdict":{"type":"string","description":"Short verdict label, e.g. \"bad_data\" or \"great\""},"reason":{"type":"string","description":"Why you were dissatisfied — >=50 words required to claim a refund"},"refund_request":{"type":"boolean","description":"Set true to claim a refund (otherwise feedback is recorded without a payout)"}},"required":["original_tx_hash"]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["success","failed"]},"data":{"type":"object","description":"Service-specific response data"}},"required":["status"]}}}},"402":{"description":"Payment Required"}}}}}}