The Stall

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action', 'actor'], 'properties': {'meta': {'type': 'string', 'description': 'freeform context, max 500 chars (optional)'}, 'actor': {'type': 'string', 'description': 'who/what did it â\x80\x94 agent id, wallet, or name'}, 'action': {'type': 'string', 'description': "what was done, e.g. 'sent_quote', 'published_listing', 'completed_job'"}, 'subject': {'type': 'string', 'description': 'what it was done to/for (optional)'}, 'result_hash': {'type': 'string', 'description': 'sha256 of the work product, if any (optional)'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'issued_at': {'type': 'string'}, 'chain_hash': {'type': 'string'}, 'receipt_id': {'type': 'string'}, 'verify_recipe': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'For mode=recent: how many calendar days back to search (default 30, max 365).'}, 'mode': {'enum': ['company', 'recent'], 'type': 'string', 'description': "'company' (default when ticker provided) returns 5%+ shareholders for that ticker. 'recent' returns market-wide Schedule 13D filings in the last N days."}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results to return (default 20, max 50).'}, 'ticker': {'type': 'string', 'description': 'US public company ticker symbol (e.g. TSLA, AAPL, CRM). Case-insensitive. Provide to get 5%+ holders for that specific company.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ticker': {'type': 'string'}, 'company': {'type': 'string'}, 'filings': {'type': 'array'}, 'holders': {'type': 'array'}, 'activist_count': {'type': 'integer'}, 'total_disclosures': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mode': {'enum': ['quick', 'standard', 'deep'], 'type': 'string', 'description': 'Analysis depth. quick: address type + USDC balance + 24h USDC summary. standard: + full USDC transfer history + diversity score + counterparty map. deep: + sybil vanity-lookalike detection + SKIM-leg detection + risk label. Default: standard.'}, 'address': {'type': 'string', 'description': 'Base wallet address to analyze (0x-prefixed, 42 hex chars). EOA or contract. Example: 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'}, 'lookback_blocks': {'type': 'integer', 'maximum': 43200, 'minimum': 1000, 'description': 'Block window for USDC transfer history. Base is approximately 2s/block: 43200 is about 24h. Default and maximum 43200. Larger windows are rejected before scanning; unavailable pages fail instead of reporting incomplete history as complete.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'mode': {'type': 'string'}, 'nonce': {'type': ['integer', 'null']}, 'address': {'type': 'string'}, 'summary': {'type': 'object'}, 'coverage': {'type': 'object', 'description': 'Complete requested block range for both transfer directions; incomplete scans fail instead of reporting false zero activity.'}, 'diversity': {'type': 'object'}, 'skim_legs': {'type': 'array'}, 'risk_label': {'type': 'string'}, 'block_range': {'type': 'object'}, 'address_type': {'type': 'string'}, 'usdc_balance': {'type': ['number', 'null']}, 'counterparties': {'type': 'object'}, 'transfers_sent': {'type': 'array'}, 'lookback_blocks': {'type': 'integer'}, 'sybil_lookalikes': {'type': 'array'}, 'transfers_received': {'type': 'array'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chain': {'type': 'string', 'description': 'Chain name or EIP-155 chain ID. Supported names: ethereum, base, bsc, polygon, arbitrum, optimism, avalanche. Default: ethereum'}, 'address': {'type': 'string', 'description': 'EVM wallet address (0x...)'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'flags': {'type': 'object', 'properties': {'mixer': {'type': ['boolean', 'null']}, 'reinit': {'type': ['boolean', 'null']}, 'fake_kyc': {'type': ['boolean', 'null']}, 'gas_abuse': {'type': ['boolean', 'null']}, 'cybercrime': {'type': ['boolean', 'null']}, 'fake_token': {'type': ['boolean', 'null']}, 'sanctioned': {'type': ['boolean', 'null']}, 'blacklist_doubt': {'type': ['boolean', 'null']}, 'financial_crime': {'type': ['boolean', 'null']}, 'stealing_attack': {'type': ['boolean', 'null']}, 'money_laundering': {'type': ['boolean', 'null']}, 'phishing_activities': {'type': ['boolean', 'null']}, 'blackmail_activities': {'type': ['boolean', 'null']}, 'darkweb_transactions': {'type': ['boolean', 'null']}, 'fake_standard_interface': {'type': ['boolean', 'null']}, 'honeypot_related_address': {'type': ['boolean', 'null']}, 'malicious_mining_activities': {'type': ['boolean', 'null']}}}, 'address': {'type': 'string'}, 'chain_id': {'type': 'string'}, 'risk_label': {'type': 'string', 'description': 'CLEAN | LOW | MEDIUM | HIGH | CRITICAL'}, 'risk_score': {'type': 'integer', 'description': '0 = clean, 100 = critical risk'}, 'is_contract': {'type': ['boolean', 'null']}, 'data_sources': {'type': 'string'}, 'malicious_contracts_created': {'type': ['integer', 'null']}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'Domain or URL to check. Can be a bare domain (example.com) or full URL (https://example.com/path).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ai_txt': {'type': 'object', 'description': 'Parsed .well-known/ai.txt if present.'}, 'domain': {'type': 'string'}, 'reachable': {'type': 'boolean'}, 'robots_txt': {'type': 'object', 'description': 'Parsed robots.txt summary.'}, 'has_sitemap': {'type': 'boolean'}, 'http_status': {'type': 'integer'}, 'sitemap_url': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'agent_verdict': {'type': 'string', 'description': "'OPEN' | 'RESTRICTED' | 'BLOCKED' | 'UNREACHABLE'"}, 'headers_intel': {'type': 'object', 'description': 'Key HTTP headers relevant to agents.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'address': {'type': 'string', 'description': 'EVM wallet address to score (0x-prefixed, 42 chars). Works on any EVM chain â\x80\x94 score is chain-agnostic.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'tier': {'type': 'string', 'description': 'trusted | verified | unknown | suspended'}, 'flags': {'type': 'array', 'items': {'type': 'string'}}, 'limits': {'type': 'object', 'properties': {'max_daily_usd': {'type': 'number'}, 'max_per_tx_usd': {'type': 'number'}}}, 'wallet': {'type': 'object', 'properties': {'tx_count': {'type': 'integer'}, 'has_activity': {'type': 'boolean'}, 'usdc_balance': {'type': 'number'}, 'estimated_age_days': {'type': 'integer'}, 'native_balance_eth': {'type': 'number'}}}, 'address': {'type': 'string'}, 'allowed': {'type': 'boolean', 'description': 'Whether AsterPay would allow transactions from this wallet'}, 'identity': {'type': 'object', 'properties': {'owner': {'type': 'string', 'nullable': True}, 'agent_id': {'type': 'string', 'nullable': True}, 'erc8004_registered': {'type': 'boolean'}}}, 'breakdown': {'type': 'object', 'properties': {'trust_bond': {'type': 'integer'}, 'tx_history': {'type': 'integer'}, 'wallet_age': {'type': 'integer'}, 'operator_kyb': {'type': 'integer'}, 'sanctions_clean': {'type': 'integer'}, 'wallet_activity': {'type': 'integer'}, 'endpoint_quality': {'type': 'integer'}, 'endpoint_signals': {'type': 'integer'}, 'erc8004_identity': {'type': 'integer'}}}, 'checked_at': {'type': 'string'}, 'sanctioned': {'type': 'boolean'}, 'blacklisted': {'type': 'boolean'}, 'trust_score': {'type': 'integer', 'maximum': 100, 'minimum': 0}, 'ttl_seconds': {'type': 'integer'}, 'attestations': {'type': 'object', 'properties': {'coinbase_kyc': {'type': 'boolean'}, 'coinbase_country': {'type': 'boolean'}, 'gitcoin_passport': {'type': 'boolean'}, 'usdc_balance_100': {'type': 'boolean'}}}, 'score_cached': {'type': 'boolean'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'softs': {'type': 'object', 'properties': {'cotton': {'type': 'object'}, 'de_deere': {'type': 'object'}, 'moo_agribiz': {'type': 'object'}, 'coffee_arabica': {'type': 'object'}}, 'description': 'Soft commodity and sector signals.'}, 'grains': {'type': 'object', 'properties': {'corn_usxbu': {'type': 'object'}, 'wheat_usxbu': {'type': 'object'}, 'soy_corn_ratio': {'type': 'number', 'description': 'Soybean/corn price ratio â\x80\x94 crush margin proxy.'}, 'soybeans_usxbu': {'type': 'object'}, 'wheat_corn_spread': {'type': 'number', 'description': 'Wheat/corn price spread in USX/bu.'}}, 'description': 'Real-time grain futures prices.'}, 'livestock': {'type': 'object', 'properties': {'lean_hogs_usxlb': {'type': 'object'}, 'live_cattle_usxlb': {'type': 'object'}}, 'description': 'Real-time livestock futures prices.'}, 'narrative': {'type': 'string', 'description': 'Full ~200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence ag market summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'generated_at': {'type': 'string'}, 'grain_regime': {'type': 'string', 'description': 'grain_rally | grain_pressure | grain_mixed | uncertain'}, 'dominant_risk': {'type': 'string', 'description': 'Most important supply or demand risk.'}, 'livestock_regime': {'type': 'string', 'description': 'livestock_firm | livestock_soft | livestock_neutral | uncertain'}, 'agent_implication': {'type': 'string', 'description': 'Concrete action relevance for AI agents.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'size': {'enum': ['1024x1024', '1024x1792', '1792x1024'], 'type': 'string', 'description': "Image dimensions. '1024x1024' is square (default), '1024x1792' is portrait, '1792x1024' is landscape."}, 'style': {'enum': ['vivid', 'natural'], 'type': 'string', 'description': "Image style. 'vivid' produces hyper-real, dramatic compositions. 'natural' produces softer, more realistic images. Default: vivid."}, 'prompt': {'type': 'string', 'description': 'Text description of the image to generate. Be specific â\x80\x94 include subject, style, lighting, mood, and composition for best results. Max 4000 characters.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'url': {'type': 'string', 'description': 'Public URL of the generated image. Valid for 1 hour â\x80\x94 download promptly.'}, 'size': {'type': 'string'}, 'model': {'type': 'string'}, 'style': {'type': 'string'}, 'duration_ms': {'type': 'integer'}, 'revised_prompt': {'type': ['string', 'null'], 'description': 'The prompt as reinterpreted by DALL-E 3, which may include additional detail.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['task_description'], 'properties': {'schedule': {'type': 'string', 'description': "When to run the pipeline. Accepts: named shortcuts (@hourly, @daily, @weekly, @monthly), natural language ('every 4 hours', 'daily', 'every 30 minutes'), or a raw cron expression (e.g. '0 */4 * * *'). Defaults to hourly if omitted."}, 'model_limit': {'type': 'integer', 'maximum': 10, 'minimum': 3, 'description': 'How many HuggingFace models to consider in the search (3â\x80\x9310). Default: 8.'}, 'pipeline_task': {'type': 'string', 'description': 'Optional HuggingFace pipeline task filter to narrow model search. Common values: text-classification, text-generation, summarization, token-classification, question-answering, sentence-similarity, image-classification, zero-shot-classification.'}, 'task_description': {'type': 'string', 'description': "What the AI pipeline should do. Be specific (e.g. 'classify customer support tickets into 5 categories every 15 minutes' or 'generate daily summaries of earnings call transcripts'). Required."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'gotchas': {'type': 'string'}, 'runner_up': {'type': 'string'}, 'models_found': {'type': 'integer'}, 'schedule_fit': {'type': 'string'}, 'cost_estimate': {'type': 'string'}, 'cron_schedule': {'type': 'object', 'description': 'Resolved cron expression, human description, and validity flag.'}, 'pipeline_steps': {'type': 'array', 'items': {'type': 'string'}}, 'model_rationale': {'type': 'string'}, 'synthesis_error': {'type': 'string'}, 'candidate_models': {'type': 'array', 'description': 'HuggingFace model results (id, task, downloads, likes, library).'}, 'deployment_notes': {'type': 'string'}, 'task_description': {'type': 'string'}, 'top_model_recommendation': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'lat': {'type': 'number', 'maximum': 90, 'minimum': -90, 'description': 'Latitude in decimal degrees (e.g. 40.71 for New York City).'}, 'lon': {'type': 'number', 'maximum': 180, 'minimum': -180, 'description': 'Longitude in decimal degrees (e.g. -74.01 for New York City).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'aqi': {'type': 'object', 'properties': {'color': {'type': 'string', 'description': 'Indicator color: green / yellow / orange / red / purple / maroon'}, 'value': {'type': 'integer', 'description': 'US AQI (0â\x80\x93500)'}, 'category': {'type': 'string', 'description': 'Good / Moderate / Unhealthy for Sensitive Groups / Unhealthy / Very Unhealthy / Hazardous'}}}, 'lat': {'type': 'number'}, 'lon': {'type': 'number'}, 'timezone': {'type': 'string'}, 'uv_index': {'type': 'number', 'description': 'Current UV index (0â\x80\x9311+)'}, 'pollutants': {'type': 'object', 'properties': {'dust': {'type': 'number', 'description': 'Dust concentration (µg/m³)'}, 'pm10': {'type': 'number', 'description': 'PM10 coarse particles (µg/m³)'}, 'ozone': {'type': 'number', 'description': 'Oâ\x82\x83 (µg/m³)'}, 'pm2_5': {'type': 'number', 'description': 'PM2.5 fine particles (µg/m³)'}, 'carbon_monoxide': {'type': 'number', 'description': 'CO (µg/m³)'}, 'nitrogen_dioxide': {'type': 'number', 'description': 'NOâ\x82\x82 (µg/m³)'}}}, 'elevation_m': {'type': 'number'}, 'measured_at': {'type': 'string', 'description': 'ISO-8601 local time'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'name': {'type': 'string', 'description': 'Company name.'}, 'trend': {'type': 'array', 'items': {'type': 'object', 'properties': {'buy': {'type': 'integer'}, 'hold': {'type': 'integer'}, 'sell': {'type': 'integer'}, 'total': {'type': 'integer'}, 'period': {'type': 'string'}, 'strong_buy': {'type': 'integer'}, 'strong_sell': {'type': 'integer'}}}, 'description': 'Rating distribution for current and prior 3 months (period 0m=current, -1m, -2m, -3m).'}, 'ticker': {'type': 'string', 'description': 'Canonical ticker symbol.'}, 'consensus': {'type': 'string', 'description': 'Analyst consensus label: Strong Buy, Buy, Hold, Sell, or Strong Sell.'}, 'target_low': {'type': 'number', 'description': 'Lowest analyst price target (USD).'}, 'upside_pct': {'type': 'number', 'description': 'Upside to mean target from current price (%).'}, 'target_high': {'type': 'number', 'description': 'Highest analyst price target (USD).'}, 'target_mean': {'type': 'number', 'description': 'Mean analyst price target (USD).'}, 'analyst_count': {'type': 'integer', 'description': 'Number of analysts providing coverage.'}, 'price_current': {'type': 'number', 'description': 'Current stock price in USD.'}, 'target_median': {'type': 'number', 'description': 'Median analyst price target (USD).'}, 'consensus_score': {'type': 'number', 'description': 'Mean recommendation score (1=Strong Buy, 3=Hold, 5=Strong Sell).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'description': 'How many calendar days back to include. Default 90, max 365.'}, 'limit': {'type': 'integer', 'description': 'Max entries to return. Default 20, max 50.'}, 'action': {'enum': ['all', 'upgrade', 'downgrade', 'initiate'], 'type': 'string', 'description': "Filter by action type. Default 'all'."}, 'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'days': {'type': 'integer'}, 'name': {'type': 'string'}, 'ticker': {'type': 'string'}, 'changes': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string', 'description': 'ISO date of rating change (YYYY-MM-DD).'}, 'firm': {'type': 'string'}, 'action': {'type': 'string', 'description': 'Upgrade | Downgrade | Initiate | Maintain | Reiterate'}, 'to_grade': {'type': 'string', 'description': 'New rating.'}, 'from_grade': {'type': 'string', 'description': 'Prior rating (null if initiation).'}}}}, 'upgrades': {'type': 'integer', 'description': 'Count of upgrades in window.'}, 'downgrades': {'type': 'integer', 'description': 'Count of downgrades in window.'}, 'initiations': {'type': 'integer', 'description': 'Count of new coverage initiations in window.'}, 'total_shown': {'type': 'integer'}, 'net_sentiment': {'type': 'integer', 'description': 'Upgrades minus downgrades. Positive = bullish analyst momentum.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'app': {'type': 'string', 'description': "(lookup) App name to look up, e.g. 'Notion', 'Robinhood'."}, 'chart': {'enum': ['free', 'paid'], 'type': 'string', 'description': "(top_charts) Chart type: 'free' or 'paid'. Default: free."}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max results to return. Default: 10 for search, 25 for top_charts.'}, 'query': {'type': 'string', 'description': "(search) Keyword or app topic to search for, e.g. 'budget tracker', 'AI assistant'."}, 'action': {'enum': ['search', 'lookup', 'top_charts'], 'type': 'string', 'description': 'Action to perform. Default: top_charts, which returns the current top free apps without requiring a query.'}, 'app_id': {'type': 'string', 'description': '(lookup) Apple App ID (numeric), e.g. 1234567890.'}, 'country': {'type': 'string', 'description': '(search/lookup) ISO 2-letter country code for App Store region. Default: us.'}, 'category': {'type': 'string', 'description': '(top_charts) App Store category. Options: all, finance, productivity, business, developer-tools, games, health-fitness, education, social, utilities, news, music, travel, shopping, lifestyle, weather, photo-video, entertainment, sports, medical, food-drink, reference, navigation, graphics-design. Default: all.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'apps': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'rank': {'type': 'number'}, 'apple_id': {'type': ['string', 'null']}, 'category': {'type': 'string'}, 'developer': {'type': 'string'}, 'price_usd': {'type': 'number'}, 'price_label': {'type': 'string'}, 'app_store_url': {'type': 'string'}}}, 'description': 'Apps from top_charts.'}, 'query': {'type': 'string'}, 'action': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'rating': {'type': ['number', 'null'], 'description': 'Average user rating (1.0â\x80\x935.0).'}, 'apple_id': {'type': 'number'}, 'category': {'type': 'string'}, 'developer': {'type': 'string'}, 'price_usd': {'type': 'number'}, 'price_label': {'type': 'string'}, 'install_tier': {'type': 'string', 'description': 'Estimated install tier from rating count.'}, 'last_updated': {'type': 'string'}, 'rating_count': {'type': 'number'}, 'app_store_url': {'type': 'string'}, 'current_version': {'type': 'string'}}}, 'description': 'Apps from a search.'}, 'freshness': {'enum': ['recently_updated', 'active', 'stable', 'stale', 'unknown'], 'type': 'string', 'description': 'Update recency for lookup action.'}, 'result_count': {'type': 'number'}, 'rating_health': {'enum': ['excellent', 'strong', 'average', 'poor', 'critical', 'unknown'], 'type': 'string', 'description': 'Rating quality signal for lookup action.'}, 'market_snapshot': {'type': 'object', 'properties': {'free_pct': {'type': 'number', 'description': '% of results that are free.'}, 'avg_rating': {'type': ['number', 'null']}, 'categories': {'type': 'array'}}}, 'description_excerpt': {'type': ['string', 'null']}, 'release_notes_excerpt': {'type': ['string', 'null']}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'sort': {'enum': ['relevance', 'lastUpdatedDate', 'submittedDate'], 'type': 'string', 'description': 'Sort order. relevance = arXiv relevance score; lastUpdatedDate = most recently updated; submittedDate = newest submissions first. Default: relevance.'}, 'field': {'enum': ['all', 'title', 'abstract', 'author'], 'type': 'string', 'description': "Which field to search. 'all' searches title+abstract+authors. Default: all."}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of papers to return (1â\x80\x9310). Default: 5.'}, 'query': {'type': 'string', 'description': "Search terms (e.g. 'diffusion models image generation', 'transformer attention mechanism', 'graph neural networks'). Natural language or keywords."}, 'category': {'type': 'string', 'description': "arXiv category filter (e.g. 'cs.AI', 'cs.LG', 'stat.ML', 'quant-ph', 'math.CO'). Optional."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'query': {'type': 'string'}, 'papers': {'type': 'array', 'items': {'type': 'object', 'properties': {'title': {'type': 'string'}, 'authors': {'type': 'array', 'items': {'type': 'string'}}, 'pdf_url': {'type': 'string'}, 'updated': {'type': 'string'}, 'abstract': {'type': 'string'}, 'arxiv_id': {'type': 'string'}, 'arxiv_url': {'type': 'string'}, 'published': {'type': 'string'}, 'categories': {'type': 'array', 'items': {'type': 'string'}}, 'primary_category': {'type': 'string'}}}}, 'generated_at': {'type': 'string'}, 'total_results': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url', 'source_rights_confirmed'], 'properties': {'url': {'type': 'string', 'description': 'Public URL of the audio file to transcribe (mp3, mp4, m4a, wav, webm, ogg, flac, wma). Must be directly accessible without authentication. Max 24 MB. This route accepts audio between 5 and 15 minutes (300-900s) duration only.'}, 'language': {'type': 'string', 'description': "Optional ISO 639-1 language code hint (e.g. 'en', 'es', 'fr', 'de', 'ja'). Improves accuracy when the audio language is known. Omit to auto-detect."}, 'source_rights_confirmed': {'type': 'boolean', 'const': True, 'description': 'Required confirmation that the caller owns the audio or is authorized to have it transcribed.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'model': {'type': 'string'}, 'language': {'type': 'string'}, 'duration_s': {'type': 'number'}, 'source_url': {'type': 'string'}, 'transcript': {'type': 'string'}, 'word_count': {'type': 'integer'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url', 'source_rights_confirmed'], 'properties': {'url': {'type': 'string', 'description': 'Public URL of the audio file to transcribe (mp3, mp4, m4a, wav, webm, ogg, flac, wma). Must be directly accessible without authentication. Max 24 MB. This route accepts audio between 15 and 30 minutes (900-1800s) duration only.'}, 'language': {'type': 'string', 'description': "Optional ISO 639-1 language code hint (e.g. 'en', 'es', 'fr', 'de', 'ja'). Improves accuracy when the audio language is known. Omit to auto-detect."}, 'source_rights_confirmed': {'type': 'boolean', 'const': True, 'description': 'Required confirmation that the caller owns the audio or is authorized to have it transcribed.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'model': {'type': 'string'}, 'language': {'type': 'string'}, 'duration_s': {'type': 'number'}, 'source_url': {'type': 'string'}, 'transcript': {'type': 'string'}, 'word_count': {'type': 'integer'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['url', 'source_rights_confirmed'], 'properties': {'url': {'type': 'string', 'description': 'Public URL of the audio file to transcribe (mp3, mp4, m4a, wav, webm, ogg, flac, wma). Must be directly accessible without authentication. Max 24 MB. This route accepts audio up to 5 minutes (300s) duration only.'}, 'language': {'type': 'string', 'description': "Optional ISO 639-1 language code hint (e.g. 'en', 'es', 'fr', 'de', 'ja'). Improves accuracy when the audio language is known. Omit to auto-detect."}, 'source_rights_confirmed': {'type': 'boolean', 'const': True, 'description': 'Required confirmation that the caller owns the audio or is authorized to have it transcribed.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'model': {'type': 'string'}, 'language': {'type': 'string'}, 'duration_s': {'type': 'number'}, 'source_url': {'type': 'string'}, 'transcript': {'type': 'string'}, 'word_count': {'type': 'integer'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'airport': {'type': 'string', 'description': 'Airport code: 3-letter IATA (e.g. JFK, LHR, SYD) or 4-letter ICAO (e.g. KJFK, EGLL, YSSY).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 query timestamp.'}, 'taf': {'type': 'object', 'properties': {'raw': {'type': ['string', 'null'], 'description': 'Raw TAF string.'}, 'valid_to': {'type': ['string', 'null'], 'description': 'Valid period end ISO-8601.'}, 'issued_at': {'type': ['string', 'null'], 'description': 'TAF issue time ISO-8601.'}, 'valid_from': {'type': ['string', 'null'], 'description': 'Valid period start ISO-8601.'}, 'forecast_periods': {'type': 'array', 'description': 'Array of forecast change groups.'}}, 'description': 'Most recent Terminal Aerodrome Forecast.'}, 'metar': {'type': 'object', 'properties': {'raw': {'type': ['string', 'null'], 'description': 'Raw METAR string.'}, 'temp_c': {'type': ['number', 'null'], 'description': 'Temperature °C.'}, 'wind_dir': {'type': ['number', 'null'], 'description': 'Wind direction degrees.'}, 'ceiling_ft': {'type': ['number', 'null'], 'description': 'Lowest BKN/OVC/VV layer AGL in feet.'}, 'dewpoint_c': {'type': ['number', 'null'], 'description': 'Dewpoint °C.'}, 'observed_at': {'type': ['string', 'null'], 'description': 'ISO-8601 observation time.'}, 'wind_gust_kt': {'type': ['number', 'null'], 'description': 'Wind gust knots (null if calm).'}, 'altimeter_hPa': {'type': ['number', 'null'], 'description': 'Altimeter setting hPa.'}, 'visibility_sm': {'type': ['string', 'number', 'null'], 'description': 'Visibility statute miles.'}, 'wind_speed_kt': {'type': ['number', 'null'], 'description': 'Wind speed knots.'}, 'sky_conditions': {'type': 'array', 'description': 'Cloud layers array.'}, 'flight_category': {'type': ['string', 'null'], 'description': 'VFR | MVFR | IFR | LIFR.'}, 'weather_phenomena': {'type': ['string', 'null'], 'description': 'Wx codes (e.g. -TSRA, VCTS).'}}, 'description': 'Most recent METAR observation.'}, 'airport_icao': {'type': 'string', 'description': 'Resolved 4-letter ICAO code.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'limit': {'type': 'integer', 'maximum': 8, 'minimum': 1, 'description': 'Periods to return; default 4.'}, 'period': {'enum': ['quarterly', 'annual'], 'type': 'string', 'description': 'Defaults to quarterly. Annual uses annual filing forms only.'}, 'ticker': {'type': 'string', 'description': 'US-listed company ticker, such as AAPL or MSFT.'}, 'known_latest_period_end': {'type': 'string', 'description': 'Optional prior latest_period_end. The response reports whether a newer filing period is available.'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'cik': '0000320193', 'source': 'SEC EDGAR Companyfacts (data.sec.gov)', 'ticker': 'AAPL', 'periods': [{'cash': 39544000000, 'filed_at': '2026-07-31', 'net_cash': -19948000000, 'net_debt': 19948000000, 'book_value': 107520000000, 'period_end': '2026-06-27', 'total_debt': 82347000000, 'total_assets': 383266000000, 'current_assets': 149818000000, 'working_capital': 492000000, 'retained_earnings': 11326000000, 'total_liabilities': 275746000000, 'shares_outstanding': None, 'current_liabilities': 149326000000, 'stockholders_equity': 107520000000, 'tangible_book_value': None, 'goodwill_intangibles': None, 'short_term_investments': 22855000000}, {'cash': 45572000000, 'filed_at': '2026-07-31', 'net_cash': -14207000000, 'net_debt': 14207000000, 'book_value': 106491000000, 'period_end': '2026-03-28', 'total_debt': 82714000000, 'total_assets': 371082000000, 'current_assets': 144114000000, 'working_capital': 9473000000, 'retained_earnings': 12359000000, 'total_liabilities': 264591000000, 'shares_outstanding': None, 'current_liabilities': 134641000000, 'stockholders_equity': 106491000000, 'tangible_book_value': None, 'goodwill_intangibles': None, 'short_term_investments': 22935000000}, {'cash': 45317000000, 'filed_at': '2026-05-01', 'net_cash': -21605000000, 'net_debt': 21605000000, 'book_value': 88190000000, 'period_end': '2025-12-27', 'total_debt': 88512000000, 'total_assets': 379297000000, 'current_assets': 158104000000, 'working_capital': -4263000000, 'retained_earnings': -2177000000, 'total_liabilities': 291107000000, 'shares_outstanding': None, 'current_liabilities': 162367000000, 'stockholders_equity': 88190000000, 'tangible_book_value': None, 'goodwill_intangibles': None, 'short_term_investments': 21590000000}, {'cash': 35934000000, 'filed_at': '2026-07-31', 'net_cash': -35981000000, 'net_debt': 35981000000, 'book_value': 73733000000, 'period_end': '2025-09-27', 'total_debt': 90678000000, 'total_assets': 359241000000, 'current_assets': 147957000000, 'working_capital': -17674000000, 'retained_earnings': -14264000000, 'total_liabilities': 285508000000, 'shares_outstanding': None, 'current_liabilities': 165631000000, 'stockholders_equity': 73733000000, 'tangible_book_value': None, 'goodwill_intangibles': None, 'short_term_investments': 18763000000}], 'currency': 'USD', 'period_type': 'quarterly', 'company_name': 'Apple Inc.', 'retrieved_at': '2026-09-22T08:12:35.855Z', 'latest_period_end': '2026-06-27', 'next_poll_after_utc': '2026-09-23T08:12:35.855Z', 'changed_since_known_period': None, 'recommended_poll_interval_hours': 24}], 'properties': {'cik': {'type': 'string'}, 'source': {'type': 'string'}, 'ticker': {'type': 'string'}, 'periods': {'type': 'array', 'items': {'type': 'object'}}, 'currency': {'type': 'string'}, 'period_type': {'type': 'string'}, 'company_name': {'type': ['string', 'null']}, 'retrieved_at': {'type': 'string'}, 'latest_period_end': {'type': ['string', 'null']}, 'next_poll_after_utc': {'type': 'string'}, 'changed_since_known_period': {'type': ['boolean', 'null']}, 'recommended_poll_interval_hours': {'type': 'integer'}}, 'x-stall-example-provenance': {'kind': 'historical verified diagnostic response', 'resources': [{'host': 'www.sec.gov', 'path': '/files/company_tickers.json', 'bytes': 800703, 'sha256': '0cadb1f058f136b0d443e16d1beddaf792033890bd465993e593b09172b43f27', 'status': 200, 'observed_at': '2026-09-22T08:12:35.516Z'}, {'host': 'data.sec.gov', 'path': '/api/xbrl/companyfacts/CIK0000320193.json', 'bytes': 3789099, 'sha256': '73a86c6aedc31f77cac2ea4df5f80f0b3bd7e6eb58bb4e01444fbedf3afb9c43', 'status': 200, 'observed_at': '2026-09-22T08:12:35.817Z'}], 'observed_at': '2026-09-22T08:12:35.855Z', 'current_data': False, 'output_sha256': '4d337e145446992cdde2b3fde6c754178997bc98bdb530f3dd4b5706e07d56ba', 'source_sha256': 'ff229f1cd3efdf1628323a556b8cf84db248f97758dbcf7f91c9981868f0219c'}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'top_tokens': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'symbol': {'type': 'string'}, 'price_usd': {'type': 'number'}, 'change_24h': {'type': 'number'}, 'market_cap': {'type': 'number'}, 'volume_24h': {'type': 'number'}}}, 'description': 'Top Base ecosystem tokens by market cap (CoinGecko).'}, 'chain_tvl_usd': {'type': 'number', 'description': 'Total Base chain TVL in USD.'}, 'season_signal': {'type': 'string', 'description': "Human-readable 1-line season summary (e.g. 'Lending dominates, DEX TVL declining 7d')."}, 'top_protocols': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'tvl_usd': {'type': 'number'}, 'category': {'type': 'string'}, 'change_7d': {'type': 'number'}}}, 'description': 'Top 10 protocols by Base-native TVL.'}, 'chain_tvl_change': {'type': 'number', 'description': 'Percentage TVL change vs previous day (positive = growth).'}, 'category_breakdown': {'type': 'array', 'items': {'type': 'object', 'properties': {'tvl_usd': {'type': 'number'}, 'category': {'type': 'string'}}}, 'description': 'DeFi category aggregates: total TVL on Base per category.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'block': {'type': 'string', 'description': "Block identifier: 'latest' (default), 'safe', 'finalized', 'earliest', decimal block number, or 0x-prefixed hex number."}, 'network': {'type': 'string', 'description': "Chain to query: 'base' (default), 'ethereum', or 'arbitrum'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'hash': {'type': 'string', 'description': 'Block hash (0x-prefixed).'}, 'number': {'type': 'integer', 'description': 'Block number (decimal).'}, 'network': {'type': 'string', 'description': 'Chain queried.'}, 'gas_used': {'type': 'integer', 'description': 'Gas used in this block (decimal).'}, 'tx_count': {'type': 'integer', 'description': 'Number of transactions in the block.'}, 'gas_limit': {'type': 'integer', 'description': 'Block gas limit (decimal).'}, 'timestamp': {'type': 'string', 'description': 'Block timestamp as ISO-8601 UTC.'}, 'validator': {'type': 'string', 'description': 'Block proposer / miner address.'}, 'parent_hash': {'type': 'string', 'description': 'Parent block hash.'}, 'gas_used_pct': {'type': 'number', 'description': 'Gas used as % of gas limit (0â\x80\x93100).'}, 'base_fee_gwei': {'type': 'number', 'description': 'Base fee per gas in gwei (EIP-1559; null for pre-London blocks).'}, 'timestamp_unix': {'type': 'integer', 'description': 'Block timestamp as Unix epoch seconds.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'credit': {'type': 'object', 'properties': {'hy_bp': {'type': 'number', 'description': 'HY OAS in basis points.'}, 'ig_bp': {'type': 'number', 'description': 'IG OAS in basis points.'}, 'hy_oas': {'type': 'number', 'description': 'High Yield OAS (%). Multiply by 100 for basis points.'}, 'ig_oas': {'type': 'number', 'description': 'Investment Grade OAS (%).'}, 'hy_ig_diff': {'type': 'number', 'description': 'HY-IG differential (pure sub-IG premium, %).'}, 'credit_regime': {'type': 'string', 'description': 'TIGHT | NORMAL | WIDE | STRESS'}}, 'description': 'Corporate credit spread environment.'}, 'narrative': {'type': 'string', 'description': 'Full ~200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence rate environment summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'real_rates': {'type': 'object', 'properties': {'real_rate_10y': {'type': 'number', 'description': 'Nominal 10Y minus breakeven (%). Positive = restrictive.'}, 'real_rate_env': {'type': 'string', 'description': 'DEEPLY_NEGATIVE | NEGATIVE | NEAR_ZERO | POSITIVE'}, 'tips_real_yield_10y': {'type': 'number', 'description': '10Y TIPS real yield (%). Positive = tight real money.'}, 'breakeven_inflation_10y': {'type': 'number', 'description': '10Y breakeven inflation rate (%). Market inflation expectation.'}}, 'description': 'Inflation-adjusted rate environment.'}, 'yield_curve': {'type': 'object', 'properties': {'y2y': {'type': 'number', 'description': '2-Year Treasury yield (%).'}, 'y3m': {'type': 'number', 'description': '3-Month T-Bill yield (%).'}, 'y5y': {'type': 'number', 'description': '5-Year Treasury yield (%).'}, 'y10y': {'type': 'number', 'description': '10-Year Treasury yield (%). Primary DCF anchor.'}, 'y30y': {'type': 'number', 'description': '30-Year Treasury yield (%).'}, 'curve_shape': {'type': 'string', 'description': 'INVERTED | FLAT | NORMAL | STEEP'}, 'spread_10y_3m': {'type': 'number', 'description': '10Y-3M spread (bp). Estrella-Mishkin recession model input.'}, 'spread_2y_10y': {'type': 'number', 'description': '2Y-10Y spread (bp). Negative = inverted curve (recession signal).'}}, 'description': 'Treasury yield curve snapshot.'}, 'generated_at': {'type': 'string'}, 'dominant_driver': {'type': 'string', 'description': 'Main force shaping rates today.'}, 'rate_environment': {'type': 'string', 'description': 'RECESSION_RISK_HIGH | INVERTED_CURVE_NORMAL_CREDIT | TIGHT_FINANCIAL_CONDITIONS | ACCOMMODATIVE | STEEPENING_EASY_MONEY | CREDIT_STRESS | NEUTRAL'}, 'agent_implication': {'type': 'string', 'description': 'Concrete action relevance for AI agents.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': "Full URL to extract breadcrumbs from (e.g. 'https://docs.example.com/api/v2/users/123/profile')."}, 'separator': {'type': 'string', 'description': "Breadcrumb separator string (default: ' > ')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'url': {'type': 'string'}, 'path': {'type': 'string'}, 'depth': {'type': 'integer', 'description': 'Path depth (number of segments).'}, 'domain': {'type': 'string'}, 'fragment': {'type': 'string'}, 'protocol': {'type': 'string'}, 'segments': {'type': 'array', 'description': 'Ordered path segments with labels.'}, 'subdomain': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'query_params': {'type': 'object', 'description': 'Query string parameters as key-value pairs.'}, 'breadcrumb_trail': {'type': 'string', 'description': 'Formatted breadcrumb string.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'connectivity_gamma': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': 'Assumed fraction of honest miners who extend the selfish chain when block heights are equal (0â\x80\x931). Higher γ means better-connected selfish miner. Default 0 (worst-case for honest miners).'}, 'efficiency_w_per_th': {'type': 'number', 'minimum': 1, 'description': 'Assumed ASIC power efficiency in W/TH. Default 20 (representative of modern S21/M60 hardware). Lower = more efficient attackers.'}, 'electricity_kwh_usd': {'type': 'number', 'minimum': 0.001, 'description': 'Assumed electricity cost in $/kWh for 51%-attack cost estimate. Default 0.07.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'network': {'type': 'object', 'properties': {'block_height': {'type': 'integer'}, 'btc_price_usd': {'type': 'number'}, 'hash_rate_ehs': {'type': 'number', 'description': 'Current network hash rate in EH/s.'}}}, 'game_theory': {'type': 'object', 'properties': {'subsidy_btc_day': {'type': 'number', 'description': 'Block subsidy in BTC per day.'}, 'fee_subsidy_ratio': {'type': 'number', 'description': 'Ratio of fee revenue to total miner revenue (0â\x80\x931). Near 0 = subsidy-dependent; near 1 = fee-driven security.'}, 'attack_cost_24h_usd': {'type': 'number', 'description': '24-hour sustained attack cost (electricity only).'}, 'fee_revenue_btc_day': {'type': 'number', 'description': 'Fee revenue in BTC per day (last ~144 blocks).'}, 'selfish_mining_threshold_pct': {'type': 'number', 'description': 'Minimum pool share (%) needed for selfish mining to be profitable given γ.'}, 'attack_cost_51pct_per_hour_usd': {'type': 'number', 'description': 'Estimated electricity cost in USD to sustain a 51% attack for one hour.'}, 'honest_mining_nash_equilibrium': {'type': 'boolean', 'description': 'True when no known public pool approaches the selfish-mining threshold.'}}}, 'generated_at': {'type': 'string'}, 'systems_theory': {'type': 'object', 'properties': {'security_trend': {'type': 'string', 'description': 'Brief narrative of current security posture.'}, 'economy_fee_sat_vb': {'type': 'integer'}, 'fastest_fee_sat_vb': {'type': 'integer'}, 'fee_pressure_state': {'enum': ['HIGH', 'MEDIUM', 'LOW'], 'type': 'string', 'description': 'Current mempool fee pressure: HIGH >20 sat/vB, MEDIUM 5â\x80\x9320, LOW <5.'}, 'blocks_until_retarget': {'type': 'integer'}, 'difficulty_loop_state': {'enum': ['EXPANDING', 'CONTRACTING', 'NEUTRAL'], 'type': 'string', 'description': 'Hash-rate loop: EXPANDING (more miners joining), CONTRACTING (miners leaving), NEUTRAL (<2% change).'}, 'estimated_retarget_date': {'type': 'string', 'description': 'ISO-8601 estimated next difficulty adjustment.'}, 'difficulty_epoch_progress_pct': {'type': 'number'}, 'difficulty_projected_change_pct': {'type': 'number', 'description': 'Projected difficulty change at next retarget (negative = easing, positive = tightening).'}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'include': {'enum': ['all', 'fees', 'difficulty', 'pools', 'mempool'], 'type': 'string', 'description': "Subset of data to return. 'all' returns every section (default). 'fees' = fee market only. 'difficulty' = next adjustment info only. 'pools' = pool hashrate distribution only. 'mempool' = backlog size only."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'pools': {'type': 'object', 'description': 'Mining pool hashrate concentration (1-week window).'}, 'mempool': {'type': 'object', 'description': 'Current unconfirmed transaction backlog.'}, 'difficulty': {'type': 'object', 'description': 'Next difficulty adjustment forecast.'}, 'fee_market': {'type': 'object', 'description': 'Current fee rates and market pressure.'}, 'block_height': {'type': 'integer', 'description': 'Current Bitcoin chain tip block height.'}, 'generated_at': {'type': 'string', 'description': 'ISO-8601 timestamp of this snapshot.'}, 'miner_revenue': {'type': 'object', 'description': "Today's miner revenue split (subsidy vs fees)."}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'pool_window': {'enum': ['24h', '3d', '1w', '1m'], 'type': 'string', 'description': 'Rolling window for mining pool distribution. Default: 1w.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'meta': {'type': 'object', 'properties': {'block_height': {'type': 'integer'}, 'data_sources': {'type': 'array', 'items': {'type': 'string'}}, 'generated_at': {'type': 'string'}}}, 'lens_3_delays': {'type': 'object', 'properties': {'economy_fee_sat_vb': {'type': 'integer'}, 'priority_fee_sat_vb': {'type': 'integer'}, 'est_economy_confirm_minutes': {'type': 'integer'}, 'est_priority_confirm_minutes': {'type': 'integer'}}, 'description': 'Transaction confirmation latency at different fee tiers.'}, 'lens_1_feedback': {'type': 'object', 'properties': {'state': {'enum': ['TIGHTENING', 'EASING', 'NEUTRAL'], 'type': 'string'}, 'retarget_eta_iso': {'type': 'string'}, 'blocks_to_retarget': {'type': 'integer'}, 'epoch_progress_pct': {'type': 'number'}, 'regulator_lag_days': {'type': 'number', 'description': 'Estimated days until adjustment corrects current hash-rate divergence.'}, 'projected_change_pct': {'type': 'number'}}, 'description': 'Difficulty adjustment as the dominant feedback regulator.'}, 'lens_5_nakamoto': {'type': 'object', 'properties': {'pool_window': {'type': 'string'}, 'total_pools': {'type': 'integer'}, 'top_pool_name': {'type': 'string'}, 'top_3_share_pct': {'type': 'number', 'description': 'Combined share of 3 largest pools (%).'}, 'top_pool_share_pct': {'type': 'number'}, 'nakamoto_coefficient': {'type': 'integer'}}, 'description': 'Minimum number of mining pools that could collude to exceed 50% of blocks.'}, 'lens_7_resilience': {'type': 'object', 'properties': {'hhi': {'type': 'integer', 'description': 'Herfindahl-Hirschman Index (0â\x80\x9310000). <1500 competitive; >2500 concentrated.'}, 'hhi_interpretation': {'type': 'string'}, 'resilience_summary': {'type': 'string'}, 'decentralization_grade': {'enum': ['A', 'B', 'C', 'D', 'F'], 'type': 'string'}}, 'description': 'Network concentration and decentralization health.'}, 'lens_2_stocks_flows': {'type': 'object', 'properties': {'flow_pressure': {'enum': ['HIGH', 'MEDIUM', 'LOW'], 'type': 'string'}, 'blocks_to_clear': {'type': 'number', 'description': 'Estimated blocks to clear mempool at current throughput.'}, 'mempool_fee_btc': {'type': 'number'}, 'mempool_tx_count': {'type': 'integer'}, 'mempool_vsize_mb': {'type': 'number'}}, 'description': 'Mempool as stock; block throughput as flow.'}, 'lens_4_nonlinearity': {'type': 'object', 'properties': {'hashrate_trend_ehs': {'type': 'number', 'description': 'Current 1-month average hash rate in EH/s.'}, 'hashrate_growth_state': {'enum': ['ACCELERATING', 'STEADY', 'DECELERATING'], 'type': 'string'}, 'fee_nonlinearity_ratio': {'type': 'number', 'description': 'Ratio of fastest-to-economy fee rate. >4 = high nonlinearity (congestion premium); <2 = linear.'}}, 'description': 'Degree of nonlinear amplification in fee market and hash-rate growth.'}, 'lens_6_self_organization': {'type': 'object', 'properties': {'self_org_score': {'type': 'integer', 'description': '0â\x80\x93100 score: 100 = perfectly competitive fee market with many equally-sized pools.'}, 'dominant_cluster': {'type': 'string', 'description': 'Name of the largest emerging mining entity.'}, 'fee_market_state': {'enum': ['EQUILIBRIUM', 'BACKLOGGED', 'UNDERLOADED'], 'type': 'string'}, 'avg_fee_delta_sat': {'type': 'number', 'description': 'Mean deviation between expected and actual fees in mempool (sat). Near 0 = equilibrium.'}}, 'description': 'Fee market equilibrium and pool emergence patterns.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, MSFT, AMZN). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'fcf': {'type': 'object', 'properties': {'fcf_bn': {'type': ['number', 'null'], 'description': 'Free cash flow in $B (OCF â\x88\x92 CapEx).'}, 'capex_bn': {'type': ['number', 'null'], 'description': 'Capital expenditures (absolute) in $B.'}, 'fcf_signal': {'type': 'string', 'description': 'STRONG (>6%) | HEALTHY (3â\x80\x936%) | POSITIVE (0â\x80\x933%) | NEGATIVE | UNKNOWN'}, 'fcf_yield_pct': {'type': ['number', 'null'], 'description': 'FCF yield % (FCF / Market Cap).'}, 'operating_cf_bn': {'type': ['number', 'null'], 'description': 'Operating cash flow in $B.'}}, 'description': 'Free cash flow and FCF yield.'}, 'roic': {'type': 'object', 'properties': {'nopat_bn': {'type': ['number', 'null'], 'description': 'Net Operating Profit After Tax in $B.'}, 'roic_pct': {'type': ['number', 'null'], 'description': 'ROIC % (NOPAT / Invested Capital). >15% excellent, >10% good, >5% adequate, <0% value-destroying.'}, 'net_debt_bn': {'type': ['number', 'null'], 'description': 'Net Debt ($B) = Total Debt â\x88\x92 Cash.'}, 'roic_signal': {'type': 'string', 'description': 'EXCEPTIONAL | EXCELLENT | GOOD | ADEQUATE | BELOW_COC | VALUE_DESTROYING | INSUFFICIENT_DATA'}, 'invested_capital_bn': {'type': ['number', 'null'], 'description': 'Invested Capital ($B) = Equity + Net Debt.'}, 'effective_tax_rate_pct': {'type': ['number', 'null'], 'description': 'Effective tax rate used in NOPAT calculation (%).'}}, 'description': 'Return on Invested Capital breakdown.'}, 'grade': {'type': 'string', 'description': 'Capital allocation quality: A (compounder) / B (good) / C (adequate) / D (marginal) / F (value destroyer) / N/A (insufficient data).'}, 'ticker': {'type': 'string'}, 'grade_score': {'type': ['integer', 'null'], 'description': 'Raw score 0â\x80\x938 underlying the letter grade.'}, 'retrieved_at': {'type': 'string'}, 'market_cap_bn': {'type': ['number', 'null'], 'description': 'Market capitalization in $B.'}, 'grade_rationale': {'type': 'string', 'description': 'One-sentence explanation of the grade.'}, 'statement_period': {'type': ['string', 'null'], 'description': 'Most recent annual statement end date (YYYY-MM-DD).'}, 'shareholder_yield': {'type': 'object', 'properties': {'buybacks_bn': {'type': ['number', 'null'], 'description': 'Stock repurchases in $B.'}, 'div_yield_pct': {'type': ['number', 'null'], 'description': 'Dividend yield % (Dividends / Market Cap).'}, 'buyback_yield_pct': {'type': ['number', 'null'], 'description': 'Buyback yield % (Repurchases / Market Cap).'}, 'dividends_paid_bn': {'type': ['number', 'null'], 'description': 'Cash dividends paid in $B.'}, 'shareholder_return_signal': {'type': 'string', 'description': 'AGGRESSIVE_RETURN (>8%) | GENEROUS_RETURN (4â\x80\x938%) | MODEST_RETURN (1â\x80\x934%) | MINIMAL_RETURN (<1%)'}, 'total_shareholder_yield_pct': {'type': ['number', 'null'], 'description': 'Total shareholder yield % = Dividend Yield + Buyback Yield.'}}, 'description': 'Cash returned to shareholders via dividends and buybacks.'}, 'capex_reinvestment': {'type': 'object', 'properties': {'da_bn': {'type': ['number', 'null'], 'description': 'D&A in $B (maintenance capex proxy).'}, 'capex_bn': {'type': ['number', 'null'], 'description': 'Absolute CapEx in $B.'}, 'reinvestment_rate': {'type': ['number', 'null'], 'description': 'Net Investment / NOPAT. >0 growing asset base; <0 harvesting.'}, 'capex_intensity_pct': {'type': ['number', 'null'], 'description': 'CapEx as % of revenue. <5% capital-light; >20% capital-heavy.'}, 'reinvestment_signal': {'type': 'string', 'description': 'GROWTH_MODE (>1.0) | REINVESTING (0.3â\x80\x931.0) | MAINTENANCE (0â\x80\x930.3) | HARVESTING (<0) | INSUFFICIENT_DATA'}}, 'description': 'Capital expenditure intensity and net reinvestment rate.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 8, 'minimum': 1, 'description': 'Max periods to return (1â\x80\x938 for quarterly; 1â\x80\x934 for annual). Default: 4.'}, 'period': {'enum': ['quarterly', 'annual'], 'type': 'string', 'description': "Period type. Default: 'quarterly' (up to 8 recent quarters). 'annual' returns up to 4 fiscal years."}, 'ticker': {'type': 'string', 'description': "US equity ticker symbol (e.g. 'AAPL', 'MSFT', 'NVDA', 'TSLA')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ticker': {'type': 'string'}, 'periods': {'type': 'array', 'items': {'type': 'object', 'properties': {'net_income': {'type': ['number', 'null'], 'description': 'Net income (starting point of indirect method).'}, 'period_end': {'type': 'string', 'description': 'Period end date (YYYY-MM-DD).'}, 'ending_cash': {'type': ['number', 'null'], 'description': 'Cash balance at period end.'}, 'deferred_tax': {'type': ['number', 'null'], 'description': 'Deferred income tax change.'}, 'debt_issuance': {'type': ['number', 'null'], 'description': 'New debt issuance proceeds.'}, 'beginning_cash': {'type': ['number', 'null'], 'description': 'Cash balance at period start.'}, 'debt_repayment': {'type': ['number', 'null'], 'description': 'Debt repayments (typically negative).'}, 'dividends_paid': {'type': ['number', 'null'], 'description': 'Common stock dividends paid (typically negative).'}, 'free_cash_flow': {'type': ['number', 'null'], 'description': 'Free cash flow (operating CF â\x80\x93 capex).'}, 'owner_earnings': {'type': ['number', 'null'], 'description': 'Owner earnings: net income + D&A â\x80\x93 capex (Buffett metric).'}, 'share_buybacks': {'type': ['number', 'null'], 'description': 'Share repurchases (typically negative).'}, 'other_financing': {'type': ['number', 'null'], 'description': 'Other financing cash flows.'}, 'capex_pct_of_ocf': {'type': ['number', 'null'], 'description': 'Capex as % of operating CF (capital intensity).'}, 'net_change_in_cash': {'type': ['number', 'null'], 'description': 'Net change in cash during period.'}, 'financing_cash_flow': {'type': ['number', 'null'], 'description': 'Total financing cash flow.'}, 'investing_cash_flow': {'type': ['number', 'null'], 'description': 'Total investing cash flow.'}, 'operating_cash_flow': {'type': ['number', 'null'], 'description': 'Total operating cash flow.'}, 'capital_expenditures': {'type': ['number', 'null'], 'description': 'Capital expenditures (typically negative).'}, 'other_non_cash_items': {'type': ['number', 'null'], 'description': 'Other non-cash adjustments.'}, 'cash_conversion_ratio': {'type': ['number', 'null'], 'description': 'FCF / net income. >1 = high earnings quality.'}, 'net_ppe_purchase_sale': {'type': ['number', 'null'], 'description': 'Net PP&E purchases and sales.'}, 'stock_based_compensation': {'type': ['number', 'null'], 'description': 'Stock-based compensation add-back.'}, 'acquisitions_divestitures': {'type': ['number', 'null'], 'description': 'Net business acquisitions and divestitures.'}, 'change_in_working_capital': {'type': ['number', 'null'], 'description': 'Net change in operating working capital.'}, 'depreciation_amortization': {'type': ['number', 'null'], 'description': 'D&A add-back (non-cash expense).'}, 'net_investment_purchase_sale': {'type': ['number', 'null'], 'description': 'Net investment purchases and sales.'}}}, 'description': 'Cash flow periods, most-recent-first. Monetary values in USD.'}, 'currency': {'type': 'string'}, 'period_type': {'type': 'string'}, 'retrieved_at': {'type': 'string'}, 'related_capabilities': {'type': 'array', 'items': {'type': 'object', 'properties': {'cap': {'type': 'string'}, 'price': {'type': 'string'}, 'description': {'type': 'string'}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'depth': {'type': 'integer', 'description': 'Number of order book levels to return on each side (bids + asks). 3, 5, or 10. Default 5.'}, 'product_id': {'type': 'string', 'description': 'Coinbase product ID in BASE-QUOTE format, e.g. BTC-USD, ETH-USD, SOL-USD, ETH-BTC, CBBTC-USDC. Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'asks': {'type': 'array', 'items': {'type': 'object', 'properties': {'size': {'type': 'number'}, 'price': {'type': 'number'}, 'notional': {'type': 'number'}}}, 'description': 'Top asks ordered best-to-worst, each with price, size (base units), and notional (USD equivalent)'}, 'bids': {'type': 'array', 'items': {'type': 'object', 'properties': {'size': {'type': 'number'}, 'price': {'type': 'number'}, 'notional': {'type': 'number'}}}, 'description': 'Top bids ordered best-to-worst, each with price, size (base units), and notional (USD equivalent)'}, 'price': {'type': 'number', 'description': 'Latest trade price (USD or quote currency)'}, 'spread': {'type': 'number', 'description': 'Absolute bid-ask spread (ask - bid)'}, 'low_24h': {'type': 'number', 'description': '24-hour low price'}, 'best_ask': {'type': 'number', 'description': 'Lowest current ask price'}, 'best_bid': {'type': 'number', 'description': 'Highest current bid price'}, 'high_24h': {'type': 'number', 'description': '24-hour high price'}, 'timestamp': {'type': 'string', 'description': 'ISO-8601 timestamp of this snapshot'}, 'ask_volume': {'type': 'number', 'description': 'Total base volume across returned ask levels'}, 'bid_volume': {'type': 'number', 'description': 'Total base volume across returned bid levels'}, 'product_id': {'type': 'string', 'description': 'Canonical Coinbase product ID'}, 'spread_pct': {'type': 'number', 'description': 'Spread as % of mid price'}, 'volume_24h': {'type': 'number', 'description': '24-hour trading volume in base currency'}, 'recent_trades': {'type': 'array', 'items': {'type': 'object', 'properties': {'side': {'type': 'string'}, 'size': {'type': 'number'}, 'time': {'type': 'string'}, 'price': {'type': 'number'}}}, 'description': 'Last 5 executed trades on this pair'}, 'order_pressure': {'type': 'number', 'description': 'Bid volume / ask volume. >1 = more buy pressure; <1 = more sell pressure'}, 'price_change_24h_pct': {'type': 'number', 'description': '24-hour price change as a percentage'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'block': {'type': 'string', 'description': 'Block number (integer or 0x hex) or tag: latest/pending/earliest/safe/finalized. Default: latest.'}, 'network': {'enum': ['ethereum', 'base', 'polygon', 'arbitrum'], 'type': 'string', 'description': 'Chain to query for block data. Default: ethereum.'}, 'alert_only': {'type': 'boolean', 'description': 'If true, only return stablecoins depegged (MILD_DEPEG or worse).'}, 'stablecoin_symbol': {'type': 'string', 'description': 'Filter stablecoins to a specific symbol (e.g. USDT, USDC, DAI). Omit to return top 10 by market cap.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'block': {'type': 'object', 'properties': {'hash': {'type': 'string'}, 'miner': {'type': 'string'}, 'network': {'type': 'string'}, 'gas_used': {'type': 'integer'}, 'tx_count': {'type': 'integer'}, 'gas_limit': {'type': 'integer'}, 'block_number': {'type': 'integer'}, 'base_fee_gwei': {'type': ['number', 'null']}, 'timestamp_iso': {'type': 'string'}, 'timestamp_unix': {'type': 'integer'}}, 'description': 'Block header from the requested chain.'}, 'stablecoins': {'type': 'object', 'properties': {'coins': {'type': 'array', 'items': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'symbol': {'type': 'string'}, 'depeg_status': {'type': 'string'}, 'peg_deviation': {'type': 'number'}, 'circulating_bn': {'type': 'number'}}}}, 'count': {'type': 'integer'}, 'alert_level': {'type': 'string', 'description': 'GREEN | YELLOW | ORANGE | RED'}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'date': {'type': 'string', 'description': 'Release date in YYYY-MM-DD format. Default: today (UTC).'}, 'format': {'enum': ['markdown', 'json'], 'type': 'string', 'description': "'markdown' returns a keep-a-changelog block string. 'json' returns structured sections object. Default: markdown."}, 'commits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Array of commit message strings. Supports conventional commits (feat:, fix:, perf:, docs:, chore:, security:, etc.). Maximum 500 entries.'}, 'version': {'type': 'string', 'description': "Release version label (e.g. '1.4.2' or 'v2.0.0'). Default: 'Unreleased'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'date': {'type': 'string', 'description': 'Release date used in the output.'}, 'skipped': {'type': 'integer', 'description': 'Empty or invalid messages skipped.'}, 'version': {'type': 'string', 'description': 'Version label used in the output.'}, 'sections': {'type': 'object', 'description': 'Structured groups: Added, Fixed, Changed, etc. (format=json).'}, 'changelog': {'type': 'string', 'description': 'Keep-a-changelog formatted block (format=markdown).'}, 'total_commits': {'type': 'integer', 'description': 'Total commit messages processed.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'sweep': {'type': 'string', 'description': 'Optional wavelength sweep to compute dispersion across a range.'}, 'fiber_type': {'enum': ['smf28', 'nzdsf', 'dsf', 'leaf', 'dcf', 'ullsf'], 'type': 'string', 'description': "Fiber type. Default: 'smf28' (standard SMF-28, G.652D)."}, 'wavelength_nm': {'type': 'number', 'description': 'Operating wavelength in nanometers (default 1550). Range: 1260â\x80\x931675 nm.'}, 'fiber_length_km': {'type': 'number', 'description': 'Fiber span length in km for accumulated dispersion calculation (default 80).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'D_slope': {'type': 'number', 'description': 'Dispersion slope in ps/(nm²·km).'}, 'fiber_name': {'type': 'string'}, 'fiber_type': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'D_coefficient': {'type': 'number', 'description': 'Dispersion coefficient in ps/(nm·km).'}, 'sweep_results': {'type': 'array', 'description': 'Per-wavelength results when sweep is requested.'}, 'wavelength_nm': {'type': 'number'}, 'attenuation_dB': {'type': 'number', 'description': 'Estimated span attenuation in dB.'}, 'fiber_length_km': {'type': 'number'}, 'accumulated_dispersion_ps_nm': {'type': 'number', 'description': 'Total dispersion over span in ps/nm.'}, 'zero_dispersion_wavelength_nm': {'type': 'number'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'max': {'type': 'integer', 'description': 'Max results to return (default 10, max 20)'}, 'country': {'type': 'string', 'description': "Optional ISO country name filter (e.g. 'United Kingdom')"}, 'keyword': {'type': 'string', 'description': "City name, airport name, or IATA/ICAO code (e.g. 'London', 'LHR', 'Paris')"}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'count': {'type': 'integer'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'tz': {'type': 'string'}, 'lat': {'type': 'number'}, 'lon': {'type': 'number'}, 'city': {'type': 'string'}, 'iata': {'type': 'string'}, 'icao': {'type': 'string'}, 'name': {'type': 'string'}, 'country': {'type': 'string'}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'isbn': {'type': 'string', 'description': 'ISBN-10 or ISBN-13 for exact lookup.'}, 'limit': {'type': 'integer', 'description': 'Max results (default 5, max 20).'}, 'title': {'type': 'string', 'description': "Book title to search (e.g. 'Pride and Prejudice', 'Moby-Dick')."}, 'author': {'type': 'string', 'description': "Author name to search (e.g. 'Jane Austen', 'Herman Melville')."}, 'subject': {'type': 'string', 'description': "Subject/genre filter (e.g. 'science fiction', 'philosophy', 'Victorian literature')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'books': {'type': 'array', 'description': 'Matched books with full metadata.'}, 'count': {'type': 'integer'}, 'total_found': {'type': 'integer'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'description': 'Maximum results to return (1-50). Default 10.'}, 'phase': {'enum': ['PHASE1', 'PHASE2', 'PHASE3', 'PHASE4', 'EARLY_PHASE1', 'NA'], 'type': 'string', 'description': 'Trial phase filter (optional). Omit to include all phases.'}, 'status': {'enum': ['recruiting', 'active', 'completed', 'not_yet', 'terminated', 'withdrawn', 'enrolling', 'any'], 'type': 'string', 'description': "Study recruitment status filter. Default: 'recruiting'."}, 'sponsor': {'type': 'string', 'description': "Filter by lead sponsor name (partial match). E.g. 'Pfizer', 'NIH'."}, 'condition': {'type': 'string', 'description': "Disease or condition to search (e.g. 'diabetes', 'lung cancer', 'Alzheimer'). Also accepts free-text keywords."}, 'intervention': {'type': 'string', 'description': "Drug, device, or intervention name to filter by (optional). E.g. 'metformin', 'CAR-T'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'query': {'type': 'object', 'description': 'Echo of search parameters used.'}, 'studies': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'ClinicalTrials.gov study page URL.'}, 'phase': {'type': 'string', 'description': 'Trial phase(s). Null for observational studies.'}, 'title': {'type': 'string', 'description': 'Official study title.'}, 'nct_id': {'type': 'string', 'description': 'ClinicalTrials.gov identifier (NCTxxxxxxxx).'}, 'status': {'type': 'string', 'description': 'Overall recruitment status.'}, 'conditions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Conditions/diseases studied.'}, 'enrollment': {'type': 'integer', 'description': 'Target or actual enrollment count.'}, 'start_date': {'type': 'string', 'description': 'Study start date (YYYY-MM or YYYY-MM-DD).'}, 'study_type': {'type': 'string', 'description': 'INTERVENTIONAL or OBSERVATIONAL.'}, 'lead_sponsor': {'type': 'string', 'description': 'Primary sponsor organization.'}, 'brief_summary': {'type': 'string', 'description': 'Plain-language study summary (truncated to 500 chars).'}, 'interventions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Drugs, devices, or procedures being tested.'}, 'completion_date': {'type': 'string', 'description': 'Primary completion date (YYYY-MM or YYYY-MM-DD).'}}}}, 'returned': {'type': 'integer', 'description': 'Number of studies returned in this response.'}, 'total_found': {'type': 'integer', 'description': 'Total matching studies in ClinicalTrials.gov (may exceed returned count).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'code': {'type': 'string', 'description': 'Source code to analyze (any language/framework). Max ~50KB recommended.'}, 'detail': {'enum': ['full', 'routes', 'exports'], 'type': 'string', 'description': "Output scope: 'full' (default) = all fields; 'routes' = HTTP routes only; 'exports' = exported symbols only."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'lang': {'type': 'string', 'description': 'Detected programming language.'}, 'routes': {'type': 'array', 'description': 'HTTP routes [{method, path}].'}, 'exports': {'type': 'array', 'description': 'Exported symbols [{kind, name}].'}, 'summary': {'type': 'string', 'description': 'One-line plain-English description of the API surface.'}, 'framework': {'type': 'string', 'description': 'Detected framework (express, fastapi, flask, etc.).'}, 'middleware': {'type': 'array', 'description': 'Detected middleware names.'}, 'route_count': {'type': 'number'}, 'export_count': {'type': 'number'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['repo_url', 'authorized'], 'properties': {'repo_url': {'type': 'string', 'description': "Public GitHub HTTPS URL of the repository to scan, e.g. 'https://github.com/owner/repo'. Must be a public repo (no auth is provided)."}, 'authorized': {'type': 'string', 'description': "Must be 'true'. By submitting you certify you own this repository or have explicit written authorization to perform a security audit against it."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'as_of': {'type': 'string'}, 'repo_url': {'type': 'string'}, 'sast_findings': {'type': 'array', 'items': {'type': 'object', 'properties': {'cwe': {'type': 'array', 'items': {'type': 'string'}}, 'file': {'type': 'string'}, 'line': {'type': 'integer'}, 'message': {'type': 'string'}, 'rule_id': {'type': 'string'}, 'severity': {'type': 'string'}}}}, 'secrets_found': {'type': 'array', 'items': {'type': 'object', 'properties': {'file': {'type': 'string'}, 'line': {'type': 'integer'}, 'match': {'type': 'string'}, 'rule_id': {'type': 'string'}}}}, 'scan_duration_ms': {'type': 'integer'}, 'sast_finding_count': {'type': 'integer'}, 'secrets_finding_count': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'code': {'type': 'string', 'description': 'Code snippet to analyze for test patterns.'}, 'filename': {'type': 'string', 'description': "Optional filename for the code snippet (e.g. 'utils.test.js') â\x80\x94 helps confirm test file naming conventions."}, 'github_repo': {'type': 'string', 'description': "GitHub repository in 'owner/repo' format (e.g. 'facebook/react'). Analyzes the full repo file tree for test coverage."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string', 'description': "'code' or 'repo'"}, 'verdict': {'type': 'string', 'description': "'HAS_TESTS' | 'HAS_ASSERTIONS' | 'NO_TESTS_DETECTED' | 'MINIMAL_TESTS' | 'WELL_TESTED' | 'NO_TESTS'"}, 'analysis': {'type': 'object', 'description': 'Test detection results.'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'category': {'enum': ['energy', 'metals', 'agricultural', 'all'], 'type': 'string', 'description': 'Filter by category: energy (crude_oil, natural_gas), metals (gold, silver, copper, platinum), agricultural (wheat, corn, soybeans, coffee), or all. Default: all. Ignored if commodities list is provided.'}, 'commodities': {'type': 'array', 'items': {'enum': ['crude_oil', 'natural_gas', 'gold', 'silver', 'copper', 'platinum', 'wheat', 'corn', 'soybeans', 'coffee'], 'type': 'string'}, 'description': 'Specific commodities to fetch. One or more of: crude_oil, natural_gas, gold, silver, copper, platinum, wheat, corn, soybeans, coffee. Omit to get all commodities (limited by category if provided).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'quotes': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Full contract name.'}, 'unit': {'type': 'string', 'description': "Price unit (e.g. 'USD/troy oz', 'USX/bu')."}, 'price': {'type': ['number', 'null'], 'description': 'Current market price.'}, 'symbol': {'type': 'string', 'description': "Yahoo Finance ticker symbol (e.g. 'GC=F')."}, 'day_low': {'type': ['number', 'null'], 'description': 'Intraday low.'}, 'category': {'type': 'string', 'description': 'Asset category.'}, 'contract': {'type': ['string', 'null'], 'description': "Active contract label (e.g. 'Gold Jul 26')."}, 'currency': {'type': ['string', 'null'], 'description': 'Quote currency (USD or USX for grains).'}, 'day_high': {'type': ['number', 'null'], 'description': 'Intraday high.'}, 'exchange': {'type': ['string', 'null'], 'description': 'Exchange name.'}, 'commodity': {'type': 'string', 'description': "Commodity key (e.g. 'gold')."}, 'change_pct': {'type': ['number', 'null'], 'description': 'Percentage change from prev close.'}, 'change_usd': {'type': ['number', 'null'], 'description': 'Change from prev close.'}, 'prev_close': {'type': ['number', 'null'], 'description': 'Previous close price.'}, 'market_time': {'type': ['string', 'null'], 'description': 'ISO-8601 timestamp of last price.'}, 'week_52_low': {'type': ['number', 'null'], 'description': '52-week low.'}, 'week_52_high': {'type': ['number', 'null'], 'description': '52-week high.'}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'domain': {'type': 'string', 'description': "Optional company website domain or URL (e.g. 'stripe.com'). When provided, adds website-based intelligence to the report."}, 'company': {'type': 'string', 'description': "Company name to look up (e.g. 'Coinbase Global', 'Stripe Inc')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'query': {'type': 'string', 'description': 'Original query.'}, 'company': {'type': 'string', 'description': 'Resolved company name.'}, 'sec_data': {'type': 'object', 'description': 'SEC EDGAR data â\x80\x94 CIK, ticker, SIC, address, filing history. Null for private companies.'}, 'risk_flags': {'type': 'array', 'description': 'List of potential red flags or notable observations.'}, 'generated_at': {'type': 'string', 'description': 'ISO-8601 timestamp.'}, 'website_intel': {'type': 'object', 'description': 'Website-derived intelligence. Null if no domain provided or site unreachable.'}, 'public_company': {'type': 'boolean', 'description': 'True if found in SEC EDGAR (US public company).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ticker': {'type': 'string', 'description': "US stock ticker symbol (e.g. 'AAPL', 'MSFT', 'TSLA'). Case-insensitive. Standard tickers only â\x80\x94 class-suffix tickers like BRK.A may need to be submitted as BRKA."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'cik': {'type': 'string', 'description': 'SEC Central Index Key (10-digit, zero-padded).'}, 'sic': {'type': ['string', 'null'], 'description': 'Standard Industrial Classification code.'}, 'name': {'type': 'string', 'description': 'Company legal name as filed with SEC.'}, 'ticker': {'type': 'string', 'description': 'Ticker symbol (uppercased, as matched in EDGAR).'}, 'last_8k': {'type': ['string', 'null'], 'description': 'Date of most recent 8-K material event filing (YYYY-MM-DD).'}, 'last_10k': {'type': ['string', 'null'], 'description': 'Date of most recent 10-K annual report (YYYY-MM-DD).'}, 'last_10q': {'type': ['string', 'null'], 'description': 'Date of most recent 10-Q quarterly report (YYYY-MM-DD).'}, 'edgar_url': {'type': 'string', 'description': 'EDGAR company filing page URL.'}, 'filings_2y': {'type': 'object', 'description': 'Count of each SEC form type filed in the last 2 years.', 'additionalProperties': {'type': 'integer'}}, 'filer_category': {'type': ['string', 'null'], 'description': "SEC filer category (e.g. 'Large accelerated filer', 'Non-accelerated filer')."}, 'fiscal_year_end': {'type': ['string', 'null'], 'description': "Fiscal year end formatted as 'Mon D' (e.g. 'Sep 26')."}, 'sic_description': {'type': ['string', 'null'], 'description': 'SIC industry description.'}, 'business_location': {'type': ['string', 'null'], 'description': 'Primary business location (city, state) from most recent filing.'}, 'state_of_incorporation': {'type': ['string', 'null'], 'description': 'US state code where the company is incorporated.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, MSFT, NVDA). Used for stock quote and income statements.'}, 'entity_name': {'type': 'string', 'description': "Company or entity name for Wikipedia lookup (e.g. 'Apple Inc'). Falls back to ticker if omitted."}, 'github_repo': {'type': 'string', 'description': "GitHub repo in 'owner/repo' format (e.g. 'microsoft/vscode'). If provided, adds GitHub repo intelligence to the result."}, 'website_url': {'type': 'string', 'description': "Company website URL (e.g. 'https://stripe.com'). If provided, adds website intelligence to the result."}, 'income_period': {'enum': ['quarterly', 'annual'], 'type': 'string', 'description': "Period type for income statements. Default: 'quarterly' (up to 4 recent quarters)."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ticker', 'as_of'], 'properties': {'as_of': {'type': 'string'}, 'errors': {'type': 'object', 'description': 'Per-source errors (non-fatal; other fields still populated).'}, 'github': {'type': 'object', 'description': 'GitHub repo intelligence from github-repo-intel (present only when github_repo was supplied).'}, 'ticker': {'type': 'string'}, 'website': {'type': 'object', 'description': 'Website intelligence from web-company-intel (present only when website_url was supplied).'}, 'wikipedia': {'type': 'object', 'description': 'Entity background and summary from wikipedia-intel.'}, 'stock_quote': {'type': 'object', 'description': 'Live stock price, change, volume from us-stock-price.'}, 'income_statements': {'type': 'object', 'description': 'Quarterly/annual income statement data from income-statements.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'address': {'type': 'string', 'description': 'The pay_to wallet address to score (0x-prefixed, 42 hex chars).'}, 'window_days': {'type': 'integer', 'description': 'Observation window in days (default 7, max 30).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'hhi': {'type': 'number', 'description': 'Herfindahl-Hirschman Index [0, 1]. 1 = monopoly.'}, 'address': {'type': 'string'}, 'risk_tier': {'enum': ['LOW', 'MEDIUM', 'HIGH', 'CRITICAL', 'NO_DATA'], 'type': 'string'}, 'observed_at': {'type': 'string'}, 'window_days': {'type': 'integer'}, 'unique_payers': {'type': 'integer'}, 'recommendation': {'type': 'string'}, 'top_payer_share': {'type': 'number', 'description': 'Fraction of total settlements from the single largest payer.'}, 'persistence_scans': {'type': 'integer', 'description': 'Number of distinct 10-min scan windows address was observed in.'}, 'total_settlements': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum trades to return. Default 25, max 100.'}, 'ticker': {'type': 'string', 'description': 'Stock ticker to filter by (e.g. AAPL, NVDA). Case-insensitive. Omit for market-wide recent trades.'}, 'chamber': {'enum': ['all', 'house', 'senate'], 'type': 'string', 'description': 'Filter by congressional chamber. Default: all.'}, 'transaction_type': {'enum': ['all', 'purchase', 'sale'], 'type': 'string', 'description': 'Filter by transaction direction. Default: all.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'mode': {'type': 'string', 'description': "'ticker' (historical for a specific stock) or 'market_wide' (recent all-congress)."}, 'source': {'type': 'string'}, 'trades': {'type': 'array', 'items': {'type': 'object', 'properties': {'party': {'type': 'string', 'description': 'Republican | Democratic | Independent'}, 'ticker': {'type': 'string'}, 'chamber': {'type': 'string', 'description': 'Representatives | Senate'}, 'range_usd': {'type': 'string', 'description': "STOCK Act dollar range, e.g. '$1,001 - $15,000'."}, 'description': {'type': ['string', 'null'], 'description': "Filer's description note (often null)."}, 'report_date': {'type': 'string', 'description': 'YYYY-MM-DD date filed with clerk.'}, 'transaction': {'type': 'string', 'description': 'Purchase | Sale | Sale (Partial)'}, 'representative': {'type': 'string'}, 'spy_change_pct': {'type': ['number', 'null'], 'description': 'SPY price change (%) over same period.'}, 'price_change_pct': {'type': ['number', 'null'], 'description': 'Stock price change (%) since transaction date.'}, 'transaction_date': {'type': 'string', 'description': 'YYYY-MM-DD date of the actual trade.'}, 'performance_vs_spy': {'type': ['number', 'null'], 'description': 'Excess return (%) vs. SPY since transaction date.'}}}, 'description': 'List of congressional stock trades matching filters.'}, 'summary': {'type': 'object', 'properties': {'sales': {'type': 'integer'}, 'purchases': {'type': 'integer'}, 'date_range': {'type': ['object', 'null']}, 'total_trades': {'type': 'integer'}, 'filter_applied': {'type': 'object'}, 'tickers_mentioned': {'type': 'array', 'items': {'type': 'string'}}, 'avg_excess_return_pct': {'type': ['number', 'null'], 'description': 'Average performance vs. SPY across all returned trades.'}, 'unique_representatives': {'type': 'integer'}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'signals': {'type': 'object', 'properties': {'real_pce': {'type': ['object', 'null']}, 'sentiment': {'type': ['object', 'null']}, 'nominal_pce': {'type': ['object', 'null']}, 'retail_sales': {'type': ['object', 'null']}, 'revolving_credit': {'type': ['object', 'null']}, 'savings_rate_pct': {'type': ['object', 'null']}, 'total_consumer_credit': {'type': ['object', 'null']}, 'real_disposable_income': {'type': ['object', 'null']}}, 'description': 'Raw FRED signals assembled for this briefing.'}, 'narrative': {'type': 'string', 'description': '150-word consumer health brief'}, 'dominant_risk': {'type': 'string', 'description': 'Primary risk to consumer spending'}, 'savings_stress': {'type': 'string', 'description': 'adequate | low | depleted'}, 'spending_regime': {'type': 'string', 'description': 'expanding | stable | contracting'}, 'confidence_level': {'type': 'string', 'description': 'high | moderate | low | recessionary'}, 'consumer_posture': {'type': 'string', 'description': 'strong | cautious | stressed | distressed'}, 'agent_implication': {'type': 'string', 'description': 'What an AI agent should do with this data'}, 'credit_dependency': {'type': 'string', 'description': 'low | moderate | high | extreme'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'Public URL to analyze (article, blog post, news page, documentation, product page, etc.).'}, 'focus': {'type': 'string', 'description': "Optional focus instruction. E.g. 'focus on financial claims', 'extract regulatory implications', 'identify risk factors'. Narrows the analysis."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'url': {'type': 'string'}, 'topics': {'type': 'array', 'description': 'Topic tags in kebab-case.'}, 'summary': {'type': 'string', 'description': '2â\x80\x933 sentence summary of the main content.'}, 'entities': {'type': 'array', 'description': 'Named entities: name + type.'}, 'sentiment': {'type': 'object', 'description': 'label (positive/negative/neutral/mixed) + score (0â\x80\x931).'}, 'key_points': {'type': 'array', 'description': '3â\x80\x937 key takeaways.'}, 'content_type': {'type': 'string', 'description': 'news | blog | research | product | documentation | social | forum | other'}, 'credibility_signals': {'type': 'object', 'description': 'has_author, has_date, has_sources, word_count_adequate.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'text': {'type': 'string', 'description': 'Text content to moderate (required unless image_url provided).'}, 'rewrite': {'type': 'boolean', 'description': 'If true and content is flagged, return an AI-generated safe rewrite. Adds ~1s latency.'}, 'image_url': {'type': 'string', 'description': 'Optional public image URL to moderate alongside text.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['flagged', 'risk_level', 'flagged_categories', 'top_scores'], 'properties': {'model': {'type': 'string', 'description': 'Moderation model used.'}, 'flagged': {'type': 'boolean', 'description': 'True if any harmful category was detected.'}, 'risk_level': {'type': 'string', 'description': 'NONE | LOW | MEDIUM | HIGH â\x80\x94 based on highest category score.'}, 'top_scores': {'type': 'array', 'description': 'Top 5 category scores [{ category, score }].'}, 'safe_rewrite': {'type': 'string', 'description': 'Safe rewrite of flagged content (only present if rewrite=true and flagged=true).'}, 'flagged_categories': {'type': 'array', 'description': 'List of violated category names.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['commodity'], 'properties': {'commodity': {'type': 'string', 'description': "Commodity or market name to look up (e.g. 'crude oil', 'gold', 'wheat', 'S&P 500', 'euro', 'natural gas', 'soybeans', 'copper')"}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'query': {'type': 'string'}, 'market': {'type': 'string'}, 'signal': {'enum': ['SPEC_LONG', 'SPEC_SHORT', 'NEUTRAL'], 'type': 'string'}, 'trend_4w': {'type': 'array'}, 'report_date': {'type': 'string'}, 'open_interest': {'type': 'integer'}, 'small_traders': {'type': 'object'}, 'large_speculators': {'type': 'object'}, 'commercial_hedgers': {'type': 'object'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'code': {'type': 'string', 'description': "ISO 3166-1 alpha-2 (e.g. 'DE') or alpha-3 (e.g. 'DEU') code for exact lookup."}, 'name': {'type': 'string', 'description': "Country name or partial name to search (e.g. 'Germany', 'United States', 'Korea')."}, 'region': {'enum': ['Africa', 'Americas', 'Asia', 'Europe', 'Oceania', 'Antarctic'], 'type': 'string', 'description': 'Return all countries in a region.'}, 'capital': {'type': 'string', 'description': "Capital city name to look up the country by (e.g. 'Berlin', 'Tokyo')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'count': {'type': 'integer'}, 'results': {'type': 'array'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'hy_oas': {'type': 'number', 'description': 'ICE BofA US High Yield OAS (%). Multiply by 100 for basis points.'}, 'ig_oas': {'type': 'number', 'description': 'ICE BofA US Investment Grade OAS (%). All corporate bonds incl BBBâ\x80\x93AAA.'}, 'bbb_oas': {'type': 'number', 'description': 'ICE BofA BBB Corporate OAS (%). Lowest investment-grade tier â\x80\x94 canary for IG deterioration.'}, 'hy_date': {'type': 'string', 'description': 'Date of latest HY OAS observation (YYYY-MM-DD).'}, 'ig_date': {'type': 'string', 'description': 'Date of latest IG OAS observation (YYYY-MM-DD).'}, 'bbb_date': {'type': 'string', 'description': 'Date of latest BBB OAS observation (YYYY-MM-DD).'}, 'hy_ig_diff': {'type': 'number', 'description': 'HY minus IG spread differential (%). Pure sub-investment-grade credit risk premium.'}, 'risk_regime': {'type': 'string', 'description': 'Credit stress classification based on HY OAS: tight (<300bp) | normal (300â\x80\x93500bp) | wide (500â\x80\x93700bp) | stress (>700bp).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'from_iso': {'type': 'string', 'description': 'ISO 8601 reference timestamp to compute next runs from (default: now).'}, 'next_runs': {'type': 'number', 'description': 'Number of upcoming run times to return (default 5, max 20).'}, 'expression': {'type': 'string', 'description': "Cron expression (5 fields: minute hour day month weekday) or shortcut (@daily, @hourly, etc.). Example: '0 9 * * 1-5'. Defaults to '@daily'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'valid': {'type': 'boolean'}, 'fields': {'type': 'object', 'properties': {'hour': {'type': 'string'}, 'month': {'type': 'string'}, 'minute': {'type': 'string'}, 'day_of_week': {'type': 'string'}, 'day_of_month': {'type': 'string'}}}, 'expression': {'type': 'string'}, 'normalized': {'type': 'string'}, 'description': {'type': 'string'}, 'next_run_times': {'type': 'array', 'items': {'type': 'string'}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to_chain': {'type': 'string', 'description': 'Destination chain name or ID (default: ethereum). Same options as from_chain.'}, 'from_chain': {'type': 'string', 'description': 'Source chain name or ID (default: base). Examples: ethereum, base, arbitrum, polygon, bsc, optimism, avalanche, zksync, 8453, 1.'}, 'show_all_bridges': {'type': 'boolean', 'description': 'If true, return all 32 bridges with their chain coverage (ignores from/to filter). Default false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'bridges': {'type': 'array', 'items': {'type': 'object', 'properties': {'key': {'type': 'string'}, 'name': {'type': 'string'}, 'chain_pairs_supported': {'type': 'integer', 'description': 'Total chain pairs this bridge supports across all networks â\x80\x94 a proxy for maturity/liquidity.'}}}, 'description': 'Bridges that support this chain pair, sorted by chain-pair coverage breadth (most versatile first).'}, 'to_chain': {'type': 'object', 'description': 'Destination chain info.'}, 'from_chain': {'type': 'object', 'description': 'Source chain info.'}, 'bridge_count': {'type': 'integer', 'description': 'Number of bridges supporting this route.'}, 'recommendation': {'type': 'string', 'description': 'Top bridge recommendation for this route.'}, 'route_available': {'type': 'boolean', 'description': 'True if at least one bridge supports this chain pair.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'coins': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Raw coin data: symbol, price_usd, change_24h_pct, market_cap_usd, volume_24h_usd.'}, 'narrative': {'type': 'string', 'description': 'Full ~200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence crypto market summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'generated_at': {'type': 'string'}, 'crypto_regime': {'type': 'string', 'description': 'extreme_greed | greed | neutral | fear | extreme_fear | risk_on | risk_off'}, 'dominant_signal': {'type': 'string', 'description': 'Most important signal from the data.'}, 'fear_greed_index': {'type': 'object', 'properties': {'value': {'type': 'integer'}, 'value_classification': {'type': 'string'}}, 'description': 'Alternative.me Fear & Greed Index.'}, 'agent_implication': {'type': 'string', 'description': 'Concrete action relevance for AI agents.'}, 'btc_dominance_signal': {'type': 'string', 'description': 'Whether BTC is leading or lagging altcoins.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'focus': {'type': 'string', 'description': "Optional analytical focus (e.g. 'AI token momentum', 'macro risk-off signals', 'BTC dominance shift'). Narrows the synthesis lens."}, 'crypto_limit': {'type': 'integer', 'maximum': 15, 'minimum': 3, 'description': 'Number of top crypto gainers and losers to include in the analysis (default 5, max 15).'}, 'equity_tickers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 8 equity or ETF tickers to include (e.g. ["SPY","NVDA","BTC-USD"]). Defaults to SPY, QQQ, IWM, BTC-USD if omitted.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'focus': {'type': 'string'}, 'crypto': {'type': 'object', 'description': 'Top crypto gainers, losers, and global market stats.'}, 'equity': {'type': 'array', 'description': 'Live equity/ETF price data per ticker.'}, 'key_themes': {'type': 'array', 'items': {'type': 'string'}}, 'risk_signals': {'type': 'array', 'items': {'type': 'string'}}, 'crypto_signal': {'type': 'string'}, 'equity_signal': {'type': 'string'}, 'market_regime': {'type': 'string', 'description': 'risk-on | risk-off | diverging | correlated | mixed'}, 'tactical_note': {'type': 'string'}, 'standout_crypto': {'type': 'string'}, 'standout_equity': {'type': 'string'}, 'cross_market_summary': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'History depth for trend and summary (1â\x80\x9330). Default: 7.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'trend': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'label': {'type': 'string'}, 'score': {'type': 'integer'}}}, 'description': 'Daily scores, newest first'}, 'current': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'score': {'type': 'integer', 'description': '0=extreme fear, 100=extreme greed'}, 'regime': {'type': 'string', 'description': 'capitulation_zone | fear_accumulate | neutral_hold | greed_cautious | euphoria_reduce'}, 'updated_at': {'type': 'string', 'description': 'ISO-8601 UTC timestamp'}, 'next_update_secs': {'type': 'integer'}}}, 'summary': {'type': 'object', 'properties': {'avg': {'type': 'number'}, 'max': {'type': 'integer'}, 'min': {'type': 'integer'}, 'days': {'type': 'integer'}, 'label': {'type': 'string', 'description': 'Dominant classification for window'}, 'signal': {'type': 'string', 'description': 'buy_signal | hold | sell_signal â\x80\x94 derived from current vs 30d avg'}}, 'description': 'Stats across the requested history window'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'coin': {'type': 'string', 'description': 'Cryptocurrency ID or common ticker (e.g. bitcoin, ethereum, solana, btc, eth, sol, bnb, xrp). CoinGecko IDs also accepted.'}, 'currencies': {'type': 'string', 'description': 'Comma-separated fiat codes to return (e.g. jpy,eur,cny or usd,gbp,krw,inr). Default: usd,jpy,eur.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'coin': {'type': 'string', 'description': 'CoinGecko ID used'}, 'prices': {'type': 'object', 'description': 'Price per fiat code (e.g. {usd: 60000, jpy: 9600000})'}, 'changes_24h': {'type': 'object', 'description': '24h % change per fiat code'}, 'last_updated': {'type': 'string', 'description': 'ISO-8601 timestamp of last price update'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mode': {'enum': ['gainers', 'losers', 'volume'], 'type': 'string', 'description': "Ranking mode: 'gainers' (top 24h % up), 'losers' (top 24h % down), 'volume' (highest 24h USD volume). Default: gainers."}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Number of tokens to return per source (1â\x80\x9320). Default 10.'}, 'korean_only': {'type': 'boolean', 'description': 'If true, returns only the Korean Upbit data (faster, omits CoinGecko global movers). Default false.'}, 'include_yields': {'type': 'boolean', 'description': 'If true, cross-reference results with DeFiLlama yield farming pools for the identified tokens. Adds ~1s latency. Default false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string'}, 'summary': {'type': 'string', 'description': 'Plain-English momentum summary.'}, 'sourced_at': {'type': 'string', 'description': 'ISO-8601 timestamp'}, 'yield_pools': {'type': 'array', 'items': {'type': 'object', 'properties': {'chain': {'type': 'string'}, 'il_risk': {'type': 'string'}, 'tvl_usd': {'type': 'number'}, 'protocol': {'type': 'string'}, 'stablecoin': {'type': 'boolean'}, 'apy_current': {'type': 'number'}, 'pool_symbol': {'type': 'string'}, 'apy_30d_mean': {'type': 'number'}}}, 'description': 'DeFiLlama yield pools matching identified tokens. Only present when include_yields=true.'}, 'global_movers': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'rank': {'type': 'integer'}, 'symbol': {'type': 'string'}, 'price_usd': {'type': 'number'}, 'change_24h_pct': {'type': 'number'}, 'market_cap_usd': {'type': 'number'}, 'volume_24h_usd': {'type': 'number'}}}, 'description': 'Global movers from CoinGecko. Omitted when korean_only=true.'}, 'korean_leaders': {'type': 'array', 'items': {'type': 'object', 'properties': {'symbol': {'type': 'string'}, 'exchange': {'type': 'string'}, 'price_krw': {'type': 'number'}, 'low_24h_krw': {'type': 'number'}, 'high_24h_krw': {'type': 'number'}, 'trade_status': {'type': 'string'}, 'change_24h_pct': {'type': 'number'}, 'volume_24h_usd_approx': {'type': 'number'}}}, 'description': 'Top movers on Upbit (Korea). Volume in USD is approximate (KRW/1350).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'tickers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 8 equity or ETF tickers to price (e.g. ["SPY","NVDA","COIN"]). Defaults to SPY, QQQ, BTC-USD if omitted.'}, 'max_news': {'type': 'integer', 'maximum': 10, 'minimum': 3, 'description': 'Number of CoinDesk headlines to include in synthesis (default 10, max 10).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'brief': {'type': 'string', 'description': 'AI-synthesized 3-4 sentence portfolio brief.'}, 'equities': {'type': 'array', 'description': 'Equity ticker prices and % change.'}, 'headlines': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Raw CoinDesk headline list.'}, 'news_count': {'type': 'integer', 'description': 'Number of headlines fetched.'}, 'generated_at': {'type': 'string', 'description': 'ISO-8601 timestamp.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'description': 'Number of headlines to return (1â\x80\x9320). Default: 10.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'headlines': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Full article URL.'}, 'coins': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'CoinGecko asset ID (e.g. bitcoin, ethereum).'}, 'price_usd': {'type': ['number', 'null'], 'description': 'Current USD price.'}, 'change_24h': {'type': ['number', 'null'], 'description': '24-hour price change %.'}}}, 'description': 'Crypto assets mentioned in the headline, with live prices.'}, 'title': {'type': 'string', 'description': 'Article headline.'}, 'category': {'type': ['string', 'null'], 'description': 'Primary article category (Markets, Tech, Policy, Finance, â\x80¦).'}, 'sentiment': {'enum': ['bullish', 'bearish', 'neutral'], 'type': 'string', 'description': 'Keyword-derived impact signal from headline and category text.'}, 'published_at': {'type': ['string', 'null'], 'description': 'ISO-8601 publish timestamp.'}}}, 'description': 'Recent crypto news articles enriched with price data.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'network': {'enum': ['ethereum', 'base'], 'type': 'string', 'description': 'Chain for block context. Default: ethereum.'}, 'movers_limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Number of gainers + losers each (1â\x80\x9320). Default 5.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'block': {'type': 'object', 'properties': {'hash': {'type': 'string'}, 'miner': {'type': 'string'}, 'network': {'type': 'string'}, 'gas_used': {'type': 'integer'}, 'tx_count': {'type': 'integer'}, 'gas_limit': {'type': 'integer'}, 'block_number': {'type': 'integer'}, 'base_fee_gwei': {'type': ['number', 'null']}, 'timestamp_iso': {'type': 'string'}, 'timestamp_unix': {'type': 'integer'}}, 'description': 'Latest block header for the selected network.'}, 'generated_at': {'type': 'string'}, 'crypto_losers': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Top crypto losers by 24h % change.'}, 'crypto_gainers': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Top crypto gainers by 24h % change.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'focus': {'type': 'string', 'description': "Optional analytical focus (e.g. 'BTC dominance effect on MSTR', 'AI token rally vs NVDA', 'risk-off signal for fintech'). Narrows the synthesis."}, 'ticker': {'type': 'string', 'description': 'US stock ticker to analyze against the crypto backdrop (e.g. COIN, MSTR, NVDA, AAPL). Defaults to SPY if omitted.'}, 'crypto_limit': {'type': 'integer', 'maximum': 12, 'minimum': 3, 'description': 'Number of top crypto gainers and losers to include (default 5, max 12).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'focus': {'type': 'string'}, 'stock': {'type': 'object', 'description': 'Live equity data for the requested ticker.'}, 'crypto': {'type': 'object', 'description': 'Top crypto gainers, losers, and global market stats.'}, 'key_driver': {'type': 'string'}, 'watch_level': {'type': 'string'}, 'risk_signals': {'type': 'array', 'items': {'type': 'string'}}, 'stock_context': {'type': 'string'}, 'crypto_context': {'type': 'string'}, 'opportunity_note': {'type': 'string'}, 'correlation_regime': {'type': 'string', 'description': 'correlated | diverging | crypto-leading | equity-leading | uncorrelated'}, 'cross_asset_summary': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'global': {'type': 'object', 'properties': {'active_coins': {'type': 'integer', 'description': 'Number of active cryptocurrencies tracked.'}, 'btc_dominance_pct': {'type': 'number', 'description': 'Bitcoin market cap as % of total market.'}, 'total_market_cap_b': {'type': 'number', 'description': 'Total crypto market cap in billions USD.'}, 'total_volume_24h_b': {'type': 'number', 'description': 'Total 24h trading volume in billions USD.'}}, 'description': 'Global crypto market statistics.'}, 'top_losers': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Top 5 coins with largest 24h % decline (market cap rank â\x89¤ 100, stablecoins excluded).'}, 'top_by_mcap': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Top 10 coins by market cap with current price and 24h change.'}, 'top_gainers': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Coin name.'}, 'rank': {'type': ['integer', 'null'], 'description': 'CoinGecko market cap rank.'}, 'symbol': {'type': 'string', 'description': 'Ticker symbol (uppercased).'}, 'price_usd': {'type': 'number', 'description': 'Current price in USD.'}, 'change_24h': {'type': 'number', 'description': '24-hour % price change.'}, 'market_cap_b': {'type': ['number', 'null'], 'description': 'Market cap in billions USD.'}, 'volume_24h_m': {'type': ['number', 'null'], 'description': '24h trading volume in millions USD.'}}}, 'description': 'Top 5 coins with highest 24h % gain (market cap rank â\x89¤ 100, stablecoins excluded).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mode': {'enum': ['format', 'info', 'both'], 'type': 'string', 'description': "'format' returns the formatted string only. 'info' returns symbol and separators only. 'both' returns everything. Default: 'both'."}, 'amount': {'type': 'number', 'description': 'Numeric amount to format (e.g. 1234.56).'}, 'locale': {'type': 'string', 'description': "BCP 47 locale tag (e.g. 'en-US', 'de-DE', 'ja-JP'). Defaults to the canonical locale for the currency."}, 'currency': {'type': 'string', 'description': "ISO 4217 currency code (e.g. 'USD', 'EUR', 'JPY', 'KRW', 'BTC is not supported â\x80\x94 ISO only)."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'name': {'type': ['string', 'null'], 'description': 'Human-readable currency name in the specified locale.'}, 'amount': {'type': ['number', 'null']}, 'locale': {'type': 'string'}, 'symbol': {'type': ['string', 'null']}, 'currency': {'type': 'string'}, 'formatted': {'type': ['string', 'null'], 'description': 'Amount formatted as currency string. Null if no amount provided.'}, 'decimal_separator': {'type': ['string', 'null']}, 'grouping_separator': {'type': ['string', 'null']}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'Restrict to CVEs published in the last N days. Only applies to keyword searches.'}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Max results to return (default 10). Only applies to keyword searches.'}, 'query': {'type': 'string', 'description': "CVE ID (e.g. 'CVE-2021-44228') for a direct lookup, or a keyword/phrase (e.g. 'log4j', 'remote code execution', 'openssl') to search descriptions."}, 'severity': {'enum': ['CRITICAL', 'HIGH', 'MEDIUM', 'LOW'], 'type': 'string', 'description': 'Filter results to a minimum CVSSv3 severity. Only applies to keyword searches.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['query', 'total_results', 'returned', 'vulnerabilities'], 'properties': {'query': {'type': 'string', 'description': 'Query as submitted.'}, 'returned': {'type': 'integer', 'description': 'Number of CVEs returned.'}, 'total_results': {'type': 'integer', 'description': 'Total matching CVEs in NVD.'}, 'vulnerabilities': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'published', 'status'], 'properties': {'id': {'type': 'string', 'description': 'CVE identifier (e.g. CVE-2021-44228).'}, 'cvss': {'type': ['object', 'null'], 'properties': {'score': {'type': 'number'}, 'impact': {'type': 'number'}, 'vector': {'type': 'string'}, 'version': {'type': 'string'}, 'severity': {'type': 'string'}, 'attack_vector': {'type': 'string'}, 'exploitability': {'type': 'number'}}, 'description': 'CVSS scoring data (v3.1 preferred, falls back to v3.0 then v2).'}, 'cwes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'CWE weakness identifiers.'}, 'status': {'type': 'string', 'description': 'NVD status (Analyzed, Modified, etc.).'}, 'published': {'type': 'string', 'description': 'Publication date (ISO 8601).'}, 'references': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Top reference URLs.'}, 'description': {'type': 'string', 'description': 'English vulnerability description.'}, 'last_modified': {'type': 'string', 'description': 'Last modification date.'}}}, 'description': 'CVE records ordered by NVD default (publication date descending).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'include': {'enum': ['all', 'versions', 'performance'], 'type': 'string', 'description': "What to include: 'all' (default), 'versions' (EOL/release data only), 'performance' (benchmark profiles only)."}, 'database': {'type': 'string', 'description': 'Database to query. Accepts: postgresql, mysql, mariadb, mongodb, redis, elasticsearch, sqlite, cassandra, cockroachdb, mssql. Omit to return all supported databases.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'count': {'type': 'integer'}, 'databases': {'type': 'array', 'items': {'type': 'object', 'properties': {'slug': {'type': 'string'}, 'type': {'type': 'string'}, 'display_name': {'type': 'string'}, 'version_status': {'type': ['object', 'null']}, 'performance_profile': {'type': ['object', 'null']}}}}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'erp': {'type': 'number', 'description': 'Equity risk premium in % (default 5.5 â\x80\x94 Damodaran mature market ERP).'}, 'ticker': {'type': 'string', 'description': 'US stock ticker (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}, 'base_growth_pct': {'type': 'number', 'description': 'Base-case annual FCF growth rate in % (e.g. 15.0 = 15%). Default: analyst consensus 5Y EPS CAGR.'}, 'base_weight_pct': {'type': 'number', 'description': 'Probability weight for base scenario in % (default 50).'}, 'bear_growth_pct': {'type': 'number', 'description': 'Bear-case annual FCF growth rate in % (e.g. 5.0 = 5%). Default: 50% of analyst consensus 5Y EPS CAGR.'}, 'bear_weight_pct': {'type': 'number', 'description': 'Probability weight for bear scenario in % (default 25). Weights must sum to 100.'}, 'bull_growth_pct': {'type': 'number', 'description': 'Bull-case annual FCF growth rate in % (e.g. 25.0 = 25%). Default: 150% of analyst consensus 5Y EPS CAGR.'}, 'bull_weight_pct': {'type': 'number', 'description': 'Probability weight for bull scenario in % (default 25).'}, 'terminal_growth_pct': {'type': 'number', 'description': 'Perpetuity growth rate after year 5 in % (default 3.0). Use 2.0â\x80\x933.5 for mature companies.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'name': {'type': 'string'}, 'ticker': {'type': 'string'}, 'scenarios': {'type': 'object', 'properties': {'base': {'type': 'object'}, 'bear': {'type': 'object'}, 'bull': {'type': 'object'}}, 'description': 'Intrinsic value and margin of safety for each scenario.'}, 'assumptions': {'type': 'object', 'properties': {'erp_pct': {'type': 'number'}, 'wacc_pct': {'type': 'number'}, 'rf_rate_pct': {'type': 'number'}, 'net_debt_usd': {'type': 'number'}, 'growth_source': {'type': 'string'}, 'diluted_shares': {'type': 'number'}, 'terminal_growth_pct': {'type': 'number'}}}, 'scenario_weights': {'type': 'object', 'properties': {'base_pct': {'type': 'number'}, 'bear_pct': {'type': 'number'}, 'bull_pct': {'type': 'number'}}}, 'weighted_verdict': {'type': 'string', 'description': 'UNDERVALUED | FAIRLY_VALUED | OVERVALUED based on weighted intrinsic.'}, 'current_price_usd': {'type': 'number'}, 'sensitivity_table': {'type': 'object', 'properties': {'values_usd': {'type': 'array', 'items': {'type': 'array', 'items': {'type': 'number'}}, 'description': 'Row = growth rate (index into growth_rates), col = wacc offset (index into wacc_offsets_pct).'}, 'growth_rates': {'type': 'array', 'items': {'type': 'number'}}, 'wacc_offsets_pct': {'type': 'array', 'items': {'type': 'number'}}}, 'description': 'Grid of intrinsic values: growth_rate rows Ã\x97 wacc_offset columns. WACC offsets from base: -2%, -1%, 0%, +1%, +2%.'}, 'weighted_intrinsic_usd': {'type': 'number', 'description': 'Probability-weighted composite intrinsic value across all three scenarios.'}, 'weighted_margin_of_safety_pct': {'type': 'number'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'erp': {'type': 'number', 'description': 'Equity risk premium in % (default 5.5 â\x80\x94 Damodaran mature market ERP). Override for emerging market exposure.'}, 'ticker': {'type': 'string', 'description': 'US stock ticker (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}, 'growth_rate': {'type': 'number', 'description': 'Annual FCF growth rate for 5-year projection in % (e.g. 15.0 = 15%). Overrides auto-detected analyst consensus EPS CAGR. Default: analyst 5Y consensus or FCF 3Y CAGR.'}, 'terminal_growth_rate': {'type': 'number', 'description': 'Perpetuity growth rate after year 5 in % (default 3.0 â\x80\x94 long-run GDP growth). Use 2.0â\x80\x933.5 for mature companies, 0â\x80\x932.0 for declining businesses.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'name': {'type': 'string'}, 'ticker': {'type': 'string'}, 'verdict': {'type': 'string', 'description': 'UNDERVALUED | FAIRLY_VALUED | OVERVALUED based on margin of safety.'}, 'upside_pct': {'type': 'number', 'description': 'Upside from current price to intrinsic value in %.'}, 'assumptions': {'type': 'object', 'properties': {'wacc_pct': {'type': 'number'}, 'growth_source': {'type': 'string', 'description': 'analyst_consensus | historical_cagr | caller_override'}, 'growth_rate_pct': {'type': 'number'}, 'projection_years': {'type': 'integer'}, 'terminal_growth_pct': {'type': 'number'}}, 'description': 'DCF assumptions used.'}, 'fcf_history': {'type': 'array', 'items': {'type': 'object', 'properties': {'year': {'type': 'string'}, 'fcf_usd': {'type': 'number'}}}, 'description': 'Historical free cash flows (operating CF â\x88\x92 capex) by fiscal year.'}, 'dcf_schedule': {'type': 'array', 'items': {'type': 'object', 'properties': {'year': {'type': 'integer'}, 'pv_usd': {'type': 'number'}, 'fcf_usd': {'type': 'number'}}}, 'description': 'Projected FCF and present value by year.'}, 'equity_bridge': {'type': 'object', 'properties': {'pv_fcfs_usd': {'type': 'number'}, 'diluted_shares': {'type': 'number'}, 'pv_terminal_usd': {'type': 'number'}, 'equity_value_usd': {'type': 'number'}, 'minus_net_debt_usd': {'type': 'number'}, 'enterprise_value_usd': {'type': 'number'}}}, 'terminal_value': {'type': 'object', 'properties': {'tv_usd': {'type': 'number', 'description': 'Undiscounted terminal value.'}, 'tv_pv_usd': {'type': 'number', 'description': 'Present value of terminal value.'}, 'terminal_fcf_usd': {'type': 'number'}}}, 'current_price_usd': {'type': 'number', 'description': 'Current market price per share.'}, 'intrinsic_value_usd': {'type': 'number', 'description': 'DCF intrinsic value per share.'}, 'margin_of_safety_pct': {'type': 'number', 'description': 'Margin of safety: (intrinsic â\x88\x92 price) / intrinsic Ã\x97 100. Positive = undervalued, negative = overvalued.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'coins': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of coin IDs to price. Accepts shorthand (eth, btc, sol), CoinGecko IDs (coingecko:ethereum), or contract addresses (ethereum:0xABC...). Max 10.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'prices': {'type': 'array', 'description': 'Price results [{id, symbol, price_usd, confidence, ts}].'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'protocols': {'type': 'array', 'items': {'type': 'string'}, 'description': "DefiLlama protocol slugs to look up (e.g. 'aave', 'uniswap-v3', 'lido'). Use lowercase-hyphenated form from defillama.com/protocol/... Max 3."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'protocols': {'type': 'array', 'description': 'Per-protocol result. Each entry contains TVL metrics (tvl_usd, tvl_change_1d/7d, chains, category) plus the native token price (token_price_usd) when available.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'protocol': {'type': 'string', 'description': "DefiLlama protocol slug (e.g. 'aave', 'uniswap-v3', 'lido', 'compound', 'maker'). Use lowercase-hyphenated form as seen on defillama.com/protocol/..."}, 'include_tvl_history': {'type': 'boolean', 'description': 'If true, include last 7 days of TVL history. Default false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'url': {'type': 'string', 'description': 'Official URL.'}, 'name': {'type': 'string', 'description': 'Protocol display name.'}, 'chains': {'type': 'array', 'description': 'Top chains by TVL: [{chain, tvl_usd}].'}, 'symbol': {'type': 'string', 'description': 'Native token ticker.'}, 'tvl_usd': {'type': 'number', 'description': 'Current total TVL in USD (excludes borrowed, staking, pool2).'}, 'category': {'type': 'string', 'description': 'Protocol category (e.g. Lending, DEX, Yield).'}, 'gecko_id': {'type': 'string', 'description': 'CoinGecko ID for the native token.'}, 'mcap_usd': {'type': 'number', 'description': 'Market cap of native token in USD (if available).'}, 'protocol': {'type': 'string', 'description': 'Protocol slug.'}, 'description': {'type': 'string', 'description': 'Short protocol description.'}, 'tvl_history': {'type': 'array', 'description': 'Last 7 days TVL [{date, tvl_usd}] â\x80\x94 only if include_tvl_history=true.'}, 'total_chains': {'type': 'integer', 'description': 'Number of chains the protocol is deployed on.'}, 'tvl_change_1d': {'type': 'number', 'description': 'TVL percentage change over last 24h.'}, 'tvl_change_7d': {'type': 'number', 'description': 'TVL percentage change over last 7 days.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chain': {'type': 'string', 'description': "Filter yield pools by blockchain (e.g. 'Ethereum', 'Base', 'Arbitrum'). Case-insensitive. Omit for all chains."}, 'min_apy': {'type': 'number', 'minimum': 0, 'description': 'Minimum 30-day mean APY percentage. Default 5%.'}, 'protocol': {'type': 'string', 'description': "Filter yield pools by protocol name (e.g. 'aave-v3', 'uniswap-v3'). Substring match."}, 'min_tvl_usd': {'type': 'number', 'minimum': 0, 'description': 'Minimum TVL in USD for yield pools. Default $1M.'}, 'yield_limit': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Number of yield pools to return (1â\x80\x9330, default 15).'}, 'market_limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Number of market movers per category (1â\x80\x9320, default 10).'}, 'include_equity': {'type': 'boolean', 'description': 'Include equity market movers (US stocks). Default false â\x80\x94 crypto only for speed.'}, 'stablecoin_only': {'type': 'boolean', 'description': 'Return only stablecoin yield pools (no impermanent loss). Default false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'market': {'type': 'object', 'properties': {'crypto_losers': {'type': 'array', 'items': {'type': 'object'}}, 'equity_active': {'type': 'array', 'items': {'type': 'object'}}, 'equity_losers': {'type': 'array', 'items': {'type': 'object'}}, 'crypto_gainers': {'type': 'array', 'items': {'type': 'object'}}, 'equity_gainers': {'type': 'array', 'items': {'type': 'object'}}}, 'description': 'Market movers snapshot.'}, 'summary': {'type': 'object', 'properties': {'top_apy': {'type': 'number'}, 'at_risk_pools': {'type': 'integer'}, 'boosted_pools': {'type': 'integer'}, 'top_crypto_loser': {'type': 'string'}, 'top_crypto_gainer': {'type': 'string'}, 'total_yield_pools': {'type': 'integer'}}}, 'yield_pools': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Top DeFi yield pools sorted by 30-day mean APY.'}, 'generated_at': {'type': 'string'}, 'cross_signals': {'type': 'array', 'items': {'type': 'object', 'properties': {'rank': {'type': 'integer'}, 'chain': {'type': 'string'}, 'signal': {'enum': ['boosted', 'at_risk', 'neutral'], 'type': 'string'}, 'protocol': {'type': 'string'}, 'pool_symbol': {'type': 'string'}, 'apy_30d_mean': {'type': 'number'}, 'interpretation': {'type': 'string'}, 'matched_symbol': {'type': ['string', 'null']}, 'market_change_pct': {'type': ['number', 'null']}}}, 'description': "Per-pool cross-signal: 'boosted' (yield + price momentum), 'at_risk' (yield + sell-off), or 'neutral'."}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chains': {'type': 'array', 'items': {'enum': ['ethereum', 'base', 'polygon', 'arbitrum'], 'type': 'string'}, 'description': 'Chains to scan. Defaults to all four.'}, 'address': {'type': 'string', 'description': 'EVM wallet address (0x + 40 hex chars).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'chains': {'type': 'array', 'description': 'Per-chain token holdings with USD values.'}, 'address': {'type': 'string', 'description': 'Wallet address queried.'}, 'total_usd': {'type': 'number', 'description': 'Total portfolio value in USD.'}, 'scanned_at': {'type': 'string', 'description': 'ISO-8601 scan timestamp.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'block': {'type': 'string', 'description': 'Block number (integer or 0x hex) or tag: latest/pending/earliest/safe/finalized. Default: latest.'}, 'min_apy': {'type': 'number', 'minimum': 0, 'description': 'Minimum 30-day mean APY (%) for yield pool inclusion. Default 0.'}, 'network': {'enum': ['ethereum', 'base', 'polygon', 'arbitrum'], 'type': 'string', 'description': 'Chain to query for block data. Default: ethereum.'}, 'top_pools': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Max number of yield pools to return, sorted by 30-day mean APY desc. Default 10, max 25.'}, 'alert_only': {'type': 'boolean', 'description': 'If true, only return stablecoins that are depegged (MILD_DEPEG or worse).'}, 'min_tvl_usd': {'type': 'number', 'minimum': 0, 'description': 'Minimum TVL in USD for yield pool inclusion. Default 1000000 ($1M).'}, 'yield_chain': {'type': 'string', 'description': "Filter yield pools by blockchain (e.g. 'Ethereum', 'Base', 'Arbitrum'). Case-insensitive. Omit for all chains."}, 'yield_protocol': {'type': 'string', 'description': "Filter yield pools by protocol name (e.g. 'aave-v3', 'uniswap-v3'). Case-insensitive substring."}, 'stablecoin_symbol': {'type': 'string', 'description': 'Filter stablecoins to a specific symbol (e.g. USDT, USDC, DAI). Omit to return top 10 by market cap.'}, 'stablecoin_pools_only': {'type': 'boolean', 'description': 'If true, only return stablecoin-only yield pools.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'block': {'type': 'object', 'properties': {'hash': {'type': 'string'}, 'miner': {'type': 'string'}, 'network': {'type': 'string'}, 'gas_used': {'type': 'integer'}, 'tx_count': {'type': 'integer'}, 'gas_limit': {'type': 'integer'}, 'block_number': {'type': 'integer'}, 'base_fee_gwei': {'type': ['number', 'null']}, 'timestamp_iso': {'type': 'string'}, 'timestamp_unix': {'type': 'integer'}}, 'description': 'Block header from the requested chain.'}, 'stablecoins': {'type': 'object', 'properties': {'coins': {'type': 'array', 'items': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'symbol': {'type': 'string'}, 'depeg_status': {'type': 'string'}, 'peg_deviation': {'type': 'number'}, 'circulating_bn': {'type': 'number'}}}}, 'count': {'type': 'integer'}, 'alert_level': {'type': 'string', 'description': 'GREEN | YELLOW | ORANGE | RED'}}}, 'yield_pools': {'type': 'object', 'properties': {'pools': {'type': 'array', 'items': {'type': 'object', 'properties': {'rank': {'type': 'integer'}, 'chain': {'type': 'string'}, 'symbol': {'type': 'string'}, 'il_risk': {'type': 'string'}, 'tvl_usd': {'type': 'number'}, 'protocol': {'type': 'string'}, 'stablecoin': {'type': 'boolean'}, 'apy_current': {'type': 'number'}, 'apy_30d_mean': {'type': 'number'}}}}, 'total_matching': {'type': 'integer'}, 'total_returned': {'type': 'integer'}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chain': {'type': 'string', 'description': 'Filter to a specific chain (e.g. Ethereum, Base, Solana, Arbitrum, Polygon). Case-insensitive. Omit for all chains.'}, 'limit': {'type': 'integer', 'description': 'Max results to return (default 20, max 50).'}, 'min_apy': {'type': 'number', 'description': 'Minimum APY percentage (e.g. 5 for 5%). Default: 0.'}, 'min_tvl_usd': {'type': 'number', 'description': 'Minimum TVL in USD (e.g. 1000000 for $1M). Default: 100000.'}, 'stablecoin_only': {'type': 'boolean', 'description': 'If true, return only stablecoin-denominated pools. Default: false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'pools': {'type': 'array', 'items': {'type': 'object', 'properties': {'apy': {'type': 'number', 'description': 'Total APY % (base + reward).'}, 'url': {'type': 'string', 'description': 'DeFiLlama pool page URL.'}, 'chain': {'type': 'string', 'description': 'Chain name.'}, 'symbol': {'type': 'string', 'description': 'Pool token symbol (e.g. USDC, ETH-USDC).'}, 'pool_id': {'type': 'string', 'description': 'DeFiLlama pool UUID for precise reference.'}, 'project': {'type': 'string', 'description': 'Protocol name (e.g. aave-v3, uniswap-v3).'}, 'tvl_usd': {'type': 'number', 'description': 'Total value locked in USD.'}, 'apy_base': {'type': 'number', 'description': 'Base APY % (lending/protocol yield, no token rewards).'}, 'apy_reward': {'type': 'number', 'description': 'Reward APY % (token incentives on top of base).'}, 'stablecoin': {'type': 'boolean', 'description': 'True if pool is denominated in stablecoins.'}, 'apy_7d_pct_change': {'type': 'number', 'description': 'APY change over last 7 days in percentage points.'}}}, 'description': 'Yield pools matching filters, sorted by APY descending.'}, 'total_matched': {'type': 'integer', 'description': 'Total pools matching the given filters before the limit was applied.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chains': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Optional list of chains to include (e.g. ["Ethereum", "Base", "Arbitrum"]). Omit for all chains.'}, 'amount_usd': {'type': 'number', 'description': 'Portfolio size in USD to allocate (e.g. 10000).'}, 'max_positions': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Maximum number of positions in the strategy. Default: 5.'}, 'risk_tolerance': {'enum': ['low', 'medium', 'high'], 'type': 'string', 'description': 'Risk tier: low (stablecoin-only, large TVL), medium (mixed assets, min $10M TVL), high (any asset, min $1M TVL). Default: medium.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'note': {'type': 'string', 'description': 'Optional note if no pools matched filters.'}, 'summary': {'type': 'object', 'properties': {'positions': {'type': 'integer', 'description': 'Number of positions in strategy.'}, 'risk_tier': {'type': 'string', 'description': 'Risk tier used.'}, 'chains_included': {'type': 'string', 'description': 'Chains included in strategy.'}, 'weighted_avg_apy': {'type': 'number', 'description': 'Allocation-weighted average APY %.'}, 'total_allocated_usd': {'type': 'number', 'description': 'Total portfolio amount allocated.'}, 'estimated_annual_yield_usd': {'type': 'number', 'description': 'Expected annual yield (weekly Ã\x97 52).'}, 'estimated_weekly_yield_usd': {'type': 'number', 'description': 'Expected weekly yield across all positions.'}}}, 'strategy': {'type': 'array', 'items': {'type': 'object', 'properties': {'apy': {'type': 'number', 'description': 'Current APY %.'}, 'pool': {'type': 'string', 'description': 'DeFiLlama pool UUID.'}, 'chain': {'type': 'string', 'description': 'Blockchain name.'}, 'symbol': {'type': 'string', 'description': 'Pool token symbol.'}, 'tvl_usd': {'type': 'number', 'description': 'Total value locked in USD.'}, 'protocol': {'type': 'string', 'description': 'DeFi protocol name.'}, 'stablecoin': {'type': 'boolean', 'description': 'True if stablecoin pool.'}, 'allocated_usd': {'type': 'number', 'description': 'Recommended allocation in USD.'}, 'apy_7d_change': {'type': 'number', 'description': '7-day APY change in percentage points.'}, 'allocation_pct': {'type': 'number', 'description': 'Allocation as percent of total portfolio.'}, 'weekly_yield_usd': {'type': 'number', 'description': 'Estimated weekly yield in USD.'}}}, 'description': 'Recommended positions with allocation details.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Token symbol (e.g. SOL, ETH, USDC), name, or contract address to search.'}, 'chain': {'type': 'string', 'description': 'Optional: filter to a specific chain ID (solana, base, eth, bsc, arbitrum, polygon, etc.).'}, 'limit': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Max pairs to return (1â\x80\x9330). Default 10.'}, 'min_liquidity_usd': {'type': 'number', 'description': 'Filter pairs with less than this USD liquidity. Default 10000.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'count': {'type': 'integer'}, 'pairs': {'type': 'array', 'items': {'type': 'object', 'properties': {'dex': {'type': 'string'}, 'fdv': {'type': 'number'}, 'chain': {'type': 'string'}, 'txns_h24': {'type': 'object'}, 'price_usd': {'type': 'number'}, 'base_token': {'type': 'object'}, 'volume_usd': {'type': 'object'}, 'quote_token': {'type': 'object'}, 'pair_address': {'type': 'string'}, 'price_change': {'type': 'object'}, 'liquidity_usd': {'type': 'number'}, 'buy_pressure_24h_pct': {'type': 'number', 'description': '% of 24h txns that were buys. >50 = net accumulation.'}}}}, 'query': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'slippage': {'type': 'number', 'maximum': 0.5, 'minimum': 0.0001, 'description': 'Max slippage tolerance as a decimal (0.005 = 0.5%). Default 0.03 (3%).'}, 'to_chain': {'type': 'string', 'description': 'Destination chain. Same as from_chain for same-chain swaps. Use chain name or ID.'}, 'to_token': {'type': 'string', 'description': 'Destination token â\x80\x94 symbol or ERC-20 contract address.'}, 'from_chain': {'type': 'string', 'description': 'Source chain â\x80\x94 name (ethereum, base, polygon, arbitrum, optimism, bsc, avalanche) or chain ID integer.'}, 'from_token': {'type': 'string', 'description': 'Source token â\x80\x94 symbol (ETH, USDC, WBTC, USDT, MATIC, LINK) or ERC-20 contract address.'}, 'from_amount': {'type': 'string', 'description': "Amount to quote, in human-readable source-token units: '3' means 3 USDC, whether from_token is USDC or its contract address. Decimals are resolved from chain-specific token metadata. Prefix an integer with '!' for explicit smallest units: '!3000000' means 3 USDC with 6 decimals. Plain '3000000' means 3 million tokens. Positive amounts only; excess decimal places are rejected without rounding."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'route': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Ordered list of DEX/bridge names used.'}, 'fee_usd': {'type': 'number', 'description': 'Protocol/integrator fees in USD.'}, 'quote_ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this quote.'}, 'to_chain': {'type': 'string'}, 'to_token': {'type': 'string'}, 'to_amount': {'type': 'number', 'description': 'Expected output amount (before slippage).'}, 'from_chain': {'type': 'string'}, 'from_token': {'type': 'string'}, 'cross_chain': {'type': 'boolean', 'description': 'True if this is a cross-chain swap/bridge.'}, 'from_amount': {'type': 'number', 'description': 'Human-readable input amount.'}, 'gas_cost_usd': {'type': 'number', 'description': 'Estimated gas cost in USD.'}, 'price_impact': {'type': 'string', 'description': 'Estimated price impact percentage, if available.'}, 'exchange_rate': {'type': 'number', 'description': 'toToken per fromToken.'}, 'to_amount_min': {'type': 'number', 'description': 'Minimum guaranteed output (after slippage).'}, 'from_amount_atomic': {'type': 'string', 'description': 'Exact integer source-token amount sent to the quote provider.'}, 'from_token_decimals': {'type': 'integer', 'description': 'Source token decimal places confirmed by token metadata or the returned quote.'}, 'execution_time_seconds': {'type': 'number', 'description': 'Estimated execution time (bridge + swap).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Page of trending pools (20 per page). Default 1, max 10.'}, 'network': {'type': 'string', 'description': 'Network ID to query. Common: eth, base, bsc, arbitrum, polygon_pos, solana, avax, optimism. Default: base.'}, 'buy_pressure_min': {'type': 'number', 'maximum': 100, 'minimum': 0, 'description': 'Only return pools where buy_pressure_24h_pct >= this value (e.g. 60 = at least 60% buys). Omit for no filter.'}, 'min_volume_usd_24h': {'type': 'number', 'description': 'Filter pools with less than this 24h volume. Default 10000.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'count': {'type': 'integer'}, 'pools': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'pool': {'type': 'string'}, 'address': {'type': 'string'}, 'fdv_usd': {'type': 'number'}, 'pool_age': {'type': 'string'}, 'volume_usd_24h': {'type': 'number'}, 'base_token_price': {'type': 'number'}, 'price_change_pct': {'type': 'object'}, 'transactions_h24': {'type': 'object'}, 'buy_pressure_24h_pct': {'type': 'number', 'description': '% of 24h txns that were buys. >50 = accumulation, <50 = distribution.'}}}, 'description': 'Trending pools sorted by GeckoTerminal trending rank.'}, 'network': {'type': 'string'}, 'total_returned': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'lang': {'type': 'string', 'description': "Language code. Currently 'en' is best supported. Default: en."}, 'word': {'type': 'string', 'description': "English word to look up (e.g. 'serendipity', 'run', 'ephemeral'). Single word or compound (e.g. 'machine learning')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'word': {'type': 'string'}, 'meanings': {'type': 'array', 'items': {'type': 'object', 'properties': {'antonyms': {'type': 'array', 'items': {'type': 'string'}}, 'synonyms': {'type': 'array', 'items': {'type': 'string'}}, 'definitions': {'type': 'array', 'items': {'type': 'object', 'properties': {'example': {'type': 'string'}, 'antonyms': {'type': 'array', 'items': {'type': 'string'}}, 'synonyms': {'type': 'array', 'items': {'type': 'string'}}, 'definition': {'type': 'string'}}}}, 'part_of_speech': {'type': 'string'}}}}, 'phonetic': {'type': 'string', 'description': 'IPA phonetic transcription.'}, 'audio_url': {'type': 'string', 'description': 'MP3 pronunciation URL (when available).'}, 'etymology': {'type': 'string', 'description': 'Word origin/etymology (when available).'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'date': {'type': 'string', 'description': 'Target date in YYYY-MM-DD format. Default: today (UTC).'}, 'days_ahead': {'type': 'integer', 'maximum': 7, 'minimum': 1, 'description': 'Fetch dividends for this many calendar days starting from `date`. Default: 1 (single day). Max: 7.'}, 'min_dividend': {'type': 'number', 'description': 'Filter: minimum dividend amount per share (USD). Default: no filter.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'Date range queried'}, 'count': {'type': 'integer'}, 'events': {'type': 'array', 'items': {'type': 'object', 'properties': {'symbol': {'type': 'string'}, 'company': {'type': 'string'}, 'ex_date': {'type': 'string'}, 'announced': {'type': 'string'}, 'record_date': {'type': 'string'}, 'dividend_usd': {'type': 'number'}, 'payment_date': {'type': 'string'}, 'annual_yield_usd': {'type': 'number'}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker (e.g. AAPL, JNJ, KO, T, SCHD). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'name': {'type': ['string', 'null']}, 'ticker': {'type': 'string'}, 'history': {'type': 'array', 'items': {'type': 'object', 'properties': {'amount': {'type': 'number'}, 'ex_date': {'type': 'string'}}}, 'description': 'Dividend payments, most recent first (up to 5 years).'}, 'currency': {'type': 'string'}, 'price_usd': {'type': 'number', 'description': 'Current market price.'}, 'cagr_5yr_pct': {'type': ['number', 'null'], 'description': '5-year compound annual growth rate of total annual dividends. Null if < 2 years of data.'}, 'pays_dividend': {'type': 'boolean', 'description': 'False if no dividends found in 5-year history.'}, 'payout_frequency': {'enum': ['monthly', 'quarterly', 'semi-annual', 'annual', 'unknown', 'none'], 'type': 'string'}, 'forward_yield_pct': {'type': ['number', 'null'], 'description': 'forward_annual_rate / current price Ã\x97 100.'}, 'trailing_yield_pct': {'type': ['number', 'null'], 'description': 'Trailing 12-month dividend yield as a percentage of current price.'}, 'forward_annual_rate': {'type': ['number', 'null'], 'description': 'Estimated annual dividend based on most recent declared amount Ã\x97 frequency.'}, 'most_recent_dividend': {'type': ['object', 'null'], 'properties': {'amount': {'type': 'number'}, 'ex_date': {'type': 'string', 'description': 'ISO-8601 ex-dividend date.'}}}, 'consecutive_years_paid': {'type': ['integer', 'null'], 'description': 'Number of consecutive years with at least one dividend payment (up to 5-year history).'}, 'consecutive_years_growth': {'type': ['integer', 'null'], 'description': 'Number of consecutive years with annual dividend growth (most recent streak).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'type': {'enum': ['A', 'AAAA', 'MX', 'TXT', 'CNAME', 'NS', 'SOA', 'CAA', 'ALL'], 'type': 'string', 'description': "DNS record type to query. 'ALL' queries A, MX, TXT, NS, and CNAME in parallel and returns all results. Default: 'A'."}, 'domain': {'type': 'string', 'description': "Domain name to look up (e.g. 'github.com', 'mail.google.com')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'domain': {'type': 'string'}, 'records': {'type': 'array'}, 'txt_intel': {'type': ['object', 'null'], 'description': 'SPF/DMARC/DKIM signals (TXT and ALL only).'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'text': {'type': 'string', 'description': 'Document text to prepare (plain text, Markdown, or lightly-structured prose). Max 500,000 chars.'}, 'metadata': {'type': 'string', 'description': 'Optional key-value metadata to attach to every chunk (e.g. source URL, document ID).'}, 'overlap_tokens': {'type': 'integer', 'description': 'Token overlap between consecutive chunks for context continuity (default 50, max 512).'}, 'chunk_size_tokens': {'type': 'integer', 'description': 'Target chunk size in tokens (default 512, max 4096). Uses 4-char-per-token estimate.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'chunks': {'type': 'array', 'description': 'Embeddable text chunks with IDs and token estimates.'}, 'chunk_count': {'type': 'integer'}, 'generated_at': {'type': 'string'}, 'avg_chunk_tokens': {'type': 'number'}, 'document_metadata': {'type': 'object', 'description': 'Extracted document properties.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string', 'description': "Base domain name to check, without TLD (e.g. 'acme', 'my-startup'). Can also be a full domain like 'acme.com' â\x80\x94 the TLD will be stripped and checked alongside others unless tlds is set."}, 'tlds': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of TLDs to check (without dot). Defaults to: com, net, org, io, ai, co, app, dev. Max 10.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'errors': {'type': 'array', 'items': {'type': 'string'}}, 'details': {'type': 'array', 'items': {'type': 'object'}}, 'available': {'type': 'array', 'items': {'type': 'string'}}, 'base_name': {'type': 'string'}, 'checked_at': {'type': 'string'}, 'registered': {'type': 'array', 'items': {'type': 'string'}}, 'available_count': {'type': 'number'}, 'registered_count': {'type': 'number'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'domain': {'type': 'string', 'description': "Domain name to look up (e.g. 'example.com', 'github.io', 'bbc.co.uk'). Strip 'www.' prefix."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'tech': {'type': 'object'}, 'admin': {'type': 'object'}, 'domain': {'type': 'string'}, 'handle': {'type': 'string', 'description': 'Registrar-assigned domain handle.'}, 'status': {'type': 'array', 'description': 'EPP status codes.'}, 'expires': {'type': 'string', 'description': 'Expiration date (ISO 8601).'}, 'updated': {'type': 'string', 'description': 'Last modification date (ISO 8601).'}, 'registrar': {'type': 'object'}, 'registered': {'type': 'string', 'description': 'Registration date (ISO 8601).'}, 'registrant': {'type': 'object'}, 'nameservers': {'type': 'array'}, 'generated_at': {'type': 'string'}, 'days_until_expiry': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'drug_name': {'type': 'string', 'description': "Drug name â\x80\x94 brand or generic (e.g. 'ibuprofen', 'Tylenol', 'metformin', 'Lipitor')."}, 'query_type': {'enum': ['label', 'adverse_events', 'recalls', 'all'], 'type': 'string', 'description': "Which FDA data to retrieve. 'all' returns label + adverse event summary + recent recalls. Default: 'label'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'label': {'type': 'object'}, 'recalls': {'type': 'object'}, 'drug_name': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'adverse_events': {'type': 'object'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 14, 'minimum': 1, 'description': 'Look-ahead window in days (default 7).'}, 'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "'standard' = 150-200 word narrative (default). 'concise' = 80-100 words."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'headline': {'type': 'string', 'description': 'Single most important earnings catalyst.'}, 'narrative': {'type': 'string', 'description': 'Full briefing paragraph.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'window_end': {'type': 'string', 'description': 'Window end date (YYYY-MM-DD).'}, 'agent_watch': {'type': 'string', 'description': 'What agents should monitor.'}, 'window_days': {'type': 'integer', 'description': 'Requested look-ahead window.'}, 'generated_at': {'type': 'string'}, 'sector_focus': {'type': 'string', 'description': 'Sector concentration this reporting period.'}, 'total_events': {'type': 'integer', 'description': 'Total earnings events in the window.'}, 'window_start': {'type': 'string', 'description': 'Window start date (YYYY-MM-DD).'}, 'events_sample': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Top 10 events in the window (bellwethers first).'}, 'bellwether_count': {'type': 'integer', 'description': 'Number of major bellwethers reporting.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max results (default 20, max 100). Ignored when symbol is provided (returns all matches).'}, 'symbol': {'type': 'string', 'description': 'Optional single ticker, such as NVDA or AAPL. Omit to get all earnings in the window. Multiple tickers are not supported.'}, 'days_ahead': {'type': 'integer', 'maximum': 90, 'minimum': 1, 'description': 'Calendar days ahead to include (1â\x80\x9390, default 7).'}}, 'additionalProperties': False}

{'type': 'object', 'examples': [{'as_of': '2026-09-22T08:12:35.278Z', 'total': 4437, 'earnings': [{'name': 'ATLANTIC AMERICAN CORPORATION', 'symbol': 'AAME', 'timing': None, 'currency': 'USD', 'report_date': '2026-09-22', 'eps_estimate': None, 'fiscal_period_end': '2026-06-30'}, {'name': 'ALPS GROUP INCORPORATED', 'symbol': 'ALPS', 'timing': None, 'currency': 'USD', 'report_date': '2026-09-22', 'eps_estimate': None, 'fiscal_period_end': '2026-06-30'}, {'name': 'AMERICAN RESOURCES CORPORATION', 'symbol': 'AREC', 'timing': None, 'currency': 'USD', 'report_date': '2026-09-22', 'eps_estimate': -0.09, 'fiscal_period_end': '2026-06-30'}, {'name': 'AYTU BIOPHARMA INCORPORATED', 'symbol': 'AYTU', 'timing': 'post-market', 'currency': 'USD', 'report_date': '2026-09-22', 'eps_estimate': -0.22, 'fiscal_period_end': '2026-06-30'}], 'window_end': '2026-12-21'}], 'required': ['earnings', 'total', 'window_end', 'as_of'], 'properties': {'as_of': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'total': {'type': 'integer', 'description': 'Total matching results before limit applied.'}, 'earnings': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': ['string', 'null'], 'description': 'Company name.'}, 'symbol': {'type': 'string', 'description': 'Ticker symbol.'}, 'timing': {'type': ['string', 'null'], 'description': 'pre-market | post-market | null'}, 'currency': {'type': 'string', 'description': 'Reporting currency (usually USD).'}, 'report_date': {'type': 'string', 'description': 'Earnings report date (YYYY-MM-DD).'}, 'eps_estimate': {'type': ['number', 'null'], 'description': 'Consensus EPS estimate (null if not available).'}, 'fiscal_period_end': {'type': ['string', 'null'], 'description': 'Fiscal quarter/year end date.'}}}}, 'window_end': {'type': 'string', 'description': 'Last date included (YYYY-MM-DD).'}}, 'x-stall-example-provenance': {'kind': 'historical verified diagnostic response', 'resources': [{'host': 'www.alphavantage.co', 'path': '/query', 'bytes': 270134, 'sha256': 'c9f89d3a82bffa8709ed838b05b37594d37c2d9c317d96bf0a5f18f528f148d7', 'status': 200, 'observed_at': '2026-09-22T08:12:35.271Z'}], 'observed_at': '2026-09-22T08:12:35.278Z', 'current_data': False, 'output_sha256': '1b6719d8c8a827a784f3ed81441cf70cb16ab74658fb11a90d33193933be0921', 'source_sha256': '5cdcfc04e2c297f48f64e60e82d2b687f49892b4e43fe07f6b4e730c367d9211'}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['symbol'], 'properties': {'symbol': {'type': 'string', 'description': "US equity ticker symbol (e.g. 'AAPL', 'MSFT', 'NVDA')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'symbol': {'type': 'string'}, 'periods': {'type': 'object', 'description': 'Estimates keyed by period: current_quarter, next_quarter, current_year, next_year.', 'additionalProperties': {'type': 'object', 'properties': {'period': {'type': 'string', 'description': 'Yahoo period code (0q, +1q, 0y, +1y).'}, 'end_date': {'type': ['string', 'null']}, 'eps_trend': {'type': 'object', 'properties': {'current': {'type': ['number', 'null']}, 'days_7_ago': {'type': ['number', 'null']}, 'days_30_ago': {'type': ['number', 'null']}, 'days_60_ago': {'type': ['number', 'null']}, 'days_90_ago': {'type': ['number', 'null']}}, 'description': 'How the mean EPS estimate has drifted. Rising = positive revision momentum.'}, 'revisions': {'type': 'object', 'properties': {'up_last_7d': {'type': ['integer', 'null']}, 'up_last_30d': {'type': ['integer', 'null']}, 'down_last_30d': {'type': ['integer', 'null']}, 'down_last_90d': {'type': ['integer', 'null']}}, 'description': 'Analyst estimate revision counts. More ups than downs = bullish momentum.'}, 'eps_estimate': {'type': 'object', 'properties': {'avg': {'type': ['number', 'null'], 'description': 'Mean EPS estimate.'}, 'low': {'type': ['number', 'null']}, 'high': {'type': ['number', 'null']}, 'growth_pct': {'type': ['number', 'null'], 'description': 'Forecast YoY EPS growth %.'}, 'num_analysts': {'type': ['integer', 'null']}, 'year_ago_eps': {'type': ['number', 'null']}}}, 'revenue_estimate': {'type': 'object', 'properties': {'avg': {'type': ['number', 'null'], 'description': 'Mean revenue estimate (USD).'}, 'low': {'type': ['number', 'null']}, 'high': {'type': ['number', 'null']}, 'year_ago': {'type': ['number', 'null']}, 'growth_pct': {'type': ['number', 'null'], 'description': 'Forecast YoY revenue growth %.'}, 'num_analysts': {'type': ['integer', 'null']}}}}}}, 'related_capabilities': {'type': 'array', 'items': {'type': 'object', 'properties': {'cap': {'type': 'string'}, 'price': {'type': 'string'}, 'description': {'type': 'string'}}}, 'description': 'Other STALL caps for equity research workflows.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, MSFT, NVDA).'}, 'days_ahead': {'type': 'integer', 'description': 'Look-ahead window for earnings calendar (1â\x80\x9390 days, default 30).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ticker', 'as_of'], 'properties': {'fomc': {'type': 'object', 'description': 'Current fed funds rate and next meeting from fomc-tracker.'}, 'as_of': {'type': 'string'}, 'errors': {'type': 'object', 'description': 'Any per-source errors (non-fatal; other fields still populated).'}, 'ticker': {'type': 'string'}, 'fundamentals': {'type': 'object', 'description': 'Valuation metrics from equity-fundamentals.'}, 'earnings_calendar': {'type': 'object', 'description': 'Upcoming earnings dates from earnings-calendar (filtered to ticker).'}, 'earnings_surprises': {'type': 'object', 'description': 'EPS beat/miss history from earnings-surprises.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, MSFT, ENRN). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ticker': {'type': 'string'}, 'beneish': {'type': 'object', 'properties': {'note': {'type': ['string', 'null'], 'description': 'Caveat when components substituted with neutral defaults.'}, 'm_score': {'type': ['number', 'null'], 'description': 'Beneish M-Score. > -1.78: manipulation risk. -2.22 to -1.78: borderline. < -2.22: likely clean.'}, 'components': {'type': 'object', 'description': '8 M-Score component values: DSRI, GMI, AQI, SGI, DEPI, SGAI, LVGI, TATA.'}, 'manipulation_risk': {'type': 'string', 'description': 'MANIPULATION_RISK | BORDERLINE | LIKELY_CLEAN | INSUFFICIENT_DATA'}, 'components_available': {'type': 'integer', 'description': 'Number of components computed from available data (max 8).'}}, 'description': 'Beneish M-Score analysis (Beneish 1999).'}, 'accruals': {'type': 'object', 'properties': {'accrual_signal': {'type': 'string', 'description': 'HIGH_ACCRUALS | MODERATE_ACCRUALS | NEUTRAL | CASH_BACKED | INSUFFICIENT_DATA'}, 'sloan_accrual_ratio': {'type': ['number', 'null'], 'description': '(NI - OCF) / Avg Total Assets. Negative = cash-backed. > 0.10 = high accruals.'}, 'cash_conversion_ratio': {'type': ['number', 'null'], 'description': 'OCF / NI. > 1.0 = cash-backed. < 0.5 = earnings not converting to cash.'}}, 'description': 'Sloan accrual ratio and cash conversion quality.'}, 'risk_flags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Triggered quality warnings (BENEISH_MANIPULATION_RISK, HIGH_ACCRUAL_RATIO, AR_OUTPACING_REVENUE, etc.).'}, 'retrieved_at': {'type': 'string'}, 'overall_quality': {'type': 'string', 'description': 'Composite verdict: HIGH | MEDIUM | LOW | INSUFFICIENT_DATA'}, 'revenue_quality': {'type': ['object', 'null'], 'properties': {'signal': {'type': 'string', 'description': 'AR_GROWING_FASTER_THAN_REVENUE | MILD_AR_DIVERGENCE | ALIGNED | REVENUE_GROWING_FASTER_THAN_AR'}, 'revenue_growth_pct': {'type': 'number', 'description': 'Year-over-year revenue growth %.'}, 'receivables_growth_pct': {'type': 'number', 'description': 'Year-over-year AR growth %.'}, 'ar_vs_revenue_spread_pct': {'type': 'number', 'description': 'AR growth minus revenue growth %. Positive = AR growing faster (warning).'}}, 'description': 'Receivables growth vs revenue growth divergence. Null if data unavailable.'}, 'statement_period': {'type': ['string', 'null'], 'description': 'Fiscal year end of most recent annual statements (YYYY-MM-DD).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US equity ticker symbol (e.g. AAPL, MSFT, NVDA).'}, 'periods': {'type': 'integer', 'maximum': 16, 'minimum': 1, 'description': 'Number of past earnings periods to return (default 8, max 16).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'name': {'type': 'string'}, 'ticker': {'type': 'string'}, 'earnings': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'period': {'type': ['string', 'null']}, 'eps_actual': {'type': ['number', 'null']}, 'prev_close': {'type': ['number', 'null']}, 'eps_estimate': {'type': ['number', 'null']}, 'surprise_pct': {'type': ['number', 'null']}, 'reaction_class': {'type': 'string'}, 'two_day_move_pct': {'type': ['number', 'null']}, 'next_day_move_pct': {'type': ['number', 'null']}, 'report_day_move_pct': {'type': ['number', 'null']}}}}, 'beat_rate_pct': {'type': ['number', 'null']}, 'periods_shown': {'type': 'integer'}, 'avg_two_day_move_pct': {'type': ['number', 'null']}, 'avg_report_day_move_pct': {'type': ['number', 'null']}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}, 'quarters': {'type': 'integer', 'maximum': 8, 'minimum': 1, 'description': 'Number of past quarters to return (1-8, default 4).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'name': {'type': 'string', 'description': 'Company name.'}, 'annual': {'type': 'array', 'items': {'type': 'object', 'properties': {'year': {'type': 'integer', 'description': 'Fiscal year (e.g. 2025).'}, 'revenue_usd': {'type': 'number', 'description': 'Annual revenue in USD.'}, 'net_income_usd': {'type': 'number', 'description': 'Annual net income in USD.'}, 'profit_margin_pct': {'type': 'number', 'description': 'Net profit margin %.'}}}, 'description': 'Annual revenue and earnings history, newest first.'}, 'ticker': {'type': 'string', 'description': 'Canonical ticker symbol.'}, 'quarterly': {'type': 'array', 'items': {'type': 'object', 'properties': {'period': {'type': 'string', 'description': 'Calendar quarter label (e.g. 2Q2025).'}, 'actual_eps': {'type': 'number', 'description': 'Reported EPS (USD).'}, 'estimate_eps': {'type': 'number', 'description': 'Consensus EPS estimate at time of report (USD).'}, 'surprise_pct': {'type': 'number', 'description': 'EPS surprise % (positive = beat, negative = miss).'}, 'reported_date': {'type': 'string', 'description': 'ISO date when earnings were reported.'}, 'fiscal_quarter': {'type': 'string', 'description': 'Fiscal quarter label (e.g. 3Q2025).'}, 'period_end_date': {'type': 'string', 'description': 'ISO date of fiscal period end.'}}}, 'description': 'Historical quarterly EPS results, newest first.'}, 'beat_rate_pct': {'type': 'number', 'description': '% of quarters in sample where actual EPS beat estimate.'}, 'avg_surprise_pct': {'type': 'number', 'description': 'Average EPS surprise % across the sample.'}, 'next_earnings_date': {'type': 'string', 'description': 'ISO date of next expected earnings report (if announced).'}, 'current_quarter_estimate': {'type': 'number', 'description': 'Current consensus EPS estimate for next unreported quarter (USD).'}, 'estimate_revision_30d_pct': {'type': 'number', 'description': '% change in current quarter EPS estimate over last 30 days. Positive = upward revisions.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'lat': {'type': 'number', 'description': 'Latitude in decimal degrees. Required for location mode.'}, 'lon': {'type': 'number', 'description': 'Longitude in decimal degrees. Required for location mode.'}, 'days': {'type': 'number', 'description': 'Look-back window in days (1â\x80\x9330). Default: 7.'}, 'mode': {'enum': ['recent', 'location'], 'type': 'string', 'description': 'recent = global events sorted by time/magnitude; location = near a lat/lon coordinate. Default: recent.'}, 'limit': {'type': 'number', 'description': 'Maximum results to return (5â\x80\x9350). Default: 20.'}, 'radius_km': {'type': 'number', 'description': 'Search radius in km for location mode (10â\x80\x931000). Default: 500.'}, 'min_magnitude': {'type': 'number', 'description': 'Minimum reported magnitude, clamped to 1.0â\x80\x939.9. Default: 5.0 (recent) or 3.0 (location).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string'}, 'events': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'cdi': {'type': ['number', 'null'], 'description': 'Community Internet Intensity Map (felt shaking, 1-10).'}, 'mmi': {'type': ['number', 'null'], 'description': 'Instrumental intensity (ShakeMap, 1-10).'}, 'url': {'type': ['string', 'null']}, 'alert': {'type': ['string', 'null'], 'description': 'PAGER alert level: green/yellow/orange/red.'}, 'place': {'type': ['string', 'null']}, 'tsunami': {'type': 'boolean'}, 'depth_km': {'type': ['number', 'null']}, 'latitude': {'type': 'number'}, 'mag_type': {'type': ['string', 'null']}, 'time_utc': {'type': 'string'}, 'longitude': {'type': 'number'}, 'magnitude': {'type': 'number'}, 'felt_reports': {'type': 'number'}, 'significance': {'type': 'number', 'description': 'USGS significance score (0-1000+).'}}}}, 'summary': {'type': 'object', 'properties': {'avg_depth_km': {'type': ['number', 'null']}, 'max_magnitude': {'type': ['number', 'null']}, 'tsunami_flags': {'type': 'number'}, 'tsunami_warnings': {'type': 'number', 'description': 'Legacy alias for tsunami_flags; NOT a count of current official warnings.'}, 'significant_events': {'type': 'number', 'description': 'Events with USGS significance score >= 600.'}, 'max_magnitude_place': {'type': ['string', 'null']}}}, 'count_scope': {'type': 'string'}, 'total_count': {'type': 'number', 'description': 'Matching valid events in the retrieved batch before the result limit; not a complete catalog count.'}, 'window_days': {'type': 'number'}, 'cache_status': {'enum': ['live', 'fresh_cache', 'stale_cache'], 'type': 'string'}, 'returned_count': {'type': 'number'}, 'upstream_count': {'type': ['number', 'null']}, 'warning_notice': {'type': 'string'}, 'data_fetched_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days_ahead': {'type': 'integer', 'maximum': 90, 'minimum': 1, 'description': 'How many calendar days ahead to include (default: 30, max: 90).'}, 'category_filter': {'enum': ['all', 'employment', 'inflation', 'growth', 'monetary_policy', 'housing', 'trade'], 'type': 'string', 'description': "Filter by economic category. Default: 'all'."}, 'priority_filter': {'enum': ['all', 'high', 'high_medium'], 'type': 'string', 'description': "Filter by priority level. 'high' returns only market-moving releases (CPI, NFP, FOMC, GDP, PCE, PPI, JOLTS). 'high_medium' adds Retail Sales, Housing Starts, Durable Goods. 'all' returns every release. Default: 'all'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'events': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string', 'description': 'ISO-8601 date (YYYY-MM-DD).'}, 'period': {'type': 'string', 'description': "Reference period (e.g. 'May 2026', 'Q1 2026 (Advance)')."}, 'source': {'type': 'string', 'description': 'Source agency: BLS | Fed | BEA | Census.'}, 'time_et': {'type': 'string', 'description': 'Release time in US Eastern Time.'}, 'category': {'type': 'string', 'description': 'Economic category: employment | inflation | growth | monetary_policy | housing | trade | other.'}, 'priority': {'type': 'string', 'description': 'Market-impact tier: high | medium | low.'}, 'days_until': {'type': 'integer', 'description': 'Calendar days from today until this release.'}, 'report_name': {'type': 'string', 'description': 'Official name of the release.'}}}}, 'bls_live': {'type': 'boolean', 'description': 'Whether BLS live data was successfully fetched.'}, 'days_ahead': {'type': 'integer', 'description': 'Horizon used.'}, 'total_count': {'type': 'integer', 'description': 'Total events returned.'}, 'next_high_priority': {'type': 'object', 'description': 'The single next HIGH-priority release.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'cpi': {'type': 'object', 'description': 'CPI All Items: YoY %, trend, inflation signal.'}, 'core_cpi': {'type': 'object', 'description': 'Core CPI (ex food/energy): YoY %, trend, inflation signal.'}, 'composite': {'type': 'object', 'description': 'Composite: momentum (HOT/WARM/GOLDILOCKS/COOLING/COLD), score, Fed signal, sector bias.'}, 'retail_sales': {'type': 'object', 'description': 'Advance retail sales: MoM %, trend, consumer signal.'}, 'unemployment': {'type': 'object', 'description': 'Unemployment rate: current %, MoM change, trend, signal.'}, 'nonfarm_payrolls': {'type': 'object', 'description': 'Nonfarm payrolls: MoM jobs added (thousands), 3-month average, signal.'}, 'industrial_production': {'type': 'object', 'description': 'Industrial production index: YoY %, trend, supply signal.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'email': {'type': 'string', 'description': "Email address to validate (e.g. 'user@example.com')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'email': {'type': 'string'}, 'flags': {'type': 'array', 'description': 'Quality flags explaining deductions.'}, 'domain': {'type': 'string'}, 'verdict': {'type': 'string', 'description': "'DELIVERABLE' | 'RISKY' | 'UNDELIVERABLE' | 'INVALID'"}, 'mx_check': {'type': 'object', 'description': 'DNS MX record check results.'}, 'local_part': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'syntax_valid': {'type': 'boolean'}, 'is_disposable': {'type': 'boolean', 'description': 'True if domain is a known disposable/throwaway service.'}, 'quality_score': {'type': 'integer', 'description': '0-100 quality score. 80+ = deliverable.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'prices': {'type': 'object', 'properties': {'wti_crude_bbl': {'type': 'object'}, 'brent_crude_bbl': {'type': 'object'}, 'natural_gas_mmbtu': {'type': 'object'}}, 'description': 'Real-time commodity futures prices.'}, 'sector': {'type': 'object', 'properties': {'xom_exxon': {'type': 'object'}, 'xle_energy': {'type': 'object'}, 'cvx_chevron': {'type': 'object'}, 'mpc_marathon': {'type': 'object'}, 'bkr_baker_hughes': {'type': 'object'}, 'oih_oil_services': {'type': 'object'}}, 'description': 'Energy equity performance signals.'}, 'narrative': {'type': 'string', 'description': 'Full ~200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence energy market summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'generated_at': {'type': 'string'}, 'dominant_risk': {'type': 'string', 'description': 'Most important risk implied by the signals.'}, 'energy_regime': {'type': 'string', 'description': 'energy_shock | elevated | normal | energy_glut | uncertain'}, 'agent_implication': {'type': 'string', 'description': 'Concrete action relevance for AI agents.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string', 'description': "ENS name (e.g. 'vitalik.eth') for forward lookup, or 0x Ethereum address for reverse lookup."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'url': {'type': 'string'}, 'email': {'type': 'string'}, 'found': {'type': 'boolean', 'description': 'False when the name is not registered or has no linked address.'}, 'input': {'type': 'string', 'description': 'Normalized input (name or address).'}, 'github': {'type': 'string'}, 'reddit': {'type': 'string'}, 'address': {'type': 'string', 'description': 'Resolved Ethereum address (null if not linked).'}, 'discord': {'type': 'string'}, 'twitter': {'type': 'string'}, 'resolver': {'type': 'string', 'description': 'ENS resolver contract address.'}, 'telegram': {'type': 'string'}, 'avatar_url': {'type': 'string', 'description': 'Avatar image URL.'}, 'description': {'type': 'string'}, 'ens_primary': {'type': 'string', 'description': 'Primary ENS name for this address.'}, 'content_hash': {'type': 'string', 'description': 'IPFS/IPNS content hash (for decentralised sites).'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'website'], 'properties': {'name': {'type': 'string', 'description': 'entity name as claimed'}, 'email': {'type': 'string', 'description': 'claimed contact email (optional)'}, 'website': {'type': 'string', 'description': 'claimed website URL or domain'}, 'intended_action': {'type': 'string', 'description': 'what the agent wants to do next (optional; sharpens recommended_action)'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'receipt': {'type': 'object'}, 'evidence': {'type': 'array'}, 'risk_flags': {'type': 'array'}, 'verified_fields': {'type': 'object'}, 'recommended_action': {'type': 'string'}, 'verification_status': {'type': 'string', 'description': 'verified_live | partially_verified | unverified'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "'standard' = 160-word narrative (default). 'concise' = 90-word summary."}, 'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, MSFT, NVDA, TSLA). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ticker': {'type': 'string'}, 'signals': {'type': 'object', 'properties': {'iv30': {'type': 'number'}, 'price': {'type': 'number'}, 'rsi14': {'type': 'number'}, 'sma20': {'type': 'number'}, 'sma50': {'type': 'number'}, 'sma200': {'type': 'number'}, 'low_52w': {'type': 'number'}, 'high_52w': {'type': 'number'}, 'pc_ratio': {'type': 'number'}, 'change_pct': {'type': 'number'}, 'forward_pe': {'type': 'number'}, 'rsi_signal': {'type': 'string'}, 'insider_net': {'type': 'string'}, 'eps_estimate': {'type': 'number'}, 'insider_buys': {'type': 'number'}, 'trend_regime': {'type': 'string'}, 'insider_sells': {'type': 'number'}, 'next_earnings': {'type': 'string'}, 'days_to_earnings': {'type': 'number'}, 'options_sentiment': {'type': 'string'}}, 'description': 'Raw signal data used in synthesis.'}, 'bear_case': {'type': 'string'}, 'bull_case': {'type': 'string'}, 'narrative': {'type': 'string', 'description': 'Full situational brief.'}, 'confidence': {'type': 'number'}, 'generated_at': {'type': 'string'}, 'regime_label': {'type': 'string', 'description': 'momentum | consolidation | breakdown | reversal_watch | distribution | accumulation | overbought_extension | oversold_bounce'}, 'dominant_risk': {'type': 'string'}, 'signal_summary': {'type': 'string', 'description': 'One-sentence core equity setup.'}, 'agent_implication': {'type': 'string', 'description': 'Concrete action relevance for AI agents.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Company name.'}, 'growth': {'type': 'object', 'properties': {'forward_eps': {'type': 'number', 'description': 'Forward EPS estimate.'}, 'trailing_eps': {'type': 'number', 'description': 'Trailing 12-month EPS.'}, 'revenue_growth_pct': {'type': 'number', 'description': 'Year-over-year revenue growth %.'}, 'earnings_growth_pct': {'type': 'number', 'description': 'Year-over-year earnings growth %.'}}}, 'market': {'type': 'object', 'properties': {'beta': {'type': 'number', 'description': '5-year monthly beta vs S&P 500.'}, 'short_ratio': {'type': 'number', 'description': 'Short interest / average daily volume.'}, 'float_shares': {'type': 'string', 'description': 'Shares in public float.'}, 'payout_ratio_pct': {'type': 'number', 'description': 'Dividend payout ratio %.'}, 'dividend_yield_pct': {'type': 'number', 'description': 'Forward annual dividend yield %.'}, 'shares_outstanding': {'type': 'string', 'description': 'Total shares outstanding.'}}}, 'ticker': {'type': 'string', 'description': 'Canonical ticker symbol.'}, 'valuation': {'type': 'object', 'properties': {'peg_ratio': {'type': 'number', 'description': 'Price/Earnings-to-Growth ratio.'}, 'forward_pe': {'type': 'number', 'description': 'Forward P/E based on next year earnings estimate.'}, 'trailing_pe': {'type': 'number', 'description': 'Trailing 12-month P/E ratio.'}, 'ev_to_ebitda': {'type': 'number', 'description': 'Enterprise value / EBITDA.'}, 'ev_to_revenue': {'type': 'number', 'description': 'Enterprise value / trailing 12-month revenue.'}, 'price_to_book': {'type': 'number', 'description': 'Price-to-book ratio.'}, 'price_to_sales': {'type': 'number', 'description': 'Price-to-sales (TTM).'}}}, 'financials': {'type': 'object', 'properties': {'total_cash': {'type': 'string', 'description': 'Total cash and equivalents.'}, 'total_debt': {'type': 'string', 'description': 'Total debt.'}, 'revenue_ttm': {'type': 'string', 'description': 'Trailing 12-month revenue (formatted).'}, 'current_ratio': {'type': 'number', 'description': 'Current assets / current liabilities.'}, 'debt_to_equity': {'type': 'number', 'description': 'Total debt / total equity.'}, 'free_cash_flow': {'type': 'string', 'description': 'Annual free cash flow (formatted).'}}}, 'market_cap': {'type': 'string', 'description': "Market capitalization (e.g. '3.01T')."}, 'retrieved_at': {'type': 'string', 'description': 'ISO-8601 timestamp of data retrieval.'}, 'profitability': {'type': 'object', 'properties': {'gross_margin_pct': {'type': 'number', 'description': 'Gross profit margin %.'}, 'profit_margin_pct': {'type': 'number', 'description': 'Net profit margin %.'}, 'operating_margin_pct': {'type': 'number', 'description': 'Operating income margin %.'}, 'return_on_assets_pct': {'type': 'number', 'description': 'Return on assets %.'}, 'return_on_equity_pct': {'type': 'number', 'description': 'Return on equity %.'}}}, 'enterprise_value': {'type': 'string', 'description': 'Enterprise value including debt.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'altman': {'type': 'object', 'properties': {'zone': {'type': 'string', 'description': 'SAFE | GREY | DISTRESS | INSUFFICIENT_DATA'}, 'z_score': {'type': 'number', 'description': 'Composite Z. >2.99 SAFE, 1.81â\x80\x932.99 GREY, <1.81 DISTRESS.'}, 'components': {'type': 'object', 'description': 'X1â\x80\x93X5 component ratios.'}}}, 'ticker': {'type': 'string', 'description': 'Canonical ticker.'}, 'piotroski': {'type': 'object', 'properties': {'max': {'type': 'number'}, 'note': {'type': 'string'}, 'score': {'type': 'number', 'description': 'F-Score 0â\x80\x939. â\x89¥8 = strong, â\x89¤2 = distress.'}, 'signals': {'type': 'object', 'description': '9 binary signals (1=pass, 0=fail, null=no data).'}, 'periods_used': {'type': 'number'}}}, 'risk_flags': {'type': 'array', 'items': {'type': 'string'}}, 'moat_signals': {'type': 'object', 'properties': {'roe_tier': {'type': 'string', 'description': 'EXCELLENT(>20%) | GOOD(10-20%) | WEAK(<10%)'}, 'current_ratio': {'type': 'number'}, 'debt_to_equity': {'type': 'number'}, 'gross_margin_pct': {'type': 'number'}, 'gross_margin_tier': {'type': 'string', 'description': 'HIGH(>40%) | MEDIUM(20-40%) | LOW(<20%)'}, 'operating_margin_pct': {'type': 'number'}, 'return_on_assets_pct': {'type': 'number'}, 'return_on_equity_pct': {'type': 'number'}}, 'description': 'High-level moat indicators from current financials.'}, 'quality_tier': {'type': 'string', 'description': 'STRONG | GOOD | NEUTRAL | WEAK | VERY_WEAK | INSUFFICIENT_DATA'}, 'retrieved_at': {'type': 'string'}, 'composite_signal': {'type': 'string', 'description': 'BUY_QUALITY | WATCH | AVOID | UNKNOWN â\x80\x94 synthesized from F-Score + Z-Score.'}, 'statement_period': {'type': 'string', 'description': 'Fiscal year end of most recent annual statement used.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'rsi': {'type': 'object', 'description': 'SPY RSI-14, signal (OVERSOLDâ\x86\x92OVERBOUGHT), fear contribution.'}, 'vix': {'type': 'object', 'description': 'VIX current, 90d percentile, signal (LOWâ\x86\x92HIGH), fear contribution.'}, 'as_of': {'type': 'string', 'description': 'Date of most recent data (YYYY-MM-DD).'}, 'score': {'type': 'number', 'description': 'Composite score 0â\x80\x93100. 0=extreme greed, 100=extreme fear.'}, 'regime': {'type': 'string', 'description': 'EXTREME_GREED | GREED | NEUTRAL | FEAR | EXTREME_FEAR'}, 'hy_spread': {'type': 'object', 'description': 'HY OAS current (FRED), 90d percentile, signal (TIGHTâ\x86\x92VERY_WIDE), fear contribution.'}, 'spy_momentum': {'type': 'object', 'description': 'SPY vs 200-day SMA, % above/below, signal, fear contribution.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AMD, AAPL, NVDA, STRC). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'sma': {'type': 'object', 'properties': {'sma_20': {'type': 'number'}, 'sma_50': {'type': 'number'}, 'sma_200': {'type': ['number', 'null'], 'description': 'Null if < 200 data points.'}, 'above_20': {'type': 'boolean'}, 'above_50': {'type': 'boolean'}, 'above_200': {'type': ['boolean', 'null']}, 'golden_cross': {'type': 'boolean', 'description': 'SMA50 > SMA200 (long-term bullish alignment).'}}, 'description': 'Simple moving averages.'}, 'rsi_14': {'type': 'object', 'properties': {'value': {'type': 'number', 'description': 'RSI value 0â\x80\x93100.'}, 'signal': {'enum': ['OVERSOLD', 'NEUTRAL', 'OVERBOUGHT'], 'type': 'string', 'description': 'RSI zone.'}}, 'description': 'RSI(14) indicator.'}, 'ticker': {'type': 'string', 'description': 'Canonical ticker.'}, 'consensus': {'enum': ['BULLISH', 'BEARISH', 'NEUTRAL'], 'type': 'string', 'description': 'Indicator consensus: BULLISH if majority of RSI/MACD/BB signals align upward.'}, 'price_usd': {'type': 'number', 'description': 'Current market price.'}, 'change_pct': {'type': 'number', 'description': '% change from prior close.'}, 'data_points': {'type': 'integer', 'description': 'Number of daily bars used for calculation.'}, 'bollinger_20': {'type': ['object', 'null'], 'properties': {'lower': {'type': 'number'}, 'upper': {'type': 'number'}, 'middle': {'type': 'number'}, 'position': {'enum': ['ABOVE_UPPER', 'UPPER_HALF', 'LOWER_HALF', 'BELOW_LOWER'], 'type': 'string', 'description': 'Price position relative to bands.'}}, 'description': 'Bollinger Bands(20, 2Ï\x83).'}, 'macd_12_26_9': {'type': ['object', 'null'], 'properties': {'macd': {'type': 'number', 'description': 'MACD line.'}, 'signal': {'type': 'number', 'description': 'Signal line (9-period EMA of MACD).'}, 'crossover': {'enum': ['BULLISH_CROSS', 'BEARISH_CROSS', 'NO_CROSS'], 'type': 'string', 'description': 'Latest crossover state.'}, 'histogram': {'type': 'number', 'description': 'MACD - signal. Positive = bullish momentum.'}}, 'description': 'MACD(12,26,9). Null if insufficient history.'}, 'volume_ratio_20d': {'type': 'number', 'description': "Today's volume divided by 20-day average. > 1.5 = high-volume move."}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'tickers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 8 US stock ticker symbols (e.g. ["AAPL","NVDA","MSFT"]). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'portfolio': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Company name.'}, 'error': {'type': 'string', 'description': 'Error message if ticker fetch failed.'}, 'rsi_14': {'type': 'number', 'description': 'RSI(14) momentum indicator.'}, 'sma_50': {'type': 'number', 'description': '50-day simple moving average.'}, 'ticker': {'type': 'string', 'description': 'Ticker symbol.'}, 'volume': {'type': 'integer', 'description': 'Intraday volume.'}, 'day_low': {'type': 'number', 'description': 'Intraday low.'}, 'currency': {'type': 'string', 'description': 'Quote currency.'}, 'day_high': {'type': 'number', 'description': 'Intraday high.'}, 'exchange': {'type': 'string', 'description': 'Exchange name.'}, 'price_usd': {'type': 'number', 'description': 'Current price in USD.'}, 'change_pct': {'type': 'number', 'description': '% change from previous close.'}, 'change_usd': {'type': 'number', 'description': 'USD change from previous close.'}, 'market_time': {'type': 'string', 'description': 'ISO-8601 timestamp of last price.'}, 'week_52_low': {'type': 'number', 'description': '52-week low.'}, 'market_state': {'type': 'string', 'description': 'REGULAR, PRE, POST, CLOSED.'}, 'trend_regime': {'type': 'string', 'description': 'above_sma50 or below_sma50.'}, 'week_52_high': {'type': 'number', 'description': '52-week high.'}, 'vol_vs_20d_avg': {'type': 'number', 'description': 'Volume relative to 20-day average (1.0 = average, 2.0 = double).'}, 'week_52_position': {'type': 'number', 'description': 'Position in 52-week range (0=at 52w low, 1=at 52w high).'}}}, 'description': 'All requested tickers sorted by absolute move magnitude (biggest movers first).'}, 'actionable': {'type': 'string', 'description': 'One concise sentence on what to watch next for this portfolio.'}, 'risk_flags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Active risk signals: overbought conditions, volume spikes, trend breaks, 52w extremes.'}, 'focus_ticker': {'type': 'string', 'description': 'The ticker with the largest absolute move (the focus stock for AI analysis).'}, 'focus_analysis': {'type': 'string', 'description': '2-3 sentence technical and contextual analysis of the biggest mover.'}, 'portfolio_mood': {'type': 'string', 'description': 'Overall portfolio mood: bullish, bearish, mixed, or neutral.'}, 'portfolio_summary': {'type': 'string', 'description': '1-2 sentence summary of overall portfolio health and key themes.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'wallet': {'type': 'string', 'description': 'Wallet address to check token balance for (optional).'}, 'network': {'enum': ['ethereum', 'eth', 'base', 'polygon', 'matic', 'arbitrum', 'arb'], 'type': 'string', 'description': 'EVM chain. Default: ethereum.'}, 'spender': {'type': 'string', 'description': 'Spender address to check allowance against wallet (optional; requires wallet).'}, 'contract': {'type': 'string', 'description': 'ERC20 token contract address (0x-prefixed, 42 chars).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'symbol': {'type': ['string', 'null']}, 'network': {'type': 'string'}, 'contract': {'type': 'string'}, 'decimals': {'type': ['integer', 'null']}, 'allowance': {'type': ['object', 'null']}, 'block_number': {'type': ['integer', 'null']}, 'generated_at': {'type': 'string'}, 'total_supply': {'type': 'object', 'properties': {'raw': {'type': ['string', 'null']}, 'formatted': {'type': ['string', 'null']}}}, 'wallet_balance': {'type': ['object', 'null']}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ticker': {'type': 'string', 'description': 'ETF ticker symbol (e.g. SPY, VOO, QQQ, AGG, XLK, VTI). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Full ETF name.'}, 'ticker': {'type': 'string', 'description': 'ETF ticker symbol.'}, 'asset_class': {'type': 'string', 'description': 'Primary asset class (Equity, Fixed Income, etc.).'}, 'retrieved_at': {'type': 'string', 'description': 'ISO-8601 retrieval timestamp.'}, 'top_holdings': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Holding company name.'}, 'rank': {'type': 'integer', 'description': 'Position rank (1 = largest).'}, 'ticker': {'type': 'string', 'description': 'Holding ticker symbol.'}, 'weight_pct': {'type': 'number', 'description': 'Portfolio weight %.'}}}, 'description': 'Top holdings sorted by weight descending (up to 25 positions).'}, 'equity_profile': {'type': 'object', 'properties': {'price_to_book': {'type': 'number', 'description': 'Weighted average P/B.'}, 'price_to_sales': {'type': 'number', 'description': 'Weighted average P/S.'}, 'price_to_cashflow': {'type': 'number', 'description': 'Weighted average P/CF.'}, 'price_to_earnings': {'type': 'number', 'description': 'Weighted average P/E.'}, 'earnings_growth_3y': {'type': 'number', 'description': '3-year earnings growth % (weighted avg).'}}, 'description': 'Valuation/quality metrics of equity holdings (null for bond ETFs).'}, 'sector_weights': {'type': 'array', 'items': {'type': 'object', 'properties': {'sector': {'type': 'string', 'description': 'Sector name.'}, 'weight_pct': {'type': 'number', 'description': 'Sector weight %.'}}}, 'description': 'Sector allocation sorted by weight descending.'}, 'asset_allocation': {'type': 'object', 'properties': {'bond_pct': {'type': 'number', 'description': 'Fixed income allocation %.'}, 'cash_pct': {'type': 'number', 'description': 'Cash and equivalents %.'}, 'other_pct': {'type': 'number', 'description': 'Other/alternative %.'}, 'stock_pct': {'type': 'number', 'description': 'Equity allocation %.'}, 'preferred_pct': {'type': 'number', 'description': 'Preferred stock %.'}}, 'description': 'Percentage allocation by asset type.'}, 'total_top_weight_pct': {'type': 'number', 'description': 'Combined weight of all returned top holdings %.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'number': {'type': 'string', 'description': 'Block number as an integer, 0x-prefixed hex, or tag: latest/pending/earliest/safe/finalized. Defaults to latest.'}, 'network': {'enum': ['ethereum', 'base', 'polygon', 'arbitrum'], 'type': 'string', 'description': 'Chain to query. Default: ethereum.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'hash': {'type': 'string', 'description': 'Block hash.'}, 'miner': {'type': 'string', 'description': 'Block producer address.'}, 'network': {'type': 'string', 'description': 'Chain queried.'}, 'gas_used': {'type': 'integer', 'description': 'Gas used in this block.'}, 'tx_count': {'type': 'integer', 'description': 'Number of transactions in this block.'}, 'gas_limit': {'type': 'integer', 'description': 'Gas limit for this block.'}, 'parent_hash': {'type': 'string', 'description': 'Parent block hash.'}, 'block_number': {'type': 'integer', 'description': 'Block number (decimal).'}, 'base_fee_gwei': {'type': ['number', 'null'], 'description': 'EIP-1559 base fee in Gwei, null for pre-London blocks.'}, 'timestamp_iso': {'type': 'string', 'description': 'ISO-8601 block timestamp.'}, 'timestamp_unix': {'type': 'integer', 'description': 'Unix timestamp of block.'}, 'transaction_hashes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Array of transaction hashes in this block.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chain': {'enum': ['ethereum', 'eth', 'base', 'polygon', 'matic', 'arbitrum', 'arb'], 'type': 'string', 'description': 'Chain to query. Default: ethereum.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max number of log entries to return (1â\x80\x9350). Default: 20.'}, 'topic0': {'type': 'string', 'description': "Event signature hash (topic[0]) to filter by. Common values: Transfer = '0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef', Approval = '0x8c5be1e5ebec7d5bd14f71427d1e84f3dd0314c0f7b2291e5b200ac8c7c3b925', Swap (Uniswap V2) = '0xd78ad95fa46c994b6551d0da85fc275fe613ce37657fb8d5e3d130840159d822'."}, 'address': {'type': 'string', 'description': "Contract address to query logs from (e.g. '0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2' for WETH)."}, 'to_block': {'type': 'string', 'description': 'End block â\x80\x94 integer, hex string, or tag. Default: latest.'}, 'from_block': {'type': 'string', 'description': 'Start block â\x80\x94 integer, hex string, or tag (latest/earliest). Default: 100 blocks before latest.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'logs': {'type': 'array', 'items': {'type': 'object', 'properties': {'data': {'type': 'string'}, 'topics': {'type': 'array', 'items': {'type': 'string'}}, 'tx_hash': {'type': 'string'}, 'contract': {'type': 'string'}, 'log_index': {'type': 'integer'}, 'block_number': {'type': 'integer'}}}}, 'note': {'type': 'string'}, 'chain': {'type': 'string'}, 'address': {'type': 'string'}, 'to_block': {'type': 'integer'}, 'log_count': {'type': 'integer'}, 'from_block': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'address': {'type': 'string', 'description': 'EVM wallet address (0x-prefixed, 42 characters).'}, 'network': {'enum': ['ethereum', 'base', 'polygon', 'arbitrum', 'optimism'], 'type': 'string', 'description': 'Chain to query. Default: base.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'nonce': {'type': 'integer', 'description': 'Confirmed nonce â\x80\x94 number of mined transactions sent from this address.'}, 'address': {'type': 'string', 'description': 'Address queried (checksummed).'}, 'network': {'type': 'string', 'description': 'Chain queried.'}, 'pending_nonce': {'type': 'integer', 'description': 'Pending nonce â\x80\x94 includes transactions in the mempool; use this when building new transactions.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chain': {'type': 'string', 'description': 'Chain name or numeric chain ID. Common: ethereum, base, bsc, arbitrum, polygon, solana, optimism, avalanche. Default: base.'}, 'address': {'type': 'string', 'description': "Token contract address to screen (e.g. '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913' for USDC on Base)."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'flags': {'type': 'object', 'properties': {'is_proxy': {'type': ['boolean', 'null']}, 'is_in_cex': {'type': ['boolean', 'null']}, 'is_honeypot': {'type': ['boolean', 'null']}, 'is_mintable': {'type': ['boolean', 'null']}, 'hidden_owner': {'type': ['boolean', 'null']}, 'selfdestruct': {'type': ['boolean', 'null']}, 'is_open_source': {'type': ['boolean', 'null']}, 'can_take_back_ownership': {'type': ['boolean', 'null']}, 'honeypot_with_same_creator': {'type': ['boolean', 'null']}}, 'description': 'Individual risk flags. true = risk present, false = safe, null = not available for this chain.'}, 'taxes': {'type': 'object', 'properties': {'buy_tax_pct': {'type': ['number', 'null'], 'description': 'Buy tax as percent (0â\x80\x93100).'}, 'sell_tax_pct': {'type': ['number', 'null'], 'description': 'Sell tax as percent (0â\x80\x93100).'}}}, 'address': {'type': 'string'}, 'chain_id': {'type': 'string'}, 'ownership': {'type': 'object', 'properties': {'holder_count': {'type': ['integer', 'null']}, 'creator_address': {'type': ['string', 'null']}, 'creator_supply_pct': {'type': ['number', 'null'], 'description': '% of total supply held by creator wallet.'}}}, 'raw_goplus': {'type': 'object', 'description': 'Full GoPlusLabs response for the token (raw, for advanced consumers).'}, 'risk_label': {'type': 'string', 'description': 'SAFE | LOW | MEDIUM | HIGH | CRITICAL'}, 'risk_score': {'type': 'integer', 'description': '0 (safest) to 100 (critical risk). Composite of all flag weights.'}, 'token_name': {'type': 'string'}, 'token_symbol': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['claim'], 'properties': {'claim': {'type': 'string', 'description': "The factual statement to verify (e.g. 'The Eiffel Tower is 330 meters tall' or 'Apple was founded in 1976')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'claim': {'type': 'string'}, 'caveats': {'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'excerpt': {'type': 'string'}}}}, 'verdict': {'type': 'string', 'description': 'LIKELY_TRUE | LIKELY_FALSE | MIXED | UNVERIFIABLE'}, 'confidence': {'type': 'number', 'description': '0.0â\x80\x931.0 confidence in verdict.'}, 'explanation': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'evidence_summary': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Maximum recalls to return per category (1â\x80\x9310). Default: 5.'}, 'query': {'type': 'string', 'description': "Search term: company name, product name, ingredient, NDC, or recall reason keyword (e.g. 'Pfizer', 'acetaminophen', 'Listeria', 'pacemaker battery')."}, 'class_filter': {'enum': ['any', 'Class I', 'Class II', 'Class III'], 'type': 'string', 'description': "Filter by recall classification. 'Class I' = most serious. Default: 'any'."}, 'product_type': {'enum': ['all', 'drugs', 'food', 'devices'], 'type': 'string', 'description': "Product category to search. 'all' queries drugs + food + devices in parallel. Default: 'all'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'query': {'type': 'string'}, 'totals': {'type': 'object', 'description': 'Total matching records per category.'}, 'recalls': {'type': 'array', 'description': 'Normalized recall records sorted by date desc, then severity desc.'}, 'class_filter': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'product_type': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['mode'], 'properties': {'cert': {'type': 'number', 'description': 'FDIC certificate number for profile mode. Alternative to query. Example: 628 (JPMorgan Chase Bank NA).'}, 'mode': {'enum': ['search', 'profile', 'failures'], 'type': 'string', 'description': 'search: find banks by name | profile: deep financial metrics for one bank (name or FDIC cert#) | failures: recent bank failures list'}, 'year': {'type': 'number', 'description': 'Filter failures to a specific year (failures mode only). Example: 2023.'}, 'limit': {'type': 'number', 'description': 'Max results to return. Default 10 (search), 20 (failures). Max 50/100.'}, 'query': {'type': 'string', 'description': "Bank name to search (for search or profile mode). Examples: 'JPMorgan', 'Silicon Valley Bank', 'First Republic'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'cert': {'type': 'integer'}, 'name': {'type': 'string'}, 'query': {'type': 'string'}, 'state': {'type': 'string'}, 'active': {'type': 'boolean'}, 'income': {'type': 'object'}, 'ratios': {'type': 'object'}, 'source': {'type': 'string'}, 'failures': {'type': 'array'}, 'total_found': {'type': 'integer'}, 'institutions': {'type': 'array'}, 'balance_sheet': {'type': 'object'}, 'total_in_database': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string', 'description': "Donor name to search. For individuals use 'LAST, FIRST' format (e.g. 'MUSK, ELON') for best results. Organization names work too (e.g. 'Google LLC')."}, 'cycle': {'type': 'integer', 'description': 'Election cycle year to filter (e.g. 2024 for the 2023-2024 cycle). Omit for all cycles.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results to return (1â\x80\x9350, default 20).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'summary': {'type': 'object', 'properties': {'date_range': {'type': 'object', 'properties': {'latest': {'type': 'string', 'nullable': True}, 'earliest': {'type': 'string', 'nullable': True}}}, 'top_committee': {'type': 'string', 'nullable': True}, 'total_donated_usd': {'type': 'number'}, 'unique_committees': {'type': 'integer'}, 'contribution_count': {'type': 'integer'}}}, 'contributions': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'memo': {'type': 'string', 'nullable': True}, 'cycle': {'type': 'string', 'nullable': True}, 'party': {'type': 'string', 'nullable': True}, 'state': {'type': 'string', 'nullable': True}, 'office': {'type': 'string', 'nullable': True}, 'employer': {'type': 'string', 'nullable': True}, 'candidate': {'type': 'string', 'nullable': True}, 'committee': {'type': 'string'}, 'amount_usd': {'type': 'number'}, 'occupation': {'type': 'string', 'nullable': True}, 'committee_id': {'type': 'string'}, 'is_individual': {'type': 'boolean'}}}}, 'name_searched': {'type': 'string'}, 'total_results': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'top_n': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of top awards to return. Default: 5.'}, 'award_type': {'enum': ['contracts', 'grants', 'all'], 'type': 'string', 'description': "Award type to query. 'contracts' = procurement contracts; 'grants' = financial assistance grants; 'all' = both. Default: 'contracts'."}, 'years_back': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many fiscal years back to search (1 = current FY only, 2 = 2 most recent FYs). Default: 2.'}, 'company_name': {'type': 'string', 'description': "Company or organization name (e.g. 'Boeing', 'Lockheed Martin', 'SpaceX', 'Johns Hopkins University')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'summary': {'type': 'object'}, 'top_awards': {'type': 'array'}, 'company_name': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'search_period': {'type': 'object'}, 'agency_breakdown': {'type': 'array'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': "Search term or phrase (e.g. 'artificial intelligence', 'PFAS', 'cybersecurity')."}, 'days': {'type': 'integer', 'maximum': 730, 'minimum': 1, 'description': 'How many calendar days back to search (default 90). Max 730.'}, 'type': {'enum': ['Rule', 'Proposed Rule', 'Notice', 'Presidential Document'], 'type': 'string', 'description': 'Filter to a single document type (optional).'}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Max documents to return (default 10, max 20).'}, 'significant_only': {'type': 'boolean', 'description': 'If true, return only documents flagged as significant by the issuing agency.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'documents': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'pdf_url': {'type': 'string'}, 'abstract': {'type': 'string'}, 'agencies': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Short agency name list'}, 'doc_type': {'type': 'string', 'description': 'Rule | Proposed Rule | Notice | Presidential Document'}, 'significant': {'type': ['boolean', 'null'], 'description': 'Agency-designated significant rulemaking flag'}, 'effective_on': {'type': ['string', 'null'], 'description': 'Date the rule becomes effective (null if not applicable)'}, 'document_number': {'type': 'string'}, 'publication_date': {'type': 'string', 'description': 'ISO date the document was published in the FR'}}}}, 'date_range': {'type': 'string', 'description': 'ISO date range searched (YYYY-MM-DD to YYYY-MM-DD)'}, 'fetched_at': {'type': 'string'}, 'query_term': {'type': 'string'}, 'total_count': {'type': 'integer', 'description': 'Total FR documents matching query in the date window'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['mode'], 'properties': {'mode': {'enum': ['icao24', 'callsign', 'area'], 'type': 'string', 'description': 'icao24: lookup by transponder hex | callsign: find flight by ICAO callsign | area: all flights near a location'}, 'lamax': {'type': 'number', 'description': 'Max latitude (north bound) for area mode bounding box. Example: 35.0'}, 'lamin': {'type': 'number', 'description': 'Min latitude (south bound) for area mode bounding box. Example: 33.0'}, 'limit': {'type': 'number', 'description': 'Max flights to return in area mode. Default 50, max 100.'}, 'lomax': {'type': 'number', 'description': 'Max longitude (east bound) for area mode bounding box. Example: -86.0'}, 'lomin': {'type': 'number', 'description': 'Min longitude (west bound) for area mode bounding box. Example: -88.0'}, 'global': {'type': 'boolean', 'description': 'For callsign mode: search globally instead of CONUS-only. Default false. Set true for international flights.'}, 'icao24': {'type': 'string', 'description': "6-hex ICAO24 transponder code for icao24 mode. Example: 'a6a7ad' (N-registered US aircraft). Find at planefinder.net or flightaware.com."}, 'airport': {'type': 'string', 'description': "IATA airport code for area mode. Examples: 'ORD', 'LAX', 'JFK', 'LHR', 'DXB'. Searches within radius_deg of the airport."}, 'callsign': {'type': 'string', 'description': "ICAO airline callsign for callsign mode. Use 3-letter ICAO codes: 'AAL123' (American), 'UAL456' (United), 'DAL789' (Delta), 'SWA101' (Southwest), 'BAW7' (British Airways)."}, 'radius_deg': {'type': 'number', 'description': 'Radius in degrees for area mode with airport. Default 0.5 (~30 nmi). Use 0.25 for approach/departure, 1.0 for broader traffic picture.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'area': {'type': 'string'}, 'note': {'type': 'string'}, 'found': {'type': 'boolean'}, 'flight': {'type': 'object'}, 'icao24': {'type': 'string'}, 'source': {'type': 'string'}, 'flights': {'type': 'array'}, 'matches': {'type': 'array'}, 'airborne': {'type': 'integer'}, 'callsign': {'type': 'string'}, 'on_ground': {'type': 'integer'}, 'search_area': {'type': 'string'}, 'total_flights': {'type': 'integer'}, 'partial_matches': {'type': 'array'}, 'total_flights_in_search': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'rate_date': {'type': 'string', 'description': 'Date of the latest FEDFUNDS observation (YYYY-MM-01, monthly series).'}, 'rate_trend': {'type': 'string', 'description': "Rate direction over last 6 months: 'hiking', 'holding', or 'cutting'."}, 'current_rate_pct': {'type': 'number', 'description': 'FEDFUNDS monthly effective rate, latest available (%). Tracks target range midpoint.'}, 'all_2026_meetings': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string', 'description': 'Meeting end date (YYYY-MM-DD).'}, 'status': {'type': 'string', 'description': "'past' or 'upcoming'."}, 'press_conf': {'type': 'boolean', 'description': 'Includes SEP/press conference.'}}}, 'description': 'Full 2026 FOMC schedule.'}, 'next_meeting_date': {'type': 'string', 'description': 'End date of the next FOMC meeting (YYYY-MM-DD). Policy decision announced this day.'}, 'next_is_press_conf': {'type': 'boolean', 'description': 'True if the next meeting includes a press conference and SEP (dot plot).'}, 'rate_change_6m_pct': {'type': 'number', 'description': 'Rate change over last 6 months in percentage points (negative = cuts).'}, 'next_meeting_days_away': {'type': 'integer', 'description': 'Calendar days until the next FOMC meeting end date.'}, 'meetings_remaining_year': {'type': 'integer', 'description': 'FOMC meetings remaining in 2026, including the next one.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'base': {'type': 'string', 'description': 'Base currency ISO 4217 (e.g. USD, EUR, GBP). Default: USD.'}, 'date': {'type': 'string', 'description': "Date in YYYY-MM-DD format (e.g. '2023-03-15'). Use 'latest' for today's ECB rate. Historical data available from 1999-01-04."}, 'convert': {'type': 'string', 'description': "Optional point-in-time conversion. E.g. {amount: 1000, from: 'USD', to: 'EUR'} at the requested date."}, 'symbols': {'type': 'array', 'items': {'type': 'string'}, 'description': "Specific currencies to return (e.g. ['EUR','GBP','JPY']). Omit for all 30 supported currencies."}, 'end_date': {'type': 'string', 'description': 'Optional end date YYYY-MM-DD for a time-series range. Max recommended range: 365 days. Returns rates keyed by date.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'base': {'type': 'string'}, 'date': {'type': 'string', 'description': 'Actual date returned (nearest business day).'}, 'mode': {'enum': ['single', 'series'], 'type': 'string'}, 'note': {'type': ['string', 'null']}, 'rates': {'type': 'object', 'description': 'Single mode: {currency â\x86\x92 rate}. Series mode: {date â\x86\x92 {currency â\x86\x92 rate}}.'}, 'end_date': {'type': 'string'}, 'conversion': {'type': ['object', 'null'], 'properties': {'to': {'type': 'string'}, 'date': {'type': 'string'}, 'from': {'type': 'string'}, 'rate': {'type': 'number'}, 'amount': {'type': 'number'}, 'result': {'type': 'number'}}}, 'rate_count': {'type': 'integer'}, 'start_date': {'type': 'string'}, 'series_days': {'type': ['integer', 'null']}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'base': {'type': 'string', 'description': 'Base currency ISO 4217 code (e.g. USD, EUR, GBP, JPY). Default: USD.'}, 'convert': {'type': 'string', 'description': "Optional: convert an amount. E.g. {amount: 1000, from: 'USD', to: 'KRW'}."}, 'symbols': {'type': 'array', 'items': {'type': 'string'}, 'description': "Specific currency codes to return (e.g. ['KRW','EUR','GBP']). If omitted, returns all 166+ currencies."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'base': {'type': 'string'}, 'rates': {'type': 'object', 'description': 'Currency code â\x86\x92 rate (how many units of currency per 1 base currency unit).'}, 'conversion': {'type': ['object', 'null'], 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'rate': {'type': 'number'}, 'amount': {'type': 'number'}, 'result': {'type': 'number'}}}, 'rate_count': {'type': 'integer'}, 'next_update': {'type': 'string'}, 'last_updated': {'type': 'string', 'description': 'UTC timestamp of last rate update.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'number', 'description': 'Lookback window in days (default 30, max 180).'}, 'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. NVDA, AAPL, MSFT).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'cik': {'type': 'number'}, 'days': {'type': 'number'}, 'ticker': {'type': 'string'}, 'company': {'type': 'string'}, 'filings': {'type': 'array', 'items': {'type': 'object', 'properties': {'broker': {'type': 'string'}, 'seller': {'type': 'string'}, 'filing_date': {'type': 'string'}, 'notice_date': {'type': 'string'}, 'market_value': {'type': 'number'}, 'relationship': {'type': 'string'}, 'shares_planned': {'type': 'number'}, 'acquisition_type': {'type': 'string'}, 'approx_sale_date': {'type': 'string'}}}}, 'summary': {'type': 'object', 'properties': {'roles': {'type': 'array', 'items': {'type': 'string'}}, 'unique_sellers': {'type': 'number'}, 'total_planned_value': {'type': 'number'}, 'total_planned_shares': {'type': 'number'}}}, 'filings_found': {'type': 'number'}, 'filings_parsed': {'type': 'number'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['series_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 60, 'minimum': 1, 'description': 'Number of most recent observations to return (1â\x80\x9360). Default: 12.'}, 'series_id': {'type': 'string', 'description': 'FRED series ID (case-insensitive). Examples: M2SL (M2 money supply), WALCL (Fed balance sheet), PAYEMS (nonfarm payrolls), ISRATIO (inventory/sales ratio), TRUCKD11 (truck tonnage), T10YIE (10Y breakeven inflation), VIXCLS (VIX). Find series at fred.stlouisfed.org.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'tip': {'type': 'string', 'description': 'How to find additional FRED series IDs.'}, 'stats': {'type': 'object', 'description': 'Summary: current, previous, change, pct_change, min, max, mean, trend over the returned window.'}, 'source': {'type': 'string', 'description': 'Data source attribution.'}, 'coverage': {'type': 'string', 'description': 'Scope of available FRED data.'}, 'returned': {'type': 'integer', 'description': 'Number of observations returned in this response.'}, 'frequency': {'type': 'string', 'description': 'Detected data frequency: daily, weekly, monthly, quarterly, or annual.'}, 'series_id': {'type': 'string', 'description': 'FRED series ID queried (uppercased).'}, 'date_range': {'type': 'object', 'description': 'First/last available dates and total observation count for the series.'}, 'observations': {'type': 'array', 'description': 'Array of {date, value} objects for the most recent N observations.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'description': 'Max results to return (default 25, max 100).'}, 'symbol': {'type': 'string', 'description': 'Filter to a specific asset symbol (e.g. BTC, ETH, SOL). Case-insensitive. Omit for all assets.'}, 'sort_by': {'enum': ['abs_funding', 'funding', 'open_interest'], 'type': 'string', 'description': "Sort order. 'abs_funding' (default) = highest absolute rate first. 'funding' = most positive first. 'open_interest' = largest OI first."}, 'direction': {'enum': ['positive', 'negative', 'all'], 'type': 'string', 'description': "Filter by funding direction. 'positive' = longs pay shorts (bullish funding). 'negative' = shorts pay longs (bearish funding). Default: 'all'."}, 'min_oi_usd': {'type': 'number', 'description': 'Minimum open interest in USD to filter out illiquid markets (e.g. 500000 for $500K). Default: 0.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'rates': {'type': 'array', 'items': {'type': 'object', 'properties': {'symbol': {'type': 'string', 'description': 'Asset symbol (e.g. BTC, ETH).'}, 'exchange': {'type': 'string', 'description': "Exchange name. Currently always 'Hyperliquid'."}, 'direction': {'enum': ['longs-pay-shorts', 'shorts-pay-longs', 'neutral'], 'type': 'string', 'description': 'Who pays whom. Positive rate = longs pay shorts. Negative = shorts pay longs.'}, 'mark_price': {'type': 'number', 'description': 'Current mark price in USD.'}, 'funding_rate_8h': {'type': 'number', 'description': '8-hour funding rate as a decimal (e.g. 0.0001 = 0.01% per 8h).'}, 'open_interest_usd': {'type': 'number', 'description': 'Current open interest in USD.'}, 'funding_rate_annualized_pct': {'type': 'number', 'description': 'Annualized funding rate in percent (e.g. 10.95 = 10.95% p.a.). Multiply funding_rate_8h Ã\x97 3 Ã\x97 365.'}}}, 'description': 'Perpetual funding rates matching filters, sorted as requested.'}, 'exchange': {'type': 'string', 'description': 'Data source exchange.'}, 'total_matched': {'type': 'integer', 'description': 'Assets matching the given filters before limit was applied.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chain': {'enum': ['ethereum', 'base', 'polygon', 'arbitrum', 'bsc', 'all'], 'type': 'string', 'description': 'Chain to query. Options: ethereum, base, polygon, arbitrum, bsc. Omit for all 5.'}}, 'additionalProperties': False}

{'type': 'object', 'description': 'Gas estimates per chain', 'additionalProperties': {'type': 'object', 'properties': {'totalGwei': {'type': 'object'}, 'baseFeeGwei': {'type': 'number'}, 'priorityFeeGwei': {'type': 'object'}, 'transferCostUSD': {'type': 'object'}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'networks': {'type': 'array', 'items': {'enum': ['ethereum', 'base', 'arbitrum', 'optimism', 'polygon', 'bsc'], 'type': 'string'}, 'description': 'Which networks to query. Default: all 6. Specify a subset for faster response.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'chains': {'type': 'array', 'items': {'type': 'object', 'properties': {'type': {'type': 'string', 'description': 'EIP-1559 | legacy'}, 'error': {'type': 'string'}, 'symbol': {'type': 'string'}, 'network': {'type': 'string'}, 'priority_fee': {'type': 'object', 'properties': {'fast_gwei': {'type': ['number', 'null']}, 'slow_gwei': {'type': ['number', 'null']}, 'standard_gwei': {'type': ['number', 'null']}}}, 'base_fee_gwei': {'type': ['number', 'null']}, 'estimated_transfer_cost': {'type': 'object'}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'lat': {'type': 'number', 'description': "Latitude for reverse geocoding. Requires 'lon' also."}, 'lon': {'type': 'number', 'description': "Longitude for reverse geocoding. Requires 'lat' also."}, 'limit': {'type': 'integer', 'description': 'Max results for forward geocode (default 3, max 10). Ignored for reverse.'}, 'query': {'type': 'string', 'description': "Address or place name to geocode (forward lookup). Example: '1600 Pennsylvania Ave Washington DC' or 'Eiffel Tower Paris'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string', 'description': "'forward' or 'reverse'."}, 'count': {'type': 'integer'}, 'results': {'type': 'array', 'description': 'Geocoding results.'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'derived': {'type': 'object', 'properties': {'vix_regime': {'type': 'string'}, 'gold_copper_ratio': {'type': 'number'}, 'safe_haven_signal': {'type': 'string'}}, 'description': 'Derived composite signals.'}, 'narrative': {'type': 'string', 'description': 'Full ~200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence geopolitical risk summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'generated_at': {'type': 'string'}, 'dominant_signal': {'type': 'string', 'description': 'Most important market-implied warning.'}, 'fear_indicators': {'type': 'object', 'properties': {'vix': {'type': 'object'}, 'usd_uup': {'type': 'object'}, 'gold_etf': {'type': 'object'}, 'treasury_tlt': {'type': 'object'}}, 'description': 'Core fear and safe-haven signals.'}, 'agent_implication': {'type': 'string', 'description': 'Concrete action relevance for AI agents.'}, 'safe_haven_signal': {'type': 'string', 'description': 'strong_bid | mild_bid | risk_on | mixed | unknown'}, 'geopolitical_regime': {'type': 'string', 'description': 'calm | elevated | stressed | crisis | uncertain'}, 'geopolitical_proxies': {'type': 'object', 'properties': {'china_fxi': {'type': 'object'}, 'crude_oil': {'type': 'object'}, 'japan_ewj': {'type': 'object'}, 'copper_futures': {'type': 'object'}, 'emerging_markets': {'type': 'object'}}, 'description': 'Regional and risk-asset proxies.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['action'], 'properties': {'repo': {'type': 'string', 'description': "Repository in owner/repo format (e.g. 'facebook/react', 'anthropics/claude-code'). Full GitHub URLs also accepted. Required for repo, contributors, releases, issues, commit_activity."}, 'limit': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Max search results to return (default 10, max 30).'}, 'query': {'type': 'string', 'description': "Search query for search action (e.g. 'vector database', 'llm agent framework')."}, 'repos': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Array of owner/repo strings for compare action (2â\x80\x934 repos).'}, 'topic': {'type': 'string', 'description': "Filter search results by GitHub topic (e.g. 'machine-learning', 'mcp')."}, 'action': {'enum': ['repo', 'contributors', 'releases', 'issues', 'commit_activity', 'compare', 'search'], 'type': 'string', 'description': 'repo: full metadata. contributors: top 30 committers. releases: latest 10 releases + download counts. issues: 10 recent open issues. commit_activity: 52-week weekly commit trend. compare: side-by-side metrics for â\x89¤4 repos. search: find repos by keyword.'}, 'language': {'type': 'string', 'description': "Filter search results by programming language (e.g. 'Python', 'TypeScript')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'recommended_next': {'type': 'object', 'properties': {'when': {'type': 'string'}, 'endpoint': {'type': 'string'}, 'capability': {'type': 'string'}, 'price_usdc': {'type': 'string'}, 'suggested_input': {'type': 'object'}}, 'description': 'Upgrade path to research-synthesis ($0.20) for cross-source synthesis of these results.'}}, 'description': 'Varies by action. Always includes owner/repo or query + ts (ISO-8601 timestamp), plus a recommended_next pointer to research-synthesis ($0.20).'}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'org': {'type': 'string', 'description': "GitHub organization name (e.g. 'anthropics') or full org URL (e.g. 'https://github.com/anthropics')."}, 'top_repos': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Number of top repositories to include, sorted by stars. Default: 10, max: 25.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'org': {'type': 'string'}, 'email': {'type': ['string', 'null']}, 'created': {'type': 'string'}, 'twitter': {'type': ['string', 'null']}, 'website': {'type': ['string', 'null']}, 'activity': {'type': 'object'}, 'location': {'type': ['string', 'null']}, 'verified': {'type': 'boolean'}, 'followers': {'type': 'integer'}, 'top_repos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'forks': {'type': 'integer'}, 'stars': {'type': 'integer'}, 'topics': {'type': 'array', 'items': {'type': 'string'}}, 'license': {'type': ['string', 'null']}, 'archived': {'type': 'boolean'}, 'language': {'type': ['string', 'null']}, 'last_push': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'open_issues': {'type': 'integer'}}}}, 'tech_stack': {'type': 'array', 'items': {'type': 'object'}}, 'description': {'type': ['string', 'null']}, 'total_stars': {'type': 'integer'}, 'display_name': {'type': ['string', 'null']}, 'public_repos': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'repo': {'type': 'string', 'description': "GitHub repo in 'owner/repo' format, or a full GitHub URL (e.g. 'torvalds/linux' or 'https://github.com/vercel/next.js')."}, 'include_release': {'type': 'boolean', 'description': 'If true, fetches the latest release tag and date (extra API call). Default true.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'url': {'type': 'string'}, 'forks': {'type': 'integer'}, 'stars': {'type': 'integer'}, 'topics': {'type': 'array', 'items': {'type': 'string'}}, 'is_fork': {'type': 'boolean'}, 'license': {'type': ['string', 'null']}, 'homepage': {'type': ['string', 'null']}, 'language': {'type': ['string', 'null']}, 'watchers': {'type': 'integer'}, 'full_name': {'type': 'string'}, 'pushed_at': {'type': 'string', 'description': 'Last code push date (proxy for maintainer activity).'}, 'created_at': {'type': 'string'}, 'is_private': {'type': 'boolean'}, 'description': {'type': ['string', 'null']}, 'is_archived': {'type': 'boolean'}, 'open_issues': {'type': 'integer'}, 'activity_label': {'type': 'string', 'description': 'VERY_ACTIVE | ACTIVE | SLOW | STALE | ARCHIVED'}, 'default_branch': {'type': 'string'}, 'latest_release': {'type': ['object', 'null'], 'properties': {'tag': {'type': 'string'}, 'name': {'type': 'string'}, 'published': {'type': 'string'}, 'prerelease': {'type': 'boolean'}}}, 'days_since_push': {'type': 'integer', 'description': 'Days since last push. <30=active, 30-180=slow, >365=stale.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'description': 'Number of repositories to return (1â\x80\x9325, default 10).'}, 'since': {'enum': ['daily', 'weekly', 'monthly'], 'type': 'string', 'description': "Time window: 'daily' = repos created in last 24h, 'weekly' = last 7 days, 'monthly' = last 30 days."}, 'topic': {'type': 'string', 'description': "Filter by GitHub topic tag (e.g. 'llm', 'ai-agent', 'mcp', 'nextjs'). Use GitHub's exact topic slug."}, 'language': {'type': 'string', 'description': "Filter by programming language (e.g. 'python', 'typescript', 'rust', 'go'). Case-insensitive."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'repos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'name': {'type': 'string'}, 'forks': {'type': 'number'}, 'owner': {'type': ['string', 'null']}, 'stars': {'type': 'number'}, 'topics': {'type': 'array', 'items': {'type': 'string'}}, 'license': {'type': ['string', 'null']}, 'language': {'type': ['string', 'null']}, 'pushed_at': {'type': 'string'}, 'created_at': {'type': 'string'}, 'description': {'type': ['string', 'null']}, 'open_issues': {'type': 'number'}}}}, 'since': {'type': 'string'}, 'topic': {'type': ['string', 'null']}, 'language': {'type': ['string', 'null']}, 'total_found': {'type': 'number'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['github_repo'], 'properties': {'github_repo': {'type': 'string', 'description': "Public GitHub repo in 'owner/repo' format (e.g. 'vercel/next.js'). Must be publicly accessible without authentication."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'repo': {'type': 'string'}, 'as_of': {'type': 'string'}, 'clean': {'type': 'boolean', 'description': 'true when no secrets found'}, 'findings': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'file': {'type': 'string'}, 'line': {'type': 'integer'}, 'author': {'type': 'string'}, 'commit': {'type': 'string', 'description': 'Short (8-char) commit SHA'}, 'rule_id': {'type': 'string'}, 'description': {'type': 'string'}, 'secret_hint': {'type': 'string', 'description': "First 8 chars of detected secret + '...'"}}}}, 'findings_count': {'type': 'integer'}, 'scan_duration_ms': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'regions': {'type': 'array', 'items': {'enum': ['Asia', 'Europe', 'FX'], 'type': 'string'}, 'description': 'Limit to specific regions. Omit for all regions.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'Response timestamp (ISO-8601).'}, 'indices': {'type': 'array', 'items': {'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'Data timestamp (ISO-8601).'}, 'name': {'type': 'string', 'description': 'Index display name.'}, 'error': {'type': 'string', 'description': 'Error message if fetch failed.'}, 'price': {'type': 'number', 'description': 'Current index level.'}, 'region': {'type': 'string', 'description': 'Region: Asia, Europe, or FX.'}, 'ticker': {'type': 'string', 'description': 'Yahoo Finance ticker.'}, 'w52_low': {'type': 'number', 'description': '52-week low.'}, 'w52_high': {'type': 'number', 'description': '52-week high.'}, 'change_pct': {'type': 'number', 'description': 'Intraday % change.'}, 'pct_from_52w_high': {'type': 'number', 'description': '% below 52-week high (negative = below high).'}}}, 'description': 'Per-index data.'}, 'region_summary': {'type': 'object', 'description': 'Aggregated posture per region.', 'additionalProperties': {'type': 'object', 'properties': {'flat': {'type': 'integer'}, 'posture': {'type': 'string', 'description': 'bullish / mixed / bearish.'}, 'advances': {'type': 'integer'}, 'declines': {'type': 'integer'}, 'avg_change_pct': {'type': 'number', 'description': 'Average % change across region indices.'}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 180, 'minimum': 1, 'description': 'Calendar days back to search (default 90, max 180). In company mode, omit for all-time history.'}, 'mode': {'enum': ['company', 'recent', 'agency'], 'type': 'string', 'description': "'company': contracts awarded to a named company. 'recent': market-wide largest new awards. 'agency': contracts awarded by a federal agency. Default: 'company' if company_name provided, else 'recent'."}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max results to return (default 25, max 100).'}, 'agency_name': {'type': 'string', 'description': "Federal agency name for agency mode. Use official USASpending names: 'Department of Defense', 'Department of Health and Human Services', 'NASA', 'Department of Homeland Security', 'Department of Veterans Affairs'."}, 'company_name': {'type': 'string', 'description': "Company or contractor name to search (partial match OK). Used in company mode. Examples: 'Lockheed Martin', 'Palantir', 'Raytheon', 'General Dynamics', 'Leidos'."}, 'min_amount_millions': {'type': 'number', 'minimum': 0, 'description': 'For mode=recent: only return awards >= this amount in USD millions (e.g., 100 = $100M+). Default 0 = no filter.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string'}, 'note': {'type': 'string'}, 'awards': {'type': 'array'}, 'source': {'type': 'string'}, 'returned': {'type': 'integer'}, 'total_in_db': {'type': 'integer'}, 'agency_query': {'type': 'string'}, 'top_agencies': {'type': 'array', 'items': {'type': 'string'}}, 'company_query': {'type': 'string'}, 'days_searched': {'type': ['integer', 'string']}, 'sum_amount_usd': {'type': 'number'}, 'top_recipients': {'type': 'array', 'items': {'type': 'string'}}, 'unique_recipients': {'type': 'integer'}, 'min_amount_filter_millions': {'type': 'number'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'description': 'Max results (default 10, max 25).'}, 'chamber': {'enum': ['house', 'senate'], 'type': 'string', 'description': "Chamber to search. Default: 'senate'."}, 'category': {'enum': ['passage', 'amendment', 'cloture', 'procedural', 'nomination', 'treaty', 'impeachment', 'veto-override', 'other'], 'type': 'string', 'description': 'Vote category filter (inferred from vote question).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'count': {'type': 'integer'}, 'votes': {'type': 'array', 'description': 'Congressional vote records, most recent first.'}, 'chamber': {'type': 'string'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US equity ticker symbol (e.g. AAPL, MSFT, NVDA). Case-insensitive.'}, 'quarters': {'type': 'integer', 'maximum': 8, 'minimum': 2, 'description': 'Number of quarters to analyze (default 6, max 8).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'trend': {'type': 'string', 'description': 'IMPROVING | STABLE | DETERIORATING | INSUFFICIENT_DATA'}, 'ticker': {'type': 'string'}, 'beat_rate_pct': {'type': 'number', 'description': '% of quarters where actual EPS > consensus estimate.'}, 'interpretation': {'type': 'string'}, 'avg_surprise_pct': {'type': 'number', 'description': 'Average EPS surprise % (positive = beat).'}, 'guidance_quality': {'type': 'string', 'description': 'SUPER_BEATER | RELIABLE_BEATER | INCONSISTENT | GUIDANCE_RISK | INSUFFICIENT_DATA'}, 'surprise_std_dev': {'type': 'number', 'description': 'Standard deviation of surprise % (lower = more consistent).'}, 'quarterly_history': {'type': 'array'}, 'quarters_analyzed': {'type': 'integer'}, 'next_earnings_date': {'type': 'string'}, 'predictability_score': {'type': 'integer', 'description': '0â\x80\x93100; higher = more predictable earnings.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'companies': {'type': 'object', 'properties': {'jnj': {'type': 'object'}, 'abbvie': {'type': 'object'}, 'pfizer': {'type': 'object'}, 'moderna': {'type': 'object'}, 'eli_lilly': {'type': 'object'}, 'medtronic': {'type': 'object'}, 'unitedhealth': {'type': 'object'}}, 'description': 'Individual healthcare stock performance.'}, 'narrative': {'type': 'string', 'description': 'Full ~200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence healthcare sector summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'sector_etfs': {'type': 'object', 'properties': {'ibb_biotech': {'type': 'object'}, 'xbi_biotech_sm': {'type': 'object'}, 'xlv_healthcare': {'type': 'object'}}, 'description': 'Healthcare ETF performance.'}, 'generated_at': {'type': 'string'}, 'dominant_signal': {'type': 'string', 'description': 'Most important signal from the data.'}, 'agent_implication': {'type': 'string', 'description': 'Concrete action relevance for AI agents.'}, 'healthcare_regime': {'type': 'string', 'description': 'near_peak | pullback | correction | distressed | uncertain'}, 'biotech_risk_appetite': {'type': 'string', 'description': 'risk_on | risk_off | neutral | unknown'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'description': 'Max number of top holdings to return (default: 25, max: 100).'}, 'institution': {'type': 'string', 'description': "Institutional investor name as it appears in SEC filings (e.g. 'Renaissance Technologies', 'Berkshire Hathaway', 'Two Sigma')."}, 'include_options': {'type': 'boolean', 'description': 'If true, includes PUT and CALL option positions alongside equity holdings. Default: false (equity SH positions only).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'cik': {'type': 'string', 'description': 'SEC CIK identifier.'}, 'holdings': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Issuer name.'}, 'rank': {'type': 'integer'}, 'cusip': {'type': 'string', 'description': 'CUSIP identifier.'}, 'shares': {'type': 'integer', 'description': 'Number of shares or option contracts.'}, 'value_m': {'type': 'number', 'description': 'Market value in millions USD (from 13F, in thousands Ã\x97 1000).'}, 'share_type': {'type': 'string', 'description': 'SH = shares, PUT = put options, CALL = call options.'}, 'share_class': {'type': 'string', 'description': 'COM, ADR, etc.'}, 'portfolio_pct': {'type': 'number', 'description': 'Percentage of total 13F portfolio.'}}}, 'description': 'Top holdings sorted by market value descending.'}, 'file_date': {'type': 'string', 'description': 'Date the 13F was filed with the SEC.'}, 'institution': {'type': 'string', 'description': 'Matched institution name from EDGAR.'}, 'period_ending': {'type': 'string', 'description': 'Quarter-end date this filing covers (YYYY-MM-DD).'}, 'total_value_m': {'type': 'number', 'description': 'Total 13F portfolio value in millions USD.'}, 'total_positions': {'type': 'integer', 'description': 'Number of distinct positions in the filing.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'sort': {'enum': ['downloads', 'likes', 'lastModified'], 'type': 'string', 'description': 'Sort order. Default: downloads.'}, 'task': {'type': 'string', 'description': "Optional pipeline task filter (e.g. 'text-classification', 'text-generation', 'image-classification'). Omit to search all tasks."}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x9320). Default: 10.'}, 'query': {'type': 'string', 'description': "Search query â\x80\x94 model name, architecture, or keyword (e.g. 'bert', 'llama', 'sentiment'). Defaults to 'language model'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'count': {'type': 'integer'}, 'query': {'type': 'string'}, 'models': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Full model ID (author/name).'}, 'url': {'type': 'string', 'description': 'HuggingFace model page URL.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}}, 'likes': {'type': 'integer'}, 'author': {'type': 'string'}, 'library': {'type': 'string', 'description': 'Framework (transformers, diffusers, etc.).'}, 'downloads': {'type': 'integer', 'description': 'Monthly download count.'}, 'pipeline_tag': {'type': 'string', 'description': 'ML task category.'}, 'last_modified': {'type': 'string'}}}}, 'task_filter': {'type': 'string', 'description': 'Task filter applied, or null.'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Search query (required). Use quotes for exact phrases.'}, 'sort': {'enum': ['relevance', 'date'], 'type': 'string', 'description': 'Sort order â\x80\x94 relevance (default) or date (newest first).'}, 'type': {'enum': ['story', 'comment', 'all'], 'type': 'string', 'description': 'Content type to search. Default: story.'}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Number of results (1â\x80\x9320). Default: 10.'}, 'date_range': {'enum': ['day', 'week', 'month', 'year', 'all'], 'type': 'string', 'description': 'Filter results to a time window. Default: all.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'hits': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'HN item ID.'}, 'url': {'type': ['string', 'null'], 'description': 'External URL (null for Ask HN / text posts).'}, 'text': {'type': ['string', 'null'], 'description': 'Post body text (Ask HN or comments). Stripped of HTML.'}, 'type': {'type': 'string', 'description': 'story or comment.'}, 'title': {'type': ['string', 'null'], 'description': 'Story title.'}, 'author': {'type': 'string', 'description': 'Submitter username.'}, 'hn_url': {'type': 'string', 'description': 'Direct HN discussion link.'}, 'points': {'type': ['integer', 'null'], 'description': 'Upvote score.'}, 'created_at': {'type': 'string', 'description': 'ISO-8601 post timestamp.'}, 'num_comments': {'type': ['integer', 'null'], 'description': 'Comment count.'}}}}, 'total_found': {'type': 'integer', 'description': 'Total matching items in HN (can exceed returned hits).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'signals': {'type': 'object', 'properties': {'existing_sales': {'type': ['object', 'null']}, 'housing_starts': {'type': ['object', 'null']}, 'new_homes_sold': {'type': ['object', 'null']}, 'building_permits': {'type': ['object', 'null']}, 'case_shiller_hpi': {'type': ['object', 'null']}, 'median_price_usd': {'type': ['object', 'null']}, 'months_supply_new': {'type': ['object', 'null']}, 'mortgage_rate_30y': {'type': ['object', 'null']}, 'permit_starts_ratio': {'type': ['number', 'null']}}, 'description': 'Raw FRED signals assembled for this briefing.'}, 'direction': {'type': 'string', 'description': 'heating | stable | cooling'}, 'narrative': {'type': 'string', 'description': '150-word housing market situation brief'}, 'market_phase': {'type': 'string', 'description': 'seller | balanced | buyer | frozen'}, 'dominant_risk': {'type': 'string', 'description': 'Primary risk to housing market stability'}, 'supply_posture': {'type': 'string', 'description': 'under | balanced | over'}, 'agent_implication': {'type': 'string', 'description': 'What an AI agent should do with this data'}, 'affordability_regime': {'type': 'string', 'description': 'accessible | moderate | stressed | extreme'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'Public HTTP/HTTPS URL to inspect. Redirects are followed.'}, 'include_all_headers': {'type': 'boolean', 'description': 'If true, return all response headers (not just security-relevant ones). Default: false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'url': {'type': 'string'}, 'server': {'type': ['string', 'null']}, 'findings': {'type': 'array'}, 'all_headers': {'type': ['object', 'null']}, 'status_code': {'type': 'integer'}, 'cdn_detected': {'type': ['string', 'null']}, 'security_grade': {'type': 'object'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'sort': {'enum': ['downloads', 'likes'], 'type': 'string', 'description': "Sort order for search_models: 'downloads' = most widely used (default), 'likes' = most community buzz / trending. Trending action always uses likes."}, 'task': {'type': 'string', 'description': 'Filter by pipeline task for search_models, trending, or search_datasets. Valid tasks: text-generation, text2text-generation, summarization, translation, question-answering, fill-mask, text-classification, token-classification, ner, conversational, zero-shot-classification, sentence-similarity, and more. Omit to search across all tasks.'}, 'limit': {'type': 'number', 'description': 'Max results to return (default 10 for search, 15 for trending, max 30).'}, 'query': {'type': 'string', 'description': "Search keyword for search_models or search_datasets (e.g. 'bert embedding', 'llama instruction', 'image classification pytorch'). Omit to browse all."}, 'action': {'enum': ['search_models', 'model_info', 'trending', 'search_datasets'], 'type': 'string', 'description': "Action to perform. 'search_models': find models by keyword + optional task/library filter. 'model_info': full metadata for a specific model ID (params, files, license). 'trending': most-liked models, optionally filtered by pipeline task. 'search_datasets': find datasets by keyword + optional task filter. Default: 'trending'."}, 'library': {'type': 'string', 'description': "Filter models by library for search_models (e.g. 'transformers', 'diffusers', 'sentence-transformers', 'timm', 'peft', 'trl'). Omit for all libraries."}, 'model_id': {'type': 'string', 'description': "Full HuggingFace model ID for model_info action (e.g. 'meta-llama/Llama-3-8B-Instruct', 'openai/whisper-large-v3', 'sentence-transformers/all-MiniLM-L6-v2')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'note': {'type': 'string', 'description': 'Contextual note about the result.'}, 'sort': {'type': 'string'}, 'task': {'type': ['string', 'null']}, 'count': {'type': 'number', 'description': 'Number of results returned.'}, 'query': {'type': ['string', 'null']}, 'action': {'type': 'string', 'description': 'Action that was performed.'}, 'models': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': "HuggingFace model ID (e.g. 'meta-llama/Llama-3-8B-Instruct')."}, 'tags': {'type': 'array', 'description': 'Model tags (framework, architecture, task, etc.).'}, 'likes': {'type': ['number', 'null'], 'description': 'Community likes (endorsement signal).'}, 'library': {'type': ['string', 'null'], 'description': "ML library (e.g. 'transformers', 'diffusers')."}, 'license': {'type': ['string', 'null'], 'description': "SPDX license identifier (e.g. 'apache-2.0', 'mit', 'llama3')."}, 'downloads': {'type': ['number', 'null'], 'description': 'Total downloads from HuggingFace Hub.'}, 'languages': {'type': 'array', 'description': "Supported language codes (e.g. ['en', 'fr'])."}, 'created_at': {'type': ['string', 'null'], 'description': 'ISO 8601 creation date.'}, 'last_modified': {'type': ['string', 'null'], 'description': 'ISO 8601 last modification date.'}, 'pipeline_task': {'type': ['string', 'null'], 'description': "Inference pipeline task (e.g. 'text-generation', 'feature-extraction')."}}}, 'description': 'List of model objects (search_models and trending actions).'}, 'datasets': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'HuggingFace dataset ID.'}, 'tags': {'type': 'array'}, 'gated': {'type': 'boolean', 'description': 'Whether dataset requires access approval.'}, 'likes': {'type': ['number', 'null']}, 'license': {'type': ['string', 'null']}, 'downloads': {'type': ['number', 'null']}, 'description': {'type': 'string', 'description': 'Short dataset description (â\x89¤200 chars).'}}}, 'description': 'List of dataset objects (search_datasets action).'}, 'model_id': {'type': 'string', 'description': 'Requested model ID (model_info action).'}, 'siblings': {'type': 'array', 'description': 'Key files in the model repo (model_info only).'}, 'ranked_by': {'type': 'string'}, 'total_params': {'type': ['number', 'null'], 'description': 'Total parameter count (from safetensors metadata, model_info only).'}, 'model_card_url': {'type': 'string', 'description': 'URL to model card on HuggingFace Hub (model_info only).'}, 'param_breakdown': {'type': ['object', 'null'], 'description': 'Parameter count per dtype (model_info only).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'URL of the image to inspect. Must be publicly accessible. HTTP or HTTPS.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'url': {'type': 'string'}, 'note': {'type': ['string', 'null']}, 'format': {'type': 'string'}, 'dimensions': {'type': ['object', 'null']}, 'detected_mime': {'type': ['string', 'null']}, 'bytes_inspected': {'type': 'integer'}, 'file_size_bytes': {'type': ['integer', 'null']}, 'content_type_match': {'type': ['boolean', 'null']}, 'content_type_header': {'type': ['string', 'null']}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'country': {'type': 'string', 'description': "ISO 3-letter country code (e.g. 'USA', 'CHN', 'DEU'). Accepts ISO2 for common countries (e.g. 'US'). Comma-separate up to 5 countries for comparison (e.g. 'USA,CHN,DEU')."}, 'horizon': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Forecast years ahead to include (1â\x80\x935). Default: 3.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'as_of': {'type': 'string'}, 'years': {'type': 'array', 'items': {'type': 'integer'}}, 'source': {'type': 'string'}, 'countries': {'type': 'array', 'items': {'type': 'object', 'properties': {'iso3': {'type': 'string'}, 'year_base': {'type': 'integer', 'description': 'First year in outlook (current calendar year)'}, 'gdp_growth': {'type': 'array', 'items': {'type': ['number', 'null']}}, 'unemployment': {'type': 'array', 'items': {'type': ['number', 'null']}}, 'cpi_inflation': {'type': 'array', 'items': {'type': ['number', 'null']}}, 'gross_debt_pct_gdp': {'type': 'array', 'items': {'type': ['number', 'null']}}, 'fiscal_balance_pct_gdp': {'type': 'array', 'items': {'type': ['number', 'null']}}, 'current_account_pct_gdp': {'type': 'array', 'items': {'type': ['number', 'null']}}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 8, 'minimum': 1, 'description': 'Max periods to return (1â\x80\x938 for quarterly; 1â\x80\x934 for annual). Default: 4.'}, 'period': {'enum': ['quarterly', 'annual'], 'type': 'string', 'description': "Period type. Default: 'quarterly' (up to 8 recent quarters). 'annual' returns up to 4 fiscal years."}, 'ticker': {'type': 'string', 'description': "Stock ticker symbol (e.g. 'AAPL', 'MSFT', 'NVDA', 'TSLA')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ticker': {'type': 'string'}, 'periods': {'type': 'array', 'items': {'type': 'object', 'properties': {'ebitda': {'type': 'number'}, 'eps_basic': {'type': 'number'}, 'net_income': {'type': 'number'}, 'period_end': {'type': 'string'}, 'eps_diluted': {'type': 'number'}, 'gross_profit': {'type': 'number'}, 'pretax_income': {'type': 'number'}, 'tax_provision': {'type': 'number'}, 'total_revenue': {'type': 'number'}, 'free_cash_flow': {'type': 'number'}, 'cost_of_revenue': {'type': 'number'}, 'operating_income': {'type': 'number'}, 'operating_cash_flow': {'type': 'number'}, 'capital_expenditures': {'type': 'number'}, 'research_development': {'type': 'number'}, 'selling_general_admin': {'type': 'number'}, 'total_operating_expense': {'type': 'number'}}}, 'description': 'Periods most-recent-first. All monetary values in USD.'}, 'currency': {'type': 'string'}, 'period_type': {'type': 'string'}, 'retrieved_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'core': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'value': {'type': 'number'}, 'mom_pct': {'type': 'number', 'description': 'Month-over-month % change.'}, 'yoy_pct': {'type': 'number', 'description': 'Year-over-year % change â\x80\x94 the core inflation rate the Fed targets.'}}, 'description': "Core CPI (Less Food & Energy), SA. The Fed's primary inflation signal â\x80\x94 strips volatile food and energy."}, 'food': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'value': {'type': 'number'}, 'mom_pct': {'type': 'number'}, 'yoy_pct': {'type': 'number'}}, 'description': 'CPI Food component, SA.'}, 'energy': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'value': {'type': 'number'}, 'mom_pct': {'type': 'number'}, 'yoy_pct': {'type': 'number'}}, 'description': 'CPI Energy component, SA. High-volatility driver of headline CPI divergence from core.'}, 'all_items': {'type': 'object', 'properties': {'date': {'type': 'string', 'description': 'Observation date (YYYY-MM-01, monthly).'}, 'value': {'type': 'number', 'description': 'CPI index value (1982-84=100 base).'}, 'mom_pct': {'type': 'number', 'description': 'Month-over-month % change.'}, 'yoy_pct': {'type': 'number', 'description': 'Year-over-year % change â\x80\x94 the headline inflation rate.'}}, 'description': "CPI-U All Items, Seasonally Adjusted. Standard 'headline CPI'."}, 'trend_signal': {'type': 'string', 'description': 'Direction of core CPI YoY over the last 3 months: ACCELERATING (rising), DECELERATING (falling), STABLE (< 0.15pp delta), or unknown.'}, 'fed_implication': {'type': 'string', 'description': 'Plain-English Fed policy implication derived from current core CPI level and trend.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'description': 'Lookback window in days (default 30, max 180).'}, 'ticker': {'type': 'string', 'description': 'US stock ticker (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'cik': {'type': 'integer'}, 'days': {'type': 'integer'}, 'error': {'type': 'string', 'description': 'Present only on error (e.g. unknown ticker).'}, 'ticker': {'type': 'string'}, 'company': {'type': 'string'}, 'filings': {'type': 'array', 'items': {'type': 'object', 'properties': {'role': {'type': 'string'}, 'owner': {'type': 'string'}, 'period': {'type': 'string'}, 'filing_date': {'type': 'string'}, 'transactions': {'type': 'array', 'items': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'date': {'type': 'string'}, 'type': {'type': 'string'}, 'shares': {'type': 'number'}, 'security': {'type': 'string'}, 'total_value': {'type': ['number', 'null']}, 'price_per_share': {'type': 'number'}, 'shares_owned_after': {'type': ['number', 'null']}}}}}}}, 'message': {'type': 'string', 'description': 'Present only when no filings were found.'}, 'summary': {'type': 'object', 'properties': {'net_sentiment': {'enum': ['net_buying', 'net_selling', 'neutral', 'none'], 'type': 'string'}, 'total_buy_value': {'type': ['number', 'null']}, 'total_buy_shares': {'type': ['integer', 'null']}, 'total_sell_value': {'type': ['number', 'null']}, 'total_sell_shares': {'type': ['integer', 'null']}}}, 'filings_found': {'type': 'integer'}, 'filings_parsed': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['mode'], 'properties': {'days': {'type': 'integer', 'description': 'Days back to search (1â\x80\x9330). Default 7.'}, 'mode': {'enum': ['get_insider_trades', 'recent_insider_buys'], 'type': 'string', 'description': 'get_insider_trades: Form 4s for a specific company (requires ticker). recent_insider_buys: market-wide open-market purchase feed (no ticker needed).'}, 'limit': {'type': 'integer', 'description': 'Max results to return (1â\x80\x9320). Default 10.'}, 'ticker': {'type': 'string', 'description': 'Stock ticker symbol (e.g. AAPL, MSFT). Required for get_insider_trades.'}, 'min_usd': {'type': 'number', 'description': 'Minimum open-market purchase value in USD for recent_insider_buys mode. Default 50000 ($50k). Use 100000 for high-conviction only.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string'}, 'ticker': {'type': 'string'}, 'company': {'type': 'string'}, 'filings': {'type': 'array'}, 'days_back': {'type': 'integer'}, 'purchases': {'type': 'array'}, 'filings_found': {'type': 'integer'}, 'filings_parsed': {'type': 'integer'}, 'purchases_found': {'type': 'integer'}, 'net_buy_sell_usd': {'type': 'number'}, 'open_market_buys': {'type': 'integer'}, 'insider_sentiment': {'enum': ['bullish', 'bearish', 'neutral'], 'type': 'string'}, 'open_market_sells': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['symbol'], 'properties': {'symbol': {'type': 'string', 'description': "US equity ticker symbol (e.g. 'AAPL', 'MSFT', 'NVDA')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'symbol': {'type': 'string'}, 'top_insiders': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'relation': {'type': ['string', 'null'], 'description': 'Role: Officer, Director, 10% Owner, etc.'}, 'transaction': {'type': ['string', 'null'], 'description': "Transaction type (e.g. 'Stock Gift', 'S - Sale', 'P - Purchase')."}, 'shares_direct': {'type': ['integer', 'null'], 'description': 'Shares held directly.'}, 'latest_trans_date': {'type': ['string', 'null'], 'description': 'Most recent reported transaction date.'}}}, 'description': 'Up to 10 corporate insiders (officers/directors) with direct share holdings.'}, 'major_holders': {'type': 'object', 'properties': {'insiders_pct': {'type': ['number', 'null'], 'description': '% shares held by company insiders.'}, 'institutions_pct': {'type': ['number', 'null'], 'description': '% shares held by institutions (of total shares).'}, 'institution_count': {'type': ['integer', 'null'], 'description': 'Total number of institutional holders.'}, 'institutions_float_pct': {'type': ['number', 'null'], 'description': '% of float held by institutions.'}}}, 'top_institutions': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'shares': {'type': ['integer', 'null']}, 'pct_held': {'type': ['number', 'null'], 'description': '% of total shares held.'}, 'value_usd': {'type': ['integer', 'null'], 'description': 'Market value of position (USD).'}, 'pct_change': {'type': ['number', 'null'], 'description': 'Change in position since prior 13F quarter (%).'}, 'report_date': {'type': ['string', 'null'], 'description': '13F reporting date (YYYY-MM-DD).'}}}, 'description': 'Up to 10 largest institutional holders, ordered by position size.'}, 'related_capabilities': {'type': 'array'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'mode': {'enum': ['holders', 'summary', 'full'], 'type': 'string', 'description': "'holders' (default) returns top institutional funds with shares and value. 'summary' returns aggregate breakdown: % institutional, % insider, float size, concentration. 'full' returns both in one call."}, 'limit': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Max number of institutional holders to return in holders/full mode (default 15, max 30).'}, 'ticker': {'type': 'string', 'description': 'US equity ticker symbol (e.g. AAPL, TSLA, NVDA). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ticker': {'type': 'string'}, 'holders': {'type': 'array'}, 'summary': {'type': 'object'}, 'total_institutions': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'defi': {'type': 'object', 'description': 'Top DeFi yield pools from defi-yields: top 10 by APY, min TVL $1M, all chains.'}, 'market': {'type': 'object', 'description': 'Equity snapshot from market-overview: SPY, QQQ, IWM, DIA, VIX, TNX, risk_posture.'}, 'sources': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Capability names included in this pack.'}, 'prediction': {'type': 'object', 'description': 'Top prediction markets from prediction-markets: top 10 by USDC volume.'}, 'generated_at': {'type': 'string', 'description': 'ISO-8601 timestamp.'}, 'pack_version': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'market': {'type': 'string', 'description': 'Optional market shorthand to auto-append exchange suffix: fr=Paris, de=Frankfurt, gb=London, ch=Swiss, nl=Amsterdam, es=Madrid, it=Milan, jp=Tokyo, au=ASX, ca=TSX, hk=HongKong, in=BSE. Ignored when ticker already contains a period.'}, 'ticker': {'type': 'string', 'description': 'Full exchange-suffixed ticker (e.g. MC.PA, SAP.DE, AZN.L, NESN.SW, 7203.T) OR base ticker when market is also provided.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'name': {'type': 'string', 'description': 'Company full name.'}, 'price': {'type': 'number', 'description': 'Current market price in native currency.'}, 'change': {'type': 'number', 'description': 'Absolute change from previous close in native currency.'}, 'ticker': {'type': 'string', 'description': 'Canonical ticker as reported by the exchange.'}, 'volume': {'type': 'integer', 'description': 'Intraday volume (shares traded).'}, 'day_low': {'type': 'number', 'description': 'Intraday low in native currency.'}, 'currency': {'type': 'string', 'description': 'Quote currency (EUR, GBp, CHF, JPY, etc.).'}, 'day_high': {'type': 'number', 'description': 'Intraday high in native currency.'}, 'exchange': {'type': 'string', 'description': 'Exchange full name (e.g. PAR, GER, LSE, EBS).'}, 'change_pct': {'type': 'number', 'description': 'Percentage change from previous close.'}, 'market_time': {'type': 'string', 'description': 'ISO-8601 timestamp of the last market price.'}, 'week_52_low': {'type': 'number', 'description': '52-week low in native currency.'}, 'week_52_high': {'type': 'number', 'description': '52-week high in native currency.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'target': {'type': 'string', 'description': "IPv4 address, IPv6 address, or domain name to look up (e.g. '8.8.8.8', '2001:4860:4860::8888', 'github.com')."}, 'targets': {'type': 'array', 'items': {'type': 'string'}, 'description': "Batch lookup: up to 10 IP addresses or domain names. If provided, 'target' is ignored."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'count': {'type': 'integer'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'asn': {'type': ['string', 'null']}, 'isp': {'type': ['string', 'null']}, 'lat': {'type': ['number', 'null']}, 'lon': {'type': ['number', 'null']}, 'org': {'type': ['string', 'null']}, 'city': {'type': ['string', 'null']}, 'query': {'type': 'string'}, 'region': {'type': ['string', 'null']}, 'country': {'type': ['string', 'null']}, 'asn_name': {'type': ['string', 'null']}, 'is_proxy': {'type': 'boolean'}, 'timezone': {'type': ['string', 'null']}, 'is_mobile': {'type': 'boolean'}, 'is_hosting': {'type': 'boolean'}, 'reverse_dns': {'type': ['string', 'null']}, 'country_code': {'type': ['string', 'null']}}}}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum results per section.'}, 'section': {'enum': ['all', 'upcoming', 'priced', 'filed', 'withdrawn'], 'type': 'string', 'description': "Calendar section to return. 'upcoming' = deals pricing this week; 'priced' = recently priced IPOs; 'filed' = new S-1 registrations; 'withdrawn' = cancelled deals; 'all' = all sections."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'filed': {'type': 'array', 'items': {'type': 'object', 'properties': {'symbol': {'type': ['string', 'null']}, 'company': {'type': ['string', 'null']}, 'deal_id': {'type': ['string', 'null']}, 'filed_date': {'type': ['string', 'null']}, 'offer_amount': {'type': ['string', 'null']}}}}, 'priced': {'type': 'array', 'items': {'type': 'object', 'properties': {'price': {'type': ['string', 'null']}, 'shares': {'type': ['string', 'null']}, 'status': {'type': ['string', 'null']}, 'symbol': {'type': ['string', 'null']}, 'company': {'type': ['string', 'null']}, 'deal_id': {'type': ['string', 'null']}, 'exchange': {'type': ['string', 'null']}, 'priced_date': {'type': ['string', 'null']}, 'offer_amount': {'type': ['string', 'null']}}}}, 'source': {'type': 'string'}, 'section': {'type': 'string'}, 'summary': {'type': 'object', 'properties': {'filed_count': {'type': 'integer'}, 'priced_count': {'type': 'integer'}, 'calendar_year': {'type': ['integer', 'null']}, 'calendar_month': {'type': ['integer', 'null']}, 'upcoming_count': {'type': 'integer'}, 'withdrawn_count': {'type': 'integer'}, 'largest_upcoming': {'type': ['object', 'null']}, 'total_capital_usd': {'type': ['integer', 'null'], 'description': 'Total USD across all sections.'}}}, 'upcoming': {'type': 'array', 'items': {'type': 'object', 'properties': {'shares': {'type': ['string', 'null']}, 'symbol': {'type': ['string', 'null']}, 'company': {'type': ['string', 'null']}, 'deal_id': {'type': ['string', 'null']}, 'exchange': {'type': ['string', 'null']}, 'price_range': {'type': ['string', 'null'], 'description': 'Expected price range or fixed price.'}, 'offer_amount': {'type': ['string', 'null']}, 'expected_date': {'type': ['string', 'null'], 'description': 'Expected IPO pricing date (M/D/YYYY).'}}}}, 'withdrawn': {'type': 'array', 'items': {'type': 'object', 'properties': {'shares': {'type': ['string', 'null']}, 'symbol': {'type': ['string', 'null']}, 'company': {'type': ['string', 'null']}, 'deal_id': {'type': ['string', 'null']}, 'exchange': {'type': ['string', 'null']}, 'filed_date': {'type': ['string', 'null']}, 'offer_amount': {'type': ['string', 'null']}, 'withdrawn_date': {'type': ['string', 'null']}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'text': {'type': 'string', 'description': 'Text containing JSON, possibly mixed with prose or code fences. Max 200,000 chars.'}, 'schema_check': {'type': 'string', 'description': 'Optional: JSON Schema (draft-07 subset) to validate the extracted data against. If provided, returns a validation result.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'type': {'type': 'string', 'description': "'object' | 'array' | 'string' | 'number' | 'boolean' | 'null'"}, 'method': {'type': 'string', 'description': "How JSON was found: 'direct' | 'fence' | 'embedded' | 'repaired'"}, 'repaired': {'type': 'boolean', 'description': 'True if JSON repair was applied.'}, 'extracted': {'description': 'Parsed JSON value (any type).'}, 'json_string': {'type': 'string', 'description': 'Cleaned, minified JSON string.'}, 'parse_error': {'type': 'string', 'description': 'Error message if parsing failed after repair.'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'symbol': {'type': 'string', 'description': 'Crypto symbol to check, e.g. BTC, ETH, XRP, SOL, DOGE'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'symbol': {'type': 'string'}, 'fx_rate': {'type': 'number', 'description': 'USD/KRW exchange rate used'}, 'timestamp': {'type': 'string'}, 'upbit_krw': {'type': 'number', 'description': 'Upbit last trade price in KRW'}, 'global_usd': {'type': 'number', 'description': 'Global spot price in USD (Kraken or OKX)'}, 'global_source': {'type': 'string', 'description': 'Source used for global price (kraken or okx)'}, 'premium_percent': {'type': 'number', 'description': 'Premium as %; positive = Korean premium over global'}, 'upbit_usd_equiv': {'type': 'number', 'description': 'Upbit KRW price converted to USD'}, 'premium_direction': {'enum': ['positive', 'negative', 'neutral'], 'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Number of tokens to return per section (1â\x80\x9350). Default: 20.'}, 'section': {'enum': ['movers', 'volume', 'all'], 'type': 'string', 'description': "Data section to return. 'movers'=top price movers, 'volume'=top by 24h KRW volume, 'all'=both. Default: all."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'meta': {'type': 'object', 'properties': {'ts': {'type': 'string'}, 'source': {'type': 'string'}, 'markets_total': {'type': 'integer'}}}, 'movers': {'type': 'array', 'items': {'type': 'object', 'properties': {'symbol': {'type': 'string', 'description': 'Token symbol (e.g. BTC).'}, 'direction': {'type': 'string', 'description': 'RISE | FALL | EVEN'}, 'price_krw': {'type': 'number', 'description': 'Current price in KRW.'}, 'change_pct': {'type': 'number', 'description': '24h % change from previous close (negative = drop).'}, 'volume_krw': {'type': 'number', 'description': '24h trade volume in KRW.'}}}, 'description': 'Tokens with largest 24h price change (absolute %).'}, 'volume_leaders': {'type': 'array', 'items': {'type': 'object', 'properties': {'symbol': {'type': 'string'}, 'price_krw': {'type': 'number'}, 'change_pct': {'type': 'number'}, 'volume_krw': {'type': 'number'}}}, 'description': 'Tokens ranked by 24h KRW trading volume (highest first).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'top_n': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Number of results per category (risers, fallers, volume leaders). Default 10, max 30.'}, 'symbol': {'type': 'string', 'description': "Return data for a specific token symbol only (e.g. 'BTC', 'ETH'). Case-insensitive. If provided, top_n and min_volume_usd are ignored."}, 'min_volume_usd': {'type': 'number', 'description': 'Minimum 24h volume in USD to include in results (filters illiquid micro-caps). Default 50000.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'exchange': {'type': 'string'}, 'top_risers': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Tokens with the highest positive 24h price change on Upbit KRW markets.'}, 'top_fallers': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Tokens with the largest negative 24h price change on Upbit KRW markets.'}, 'volume_leaders': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Tokens with the highest 24h accumulated trading volume in KRW.'}, 'total_markets_scanned': {'type': 'integer', 'description': 'Total KRW markets scanned on Upbit for this response.'}, 'markets_above_min_volume': {'type': 'integer', 'description': 'Markets that passed the min_volume_usd filter.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'signals': {'type': 'object', 'properties': {'job_openings': {'type': ['object', 'null']}, 'initial_claims': {'type': ['object', 'null']}, 'continued_claims': {'type': ['object', 'null']}, 'nonfarm_payrolls': {'type': ['object', 'null']}, 'avg_hourly_earnings': {'type': ['object', 'null']}, 'unemployment_rate_pct': {'type': ['object', 'null']}, 'openings_per_unemployed': {'type': ['number', 'null']}, 'labor_force_participation': {'type': ['object', 'null']}}, 'description': 'Raw FRED signals assembled for this briefing.'}, 'narrative': {'type': 'string', 'description': '150-word labor market brief'}, 'claims_trend': {'type': 'string', 'description': 'improving | stable | deteriorating | alarming'}, 'labor_regime': {'type': 'string', 'description': 'overheating | tight | balanced | softening | recessionary'}, 'dominant_risk': {'type': 'string', 'description': 'Primary risk in current labor market'}, 'wage_pressure': {'type': 'string', 'description': 'rising | stable | falling'}, 'agent_implication': {'type': 'string', 'description': 'What an AI agent should do with this data'}, 'fed_posture_signal': {'type': 'string', 'description': 'hawkish | neutral | dovish'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'initial_claims': {'type': 'number', 'description': 'Initial jobless claims, seasonally adjusted (thousands). Weekly; most recent Thursday release.'}, 'jolts_openings': {'type': 'number', 'description': 'JOLTS job openings (thousands). Monthly; measures labor demand.'}, 'unemployed_date': {'type': 'string', 'description': 'Reference month for unemployed persons (YYYY-MM-DD).'}, 'continued_claims': {'type': 'number', 'description': 'Continued claims (insured unemployment), SA (thousands). One week lagged vs initial claims.'}, 'nonfarm_payrolls': {'type': 'number', 'description': 'Total nonfarm payroll employment (thousands). Monthly; net jobs added/lost.'}, 'participation_date': {'type': 'string', 'description': 'Reference month for participation rate (YYYY-MM-DD).'}, 'participation_rate': {'type': 'number', 'description': 'Labor force participation rate (%). Share of civilian noninstitutional population in labor force.'}, 'unemployed_persons': {'type': 'number', 'description': 'Unemployed persons (thousands). Monthly; from CPS household survey.'}, 'avg_hourly_earnings': {'type': 'number', 'description': 'Average hourly earnings, all private employees ($). Monthly.'}, 'initial_claims_date': {'type': 'string', 'description': 'Reference week ending date for initial claims (YYYY-MM-DD).'}, 'jolts_openings_date': {'type': 'string', 'description': 'Survey month for JOLTS openings (YYYY-MM-DD).'}, 'wage_growth_yoy_pct': {'type': 'number', 'description': 'Average hourly earnings year-over-year change (%). Wage inflation signal watched by the Fed.'}, 'continued_claims_date': {'type': 'string', 'description': 'Reference date for continued claims (YYYY-MM-DD).'}, 'nonfarm_payrolls_date': {'type': 'string', 'description': 'Reference month for nonfarm payrolls (YYYY-MM-DD).'}, 'openings_per_unemployed': {'type': 'number', 'description': 'JOLTS openings ÷ unemployed persons. >1.0 = more jobs than seekers (tight); <1.0 = labor market slack. Beveridge curve demand/supply ratio.'}, 'avg_hourly_earnings_date': {'type': 'string', 'description': 'Reference month for avg hourly earnings (YYYY-MM-DD).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker (e.g. AAPL, NVDA). Case-insensitive.'}, 'debt_pct': {'type': 'number', 'description': 'Total debt as % of entry EV (default 60 = 60% leverage). Typical range 50â\x80\x9370%.'}, 'hold_years': {'type': 'number', 'description': 'Investment hold period in years (default 5).'}, 'exit_ev_ebitda': {'type': 'number', 'description': 'Exit EV/EBITDA multiple at end of hold period. Default: same as entry.'}, 'entry_ev_ebitda': {'type': 'number', 'description': 'Entry EV/EBITDA purchase multiple. Default: current market EV/EBITDA.'}, 'ebitda_growth_pct': {'type': 'number', 'description': 'Annual EBITDA growth assumption in % (default: analyst 5Y consensus or historical).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'exit': {'type': 'object', 'properties': {'ev_usd': {'type': 'number'}, 'ebitda_usd': {'type': 'number', 'description': 'EBITDA at exit (after growth).'}, 'ev_ebitda_mult': {'type': 'number'}, 'exit_equity_usd': {'type': 'number'}, 'remaining_debt_usd': {'type': 'number'}}, 'description': 'Exit transaction metrics.'}, 'name': {'type': 'string'}, 'entry': {'type': 'object', 'properties': {'ev_usd': {'type': 'number', 'description': 'Entry enterprise value (USD).'}, 'ebitda_usd': {'type': 'number', 'description': 'LTM EBITDA used for entry sizing.'}, 'equity_pct': {'type': 'number', 'description': 'Equity as % of total capitalization.'}, 'ev_ebitda_mult': {'type': 'number', 'description': 'Entry EV/EBITDA purchase multiple.'}, 'total_debt_usd': {'type': 'number', 'description': 'Total acquisition debt (USD).'}, 'equity_check_usd': {'type': 'number', 'description': 'Equity check (USD).'}, 'leverage_x_ebitda': {'type': 'number', 'description': 'Leverage in turns of EBITDA.'}}, 'description': 'Entry transaction metrics.'}, 'ticker': {'type': 'string'}, 'returns': {'type': 'object', 'properties': {'moic': {'type': 'number', 'description': 'Multiple on invested capital.'}, 'irr_pct': {'type': 'number', 'description': 'Sponsor IRR over hold period (%).'}, 'hold_years': {'type': 'number'}}}, 'deal_brief': {'type': 'object', 'properties': {'verdict': {'type': 'string'}, 'narrative': {'type': 'string'}, 'deal_risks': {'type': 'array', 'items': {'type': 'string'}}, 'strategic_rationale': {'type': 'string'}}, 'description': 'AI-synthesized deal verdict and narrative.'}, 'assumptions': {'type': 'object', 'properties': {'debt_pct': {'type': 'number'}, 'ltm_fcf_usd': {'type': 'number'}, 'growth_source': {'type': 'string'}, 'ltm_revenue_usd': {'type': 'number'}, 'ebitda_growth_pct': {'type': 'number'}, 'ebitda_margin_pct': {'type': 'number'}}}, 'sensitivity': {'type': 'object', 'properties': {'irr_grid': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Row per entry multiple; each row = IRR% per exit multiple.'}, 'exit_multiples': {'type': 'array', 'items': {'type': 'number'}}, 'entry_multiples': {'type': 'array', 'items': {'type': 'number'}}}, 'description': 'IRR sensitivity across entry and exit EV/EBITDA multiples.'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'court': {'type': 'string', 'description': "Filter by court level: 'scotus', 'appeals', 'district', or a specific court ID (e.g. 'ca9', 'nysd'). Leave blank for all courts."}, 'limit': {'type': 'integer', 'description': 'Max results (default 5, max 20).'}, 'query': {'type': 'string', 'description': "Search query â\x80\x94 can be a legal concept, case name, statute, or citation (e.g. 'miranda rights', 'negligence per se', 'Title VII', '410 U.S. 113')."}, 'date_after': {'type': 'string', 'description': 'Filter to opinions filed after this date (YYYY-MM-DD).'}, 'date_before': {'type': 'string', 'description': 'Filter to opinions filed before this date (YYYY-MM-DD).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'count': {'type': 'integer'}, 'query': {'type': 'string'}, 'opinions': {'type': 'array', 'description': 'Matching court opinions.'}, 'total_found': {'type': 'integer'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'minimum': 1, 'description': 'Page number for pagination (default 1).'}, 'slug': {'type': 'string', 'description': "If provided, fetch a specific market by its Limitless slug (e.g. 'btc-up-or-down-5-min-1780703750051'). Overrides other filters."}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Number of markets to return (1â\x80\x9320, default 10).'}, 'query': {'type': 'string', 'description': "Optional keyword filter applied to market titles (case-insensitive). E.g. 'btc', 'eth', 'sol'."}, 'trade_type': {'enum': ['clob', 'amm'], 'type': 'string', 'description': "Filter by trade mechanism: 'clob' (order book) or 'amm' (automated market maker). Default returns all."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'markets': {'type': 'array', 'items': {'type': 'object', 'properties': {'slug': {'type': 'string', 'description': 'Unique slug for direct API lookup.'}, 'title': {'type': 'string', 'description': 'Market title / question.'}, 'status': {'type': 'string', 'description': 'Market status: FUNDED, RESOLVED, EXPIRED, etc.'}, 'volume': {'type': 'string', 'description': 'Trading volume in USDC (raw string from API).'}, 'no_price': {'type': 'number', 'description': 'Implied No probability (0â\x80\x931).'}, 'yes_price': {'type': 'number', 'description': 'Implied Yes probability (0â\x80\x931).'}, 'categories': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Market category tags.'}, 'collateral': {'type': 'string', 'description': 'Settlement token symbol (usually USDC).'}, 'expiration': {'type': 'string', 'description': 'Expiration date string.'}, 'trade_type': {'type': 'string', 'description': "'clob' or 'amm'."}, 'stable_slug': {'type': 'string', 'description': 'Stable recurring market identifier (e.g. btc-5min-price).'}, 'expiration_ts': {'type': 'number', 'description': 'Expiration as Unix ms timestamp.'}}}}, 'generated_at': {'type': 'string'}, 'total_returned': {'type': 'integer'}, 'filters_applied': {'type': 'object'}, 'total_available': {'type': 'integer', 'description': 'Total active markets on Limitless Exchange.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['prompt'], 'properties': {'model': {'enum': ['gpt-4o-mini'], 'type': 'string', 'description': 'Model to use. Only gpt-4o-mini is available on this flat-price route.'}, 'prompt': {'type': 'string', 'description': 'The user message / task to send to the LLM.'}, 'system': {'type': 'string', 'description': 'Optional system prompt. Sets the persona or role for the model.'}, 'max_tokens': {'type': 'integer', 'maximum': 2000, 'minimum': 1, 'description': 'Maximum output tokens. Default: 500. Increase for longer outputs (max 2,000).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'model': {'type': 'string', 'description': 'The model that handled the request.'}, 'usage': {'type': 'object', 'properties': {'total_tokens': {'type': 'integer'}, 'prompt_tokens': {'type': 'integer'}, 'completion_tokens': {'type': 'integer'}}}, 'content': {'type': 'string', 'description': "The model's response text."}, 'finish_reason': {'type': 'string', 'description': 'Why the model stopped: stop (natural end), length (hit max_tokens), or content_filter.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'signals': {'type': 'object', 'properties': {'hy_oas': {'type': 'number'}, 'ig_oas': {'type': 'number'}, 'core_pce': {'type': 'number'}, 'fed_funds': {'type': 'number'}, 'yield_curve': {'type': 'number'}, 'curve_regime': {'type': 'string'}, 'labor_signal': {'type': 'string'}, 'credit_regime': {'type': 'string'}, 'initial_claims': {'type': 'number'}, 'jolts_openings': {'type': 'number'}}, 'description': 'Raw signal data used in synthesis.'}, 'narrative': {'type': 'string', 'description': 'Full 200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence macro regime summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'generated_at': {'type': 'string'}, 'regime_label': {'type': 'string', 'description': 'Current macro regime: expansion | late_cycle | contraction | recovery | uncertain'}, 'dominant_risk': {'type': 'string', 'description': 'Most important risk the combined signals imply.'}, 'agent_implication': {'type': 'string', 'description': 'Concrete decision relevance for AI agents.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'cpi': {'type': 'number', 'description': 'CPI All Urban Consumers index value (1982-84=100).'}, 'cpi_date': {'type': 'string', 'description': 'Date of latest CPI observation.'}, 'cpi_yoy_pct': {'type': 'number', 'description': 'CPI year-over-year % change (inflation rate), or null if prior-year data unavailable.'}, 'real_gdp_date': {'type': 'string', 'description': 'Date of latest GDP observation.'}, 'fed_funds_date': {'type': 'string', 'description': 'Date of latest Fed Funds observation (YYYY-MM-DD).'}, 'fed_funds_rate': {'type': 'number', 'description': 'Fed Funds effective rate (%).'}, 'real_gdp_billions': {'type': 'number', 'description': 'Real GDP in billions USD (SAAR â\x80\x94 seasonally adjusted annual rate).'}, 'unemployment_date': {'type': 'string', 'description': 'Date of latest unemployment observation.'}, 'unemployment_rate': {'type': 'number', 'description': 'US unemployment rate (%).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'signals': {'type': 'object', 'properties': {'ip_mom_pct': {'type': 'number', 'description': 'Industrial Production MoM % change.'}, 'ppi_mom_pct': {'type': 'number', 'description': 'PPI All Commodities MoM % change.'}, 'output_trend': {'type': 'string'}, 'cap_util_mom_pp': {'type': 'number', 'description': 'Capacity utilization MoM percentage-point change.'}, 'capacity_regime': {'type': 'string'}, 'mfg_employment_k': {'type': 'number', 'description': 'Manufacturing employees (thousands).'}, 'inventory_posture': {'type': 'string'}, 'mfg_output_mom_pct': {'type': 'number', 'description': 'Manufacturing output MoM % change.'}, 'input_cost_pressure': {'type': 'string'}, 'ppi_all_commodities': {'type': 'number', 'description': 'PPI All Commodities index (1982=100).'}, 'mfg_production_index': {'type': 'number', 'description': 'IPMAN: manufacturing production index (2017=100).'}, 'inventory_sales_ratio': {'type': 'number', 'description': 'Total business inventories/sales ratio.'}, 'durable_orders_mom_pct': {'type': 'number', 'description': 'Durable Goods orders MoM % change.'}, 'durable_goods_orders_bn': {'type': 'number', 'description': 'Durable Goods new orders in $B.'}, 'capacity_utilization_pct': {'type': 'number', 'description': 'TCU: total industry capacity utilization %.'}, 'mfg_employment_mom_chg_k': {'type': 'number', 'description': 'Manufacturing employment MoM change (thousands).'}, 'industrial_production_index': {'type': 'number', 'description': 'INDPRO index (2017=100).'}}, 'description': 'Raw signal data used in synthesis.'}, 'narrative': {'type': 'string', 'description': 'Full ~200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence manufacturing sector summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'generated_at': {'type': 'string'}, 'dominant_risk': {'type': 'string', 'description': 'Most important risk the combined signals imply.'}, 'agent_implication': {'type': 'string', 'description': 'Concrete decision relevance for AI agents.'}, 'manufacturing_regime': {'type': 'string', 'description': 'Current regime: expanding | growing | stagnant | contracting | uncertain'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'examples': [{'ts': '2026-09-22T08:12:34.952Z', 'mid_cap': {'signal': 'UNDERPERFORMING', 'ratio_20d_avg': 0.8919, 'ratio_current': 0.864, 'divergence_pct': -3.13, 'momentum_5d_pct': -2.3}, 'small_cap': {'signal': 'UNDERPERFORMING', 'ratio_20d_avg': 0.3815, 'ratio_current': 0.3692, 'divergence_pct': -3.23, 'momentum_5d_pct': -1.93}, 'spy_price': 773.5, 'data_quality': 'COMPLETE', 'equal_weight': {'signal': 'UNDERPERFORMING', 'ratio_20d_avg': 0.2839, 'ratio_current': 0.275, 'divergence_pct': -3.14, 'momentum_5d_pct': -2.67}, 'breadth_score': -50, 'risk_appetite': {'signal': 'OUTPERFORMING', 'ratio_20d_avg': 1.9722, 'ratio_current': 2.0998, 'divergence_pct': 6.47, 'momentum_5d_pct': 8.57}, 'breadth_regime': 'STRONGLY_BEARISH', 'pairs_computed': 4, 'breadth_summary': 'STRONGLY_BEARISH: equal-weight underperforming (RSP/SPY div -3.1%); small-caps underperforming (IWM/SPY div -3.2%)'}], 'properties': {'ts': {'type': 'string', 'description': 'ISO 8601 timestamp.'}, 'mid_cap': {'type': ['object', 'null'], 'properties': {'signal': {'enum': ['OUTPERFORMING', 'NEUTRAL', 'UNDERPERFORMING'], 'type': 'string'}, 'ratio_20d_avg': {'type': 'number'}, 'ratio_current': {'type': 'number'}, 'divergence_pct': {'type': 'number'}, 'momentum_5d_pct': {'type': 'number'}}, 'description': 'MDY vs SPY â\x80\x94 mid-cap vs large-cap participation. MDY outperforming = broad market lift.'}, 'small_cap': {'type': ['object', 'null'], 'properties': {'signal': {'enum': ['OUTPERFORMING', 'NEUTRAL', 'UNDERPERFORMING'], 'type': 'string'}, 'ratio_20d_avg': {'type': 'number'}, 'ratio_current': {'type': 'number'}, 'divergence_pct': {'type': 'number'}, 'momentum_5d_pct': {'type': 'number'}}, 'description': 'IWM vs SPY â\x80\x94 small-cap vs large-cap participation. IWM outperforming = healthy risk-on breadth.'}, 'spy_price': {'type': ['number', 'null'], 'description': 'Current SPY price.'}, 'data_quality': {'enum': ['COMPLETE', 'PARTIAL'], 'type': 'string', 'description': 'PARTIAL means the composite uses fewer than all four breadth pairs.'}, 'equal_weight': {'type': ['object', 'null'], 'properties': {'signal': {'enum': ['OUTPERFORMING', 'NEUTRAL', 'UNDERPERFORMING'], 'type': 'string'}, 'ratio_20d_avg': {'type': 'number'}, 'ratio_current': {'type': 'number'}, 'divergence_pct': {'type': 'number', 'description': 'Current ratio vs 20-day avg (%). Positive = RSP outperforming SPY.'}, 'momentum_5d_pct': {'type': 'number', 'description': '5-day ratio trend (%). Positive = breadth improving.'}}, 'description': 'RSP vs SPY â\x80\x94 equal-weight vs cap-weight breadth. Positive divergence = broad participation.'}, 'breadth_score': {'type': 'integer', 'description': 'Composite breadth score: â\x88\x92100 (extreme narrowing) to +100 (extreme breadth expansion).'}, 'risk_appetite': {'type': ['object', 'null'], 'properties': {'signal': {'enum': ['OUTPERFORMING', 'NEUTRAL', 'UNDERPERFORMING'], 'type': 'string'}, 'ratio_20d_avg': {'type': 'number'}, 'ratio_current': {'type': 'number'}, 'divergence_pct': {'type': 'number'}, 'momentum_5d_pct': {'type': 'number'}}, 'description': 'SPHB vs SPLV â\x80\x94 high-beta vs low-volatility. SPHB outperforming = risk-on market posture.'}, 'breadth_regime': {'type': 'string', 'description': 'Breadth regime: STRONGLY_BULLISH | BULLISH | NEUTRAL | BEARISH | STRONGLY_BEARISH'}, 'pairs_computed': {'type': 'integer', 'description': 'Number of ratio pairs successfully computed (of 4 attempted).'}, 'breadth_summary': {'type': 'string', 'description': 'One-line interpretation of the current breadth signal.'}}, 'x-stall-example-provenance': {'kind': 'historical verified diagnostic response', 'resources': [{'host': 'query2.finance.yahoo.com', 'path': '/v8/finance/chart/RSP', 'bytes': 3440, 'sha256': '4c827e262edc81de473901bcdc10166e8351ce4dfc7fd0361dcbdc3d216bb7a4', 'status': 200, 'observed_at': '2026-09-22T08:12:34.871Z'}, {'host': 'query2.finance.yahoo.com', 'path': '/v8/finance/chart/IWM', 'bytes': 3430, 'sha256': '2053cb2a276bb2368af8ab379f2e15c58680a6b40db7bb548a685b0a208661ff', 'status': 200, 'observed_at': '2026-09-22T08:12:34.877Z'}, {'host': 'query2.finance.yahoo.com', 'path': '/v8/finance/chart/SPLV', 'bytes': 3369, 'sha256': '508d515d9021ed9ddfda396fab9aa0086b79b02cd8865ef62ca780109a9fd9f8', 'status': 200, 'observed_at': '2026-09-22T08:12:34.878Z'}, {'host': 'query2.finance.yahoo.com', 'path': '/v8/finance/chart/SPHB', 'bytes': 3365, 'sha256': '0a8280e1bc7f6cbfe498c14f6acf68c9ecc8595d65ef4555495686f4f298afd9', 'status': 200, 'observed_at': '2026-09-22T08:12:34.896Z'}, {'host': 'query2.finance.yahoo.com', 'path': '/v8/finance/chart/SPY', 'bytes': 3288, 'sha256': '112bc5b14a647b3ade28172372d227035a1952b9e9cbe8e964772eb2b7cbb47a', 'status': 200, 'observed_at': '2026-09-22T08:12:34.914Z'}, {'host': 'query2.finance.yahoo.com', 'path': '/v8/finance/chart/MDY', 'bytes': 3316, 'sha256': 'f7dc24ef0411f04642a7ef1e787b05127980f743b04246fed4a275f0b4b1b1bc', 'status': 200, 'observed_at': '2026-09-22T08:12:34.952Z'}], 'observed_at': '2026-09-22T08:12:34.952Z', 'current_data': False, 'output_sha256': '8382591582c35b14b779072122a82e76056fc6a8c81bb7f37f1a10256141a2fe', 'source_sha256': '23219f5df442fc12cb745ccb67e71fb177506e18b54392b919d1d274cb7b66e2'}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'top_n': {'type': 'integer', 'maximum': 20, 'minimum': 3, 'description': 'Number of top positive and negative GEX strikes to return. Default: 10.'}, 'ticker': {'type': 'string', 'description': 'US equity or ETF ticker (e.g. SPY, QQQ, AAPL, NVDA). Case-insensitive.'}, 'days_out': {'type': 'integer', 'maximum': 90, 'minimum': 0, 'description': 'Include only options expiring within this many calendar days. Default: 45 (captures standard monthly + weekly expiries).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'spot': {'type': 'number', 'description': 'Current underlying price.'}, 'ticker': {'type': 'string'}, 'put_gex': {'type': 'number', 'description': 'Total put-side GEX contribution.'}, 'call_gex': {'type': 'number', 'description': 'Total call-side GEX contribution.'}, 'total_gex': {'type': 'number', 'description': 'Aggregate dealer gamma exposure in USD. Positive = net long gamma; negative = net short gamma.'}, 'gamma_flip': {'type': ['number', 'null'], 'description': 'Strike where net GEX crosses zero (gamma flip level). Null if no crossing found.'}, 'vol_regime': {'type': 'string', 'description': "Volatility regime: 'pinned' (GEX > 0), 'acceleration' (GEX < 0), or 'neutral'."}, 'key_strikes': {'type': 'array', 'description': 'Top strikes by absolute GEX (both positive and negative), sorted by abs GEX descending.'}, 'expiry_range': {'type': 'string', 'description': 'Date range of expiries included.'}, 'options_count': {'type': 'integer', 'description': 'Number of options included in the analysis.'}, 'data_delay_min': {'type': 'integer'}, 'negative_gex_wall': {'type': ['number', 'null'], 'description': 'Lowest aggregate negative-GEX strike â\x80\x94 acts as downside acceleration level.'}, 'positive_gex_wall': {'type': ['number', 'null'], 'description': 'Highest aggregate positive-GEX strike â\x80\x94 acts as upside resistance/pin.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'description': 'Max results (default 20, max 50).'}, 'sort_by': {'enum': ['payers', 'settlements', 'price_asc', 'price_desc', 'last_seen'], 'type': 'string', 'description': 'Sort order. Default: payers (highest organic breadth first).'}, 'category': {'type': 'string', 'description': "Filter by endpoint category (e.g., 'ai', 'data', 'finance', 'search'). Omit for all."}, 'min_payers': {'type': 'integer', 'description': 'Minimum unique payer count (default 3). Higher = more proven organic demand.'}, 'max_price_usd': {'type': 'number', 'description': 'Maximum endpoint price in USD. Omit for no ceiling.'}, 'min_price_usd': {'type': 'number', 'description': 'Minimum endpoint price in USD (default 0.01). Use 0.50 to see PRIMARY_RANGE only.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'endpoints': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'pay_to': {'type': 'string', 'description': 'Payment wallet address.'}, 'network': {'type': 'string', 'description': 'e.g. base, base-sepolia'}, 'category': {'type': 'string'}, 'resource': {'type': 'string', 'description': 'Endpoint URL.'}, 'last_seen': {'type': 'string', 'description': 'ISO-8601 most recent settlement observed.'}, 'price_usd': {'type': 'number'}, 'first_seen': {'type': 'string', 'description': 'ISO-8601 first settlement observed.'}, 'price_tier': {'enum': ['COMMODITY', 'MICRO', 'MARGINAL', 'PRIMARY', 'HIGH_VALUE'], 'type': 'string'}, 'description': {'type': 'string'}, 'unique_payers': {'type': 'integer', 'description': 'Distinct payer wallets observed (organic breadth signal).'}, 'calls_per_payer': {'type': 'number', 'description': 'Ratio indicating recurring vs one-time usage.'}, 'total_settlements': {'type': 'integer', 'description': 'Total on-chain settled calls.'}}}}, 'window_note': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'archive_settlements': {'type': 'integer', 'description': 'Total settlements in archive at query time.'}, 'total_active_endpoints': {'type': 'integer', 'description': 'Total endpoints in archive that match query criteria (before limit).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Number of results per category (1â\x80\x9320, default 10).'}, 'mover_type': {'enum': ['all', 'gainers', 'losers', 'active'], 'type': 'string', 'description': "Which mover category. 'active' returns US equities by volume (no crypto equivalent). Default 'all'."}, 'asset_class': {'enum': ['both', 'equities', 'crypto'], 'type': 'string', 'description': "Which asset class to return. Default 'both'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'generated_at': {'type': 'string'}, 'crypto_losers': {'type': 'array', 'items': {'type': 'object'}}, 'equity_active': {'type': 'array', 'items': {'type': 'object'}}, 'equity_losers': {'type': 'array', 'items': {'type': 'object'}}, 'crypto_gainers': {'type': 'array', 'items': {'type': 'object'}}, 'equity_gainers': {'type': 'array', 'items': {'type': 'object'}}, 'sections_returned': {'type': 'array', 'items': {'type': 'string'}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'dia': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'ticker': {'type': 'string'}, 'change_pct': {'type': 'number'}, 'change_usd': {'type': 'number'}}, 'description': 'Dow Jones ETF (DIA): price, change_pct, change_usd.'}, 'iwm': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'ticker': {'type': 'string'}, 'change_pct': {'type': 'number'}, 'change_usd': {'type': 'number'}}, 'description': 'Russell 2000 ETF (IWM): price, change_pct, change_usd.'}, 'qqq': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'ticker': {'type': 'string'}, 'change_pct': {'type': 'number'}, 'change_usd': {'type': 'number'}}, 'description': 'NASDAQ-100 ETF (QQQ): price, change_pct, change_usd.'}, 'spy': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'ticker': {'type': 'string'}, 'change_pct': {'type': 'number'}, 'change_usd': {'type': 'number'}}, 'description': 'S&P 500 ETF (SPY): price, change_pct, change_usd.'}, 'vix': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'ticker': {'type': 'string'}, 'change_pct': {'type': 'number'}, 'change_usd': {'type': 'number'}}, 'description': 'CBOE Volatility Index (VIX): current level and intraday change.'}, 'yield_10y': {'type': 'object', 'properties': {'price': {'type': 'number'}, 'ticker': {'type': 'string'}, 'change_pct': {'type': 'number'}, 'change_usd': {'type': 'number'}}, 'description': 'US 10-Year Treasury Yield (^TNX): current yield and intraday change.'}, 'risk_posture': {'enum': ['RISK_ON', 'NEUTRAL', 'RISK_OFF', 'RISK_OFF_ELEVATED', 'UNKNOWN'], 'type': 'string', 'description': 'Composite signal derived from VIX level and equity breadth. RISK_ON = VIX <15 and â\x89¥2 indices advancing. RISK_OFF_ELEVATED = VIX >25. Use as a regime filter, not a trading signal.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'required': [], 'properties': {'as_of': {'type': 'string', 'description': 'ISO date of most recent data.'}, 'regime': {'type': 'string', 'description': 'BULL | CORRECTION | BEAR | SIDEWAYS | RISK_OFF'}, 'signals': {'type': 'object', 'description': 'Per-signal scores (trend, volatility, credit, rates, momentum).'}, 'narrative': {'type': 'string', 'description': 'Plain-English regime summary and key drivers.'}, 'confidence': {'type': 'number', 'description': 'Composite signal consensus 0â\x80\x93100.'}, 'price_data': {'type': 'object', 'description': 'Key levels: SPY, QQQ, IWM, VIX, HYG/IEF, TNX.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'include_iv': {'type': 'boolean', 'description': 'Whether to fetch Deribit BTC/ETH implied volatility (adds ~500ms). Default true.'}, 'history_days': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Number of past daily FGI readings to include in response (1â\x80\x9330). Default 7.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'fgi': {'type': 'object', 'properties': {'value': {'type': 'integer', 'description': 'Current Fear & Greed score 0 (max fear) to 100 (max greed).'}, 'history': {'type': 'array', 'description': 'Daily FGI readings (newest first).'}, 'trend_7d': {'type': 'string', 'description': 'IMPROVING | DETERIORATING | STABLE'}, 'last_week': {'type': 'integer'}, 'yesterday': {'type': 'integer'}, 'classification': {'type': 'string', 'description': 'EXTREME_FEAR | FEAR | NEUTRAL | GREED | EXTREME_GREED'}}}, 'composite_signal': {'type': 'string', 'description': 'Regime label combining FGI + IV: CAPITULATION_ZONE | OVERHEATED | COMPLACENT_GREED | QUIET_DREAD | CALM_MARKET | NEUTRAL_REGIME | INSUFFICIENT_DATA'}, 'implied_volatility': {'type': 'object', 'properties': {'btc': {'type': ['object', 'null']}, 'eth': {'type': ['object', 'null']}, 'note': {'type': 'string'}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'type': 'string', 'description': "Optional style variant (e.g. 'animated', 'dark', 'no'). Only supported by some templates. Defaults to template default."}, 'topic': {'type': 'string', 'description': "Topic keyword used to auto-select a template when 'template' is omitted. Examples: 'choice', 'crypto', 'success', 'fire', 'ai'. Ignored if template is specified."}, 'width': {'type': 'integer', 'maximum': 1200, 'minimum': 100, 'description': 'Output image width in pixels. Defaults to 600.'}, 'height': {'type': 'integer', 'maximum': 1200, 'minimum': 100, 'description': 'Output image height in pixels. Defaults to 450.'}, 'template': {'type': 'string', 'description': 'Meme template ID. Examples: drake, doge, distracted, buzz, fry, gru, success, oprah, astronaut, brain, fine, picard. Omit to auto-select from topic.'}, 'text_top': {'type': 'string', 'description': 'Top line of the meme (the setup or rejected option). Max 120 chars.'}, 'text_bottom': {'type': 'string', 'description': 'Bottom line of the meme (the punchline or preferred option). Max 120 chars.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['image_url', 'template_id'], 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 generation timestamp.'}, 'width': {'type': 'integer', 'description': 'Image width in pixels.'}, 'format': {'type': 'string', 'description': 'Image format (jpeg or gif for animated).'}, 'height': {'type': 'integer', 'description': 'Image height in pixels.'}, 'text_top': {'type': 'string', 'description': 'Actual top text rendered.'}, 'image_url': {'type': 'string', 'description': 'Direct URL to the generated meme image (JPEG).'}, 'template_id': {'type': 'string', 'description': 'Template ID used.'}, 'text_bottom': {'type': 'string', 'description': 'Actual bottom text rendered.'}, 'template_name': {'type': 'string', 'description': 'Human-readable template name.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 30, 'minimum': 1, 'description': 'Max tokens to return (1â\x80\x9330). Default: 10.'}, 'sort_by': {'enum': ['quality', 'volume_h24', 'price_change_h24', 'market_cap'], 'type': 'string', 'description': 'Ranking field. Default: quality (composite buy-pressure + consistency + liquidity score).'}, 'min_volume_h24': {'type': 'number', 'minimum': 0, 'description': 'Minimum 24h trading volume in USD. Default: 5000.'}, 'min_liquidity_usd': {'type': 'number', 'minimum': 0, 'description': 'Minimum pool liquidity in USD. Default: 1000 (filters micro-rugs).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'tokens': {'type': 'array', 'items': {'type': 'object', 'properties': {'dex': {'type': 'string', 'description': 'Primary DEX (e.g. pumpswap, raydium).'}, 'name': {'type': 'string', 'description': 'Token name.'}, 'symbol': {'type': 'string', 'description': 'Token ticker symbol.'}, 'address': {'type': 'string', 'description': 'Solana token mint address.'}, 'website': {'type': ['string', 'null'], 'description': 'Project website if available.'}, 'buys_h24': {'type': ['integer', 'null'], 'description': 'Buy-side transactions last 24h.'}, 'pair_url': {'type': 'string', 'description': 'DexScreener pair URL.'}, 'buy_ratio': {'type': ['number', 'null'], 'description': 'Buys / (buys + sells). >0.6 = buyer demand.'}, 'price_usd': {'type': ['number', 'null'], 'description': 'Current price in USD.'}, 'sells_h24': {'type': ['integer', 'null'], 'description': 'Sell-side transactions last 24h.'}, 'volume_h1': {'type': ['number', 'null'], 'description': '1h trading volume USD.'}, 'volume_h24': {'type': ['number', 'null'], 'description': '24h trading volume USD.'}, 'twitter_url': {'type': ['string', 'null'], 'description': 'Twitter/X link if available.'}, 'liquidity_usd': {'type': ['number', 'null'], 'description': 'Pool liquidity in USD.'}, 'quality_score': {'type': 'number', 'description': 'Composite quality score (0â\x80\x931). Higher = more organic, liquid, consistent.'}, 'market_cap_usd': {'type': ['number', 'null'], 'description': 'Market cap in USD.'}, 'price_change_h1': {'type': ['number', 'null'], 'description': '1h price change %.'}, 'price_change_h24': {'type': ['number', 'null'], 'description': '24h price change %.'}}}}, 'sort_by': {'type': 'string', 'description': 'Sort field used.'}, 'fetched_at': {'type': 'string'}, 'filters_applied': {'type': 'object', 'description': 'Active filter values used.'}, 'total_candidates': {'type': 'integer', 'description': 'Tokens evaluated before filters applied.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 365, 'minimum': 1, 'description': 'For mode=recent: calendar days back to search (default 30, max 365).'}, 'mode': {'enum': ['company', 'recent'], 'type': 'string', 'description': "'company' (default when ticker given) returns M&A filings for that ticker. 'recent' returns market-wide M&A activity in the last N days."}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results to return (default 20, max 50).'}, 'ticker': {'type': 'string', 'description': 'US public company ticker symbol (e.g. TSLA, AAPL, T). Case-insensitive. Check if a specific company has M&A filings.'}, 'filed_after': {'type': 'string', 'description': 'Optional incremental cursor. Return only filings after this YYYY-MM-DD date; reuse next_filed_after on the next poll.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ticker': {'type': 'string'}, 'company': {'type': 'string'}, 'filings': {'type': 'array'}, 'interpretation': {'type': 'string'}, 'ma_filings_found': {'type': 'integer'}, 'next_filed_after': {'type': ['string', 'null']}, 'next_poll_after_utc': {'type': 'string'}, 'total_filings_in_period': {'type': 'integer'}, 'recommended_poll_interval_hours': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ratios': {'type': 'object', 'properties': {'gold_silver_ratio': {'type': 'number'}}, 'description': 'Derived ratios.'}, 'equities': {'type': 'object', 'properties': {'gld_etf': {'type': 'object'}, 'slv_etf': {'type': 'object'}, 'copx_etf': {'type': 'object'}, 'nem_newmont': {'type': 'object'}, 'fcx_freeport': {'type': 'object'}}, 'description': 'Mining equity performance.'}, 'precious': {'type': 'object', 'properties': {'gold_oz': {'type': 'object'}, 'silver_oz': {'type': 'object'}, 'platinum_oz': {'type': 'object'}}, 'description': 'Precious metals spot prices.'}, 'narrative': {'type': 'string', 'description': 'Full ~200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence metals market summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'industrial': {'type': 'object', 'properties': {'copper_lb': {'type': 'object'}}, 'description': 'Industrial metals.'}, 'generated_at': {'type': 'string'}, 'metals_regime': {'type': 'string', 'description': 'BROAD_METALS_RALLY | PRECIOUS_RALLY | INDUSTRIAL_RALLY | GOLD_NEAR_HIGH | METALS_RISK_OFF | MIXED'}, 'dominant_driver': {'type': 'string', 'description': 'Main force moving metals today.'}, 'agent_implication': {'type': 'string', 'description': 'Concrete action relevance for AI agents.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['domain'], 'properties': {'sort': {'enum': ['downloads', 'likes', 'lastModified'], 'type': 'string', 'description': 'Model sort order. Default: downloads.'}, 'domain': {'type': 'string', 'description': "AI/ML domain or task to investigate (e.g. 'code generation', 'image segmentation', 'protein folding', 'multimodal reasoning')."}, 'task_filter': {'type': 'string', 'description': "Optional HuggingFace pipeline task filter (e.g. 'text-generation', 'image-classification', 'token-classification')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'error': {'type': ['string', 'null']}, 'domain': {'type': 'string'}, 'top_models': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'url': {'type': 'string'}, 'tags': {'type': 'array', 'items': {'type': 'string'}}, 'likes': {'type': ['integer', 'null']}, 'author': {'type': ['string', 'null']}, 'library': {'type': ['string', 'null']}, 'downloads': {'type': ['integer', 'null']}, 'pipeline_tag': {'type': ['string', 'null']}, 'last_modified': {'type': ['string', 'null']}}}}, 'model_count': {'type': 'integer'}, 'task_filter': {'type': ['string', 'null']}, 'generated_at': {'type': 'string'}, 'use_case_fit': {'type': 'string'}, 'research_trends': {'type': 'array', 'items': {'type': 'string'}}, 'sources_queried': {'type': 'integer'}, 'landscape_summary': {'type': 'string'}, 'sources_responded': {'type': 'integer'}, 'maturity_assessment': {'type': 'string'}, 'top_model_recommendation': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'number', 'description': 'Lookback window in days (1â\x80\x9330). Default: 3.'}, 'query': {'type': 'string', 'description': "Company name, stock ticker, or news topic (e.g. 'NVIDIA', 'Apple earnings', 'Bitcoin regulation', 'Fed interest rates')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'note': {'type': 'string', 'description': 'Contextual note about data availability or source fallback.'}, 'query': {'type': 'string'}, 'source': {'type': 'string', 'description': "Data source used: 'gdelt' (ML tone) or 'google_news_rss' (keyword heuristic)."}, 'avg_tone': {'type': 'number', 'description': 'Weighted avg tone: â\x88\x92100 = very negative, +100 = very positive, near 0 = neutral. Precise when source=gdelt; approximate keyword score when source=google_news_rss.'}, 'sentiment': {'enum': ['positive', 'neutral', 'negative'], 'type': 'string'}, 'period_days': {'type': 'number'}, 'top_domains': {'type': 'array', 'items': {'type': 'object', 'properties': {'count': {'type': 'number'}, 'domain': {'type': 'string'}}}, 'description': 'Top 5 news domains by article count.'}, 'top_stories': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}}}, 'description': 'Top recent headlines (Google News RSS fallback only).'}, 'top_negative': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}}}, 'description': 'Most negatively-toned articles (GDELT source only).'}, 'top_positive': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}}}, 'description': 'Most positively-toned articles (GDELT source only).'}, 'article_count': {'type': 'number', 'description': 'Total articles found matching query in the time window.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'network': {'enum': ['ethereum', 'eth', 'mainnet', 'polygon', 'matic', 'base', 'arbitrum', 'arb', 'optimism'], 'type': 'string', 'description': 'Blockchain network. Options: ethereum, polygon, base, arbitrum, optimism. Default: ethereum.'}, 'contract': {'type': 'string', 'description': 'NFT contract address (0x hex, 42 chars). Example: 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D (BAYC).'}, 'token_id': {'type': 'string', 'description': "Token ID as a string or integer. Example: '42' or '1000'. ERC-1155 token IDs also accepted."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'name': {'type': 'string', 'description': "NFT name (e.g. 'Azuki #42')."}, 'network': {'type': 'string'}, 'contract': {'type': 'object', 'description': 'Contract details: address, name, symbol, deployer.'}, 'image_url': {'type': 'string', 'description': 'CDN-cached image URL (PNG/SVG/GIF).'}, 'token_uri': {'type': 'string', 'description': 'Raw token URI (IPFS or HTTP).'}, 'attributes': {'type': 'array', 'description': 'Array of {trait_type, value} objects.'}, 'collection': {'type': 'object', 'description': 'Collection info: name, openSea floor price ETH, total supply.'}, 'mint_block': {'type': 'integer', 'description': 'Block number when this token was minted.'}, 'token_type': {'type': 'string', 'description': 'ERC721 or ERC1155.'}, 'description': {'type': 'string', 'description': 'NFT description text.'}, 'image_original': {'type': 'string', 'description': 'Original image URL or IPFS URI.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ein': {'type': 'string', 'description': "9-digit IRS Employer Identification Number (mode=by_ein). Example: '530196605'. Hyphens stripped automatically."}, 'mode': {'enum': ['search', 'by_ein', 'recent'], 'type': 'string', 'description': "'search' (default): find by organization name. 'by_ein': full 990 financial history by EIN. 'recent': browse by NTEE sector and/or state."}, 'state': {'type': 'string', 'description': "Two-letter US state code to filter results (optional). Example: 'NY', 'CA', 'TX'."}, 'org_name': {'type': 'string', 'description': "Organization name to search for (mode=search). Example: 'American Red Cross', 'Gates Foundation', 'Planned Parenthood'."}, 'ntee_code': {'type': 'string', 'description': 'NTEE major group letter for mode=recent (optional). A=Arts, B=Education, C=Environment, E=Health, G=Disease, H=Medical Research, K=Food, L=Housing, P=Human Services, Q=International, T=Philanthropy, X=Religion.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string'}, 'source': {'type': 'string'}, 'profile': {'type': 'object'}, 'showing': {'type': 'integer'}, 'filings_count': {'type': 'integer'}, 'organizations': {'type': 'array'}, 'total_results': {'type': 'integer'}, 'ntee_reference': {'type': 'object'}, 'financial_history': {'type': 'array'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'npi': {'type': 'string', 'description': '10-digit NPI number for direct lookup (fastest, most precise).'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results to return (1â\x80\x9350, default 10).'}, 'state': {'type': 'string', 'description': "2-letter US state code to filter by practice location (e.g. 'CA', 'NY')."}, 'last_name': {'type': 'string', 'description': "Provider last name (individual providers). Supports wildcard with '*' suffix (e.g. 'Smi*')."}, 'specialty': {'type': 'string', 'description': "Taxonomy/specialty description to filter (e.g. 'Internal Medicine', 'Cardiology', 'Psychiatry')."}, 'first_name': {'type': 'string', 'description': 'Provider first name (individual providers only).'}, 'postal_code': {'type': 'string', 'description': '5-digit ZIP code to filter by practice location.'}, 'organization': {'type': 'string', 'description': 'Organization name for NPI-2 (group practices, hospitals, labs, etc.).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'providers': {'type': 'array', 'items': {'type': 'object', 'properties': {'npi': {'type': 'string'}, 'sex': {'type': 'string', 'nullable': True}, 'name': {'type': 'string'}, 'status': {'type': 'string'}, 'specialty': {'type': 'string', 'nullable': True}, 'credential': {'type': 'string', 'nullable': True}, 'entity_type': {'type': 'string'}, 'last_updated': {'type': 'string', 'nullable': True}, 'license_states': {'type': 'array', 'items': {'type': 'string'}}, 'specialty_code': {'type': 'string', 'nullable': True}, 'sole_proprietor': {'type': 'boolean', 'nullable': True}, 'enumeration_date': {'type': 'string', 'nullable': True}, 'practice_address': {'type': 'object', 'nullable': True}}}}, 'result_count': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'package': {'type': 'string', 'description': "npm package name (e.g. 'express', 'react', '@anthropic-ai/sdk'). Scoped packages like '@scope/name' are supported."}, 'version': {'type': 'string', 'description': "Specific version to look up (e.g. '4.18.2'). Defaults to latest stable."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'name': {'type': 'string'}, 'author': {'type': ['string', 'null']}, 'engines': {'type': ['object', 'null'], 'description': 'Node/npm version requirements.'}, 'license': {'type': ['string', 'null']}, 'npm_url': {'type': 'string'}, 'version': {'type': 'string'}, 'bugs_url': {'type': ['string', 'null']}, 'homepage': {'type': ['string', 'null']}, 'keywords': {'type': 'array', 'items': {'type': 'string'}}, 'dep_count': {'type': 'integer', 'description': 'Number of direct runtime dependencies.'}, 'dist_tags': {'type': 'object', 'description': 'Tag â\x86\x92 version map (latest, next, etc.).'}, 'peer_deps': {'type': 'object', 'description': 'Peer dependencies.'}, 'repository': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'all_versions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Recent versions (newest first, max 20).'}, 'dependencies': {'type': 'object', 'description': 'Direct runtime dependencies and version ranges.'}, 'latest_publish': {'type': ['string', 'null'], 'description': 'ISO-8601 publish date of this version.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'period': {'enum': ['last-day', 'last-week', 'last-month', 'last-year'], 'type': 'string', 'description': "Download period to retrieve. 'last-month' gives 30 daily data points; 'last-year' gives 365. Defaults to last-month."}, 'packages': {'type': 'array', 'items': {'type': 'string'}, 'description': "npm package names to compare. e.g. ['express','fastify','hono']. Scoped packages like '@anthropic-ai/sdk' are supported."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'period': {'type': 'string', 'description': 'Period queried.'}, 'packages': {'type': 'object', 'description': 'Keyed by package name.', 'additionalProperties': {'type': 'object', 'properties': {'error': {'type': ['string', 'null'], 'description': 'Error message if this package failed.'}, 'total': {'type': ['integer', 'null'], 'description': 'Total downloads in period.'}, 'weekly': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'count': {'type': 'integer'}}}, 'description': 'Daily download counts.'}, 'trend_pct': {'type': ['number', 'null'], 'description': '% change last-7d vs prev-7d (null if insufficient data).'}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['mode'], 'properties': {'code': {'type': 'string', 'description': 'UPC (12-digit), EAN-13, or EAN-8 barcode (required for barcode mode).'}, 'mode': {'enum': ['search', 'barcode'], 'type': 'string', 'description': 'search â\x80\x94 keyword query across 3M+ products. barcode â\x80\x94 exact UPC/EAN lookup.'}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Number of results for search mode (1â\x80\x9320). Default: 10.'}, 'query': {'type': 'string', 'description': 'Product name, brand, or keyword (required for search mode).'}, 'country': {'type': 'string', 'description': "Filter search by country (e.g. 'united-states', 'france', 'japan'). Default: all countries."}, 'nutrition_grade': {'enum': ['a', 'b', 'c', 'd', 'e', 'all'], 'type': 'string', 'description': 'Filter search results by Nutri-Score grade. a=best, e=worst, all=no filter. Default: all.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string'}, 'found': {'type': 'boolean'}, 'query': {'type': 'string'}, 'source': {'type': 'string'}, 'products': {'type': 'array'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'exp': {'type': 'string', 'description': 'Filter to a specific expiration date YYYY-MM-DD. Omit to return the nearest max_expirations dates.'}, 'type': {'enum': ['call', 'put'], 'type': 'string', 'description': 'Filter by option type. Omit to return both calls and puts.'}, 'ticker': {'type': 'string', 'description': 'US equity or index ticker. Examples: AAPL, SPY, QQQ, TSLA, NVDA.'}, 'near_atm_only': {'type': 'boolean', 'description': 'If true, only return strikes within 20% of the current underlying price. Default false.'}, 'max_expirations': {'type': 'integer', 'maximum': 12, 'minimum': 1, 'description': 'Maximum number of expiration dates to include when no specific exp is set. Default 4, max 12.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'iv30': {'type': ['number', 'null'], 'description': 'Weighted average IV across ~30-DTE options (proxy for 30-day implied vol).'}, 'note': {'type': 'string'}, 'source': {'type': 'string'}, 'ticker': {'type': 'string'}, 'timestamp': {'type': 'string'}, 'underlying': {'type': 'object', 'properties': {'ask': {'type': 'number'}, 'bid': {'type': 'number'}, 'low': {'type': ['number', 'null']}, 'high': {'type': ['number', 'null']}, 'open': {'type': ['number', 'null']}, 'price': {'type': 'number'}, 'change': {'type': 'number'}, 'change_pct': {'type': 'number'}}}, 'expirations': {'type': 'array', 'items': {'type': 'object', 'properties': {'dte': {'type': 'integer', 'description': 'Days to expiration from now'}, 'exp': {'type': 'string'}, 'puts': {'type': 'array'}, 'calls': {'type': 'array'}}}}, 'total_strikes_returned': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'top_n': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Number of top unusual contracts to return per side (calls and puts). Default 5.'}, 'ticker': {'type': 'string', 'description': 'US equity or index ticker. Examples: AAPL, SPY, TSLA, NVDA, QQQ.'}, 'min_ratio': {'type': 'number', 'maximum': 50, 'minimum': 1, 'description': 'Minimum volume/OI ratio to flag as unusual. Default 5.0 (volume is 5Ã\x97 outstanding OI). Lower to 2.0 for more sensitive detection on liquid tickers.'}, 'min_volume': {'type': 'integer', 'minimum': 1, 'description': 'Minimum volume threshold to include a contract in unusual screening. Default 100 to filter noise.'}, 'days_to_exp': {'type': 'integer', 'maximum': 730, 'minimum': 1, 'description': 'Only consider options expiring within this many calendar days. Default 60 (near-term flow). Set to 365 for LEAPS sweep detection.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'iv30': {'type': ['number', 'null'], 'description': 'Weighted average IV across ~30-DTE options.'}, 'note': {'type': 'string'}, 'source': {'type': 'string'}, 'ticker': {'type': 'string'}, 'timestamp': {'type': 'string'}, 'spot_price': {'type': ['number', 'null']}, 'unusual_puts': {'type': 'array', 'description': 'Top unusual put contracts by vol/OI ratio.'}, 'unusual_calls': {'type': 'array', 'description': 'Top unusual call contracts by vol/OI ratio.'}, 'interpretation': {'enum': ['BULLISH_SWEEP', 'BEARISH_SWEEP', 'CALL_HEAVY', 'PUT_HEAVY', 'NEUTRAL'], 'type': 'string'}, 'put_call_ratio': {'type': ['number', 'null'], 'description': 'Total put volume / total call volume. >1 = put-heavy.'}, 'top_put_volume': {'type': 'array', 'description': 'Top put contracts by raw volume (largest flows).'}, 'top_call_volume': {'type': 'array', 'description': 'Top call contracts by raw volume (largest flows).'}, 'total_put_volume': {'type': 'integer'}, 'contracts_scanned': {'type': 'integer'}, 'total_call_volume': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US equity ticker symbol (e.g. AAPL, NVDA, TSLA).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'iv30': {'type': 'number', 'description': '30-day implied volatility from CBOE (annualized %)'}, 'ticker': {'type': 'string'}, 'sentiment': {'type': 'object', 'properties': {'put_oi': {'type': 'number'}, 'call_oi': {'type': 'number'}, 'put_volume': {'type': 'number'}, 'call_volume': {'type': 'number'}, 'pc_oi_ratio': {'type': 'number', 'description': 'Put/call open interest ratio'}, 'pc_volume_ratio': {'type': 'number', 'description': 'Put/call volume ratio (<1 = bullish skew)'}}}, 'data_as_of': {'type': 'string', 'description': 'CBOE delayed-data timestamp'}, 'spot_price': {'type': 'number'}, 'iv30_change': {'type': 'number', 'description': 'IV30 change from prior close'}, 'next_expiry': {'type': 'object', 'description': 'Same fields as nearest_expiry for the following expiry date.'}, 'retrieved_at': {'type': 'string'}, 'nearest_expiry': {'type': 'object', 'properties': {'expiry': {'type': 'string'}, 'atm_strike': {'type': 'number'}, 'straddle_price': {'type': 'number'}, 'expected_move_pct': {'type': 'number', 'description': 'Market-implied ±move as % of spot'}}}, 'iv30_change_pct': {'type': 'number'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'top_n': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of top calls and top puts to return (by volume). Default: 5.'}, 'ticker': {'type': 'string', 'description': 'US equity ticker symbol (e.g. AAPL, TSLA, NVDA, SPY). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'iv30': {'type': 'number', 'description': '30-day implied volatility (CBOE methodology).'}, 'ticker': {'type': 'string', 'description': 'Canonical ticker symbol.'}, 'top_puts': {'type': 'array', 'description': 'Top puts by volume (up to top_n).'}, 'top_calls': {'type': 'array', 'description': 'Top calls by volume (up to top_n).'}, 'put_volume': {'type': 'integer', 'description': 'Total put volume today.'}, 'call_volume': {'type': 'integer', 'description': 'Total call volume today.'}, 'expiry_dates': {'type': 'array', 'description': 'Next 6 expiration dates (YYYY-MM-DD).'}, 'total_volume': {'type': 'integer', 'description': 'Total options volume today.'}, 'current_price': {'type': 'number', 'description': 'Current underlying price.'}, 'data_delay_min': {'type': 'integer', 'description': 'Data delay in minutes (15 during market hours).'}, 'put_call_ratio': {'type': 'number', 'description': 'Put/call volume ratio. >1.0 = bearish skew; <1.0 = bullish skew.'}, 'unusual_volume': {'type': 'array', 'description': 'Options where volume exceeds open interest by 2Ã\x97 or more (unusual activity flags).'}, 'iv30_change_pct': {'type': 'number', 'description': 'IV30 change percentage vs prior day.'}, 'price_change_pct': {'type': 'number', 'description': 'Intraday price change percentage.'}, 'total_open_interest': {'type': 'integer', 'description': 'Total open interest across all contracts.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'Public HTTP/HTTPS URL to fetch. Redirects are followed. Max 256 KB of response read.'}, 'link_limit': {'type': 'integer', 'description': 'Maximum number of links to return (default 50, max 200).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this fetch.'}, 'url': {'type': 'string', 'description': 'Canonical URL fetched (after redirects).'}, 'links': {'type': 'array', 'description': 'Links extracted from <a href> elements.'}, 'title': {'type': ['string', 'null'], 'description': 'Page <title> text.'}, 'headings': {'type': 'array', 'description': 'H1-H3 headings found on the page, in order.'}, 'truncated': {'type': 'boolean', 'description': 'True if the page body was truncated at 256 KB before link extraction completed.'}, 'link_count': {'type': 'integer', 'description': 'Total links returned (capped at link_limit).'}, 'description': {'type': ['string', 'null'], 'description': 'Meta description content.'}, 'text_preview': {'type': ['string', 'null'], 'description': 'First 500 chars of visible page text.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'Webpage URL to extract links from (http or https).'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Max links to return (1â\x80\x93200). Default: 100.'}, 'filter': {'enum': ['all', 'external', 'internal'], 'type': 'string', 'description': 'Which links to return: all (default), external-only (different domain), or internal-only (same domain).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'url': {'type': 'string', 'description': 'Resolved URL that was fetched (after redirects).'}, 'links': {'type': 'array', 'items': {'type': 'object', 'properties': {'href': {'type': 'string', 'description': 'Absolute URL.'}, 'text': {'type': ['string', 'null'], 'description': 'Visible anchor text (HTML stripped, max 200 chars).'}, 'domain': {'type': ['string', 'null'], 'description': 'Hostname of the link target.'}, 'is_external': {'type': 'boolean', 'description': 'True if the link points to a different domain.'}}}, 'description': 'Extracted hyperlinks.'}, 'title': {'type': ['string', 'null'], 'description': 'Page <title> text.'}, 'filter': {'type': 'string', 'description': 'Filter applied: all, external, or internal.'}, 'returned': {'type': 'integer', 'description': 'Links in the links array.'}, 'total_found': {'type': 'integer', 'description': 'Total unique links found before filter/limit.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mode': {'enum': ['company', 'search'], 'type': 'string', 'description': "'company' (default when company is given): recent patents by assignee name. 'search': keyword search across all US patents."}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max patents to return (default 15, max 50).'}, 'query': {'type': 'string', 'description': "Keyword search string for mode=search (searches patent titles and abstracts). Example: 'solid state battery' or 'transformer architecture'."}, 'company': {'type': 'string', 'description': 'US stock ticker (e.g., AAPL, NVDA, MSFT) or company/assignee name for patent search. Used in mode=company.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'note': {'type': 'string'}, 'query': {'type': 'string'}, 'source': {'type': 'string'}, 'ticker': {'type': 'string'}, 'company': {'type': 'string'}, 'patents': {'type': 'array'}, 'returned': {'type': 'integer'}, 'total_found': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'name': {'type': ['string', 'null']}, 'peers': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'ticker': {'type': 'string'}, 'pe_forward': {'type': ['number', 'null']}, 'pe_trailing': {'type': ['number', 'null']}, 'ev_to_ebitda': {'type': ['number', 'null']}, 'market_cap_b': {'type': ['number', 'null']}, 'profit_margin_pct': {'type': ['number', 'null']}, 'revenue_growth_pct': {'type': ['number', 'null']}}}, 'description': 'Individual peer company metrics (up to 5).'}, 'sector': {'type': ['string', 'null']}, 'target': {'type': 'object', 'properties': {'roe_pct': {'type': ['number', 'null']}, 'pe_forward': {'type': ['number', 'null']}, 'pe_trailing': {'type': ['number', 'null']}, 'ev_to_ebitda': {'type': ['number', 'null']}, 'market_cap_b': {'type': ['number', 'null'], 'description': 'Market cap in billions.'}, 'price_to_book': {'type': ['number', 'null']}, 'price_to_sales': {'type': ['number', 'null']}, 'gross_margin_pct': {'type': ['number', 'null']}, 'profit_margin_pct': {'type': ['number', 'null']}, 'revenue_growth_pct': {'type': ['number', 'null'], 'description': 'YoY revenue growth %.'}, 'earnings_growth_pct': {'type': ['number', 'null'], 'description': 'YoY earnings growth %.'}}, 'description': 'Target stock metrics.'}, 'ticker': {'type': 'string'}, 'industry': {'type': ['string', 'null']}, 'vs_peers': {'type': 'object', 'properties': {'pe_forward_pct': {'type': ['number', 'null']}, 'pe_trailing_pct': {'type': ['number', 'null'], 'description': 'PE premium/discount vs peers (%).'}, 'ev_to_ebitda_pct': {'type': ['number', 'null']}, 'profit_margin_pct': {'type': ['number', 'null']}, 'price_to_sales_pct': {'type': ['number', 'null']}, 'revenue_growth_pct': {'type': ['number', 'null'], 'description': 'Revenue growth advantage/disadvantage vs peers (pp).'}}, 'description': 'Target premium (+) or discount (â\x80\x93) to peer median, in percentage points.'}, 'peer_count': {'type': 'number', 'description': 'Number of peers successfully fetched.'}, 'peer_median': {'type': 'object', 'properties': {'roe_pct': {'type': ['number', 'null']}, 'pe_forward': {'type': ['number', 'null']}, 'pe_trailing': {'type': ['number', 'null']}, 'ev_to_ebitda': {'type': ['number', 'null']}, 'price_to_book': {'type': ['number', 'null']}, 'price_to_sales': {'type': ['number', 'null']}, 'gross_margin_pct': {'type': ['number', 'null']}, 'profit_margin_pct': {'type': ['number', 'null']}, 'revenue_growth_pct': {'type': ['number', 'null']}, 'earnings_growth_pct': {'type': ['number', 'null']}}, 'description': 'Median value across 5 sector peers for each metric.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'msg': {'type': 'string', 'description': 'optional string to echo back'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'echo': {'type': 'string'}, 'pong': {'type': 'boolean'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'description': 'Max results (default 1, max 5). Use >1 when the query may match multiple locations.'}, 'query': {'type': 'string', 'description': "Business or place name, optionally with city/region for disambiguation. Examples: 'Starbucks Times Square New York', 'Eiffel Tower Paris', 'Golden Gate Bridge San Francisco'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'count': {'type': 'integer'}, 'results': {'type': 'array', 'description': 'Matched places with enriched metadata.'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'Direct RSS/Atom feed URL to fetch instead of searching.'}, 'query': {'type': 'string', 'description': "Podcast name/keyword to search iTunes (e.g. 'Lex Fridman', 'We Study Billionaires')."}, 'episodes': {'type': 'integer', 'description': 'Number of recent episodes to return (default 10, max 20).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'author': {'type': ['string', 'null'], 'description': 'Host or creator name.'}, 'source': {'enum': ['itunes', 'rss'], 'type': 'string'}, 'feed_url': {'type': ['string', 'null'], 'description': 'RSS feed URL.'}, 'categories': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Genre/category tags.'}, 'show_title': {'type': ['string', 'null'], 'description': 'Podcast show title.'}, 'artwork_url': {'type': ['string', 'null'], 'description': 'Cover art URL.'}, 'description': {'type': ['string', 'null'], 'description': 'Show description (500-char cap).'}, 'website_url': {'type': ['string', 'null'], 'description': 'Show website URL.'}, 'episode_count': {'type': ['integer', 'null'], 'description': 'Episodes available in feed.'}, 'latest_episodes': {'type': 'array', 'items': {'type': 'object', 'properties': {'guid': {'type': ['string', 'null']}, 'title': {'type': ['string', 'null']}, 'pub_date': {'type': ['string', 'null']}, 'audio_url': {'type': ['string', 'null']}, 'description': {'type': ['string', 'null']}, 'duration_string': {'type': ['string', 'null']}, 'duration_seconds': {'type': ['integer', 'null']}}}, 'description': 'Most recent episodes.'}}}, 'description': 'Matched podcasts (1 when url provided, up to 5 when query-searching).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['route_class'], 'properties': {'notes': {'type': 'string', 'description': "Optional freeform context â\x80\x94 scanned for unresolved vague terms (e.g. 'high quality') even in Mode A."}, 'route_class': {'type': 'string', 'description': 'One of: ENTITY, CONTRACTOR, CODE, FINANCIAL, COMPOSITE'}, 'predicate_object': {'type': 'string', 'description': 'Client-authored predicate fields per the route_class template. Omit to receive the template + an example for that route_class instead of compiling.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string'}, 'status': {'type': 'string', 'description': 'COMPILED | REFUSED | TEMPLATE'}, 'refusal': {'type': 'object'}, 'policy_hash': {'type': 'string'}, 'compile_receipt': {'type': 'object'}, 'predicate_object': {'type': 'object'}, 'valid_for_routes': {'type': 'array'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['route_class', 'job_description'], 'properties': {'client_sig': {'type': 'string', 'description': "Client's signature/attestation over the draft (any wallet-signature or nominal attestation string the two parties agree on off-chain). Required to receive anything beyond a preview draft."}, 'route_class': {'type': 'string', 'description': 'One of: ENTITY, CONTRACTOR, CODE, FINANCIAL, COMPOSITE'}, 'provider_sig': {'type': 'string', 'description': "Provider's countersignature. Omit on the first call (draft-only, unsigned). Supply on a second call with the SAME route_class + job_description + client_sig to finalize the jointly-signed policy_hash."}, 'job_description': {'type': 'string', 'description': 'Plain-language description of the job to be delivered.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string'}, 'status': {'type': 'string', 'description': 'COMPILED_UNSIGNED | COMPILED_FINALIZED | REFUSED'}, 'refusal': {'type': 'object'}, 'policy_hash': {'type': 'string'}, 'compile_receipt': {'type': 'object'}, 'predicate_object': {'type': 'object'}, 'requires_provider_countersign': {'type': 'boolean'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'text': {'type': 'string', 'description': 'Policy, regulation, or legislative text to analyze. Can be a full document, a section, or a press release summarizing a policy change. Max 100,000 chars.'}, 'title': {'type': 'string', 'description': "Optional title or name of the policy/regulation (e.g. 'EU AI Act Article 13')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'title': {'type': 'string'}, 'word_count': {'type': 'integer'}, 'change_types': {'type': 'array', 'description': 'Detected policy change categories.'}, 'generated_at': {'type': 'string'}, 'key_entities': {'type': 'array', 'description': 'Agencies, organizations, and entities mentioned.'}, 'overall_impact': {'type': 'string', 'description': "'HIGH' | 'MEDIUM' | 'LOW' â\x80\x94 based on sector spread and compliance density."}, 'effective_dates': {'type': 'array', 'description': 'Extracted compliance deadlines and effective dates.'}, 'affected_sectors': {'type': 'array', 'description': 'Sectors with impact levels (HIGH/MEDIUM/LOW).'}, 'compliance_items': {'type': 'array', 'description': 'Key sentences containing compliance obligations.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['token'], 'properties': {'token': {'type': 'string', 'description': 'Token symbol (MATIC, WETH, WBTC, USDC, USDT, LINK, AAVE, QUICK, stMATIC, USDC.e) or Polygon contract address as polygon:0x... or raw 0x...'}, 'include_change': {'type': 'boolean', 'description': 'Include 24h price change (adds ~200ms if not cached). Default: true.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'token': {'type': 'string', 'description': 'Resolved token symbol'}, 'source': {'type': 'string', 'description': 'Data source'}, 'address': {'type': 'string', 'description': 'Polygon ERC-20 contract address'}, 'network': {'type': 'string', 'description': 'Always: polygon'}, 'price_usd': {'type': 'number', 'description': 'Current spot price in USD'}, 'confidence': {'type': ['number', 'null'], 'description': 'DeFiLlama on-chain confidence score (0â\x80\x931; >0.9 = high)'}, 'staleness_ms': {'type': 'number', 'description': 'Age of cached price in ms (<10 000 = fresh)'}, 'timestamp_ms': {'type': 'number', 'description': 'Epoch ms when data was fetched'}, 'change_24h_pct': {'type': ['number', 'null'], 'description': '24-hour price change % (null if unavailable)'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'category': {'enum': ['crypto', 'politics', 'sports', 'macro', 'equities', 'ai', 'other'], 'type': 'string', 'description': 'Restrict analysis to one category. Omit for all categories.'}, 'days_back': {'type': 'integer', 'maximum': 90, 'minimum': 1, 'description': 'Lookback window in days for resolved markets (1â\x80\x9390, default 30).'}, 'min_volume': {'type': 'number', 'minimum': 0, 'description': 'Minimum market trading volume in USDC to include (default 0). Use 1000 to focus on liquid markets.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'brier_score': {'type': 'number', 'description': 'Mean Brier score. 0.00=perfect, 0.25=random, 1.00=systematically wrong.'}, 'data_source': {'type': 'string'}, 'period_days': {'type': 'integer'}, 'generated_at': {'type': 'string'}, 'interpretation': {'type': 'string'}, 'sample_markets': {'type': 'array'}, 'markets_analyzed': {'type': 'integer'}, 'category_breakdown': {'type': 'array'}, 'overall_accuracy_pct': {'type': 'number', 'description': '% of markets where crowd majority prediction was correct.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'category': {'enum': ['crypto', 'politics', 'sports', 'ai', 'macro', 'equities', 'other'], 'type': 'string', 'description': 'Filter to a single category. Omit to return all categories ranked by volume.'}, 'min_liquidity': {'type': 'number', 'minimum': 0, 'description': 'Only include markets with at least this much liquidity (USD). Default: 1000.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'note': {'type': 'string'}, 'source': {'type': 'string'}, 'summary': {'type': 'object', 'description': 'Aggregate totals and top category.'}, 'timestamp': {'type': 'string'}, 'categories': {'type': 'array', 'description': 'Categories ranked by 7-day volume.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'asset': {'type': 'string', 'description': 'Asset symbol to filter (btc, eth, sol, xrp, doge, bnb, ada, avax, link, dot). Omit for all active crypto markets.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max markets to return (1â\x80\x9350). Default: 20.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'markets': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'end_date': {'type': 'string'}, 'question': {'type': 'string'}, 'liquidity': {'type': 'number'}, 'volume_24h': {'type': 'number'}, 'volume_total': {'type': 'number'}, 'no_probability': {'type': 'number'}, 'yes_probability': {'type': 'number', 'description': 'Current Yes price (0â\x80\x931)'}}}}, 'fetched_at': {'type': 'string'}, 'total_volume_24h': {'type': 'number'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': "Topic keyword to search (e.g. 'bitcoin', 'trump', 'recession', 'fed rate'). Omit for top markets by volume."}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Number of markets to return (1â\x80\x9325). Default: 10.'}, 'period': {'enum': ['24h', '1wk', '1mo'], 'type': 'string', 'description': 'Volume period used for ranking (default: 24h).'}, 'min_liquidity': {'type': 'number', 'description': 'Filter out markets with liquidity below this USD threshold (default: 500).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'markets': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Polymarket market URL'}, 'spread': {'type': 'number', 'description': 'Bid-ask spread (lower = tighter market)'}, 'end_date': {'type': 'string', 'description': 'Resolution date ISO-8601'}, 'question': {'type': 'string'}, 'liquidity': {'type': 'number', 'description': 'Total liquidity in USD'}, 'volume_24h': {'type': 'number', 'description': 'USD volume in last 24h'}, 'volume_total': {'type': 'number'}, 'no_probability': {'type': 'number'}, 'price_change_1d': {'type': 'number', 'description': 'Yes-price change in last 24h (positive = bullish)'}, 'yes_probability': {'type': 'number', 'description': 'Current Yes price (0â\x80\x931 = 0â\x80\x93100%)'}, 'last_trade_price': {'type': 'number'}, 'price_change_1wk': {'type': 'number', 'description': 'Yes-price change in last 7 days'}}}}, 'fetched_at': {'type': 'string'}, 'total_volume_24h': {'type': 'number', 'description': 'Sum of 24h volume across returned markets'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Max markets to return (1â\x80\x9320, default 10).'}, 'window': {'enum': ['1d', '1w', '1m'], 'type': 'string', 'description': "Time window for price change ranking: '1d' (24h), '1w' (7-day, default), '1m' (30-day)."}, 'direction': {'enum': ['all', 'up', 'down'], 'type': 'string', 'description': "Filter by direction of shift: 'up' (probability rising), 'down' (falling), or 'all' (default)."}, 'min_volume': {'type': 'number', 'description': 'Minimum total USDC trading volume. Default 10000. Higher = more liquid markets.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'markets': {'type': 'array', 'items': {'type': 'object', 'properties': {'end_date': {'type': 'string', 'description': 'ISO-8601 market resolution date.'}, 'question': {'type': 'string', 'description': 'The prediction market question.'}, 'direction': {'type': 'string', 'description': "'up', 'down', or 'flat'."}, 'market_url': {'type': 'string', 'description': 'Direct Polymarket link.'}, 'volume_24hr': {'type': 'number', 'description': '24-hour USDC volume.'}, 'volume_usdc': {'type': 'number', 'description': 'Total USDC trading volume.'}, 'price_change': {'type': 'number', 'description': 'Probability shift over the requested window (positive = rising).'}, 'price_change_1m': {'type': 'number', 'description': '1-month probability change.'}, 'price_change_1w': {'type': 'number', 'description': '1-week probability change.'}, 'current_probability': {'type': 'number', 'description': 'Current YES probability (0â\x80\x931) from last trade.'}}}}, 'window_used': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'total_returned': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'side': {'enum': ['BUY', 'SELL'], 'type': 'string', 'description': 'Filter by trade direction: BUY (taking YES/NO position) or SELL (closing/shorting). Omit for both.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum whale trades to return (1â\x80\x9350). Default: 10.'}, 'market': {'type': 'string', 'description': "Keyword filter on market title (case-insensitive). E.g. 'bitcoin', 'election', 'fed rate'."}, 'min_usdc': {'type': 'number', 'maximum': 100000, 'minimum': 10, 'description': 'Minimum USDC value per trade (size Ã\x97 price). Default: 500.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'trades': {'type': 'array', 'items': {'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'Trade timestamp ISO-8601.'}, 'side': {'type': 'string', 'description': 'BUY (entering position) or SELL (exiting/shorting).'}, 'size': {'type': 'number', 'description': 'Position size in outcome tokens.'}, 'price': {'type': 'number', 'description': 'Entry price (0â\x80\x931 range, where 1.0 = 100% probability).'}, 'wallet': {'type': 'string', 'description': "Trader's Polymarket proxy wallet address."}, 'outcome': {'type': 'string', 'description': 'YES or NO outcome being traded.'}, 'tx_hash': {'type': ['string', 'null'], 'description': 'On-chain transaction hash (Base/Polygon).'}, 'pseudonym': {'type': ['string', 'null'], 'description': "Trader's display name if set."}, 'market_url': {'type': 'string', 'description': 'Polymarket URL for the market.'}, 'usdc_value': {'type': 'number', 'description': 'Approx USDC spent/received (size Ã\x97 price). BUY = cost, SELL = proceeds.'}, 'market_title': {'type': 'string', 'description': 'Full market question.'}}}}, 'fetched_at': {'type': 'string'}, 'total_found': {'type': 'integer', 'description': 'Total whale trades found before limit applied.'}, 'pool_scanned': {'type': 'integer', 'description': 'Number of recent trades scanned.'}, 'min_usdc_threshold': {'type': 'number', 'description': 'Minimum USDC threshold used.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'targets': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Target allocation percentages. Must sum to 100.'}, 'holdings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Current portfolio positions.'}, 'cash_injection': {'type': 'number', 'description': 'Optional additional cash (USD) to deploy during rebalancing (positive = buying, negative = withdrawing).'}, 'drift_threshold_pct': {'type': 'number', 'description': "Minimum drift percentage before an asset is flagged as needing rebalance (default 1.0). Positions within threshold are marked 'in_range'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'orders': {'type': 'array', 'description': 'Buy/sell orders to reach target weights.'}, 'summary': {'type': 'object'}, 'generated_at': {'type': 'string'}, 'total_portfolio_value': {'type': 'number'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'focus': {'type': 'string', 'description': "Optional analytical focus for the portfolio synthesis (e.g. 'AI exposure', 'earnings risk', 'macro sensitivity', 'dividend yield'). Narrows the intelligence lens."}, 'tickers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 5 US equity ticker symbols (e.g. ["AAPL","NVDA","MSFT"]). NYSE/NASDAQ symbols. Case-insensitive.'}, 'portfolio_name': {'type': 'string', 'description': "Optional label for this portfolio (e.g. 'Tech growth basket', 'Mag7 watchlist'). Included in the response for reference."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'focus': {'type': 'string'}, 'tickers': {'type': 'array', 'description': 'Live price data per ticker.'}, 'key_themes': {'type': 'array', 'items': {'type': 'string'}}, 'portfolio_name': {'type': 'string', 'description': 'Portfolio label if provided.'}, 'risk_assessment': {'type': 'string'}, 'sector_exposure': {'type': 'object'}, 'sources_queried': {'type': 'integer'}, 'standout_ticker': {'type': 'string'}, 'correlation_note': {'type': 'string'}, 'portfolio_summary': {'type': 'string', 'description': '2-3 sentence executive portfolio overview.'}, 'sources_responded': {'type': 'integer'}, 'investment_outlook': {'type': 'string', 'description': 'positive | cautious | bearish | neutral | mixed'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Max markets to return (1â\x80\x9325, default 10).'}, 'query': {'type': 'string', 'description': "Optional keyword filter. Returns only markets whose question contains this string (case-insensitive). E.g. 'bitcoin', 'election', 'fed rate'."}, 'min_volume': {'type': 'number', 'description': 'Minimum USDC trading volume to include (default 1000). Higher = more liquid and reliable signal.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'markets': {'type': 'array', 'items': {'type': 'object', 'properties': {'active': {'type': 'boolean'}, 'end_date': {'type': 'string', 'description': 'ISO-8601 resolution date.'}, 'outcomes': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'probability': {'type': 'number', 'description': 'Implied probability 0â\x80\x931 from last trade price.'}}}}, 'question': {'type': 'string', 'description': 'The prediction market question.'}, 'volume_usdc': {'type': 'number', 'description': 'Total USDC trading volume.'}, 'liquidity_usdc': {'type': 'number', 'description': 'Current USDC liquidity in the pool.'}}}}, 'generated_at': {'type': 'string'}, 'total_returned': {'type': 'integer'}, 'filters_applied': {'type': 'object'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'query': {'type': 'string', 'description': "Optional keyword to filter prediction markets (e.g. 'btc', 'eth', 'rate cut'). If omitted returns top 5 markets by volume."}, 'ticker': {'type': 'string', 'description': 'US stock ticker (e.g. AMD, NVDA, SPY). Case-insensitive.'}, 'market_limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of prediction markets to return (1â\x80\x9310, default 5).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'stock': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'ticker': {'type': 'string'}, 'volume': {'type': 'integer'}, 'day_low': {'type': 'number'}, 'day_high': {'type': 'number'}, 'exchange': {'type': 'string'}, 'price_usd': {'type': 'number'}, 'change_pct': {'type': 'number'}, 'change_usd': {'type': 'number'}, 'market_time': {'type': 'string'}}, 'description': 'Live equity price and intraday metrics for the requested ticker.'}, 'seam_note': {'type': 'string', 'description': 'Confirms this endpoint collapsed a two-call chain into one.'}, 'generated_at': {'type': 'string', 'description': 'ISO-8601 timestamp.'}, 'prediction_markets': {'type': 'array', 'items': {'type': 'object', 'properties': {'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'volume': {'type': 'string'}, 'no_price': {'type': 'number', 'description': 'Implied No probability (0â\x80\x931).'}, 'yes_price': {'type': 'number', 'description': 'Implied Yes probability (0â\x80\x931).'}, 'expiration': {'type': 'string'}}}, 'description': 'Active prediction markets from Limitless Exchange.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': "US stock ticker symbol (e.g. 'AAPL', 'NVDA', 'TSLA')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'ticker': {'type': 'string'}, 'week52_low': {'type': ['number', 'null']}, 'week52_high': {'type': ['number', 'null']}, 'company_name': {'type': ['string', 'null']}, 'current_price': {'type': ['number', 'null'], 'description': 'Current stock price (USD).'}, 'next_earnings': {'type': 'object', 'properties': {'date_iso': {'type': ['string', 'null'], 'description': 'Earnings date as YYYY-MM-DD.'}, 'date_unix': {'type': ['number', 'null'], 'description': 'Earnings date as Unix timestamp.'}, 'days_until': {'type': ['number', 'null'], 'description': 'Calendar days until earnings.'}, 'eps_estimate': {'type': ['number', 'null'], 'description': 'Consensus EPS estimate (USD).'}, 'revenue_estimate': {'type': ['number', 'null'], 'description': 'Consensus revenue estimate (USD).'}}, 'description': 'Upcoming earnings event.'}, 'short_interest': {'type': 'object', 'properties': {'short_ratio': {'type': ['number', 'null'], 'description': 'Days to cover (shares short ÷ avg daily volume).'}, 'short_pct_float': {'type': ['number', 'null'], 'description': 'Short interest as % of float.'}}}, 'analyst_consensus': {'type': 'object', 'properties': {'buy': {'type': ['integer', 'null']}, 'hold': {'type': ['integer', 'null']}, 'sell': {'type': ['integer', 'null']}, 'buy_pct': {'type': ['number', 'null']}, 'low_target': {'type': ['number', 'null']}, 'upside_pct': {'type': ['number', 'null'], 'description': 'Upside to mean target from current price (%).'}, 'high_target': {'type': ['number', 'null']}, 'mean_target': {'type': ['number', 'null'], 'description': 'Mean price target (USD).'}, 'total_analysts': {'type': ['integer', 'null']}}}, 'week52_position_pct': {'type': ['number', 'null'], 'description': 'Where current price sits in the 52-week range (0â\x80\x93100%).'}, 'earnings_track_record': {'type': 'object', 'properties': {'beats': {'type': ['integer', 'null'], 'description': 'Number of beats in last 4 quarters.'}, 'history': {'type': 'array', 'items': {'type': 'object', 'properties': {'beat': {'type': ['boolean', 'null']}, 'period': {'type': ['string', 'null'], 'description': "Quarter label (e.g. '-1q', '-2q')."}, 'actual_eps': {'type': ['number', 'null']}, 'estimate_eps': {'type': ['number', 'null']}, 'surprise_pct': {'type': ['number', 'null'], 'description': 'Earnings surprise % (positive = beat).'}}}}, 'avg_surprise_pct': {'type': ['number', 'null'], 'description': 'Average earnings surprise % across last 4 quarters.'}, 'consecutive_beats': {'type': ['integer', 'null'], 'description': 'Current streak of consecutive beats (from most recent quarter back).'}}, 'description': 'Last 4 reported quarters.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'name': {'type': 'string'}, 'notes': {'type': 'array', 'items': {'type': 'string'}}, 'ticker': {'type': 'string'}, 'consensus': {'type': 'object', 'properties': {'analyst_count': {'type': 'integer', 'description': 'Number of analysts covering this stock.'}, 'recommendation': {'type': 'string', 'description': 'Text label from Yahoo: strongBuy | buy | hold | underperform | sell.'}, 'target_low_usd': {'type': 'number', 'description': 'Lowest analyst price target.'}, 'target_high_usd': {'type': 'number', 'description': 'Highest analyst price target.'}, 'target_mean_usd': {'type': 'number', 'description': 'Mean analyst 12-month price target.'}, 'target_median_usd': {'type': 'number', 'description': 'Median analyst 12-month price target.'}, 'implied_upside_pct': {'type': 'number', 'description': 'Implied upside from current price to mean target in %.'}, 'recommendation_mean': {'type': 'number', 'description': 'Mean recommendation score (1=strong buy, 5=sell).'}}}, 'current_price_usd': {'type': 'number'}, 'valuation_context': {'type': 'object', 'properties': {'pe_forward': {'type': 'number'}, 'pe_trailing': {'type': 'number'}, 'ev_to_ebitda': {'type': 'number'}, 'price_to_book': {'type': 'number'}, 'market_cap_usd': {'type': 'number'}}, 'description': 'Key valuation multiples for context alongside the price target.'}, 'rating_distribution': {'type': 'object', 'properties': {'buy': {'type': 'integer'}, 'hold': {'type': 'integer'}, 'sell': {'type': 'integer'}, 'total': {'type': 'integer'}, 'strong_buy': {'type': 'integer'}, 'pct_bullish': {'type': 'number', 'description': '% of analysts with buy or strong buy rating.'}, 'underperform': {'type': 'integer'}}, 'description': 'Analyst rating breakdown.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'description': 'Number of protocols to return. Default 20, max 100.'}, 'sort_by': {'enum': ['daily_fees', '7d_fees', '30d_fees', '1d_change'], 'type': 'string', 'description': "Ranking metric. 'daily_fees' = 24h fees (default). '7d_fees' = 7-day total. '30d_fees' = 30-day total. '1d_change' = biggest 1-day fee growth (%)."}, 'category': {'type': 'string', 'description': "Filter by protocol category (e.g. 'Dexes', 'Lending', 'Derivatives', 'CDP', 'Liquid Staking', 'Bridge'). Case-insensitive partial match."}, 'min_daily_fees': {'type': 'number', 'description': 'Minimum 24h fees in USD to include a protocol (e.g. 10000 for $10K+). Filters out noise.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'leaders': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'rank': {'type': 'integer'}, 'slug': {'type': 'string'}, 'chains': {'type': 'array', 'items': {'type': 'string'}}, 'category': {'type': 'string'}, 'fees_7d_usd': {'type': 'number'}, 'fees_30d_usd': {'type': 'number'}, 'change_1d_pct': {'type': 'number'}, 'change_7d_pct': {'type': 'number'}, 'daily_fees_usd': {'type': 'number'}}}}, 'ranked_by': {'type': 'string'}, 'timestamp': {'type': 'string'}, 'total_protocols': {'type': 'integer'}, 'category_summary': {'type': 'array', 'items': {'type': 'object', 'properties': {'category': {'type': 'string'}, 'daily_fees_usd': {'type': 'number'}, 'protocol_count': {'type': 'integer'}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['mode'], 'properties': {'mode': {'enum': ['search', 'article'], 'type': 'string', 'description': 'search: find papers by query | article: full details for a specific PMID'}, 'pmid': {'type': 'string', 'description': "PubMed ID for article mode. Example: '38650234' or 38650234."}, 'limit': {'type': 'number', 'description': 'Max results to return in search mode. Default 10, max 50.'}, 'query': {'type': 'string', 'description': "Search query for search mode. Supports PubMed syntax: e.g. 'CRISPR cancer[Title]', 'Alzheimer treatment', 'COVID-19 mRNA vaccine efficacy'."}, 'year_end': {'type': 'number', 'description': 'Filter search results to this year or earlier. Example: 2024.'}, 'year_start': {'type': 'number', 'description': 'Filter search results to this year or later. Example: 2020.'}, 'article_type': {'enum': ['journal_article', 'clinical_trial', 'review', 'meta_analysis', 'case_report', 'systematic_review', 'randomized_trial'], 'type': 'string', 'description': 'Filter by article type. clinical_trial: FDA-registered trials. review: narrative reviews. meta_analysis: quantitative evidence synthesis. systematic_review: PRISMA-style. randomized_trial: RCTs.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'doi': {'type': 'string'}, 'pmid': {'type': 'string'}, 'query': {'type': 'string'}, 'title': {'type': 'string'}, 'pmc_id': {'type': 'string'}, 'source': {'type': 'string'}, 'authors': {'type': 'array'}, 'journal': {'type': 'string'}, 'abstract': {'type': 'string'}, 'articles': {'type': 'array'}, 'keywords': {'type': 'array'}, 'pub_date': {'type': 'string'}, 'returned': {'type': 'integer'}, 'mesh_terms': {'type': 'array'}, 'pubmed_url': {'type': 'string'}, 'total_found': {'type': 'integer'}, 'full_text_url': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'description': 'Max versions to return in version_history (default 20, max 50).'}, 'action': {'enum': ['package_info', 'download_stats', 'version_history', 'compare'], 'type': 'string', 'description': "Action to perform. 'package_info': full metadata for one package (license, deps, dev status, vulnerabilities). 'download_stats': last day/week/month pip download counts. 'version_history': all published versions with release dates, newest first. 'compare': package_info + download_stats for 2â\x80\x934 packages side-by-side. Default: 'package_info'."}, 'package': {'type': 'string', 'description': "PyPI package name (case-insensitive). Required for package_info, download_stats, and version_history. Examples: 'requests', 'numpy', 'langchain', 'fastapi', 'pydantic'."}, 'packages': {'type': 'array', 'items': {'type': 'string'}, 'description': "List of 2â\x80\x934 package names for the 'compare' action. Example: ['aiohttp', 'httpx', 'requests'] to compare HTTP client libraries."}, 'include_downloads': {'type': 'boolean', 'description': "Whether to include download stats in 'compare' action (default true). Set false to skip the pypistats.org call and get faster metadata-only comparison."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Canonical PyPI package name.'}, 'action': {'type': 'string', 'description': 'Action that was performed.'}, 'author': {'type': ['string', 'null'], 'description': 'Package author or maintainer name.'}, 'license': {'type': ['string', 'null'], 'description': "SPDX license identifier (e.g. 'MIT', 'Apache-2.0')."}, 'summary': {'type': 'string', 'description': 'One-sentence package description.'}, 'version': {'type': 'string', 'description': 'Latest published version.'}, 'last_day': {'type': ['number', 'null'], 'description': 'Downloads in last 24 hours.'}, 'pypi_url': {'type': 'string', 'description': 'Direct link to PyPI package page.'}, 'versions': {'type': 'array', 'items': {'type': 'object', 'properties': {'version': {'type': 'string'}, 'released': {'type': 'string'}}}, 'description': 'Paginated version list for version_history action.'}, 'last_week': {'type': ['number', 'null'], 'description': 'Downloads in last 7 days.'}, 'comparison': {'type': 'array', 'description': 'Per-package results for compare action.'}, 'dev_status': {'type': ['string', 'null'], 'description': "PyPI development status (e.g. '5 - Production/Stable', '4 - Beta')."}, 'last_month': {'type': ['number', 'null'], 'description': 'Downloads in last 30 days.'}, 'dependencies': {'type': 'array', 'description': 'Direct dependencies (requires_dist, optional deps excluded), up to 20.'}, 'project_urls': {'type': 'object', 'description': 'Project URLs: Documentation, Source, Changelog, etc.'}, 'total_releases': {'type': 'number', 'description': 'Total number of published versions.'}, 'python_versions': {'type': 'array', 'description': 'Supported Python versions from classifiers.'}, 'recent_versions': {'type': 'array', 'items': {'type': 'object', 'properties': {'version': {'type': 'string'}, 'released': {'type': 'string', 'description': 'Release date YYYY-MM-DD.'}}}, 'description': '5 most recently published versions with release dates.'}, 'requires_python': {'type': ['string', 'null'], 'description': "Python version constraint (e.g. '>=3.8')."}, 'vulnerabilities': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'details': {'type': 'string'}, 'fixed_in': {'type': 'array'}}}, 'description': 'Known security vulnerabilities from PyPI advisory database.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'package': {'type': 'string', 'description': "PyPI package name (e.g. 'requests', 'numpy', 'anthropic', 'langchain'). Case-insensitive."}, 'version': {'type': 'string', 'description': "Specific version to look up (e.g. '2.31.0'). If omitted, returns the latest stable release."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'name': {'type': 'string'}, 'author': {'type': ['string', 'null']}, 'license': {'type': ['string', 'null']}, 'summary': {'type': ['string', 'null']}, 'version': {'type': 'string'}, 'keywords': {'type': ['string', 'null']}, 'pypi_url': {'type': 'string'}, 'home_page': {'type': ['string', 'null']}, 'classifiers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'PyPI classifiers (Development Status, License, etc.).'}, 'project_url': {'type': ['string', 'null'], 'description': 'Primary project URL (GitHub, docs, etc.).'}, 'all_versions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'All known release version numbers (latest first).'}, 'author_email': {'type': ['string', 'null']}, 'latest_upload': {'type': ['string', 'null'], 'description': 'ISO-8601 upload date of this release.'}, 'requires_dist': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Direct dependencies (pip-style specifiers).'}, 'requires_python': {'type': ['string', 'null'], 'description': "Python version constraint (e.g. '>=3.10')."}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'Public HTTP/HTTPS URL to extract readable content from. Redirects are followed.'}, 'no_cache': {'type': 'boolean', 'description': "If true, forces a fresh fetch bypassing Jina's cache (default false)."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this extraction.'}, 'url': {'type': 'string', 'description': 'Canonical URL as reported by the reader.'}, 'body': {'type': 'string', 'description': 'Full readable content as Markdown. Stripped of nav, ads, footer, and boilerplate.'}, 'title': {'type': ['string', 'null'], 'description': 'Page/article title extracted by the reader.'}, 'published': {'type': ['string', 'null'], 'description': 'Published date/time string if detected in page metadata.'}, 'truncated': {'type': 'boolean', 'description': 'True if response exceeded 128 KB and was cut. Rare for standard articles.'}, 'char_count': {'type': 'integer', 'description': 'Character count of the body text.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Search query. Supports quoted phrases (e.g. "AI agents") and boolean operators.'}, 'mode': {'enum': ['posts', 'comments', 'both'], 'type': 'string', 'description': "What to search: 'posts' (default), 'comments', or 'both'."}, 'sort': {'enum': ['score', 'created_utc', 'num_comments'], 'type': 'string', 'description': 'Sort field. Default: score.'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Max results per mode (1â\x80\x9325). Default: 10.'}, 'subreddit': {'type': 'string', 'description': "Restrict search to this subreddit (omit 'r/' prefix). Omit for all subreddits."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'query': {'type': 'string'}, 'total': {'type': 'integer'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': ['string', 'null']}, 'body': {'type': ['string', 'null']}, 'type': {'type': 'string', 'description': 'post or comment'}, 'score': {'type': 'integer'}, 'title': {'type': ['string', 'null']}, 'author': {'type': 'string'}, 'comments': {'type': ['integer', 'null']}, 'permalink': {'type': ['string', 'null']}, 'subreddit': {'type': 'string'}, 'created_utc': {'type': ['string', 'null']}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'flags': {'type': 'string', 'description': "Regex flags: g (global), i (case-insensitive), m (multiline), s (dotAll), u (unicode). Default: 'g'."}, 'input': {'type': 'string', 'description': 'Text to test the pattern against. Max 50,000 chars.'}, 'pattern': {'type': 'string', 'description': "Regular expression pattern (without delimiters). Example: '(\\\\d{3})-?(\\\\d{4})'"}, 'replace_with': {'type': 'string', 'description': 'Optional replacement string. Uses $1, $2, etc. for capture groups. When provided, returns replaced output.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'matches': {'type': 'array', 'description': 'Up to 100 matches with index and capture groups.'}, 'match_count': {'type': 'integer'}, 'generated_at': {'type': 'string'}, 'pattern_valid': {'type': 'boolean'}, 'replaced_output': {'type': 'string', 'description': 'Result of replace operation (when replace_with is provided).'}, 'has_more_matches': {'type': 'boolean'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'focus': {'type': 'string', 'description': "Optional analytical focus direction (e.g. 'risks and challenges', 'market adoption', 'technical implementation'). Narrows the synthesis lens."}, 'query': {'type': 'string', 'description': "Research topic or question. Works across any domain: financial markets ('Fed rate policy impact on equities'), technology ('AI agent protocols 2025'), science ('CRISPR therapeutic applications'), geopolitics, and more. Omit for a default AI agents & autonomous systems report."}, 'schedule': {'type': 'string', 'description': "When to run this research recurringly. Accepts: named shortcuts (@hourly, @daily, @weekly, @monthly), natural language ('every 4 hours', 'daily', 'every 30 minutes'), or a raw cron expression (e.g. '0 8 * * 1'). Omit to get an AI-recommended cadence for your topic."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'focus': {'type': ['string', 'null']}, 'query': {'type': 'string'}, 'trends': {'type': 'array', 'items': {'type': 'string'}}, 'summary': {'type': 'string'}, 'sentiment': {'type': 'string'}, 'key_findings': {'type': 'array', 'items': {'type': 'string'}}, 'schedule_fit': {'type': 'string', 'description': 'Assessment of the provided schedule (or confirmation of recommendation).'}, 'cron_schedule': {'type': ['object', 'null'], 'description': 'Resolved cron schedule (if provided). null if none given.'}, 'recommendations': {'type': 'array', 'items': {'type': 'string'}}, 'sources_queried': {'type': 'integer'}, 'synthesis_error': {'type': 'string'}, 'automation_notes': {'type': 'string', 'description': 'Guidance for running this research unattended.'}, 'freshness_window': {'type': 'string', 'description': 'How long before this research goes stale.'}, 'recommended_cron': {'type': 'string', 'description': 'AI-recommended cron expression for recurring runs.'}, 'source_breakdown': {'type': 'object'}, 'sources_responded': {'type': 'integer'}, 'recommended_cadence': {'type': 'string', 'description': 'Plain-English cadence recommendation with rationale.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'sort': {'enum': ['relevant', 'cited', 'recent'], 'type': 'string', 'description': 'Sort order. relevant = OpenAlex relevance score; cited = most-cited first; recent = newest first. Default: relevant.'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of papers to return (1â\x80\x9310). Default: 5.'}, 'query': {'type': 'string', 'description': "Search query. Natural-language or keyword (e.g. 'transformer attention mechanism', 'CRISPR gene editing cancer', 'bitcoin game theory')."}, 'min_year': {'type': 'integer', 'maximum': 9999, 'minimum': 1, 'description': 'Only return papers published this year or later (e.g. 2020). Optional.'}, 'open_access_only': {'type': 'boolean', 'description': 'If true, request works with free-to-read full text. An OA URL may be a landing page, not a PDF; this is not a reuse license. Default: false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'query': {'type': 'string'}, 'papers': {'type': 'array', 'items': {'type': 'object', 'properties': {'doi': {'type': ['string', 'null']}, 'year': {'type': ['integer', 'null']}, 'title': {'type': ['string', 'null']}, 'oa_url': {'type': ['string', 'null'], 'description': 'Reported free-to-read HTTP(S) link (PDF or landing page), not fetched or license-verified.'}, 'authors': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 5 author display names.'}, 'abstract': {'type': ['string', 'null'], 'description': 'Up to 500 abstract characters from a bounded valid index; null for missing, malformed or over-limit data. Reuse rights are not established here.'}, 'open_access': {'type': ['boolean', 'null']}, 'primary_topic': {'type': ['string', 'null'], 'description': 'OpenAlex primary research topic.'}, 'cited_by_count': {'type': ['integer', 'null']}}}}, 'generated_at': {'type': 'string'}, 'total_in_index': {'type': ['integer', 'null'], 'description': 'Upstream total matching works, or null if missing/invalid; not the returned page length.'}, 'recommended_next': {'type': 'object', 'properties': {'when': {'type': 'string'}, 'endpoint': {'type': 'string'}, 'capability': {'type': 'string'}, 'price_usdc': {'type': 'string'}, 'suggested_input': {'type': 'object'}}, 'description': 'Upgrade path to research-synthesis ($0.20) for cross-source synthesis of these results.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'focus': {'type': 'string', 'description': "Optional focus direction for synthesis (e.g. 'technical implementation details', 'market adoption', 'risks and challenges'). Narrows the analytical lens."}, 'query': {'type': 'string', 'description': "Research query or topic â\x80\x94 works across any domain: financial markets (e.g. 'S&P 500 earnings outlook Q3 2026'), macroeconomics ('Fed rate policy impact on equities'), technology ('AI agent protocols 2025'), and more. Omit for default AI agents report."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'focus': {'type': ['string', 'null']}, 'query': {'type': 'string'}, 'trends': {'type': 'array', 'items': {'type': 'string'}}, 'summary': {'type': 'string'}, 'sentiment': {'type': 'string'}, 'generated_at': {'type': 'string', 'description': 'ISO-8601 timestamp of when this report was synthesized (report is fetched live, never cached).'}, 'key_findings': {'type': 'array', 'items': {'type': 'string'}}, 'recommendations': {'type': 'array', 'items': {'type': 'string'}}, 'sources_queried': {'type': 'integer'}, 'source_breakdown': {'type': 'object'}, 'sources_responded': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 160-200 word narrative (default). 'concise' = 110-130 word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'etfs': {'type': 'object', 'properties': {'xly_disc': {'type': 'object'}, 'xrt_retail': {'type': 'object'}, 'xlp_staples': {'type': 'object'}}, 'description': 'Retail and consumer sector ETF performance.'}, 'derived': {'type': 'object', 'properties': {'retail_alpha': {'type': 'string', 'description': 'outperforming | in_line | underperforming'}, 'risk_appetite': {'type': 'string', 'description': 'risk_on | neutral | defensive'}, 'xly_xlp_spread': {'type': 'number', 'description': 'Discretionary minus staples daily % (risk appetite proxy)'}, 'xrt_vs_spy_alpha': {'type': 'number', 'description': 'XRT minus SPY daily % (retail alpha)'}, 'ecomm_vs_physical': {'type': 'number', 'description': 'AMZN minus TGT daily % (online vs in-store)'}, 'retailer_composite': {'type': 'number', 'description': 'Avg daily % of AMZN+WMT+TGT+COST+HD'}, 'home_improvement_avg': {'type': 'number', 'description': 'Avg daily % of HD+LOW (housing-linked)'}}, 'description': 'Composite heuristic signals.'}, 'key_risk': {'type': 'string', 'description': 'Biggest risk to retail sector outlook.'}, 'narrative': {'type': 'string', 'description': 'Full synthesis narrative.'}, 'retailers': {'type': 'object', 'properties': {'low_lowes': {'type': 'object'}, 'tgt_target': {'type': 'object'}, 'amzn_amazon': {'type': 'object'}, 'cost_costco': {'type': 'object'}, 'wmt_walmart': {'type': 'object'}, 'hd_home_depot': {'type': 'object'}}, 'description': 'Major retailer stock performance.'}, 'situation': {'type': 'string', 'description': 'One-sentence retail sector summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'generated_at': {'type': 'string'}, 'retail_regime': {'type': 'string', 'description': 'EXPANDING | OUTPERFORMING | STABLE | UNDERPERFORMING | CONTRACTING'}, 'dominant_driver': {'type': 'string', 'description': 'Primary driver of retail performance.'}, 'agent_implication': {'type': 'string', 'description': 'Concrete relevance for AI agents tracking retail/consumer.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, MSFT, NVDA). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'grade': {'type': 'string', 'description': 'Revenue growth quality: A / B / C / D / F.'}, 'ticker': {'type': 'string'}, 'cagr_1y': {'type': ['number', 'null'], 'description': '1-year revenue CAGR (decimal).'}, 'cagr_3y': {'type': ['number', 'null'], 'description': '3-year revenue CAGR (decimal).'}, 'cagr_5y': {'type': ['number', 'null'], 'description': '5-year revenue CAGR (decimal).'}, 'periods': {'type': 'integer', 'description': 'Number of annual periods available.'}, 'acceleration': {'type': 'object', 'properties': {'label': {'type': 'string', 'description': 'ACCELERATING | STABLE | DECELERATING'}, 'cagr_2y': {'type': ['number', 'null'], 'description': '2-year CAGR (recent momentum).'}, 'delta_vs_longrun': {'type': ['number', 'null'], 'description': '2yr CAGR minus long-run CAGR. Positive = accelerating.'}}}, 'margin_trend': {'type': ['string', 'null'], 'description': 'Gross margin 5-year direction: EXPANDING | STABLE | CONTRACTING'}, 'retrieved_at': {'type': 'string'}, 'annual_series': {'type': 'array', 'items': {'type': 'object', 'properties': {'fiscal_year': {'type': 'string'}, 'gross_profit': {'type': ['number', 'null']}, 'op_margin_pct': {'type': ['number', 'null']}, 'total_revenue': {'type': ['number', 'null']}, 'yoy_growth_pct': {'type': ['number', 'null']}, 'gross_margin_pct': {'type': ['number', 'null']}, 'operating_income': {'type': ['number', 'null']}}}, 'description': 'Year-by-year revenue and margin data, oldest to most recent.'}, 'latest_revenue': {'type': ['number', 'null'], 'description': 'Most recent full-year revenue ($).'}, 'composite_score': {'type': 'integer', 'description': 'Raw score 0â\x80\x93100 underlying the letter grade.'}, 'yoy_growth_rates': {'type': 'array', 'items': {'type': ['number', 'null']}, 'description': 'Year-over-year revenue growth rates, oldest to most recent (decimal).'}, 'growth_consistency': {'type': 'object', 'properties': {'label': {'type': 'string', 'description': 'HIGHLY_CONSISTENT | MODERATE | VOLATILE | INSUFFICIENT_DATA'}, 'coefficient_of_variation': {'type': ['number', 'null'], 'description': 'Ï\x83/μ of YoY growth rates. <0.3 consistent, 0.3â\x80\x930.6 moderate, >0.6 volatile.'}}}, 'operating_leverage': {'type': 'object', 'properties': {'label': {'type': ['string', 'null'], 'description': 'STRONG | MODERATE | WEAK | NEGATIVE | INSUFFICIENT_DATA'}, 'score': {'type': ['number', 'null'], 'description': 'Op-income growth / revenue growth over full history. >1.5 strong, 1.0â\x80\x931.5 moderate, <1.0 weak.'}}}, 'best_available_cagr': {'type': ['number', 'null'], 'description': 'Longest available CAGR (5y > 3y > 1y).'}, 'grade_interpretation': {'type': 'string', 'description': 'One-sentence interpretation of the grade for DCF use.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'Public RSS or Atom feed URL to fetch.'}, 'limit': {'type': 'integer', 'description': 'Maximum number of items to return (default 20, max 100).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'feed': {'type': 'object', 'description': 'Feed-level metadata.'}, 'items': {'type': 'array', 'description': 'Feed items, most recent first.'}, 'item_count': {'type': 'integer', 'description': 'Items returned (capped at limit).'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'name': {'type': 'string', 'description': 'Entity name to screen (person, company, vessel, or aircraft). Full name preferred; partial name also works.'}, 'type': {'enum': ['individual', 'entity', 'vessel', 'aircraft'], 'type': 'string', 'description': 'Optional type filter. Omit to search all types.'}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of hits to return. Default 10, max 50.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'hits': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Official SDN name'}, 'type': {'type': 'string', 'description': 'individual | entity | vessel | aircraft'}, 'title': {'type': ['string', 'null']}, 'ent_num': {'type': 'string', 'description': 'OFAC internal entity number'}, 'program': {'type': 'string', 'description': 'Sanctions program(s) e.g. RUSSIA-EO14024, SDGT'}, 'remarks': {'type': ['string', 'null'], 'description': 'AKA aliases and remarks (first 200 chars)'}, 'match_type': {'type': 'string', 'description': 'primary | alias (matched via AKA)'}, 'match_score': {'type': 'integer', 'description': '0â\x80\x93100 name match confidence (F1 score)'}}}}, 'query': {'type': 'string'}, 'source': {'type': 'string'}, 'matched': {'type': 'boolean', 'description': 'True if any hits found at or above 35% match score'}, 'hit_count': {'type': 'integer'}, 'disclaimer': {'type': 'string'}, 'type_filter': {'type': 'string'}, 'programs_hit': {'type': 'array', 'items': {'type': 'string'}}, 'sdn_list_date': {'type': 'string', 'description': 'Date the SDN list was last fetched (YYYY-MM-DD)'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'cik': {'type': 'string', 'description': 'SEC Central Index Key (CIK). Provide as numeric string or zero-padded 10-digit form. Use instead of ticker if ticker is unknown.'}, 'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Max number of filings to return. Default 10, max 25.'}, 'ticker': {'type': 'string', 'description': 'US public company ticker symbol (e.g. AAPL, MSFT, TSLA). Case-insensitive. Provide either ticker or cik.'}, 'form_type': {'type': 'string', 'description': 'Filter results to a specific form type (e.g. 8-K, 10-K, 10-Q, 4, DEF14A, S-1). Case-insensitive. If omitted, returns all recent filings.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'company': {'type': 'object', 'properties': {'cik': {'type': 'string'}, 'sic': {'type': ['string', 'null']}, 'name': {'type': 'string'}, 'state': {'type': ['string', 'null']}, 'ticker': {'type': ['string', 'null']}, 'exchanges': {'type': 'array', 'items': {'type': 'string'}}, 'sic_description': {'type': ['string', 'null']}}}, 'filings': {'type': 'array', 'items': {'type': 'object', 'properties': {'form': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'string'}}, 'edgar_url': {'type': 'string'}, 'description': {'type': ['string', 'null']}, 'filing_date': {'type': 'string'}, 'report_date': {'type': ['string', 'null']}, 'accession_number': {'type': 'string'}}}}, 'timestamp': {'type': 'string'}, 'filtered_count': {'type': 'integer'}, 'form_filter_applied': {'type': ['string', 'null']}, 'total_recent_filings': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'days': {'type': 'integer', 'description': 'How many days back to search. Default 90, max 730.'}, 'forms': {'type': 'string', 'description': "Comma-separated SEC form types to search (e.g. '10-K,10-Q,8-K'). Default: 10-K,10-Q,8-K"}, 'limit': {'type': 'integer', 'description': 'Max results to return. Default 10, max 25.'}, 'query': {'type': 'string', 'description': "Keyword or phrase to search (e.g. 'tariff risk', 'artificial intelligence', 'China operations'). Wrap in quotes for exact phrase match."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'query': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'cik': {'type': 'string'}, 'filed': {'type': 'string'}, 'period': {'type': 'string'}, 'company': {'type': 'string'}, 'tickers': {'type': 'array', 'items': {'type': 'string'}}, 'form_type': {'type': 'string'}, 'relevance': {'type': 'number'}, 'filing_url': {'type': 'string'}}}}, 'date_range': {'type': 'string'}, 'total_matches': {'type': 'integer'}, 'forms_searched': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 25, 'minimum': 1, 'description': 'Number of recent Form 4 filings to retrieve and parse. Default 10, max 25.'}, 'ticker': {'type': 'string', 'description': 'US stock ticker symbol. Examples: AAPL, NVDA, TSLA, MSFT.'}, 'include_derivatives': {'type': 'boolean', 'description': 'Include derivative transactions (option exercises, conversions). Default true.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'cik': {'type': 'string'}, 'source': {'type': 'string'}, 'ticker': {'type': 'string'}, 'filings': {'type': 'array', 'items': {'type': 'object', 'properties': {'form_url': {'type': 'string'}, 'is_officer': {'type': 'boolean'}, 'filing_date': {'type': 'string'}, 'is_director': {'type': 'boolean'}, 'insider_name': {'type': 'string'}, 'transactions': {'type': 'array'}, 'officer_title': {'type': ['string', 'null']}, 'is_ten_pct_owner': {'type': 'boolean'}, 'period_of_report': {'type': 'string'}}}}, 'company_name': {'type': 'string'}, 'total_filings_found': {'type': 'integer', 'description': 'Total Form 4 filings available in EDGAR for this company'}, 'total_filings_parsed': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'rank_by': {'enum': ['1d', '5d', '1m', '3m'], 'type': 'string', 'description': 'Timeframe to rank sectors by relative performance. Default: 1m.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'spy': {'type': 'object', 'description': 'SPY reference prices and returns for each timeframe.'}, 'as_of': {'type': 'string', 'description': 'Date of most recent data (YYYY-MM-DD).'}, 'leaders': {'type': 'array', 'description': 'Top 3 outperforming sectors (tickers) for the rank_by timeframe.'}, 'sectors': {'type': 'array', 'description': 'Array of 11 sector objects sorted by rank_by relative performance.'}, 'laggards': {'type': 'array', 'description': 'Bottom 3 underperforming sectors (tickers) for the rank_by timeframe.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['target', 'authorized'], 'properties': {'target': {'type': 'string', 'description': "Hostname or IP address to scan (e.g. 'example.com' or '192.168.1.1')."}, 'scan_type': {'enum': ['quick', 'standard'], 'type': 'string', 'description': "Scan depth. 'quick' = top-100 ports, fast. 'standard' = top-1000 ports + service version detection."}, 'authorized': {'type': 'string', 'description': "Must be 'true'. By submitting you certify you own this target or have explicit written authorization to perform network reconnaissance against it."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'dns': {'type': 'object', 'properties': {'A': {'type': 'array', 'items': {'type': 'string'}}, 'MX': {'type': 'array', 'items': {'type': 'string'}}, 'TXT': {'type': 'array', 'items': {'type': 'string'}}, 'AAAA': {'type': 'array', 'items': {'type': 'string'}}}}, 'as_of': {'type': 'string'}, 'target': {'type': 'string'}, 'scan_type': {'type': 'string'}, 'open_ports': {'type': 'array', 'items': {'type': 'object', 'properties': {'port': {'type': 'integer'}, 'service': {'type': 'string'}, 'version': {'type': 'string'}, 'protocol': {'type': 'string'}}}}, 'open_port_count': {'type': 'integer'}, 'whois_registrar': {'type': 'string'}, 'scan_duration_ms': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['github_repo'], 'properties': {'ruleset': {'enum': ['auto', 'security-audit', 'owasp-top-ten'], 'type': 'string', 'description': "Semgrep ruleset. 'auto' (default) applies best-match rules for the detected language stack. 'security-audit' targets common vuln classes. 'owasp-top-ten' focuses on OWASP Top 10."}, 'github_repo': {'type': 'string', 'description': "Public GitHub repo in 'owner/repo' format (e.g. 'expressjs/express'). Must be publicly accessible without authentication."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'repo': {'type': 'string'}, 'as_of': {'type': 'string'}, 'clean': {'type': 'boolean', 'description': 'true when no findings returned'}, 'ruleset': {'type': 'string'}, 'findings': {'type': 'array', 'items': {'type': 'object', 'properties': {'cwe': {'type': 'string'}, 'file': {'type': 'string'}, 'line': {'type': 'integer'}, 'message': {'type': 'string'}, 'rule_id': {'type': 'string'}, 'severity': {'type': 'string'}}}}, 'findings_count': {'type': 'integer'}, 'scan_duration_ms': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'US equity ticker symbol (e.g. AAPL, TSLA, GME). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ticker': {'type': 'string'}, 'float_shares': {'type': 'integer'}, 'shares_short': {'type': 'integer'}, 'squeeze_risk': {'type': 'string'}, 'days_to_cover': {'type': 'number'}, 'interpretation': {'type': 'string'}, 'shares_outstanding': {'type': 'integer'}, 'short_pct_of_float': {'type': 'number'}, 'date_short_interest': {'type': 'string'}, 'short_interest_label': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of recent trading days to fetch (1â\x80\x9310, default 5).'}, 'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AMD, GME, NVDA). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'trend': {'enum': ['INCREASING', 'DECREASING', 'FLAT'], 'type': 'string', 'description': 'Short ratio trend over the window: INCREASING | DECREASING | FLAT.'}, 'source': {'type': 'string'}, 'ticker': {'type': 'string'}, 'history': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string', 'description': 'Trading date (YYYY-MM-DD).'}, 'short_pct': {'type': 'number', 'description': 'Short percentage (0â\x80\x93100).'}, 'short_ratio': {'type': 'number', 'description': 'Short volume / total volume (0â\x80\x931).'}, 'short_volume': {'type': 'integer', 'description': 'Short sale share volume.'}, 'total_volume': {'type': 'integer', 'description': 'Total consolidated share volume.'}}}, 'description': 'Daily short volume data, most recent first.'}, 'avg_short_pct': {'type': 'number', 'description': 'Average short percentage across the returned history.'}, 'days_returned': {'type': 'integer'}, 'days_requested': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'Full profile URL. Platform auto-detected from hostname. Use this OR platform+username.'}, 'platform': {'enum': ['github', 'reddit', 'hackernews', 'twitter', 'npm', 'opengraph'], 'type': 'string', 'description': 'Platform to query. Required when username is provided without a URL.'}, 'username': {'type': 'string', 'description': 'Username on the target platform (no @ prefix needed).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'bio': {'type': 'string', 'description': 'Profile bio or description.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'platform': {'type': 'string', 'description': 'Resolved platform name.'}, 'username': {'type': 'string', 'description': 'Canonical username.'}, 'followers': {'type': 'integer', 'description': 'Follower count (platform-dependent).'}, 'avatar_url': {'type': 'string', 'description': 'Profile image URL.'}, 'created_at': {'type': 'string', 'description': 'ISO-8601 account creation timestamp.'}, 'profile_url': {'type': 'string', 'description': 'Canonical URL of the profile.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'topic': {'type': 'string', 'description': "Topic or entity to query across all platforms. E.g. 'ethereum staking', 'LLM agents', 'Anthropic', 'DeFi yields'."}, 'hn_limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Max HN stories to return (1â\x80\x9320, default 10).'}, 'github_limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Max GitHub repos to return (1â\x80\x9320, default 10).'}, 'reddit_limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Max Reddit posts to return (1â\x80\x9320, default 10).'}, 'window_hours': {'type': 'integer', 'maximum': 168, 'minimum': 1, 'description': 'Lookback window in hours (default 24, min 1, max 168 = 7 days). Shorter windows are more noise-sensitive; 24â\x80\x9372h gives the most stable signal.'}, 'reddit_subreddits': {'type': 'array', 'items': {'type': 'string'}, 'description': "Restrict Reddit search to specific subreddits (e.g. ['bitcoin', 'ethereum', 'CryptoCurrency']). Omit to search all Reddit."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'hn': {'type': 'object', 'properties': {'stories': {'type': 'array', 'items': {'type': 'object'}}, 'story_count': {'type': 'integer'}, 'total_points': {'type': 'integer', 'description': 'Sum of HN points across returned stories.'}}}, 'topic': {'type': 'string', 'description': 'Topic queried.'}, 'github': {'type': 'object', 'properties': {'note': {'type': 'string', 'description': 'Present if GitHub returned a rate-limit error.'}, 'repos': {'type': 'array', 'items': {'type': 'object'}}, 'repo_count': {'type': 'integer'}, 'total_stars': {'type': 'integer', 'description': 'Sum of star counts on returned repos.'}}}, 'reddit': {'type': 'object', 'properties': {'posts': {'type': 'array', 'items': {'type': 'object'}}, 'post_count': {'type': 'integer'}, 'total_score': {'type': 'integer', 'description': 'Sum of Reddit scores across returned posts.'}}}, 'generated_at': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'window_hours': {'type': 'integer', 'description': 'Lookback window used.'}, 'momentum_label': {'type': 'string', 'description': 'HOT (â\x89¥70) | RISING (â\x89¥40) | STEADY (â\x89¥15) | QUIET (<15).'}, 'momentum_score': {'type': 'integer', 'description': 'Composite momentum score 0â\x80\x93100. Weighted: Reddit 50%, HN 30%, GitHub 20%.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mint': {'type': 'string', 'description': 'Solana SPL token mint address (base58, 32â\x80\x9344 chars).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'age': {'type': 'object', 'properties': {'age_days': {'type': ['integer', 'null']}, 'created_at': {'type': ['string', 'null'], 'description': 'ISO-8601 first-pair-created timestamp.'}}}, 'mint': {'type': 'string', 'description': 'The queried mint address.'}, 'risk': {'type': 'object', 'properties': {'flags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Positive signals (mint-renounced, deep-liquidity, â\x80¦)'}, 'level': {'type': 'string', 'description': 'safe | moderate | risky | danger'}, 'score': {'type': 'integer', 'description': 'Safety score 0â\x80\x93100 (higher = safer).'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Negative signals (mint-authority-active, low-liquidity, â\x80¦)'}}}, 'metadata': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'symbol': {'type': ['string', 'null']}, 'decimals': {'type': ['integer', 'null']}}}, 'liquidity': {'type': 'object', 'properties': {'price_usd': {'type': ['number', 'null']}, 'market_cap': {'type': ['number', 'null']}, 'volume_24h': {'type': ['number', 'null']}, 'liquidity_usd': {'type': ['number', 'null']}}}, 'authorities': {'type': 'object', 'properties': {'mint_renounced': {'type': 'boolean', 'description': 'true if mint authority has been burned (no new supply possible).'}, 'freeze_renounced': {'type': 'boolean', 'description': 'true if freeze authority has been burned.'}}}, 'distribution': {'type': 'object', 'properties': {'supply': {'type': ['string', 'null'], 'description': 'Total token supply (raw integer string).'}, 'top10_holder_pct': {'type': ['number', 'null'], 'description': 'Percentage of supply held by the 10 largest wallets.'}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'signature': {'type': 'string', 'description': 'Solana transaction signature (base58, 87â\x80\x9388 characters).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'status': {'enum': ['success', 'failed'], 'type': 'string', 'description': 'Transaction execution status.'}, 'fee_sol': {'type': 'number', 'description': 'Transaction fee in SOL.'}, 'fee_usd': {'type': ['number', 'null'], 'description': 'Transaction fee in USD (null if SOL price unavailable).'}, 'summary': {'type': 'string', 'description': 'One-sentence human-readable explanation of what this transaction did.'}, 'programs': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Unique programs invoked (outer + inner instructions), resolved to human-readable names.'}, 'fee_payer': {'type': 'string', 'description': 'Address that paid the transaction fee.'}, 'signature': {'type': 'string', 'description': 'Transaction signature queried.'}, 'block_slot': {'type': ['integer', 'null'], 'description': 'Slot number containing this transaction.'}, 'block_time': {'type': ['string', 'null'], 'description': 'ISO-8601 timestamp of the block.'}, 'queried_at': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'token_changes': {'type': 'array', 'items': {'type': 'object', 'properties': {'mint': {'type': 'string', 'description': 'SPL token mint address.'}, 'delta': {'type': 'number', 'description': 'Token amount change (positive = received, negative = sent).'}, 'account': {'type': 'integer', 'description': 'Account index in the transaction.'}}}, 'description': 'SPL token balance changes for all affected token accounts.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'latitude': {'type': 'number', 'description': 'Latitude in decimal degrees (-90 to 90). Use with longitude instead of location name.'}, 'location': {'type': 'string', 'description': "City, region, or address (e.g. 'Phoenix AZ', 'London', 'Sydney Australia'). Use this OR latitude+longitude."}, 'longitude': {'type': 'number', 'description': 'Longitude in decimal degrees (-180 to 180). Use with latitude instead of location name.'}, 'forecast_days': {'type': 'integer', 'maximum': 16, 'minimum': 1, 'description': 'Number of forecast days (1â\x80\x9316). Default 7.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'today': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'sunset': {'type': ['string', 'null']}, 'sunrise': {'type': ['string', 'null']}, 'solar_rating': {'type': 'string', 'description': 'Qualitative solar potential: excellent | good | moderate | poor.'}, 'ghi_sum_mj_m2': {'type': ['number', 'null'], 'description': 'Total global horizontal irradiance today (MJ/m²).'}, 'daylight_hours': {'type': ['number', 'null'], 'description': 'Total daylight duration in hours.'}, 'peak_sun_hours': {'type': ['number', 'null'], 'description': 'Equivalent peak sun hours (kWh/m²). 1 PSH = 1 kW/m² for 1 hour.'}, 'panel_yield_kwh': {'type': ['number', 'null'], 'description': 'Estimated output of a 1 kW solar system today (kWh), assuming 80% system efficiency.'}, 'cloud_cover_avg_pct': {'type': ['number', 'null'], 'description': 'Average cloud cover percentage for the day.'}}, 'description': 'Solar summary for today.'}, 'forecast': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'sunset': {'type': ['string', 'null']}, 'sunrise': {'type': ['string', 'null']}, 'solar_rating': {'type': 'string'}, 'ghi_sum_mj_m2': {'type': ['number', 'null']}, 'daylight_hours': {'type': ['number', 'null']}, 'peak_sun_hours': {'type': ['number', 'null']}, 'panel_yield_kwh': {'type': ['number', 'null']}}}, 'description': '7-day daily solar forecast.'}, 'location': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'country': {'type': ['string', 'null']}, 'latitude': {'type': 'number'}, 'timezone': {'type': ['string', 'null']}, 'longitude': {'type': 'number'}, 'elevation_m': {'type': ['number', 'null']}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'date': {'type': 'string', 'description': 'Date in YYYY-MM-DD format (default: today UTC). Use for historical or upcoming schedules.'}, 'team': {'type': 'string', 'description': "Optional filter: team name or abbreviation (case-insensitive substring match). E.g. 'Cubs', 'CHC', 'Lakers'."}, 'sport': {'type': 'string', 'description': 'League code: mlb | nba | nfl | nhl | ncaaf | ncaab'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'games': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'ESPN event ID.'}, 'away': {'type': 'object', 'properties': {'team': {'type': 'string'}, 'score': {'type': 'integer'}, 'record': {'type': 'string'}, 'winner': {'type': 'boolean'}, 'abbreviation': {'type': 'string'}}}, 'home': {'type': 'object', 'properties': {'team': {'type': 'string'}, 'score': {'type': 'integer', 'description': 'Current/final score (null if not started).'}, 'record': {'type': 'string', 'description': 'W-L record (regular season overall).'}, 'winner': {'type': 'boolean'}, 'abbreviation': {'type': 'string'}}}, 'name': {'type': 'string', 'description': "Full game name, e.g. 'San Francisco Giants at Chicago Cubs'."}, 'venue': {'type': 'string', 'description': 'Venue name.'}, 'status': {'type': 'string', 'description': 'Game status: scheduled | in_progress | final.'}, 'broadcast': {'type': 'string', 'description': 'TV broadcast network if available.'}, 'start_utc': {'type': 'string', 'description': 'ISO-8601 scheduled start time (UTC).'}, 'short_name': {'type': 'string', 'description': "Abbreviated, e.g. 'SF @ CHC'."}, 'venue_city': {'type': 'string', 'description': 'City, State.'}}}}, 'sport': {'type': 'string', 'description': 'Requested league code.'}, 'total_games': {'type': 'integer'}, 'date_queried': {'type': 'string', 'description': 'Date queried in YYYY-MM-DD (UTC).'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'date': {'type': 'string', 'description': "Date in YYYYMMDD format (e.g. '20240115'). Defaults to today."}, 'limit': {'type': 'integer', 'description': 'Max games to return (default 10, max 30).'}, 'league': {'enum': ['nba', 'wnba', 'ncaab', 'nfl', 'ncaaf', 'mlb', 'nhl', 'mls', 'epl', 'laliga', 'bundesliga', 'seriea', 'ucl'], 'type': 'string', 'description': "League code. Default: 'nba'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'date': {'type': 'string'}, 'games': {'type': 'array', 'description': 'Game scores and status.'}, 'league': {'type': 'string'}, 'game_count': {'type': 'integer'}, 'league_name': {'type': 'string'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'host': {'type': 'string', 'description': "Hostname or IP address to inspect (e.g. 'github.com', 'api.example.com')."}, 'port': {'type': 'integer', 'description': 'TLS port number (default: 443).'}, 'servername': {'type': 'string', 'description': "SNI server name override (defaults to 'host'). Useful when connecting to an IP that hosts multiple domains."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'host': {'type': 'string'}, 'port': {'type': 'integer'}, 'valid_to': {'type': 'string'}, 'issuer_cn': {'type': ['string', 'null']}, 'issuer_org': {'type': ['string', 'null']}, 'subject_cn': {'type': ['string', 'null']}, 'valid_from': {'type': 'string'}, 'san_domains': {'type': 'array', 'items': {'type': 'string'}}, 'subject_org': {'type': ['string', 'null']}, 'generated_at': {'type': 'string'}, 'expiry_status': {'enum': ['HEALTHY', 'OK', 'WARNING', 'CRITICAL', 'EXPIRED'], 'type': 'string'}, 'serial_number': {'type': ['string', 'null']}, 'days_remaining': {'type': 'integer'}, 'fingerprint_sha256': {'type': ['string', 'null']}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'top_n': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Number of top stablecoins to return, ranked by circulating supply. Default 20, max 50. Ignored if symbol is specified.'}, 'symbol': {'type': 'string', 'description': 'Filter to a specific stablecoin symbol (e.g. USDT, USDC, DAI). Case-insensitive. If omitted, returns top coins by market cap.'}, 'alert_only': {'type': 'boolean', 'description': 'If true, only return coins with MILD_DEPEG or worse. Useful for alert-driven workflows.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'coins': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Full stablecoin name.'}, 'price': {'type': 'number', 'description': 'Current price in USD.'}, 'symbol': {'type': 'string', 'description': 'Stablecoin ticker symbol.'}, 'depeg_status': {'type': 'string', 'description': 'PARITY | MILD_DEPEG | MODERATE_DEPEG | SEVERE_DEPEG'}, 'peg_deviation': {'type': 'number', 'description': 'Absolute deviation from $1.00 (e.g. 0.0012 = 0.12% off peg).'}, 'peg_mechanism': {'type': ['string', 'null'], 'description': 'fiat-backed | crypto-backed | algorithmic | etc.'}, 'supply_1d_pct': {'type': ['number', 'null'], 'description': 'Supply change vs prior day in percent (positive = expansion, negative = contraction).'}, 'circulating_bn': {'type': 'number', 'description': 'Current circulating supply in billions USD.'}}}}, 'count': {'type': 'integer', 'description': 'Number of coins in this response.'}, 'alert_level': {'type': 'string', 'description': 'Composite depeg signal across all returned coins: GREEN (all at PARITY), YELLOW (mild depeg present), ORANGE (moderate depeg present), RED (severe depeg present).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Search query (required). Use natural language or error messages.'}, 'sort': {'enum': ['votes', 'relevance', 'activity', 'creation'], 'type': 'string', 'description': 'Sort order. Default: votes (highest score first).'}, 'tags': {'type': 'string', 'description': "Semicolon-separated list of required tags (e.g. 'python;asyncio'). Optional."}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of results (1â\x80\x9310). Default: 5.'}, 'accepted_only': {'type': 'boolean', 'description': 'If true, return only questions with an accepted answer. Default: false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'questions': {'type': 'array', 'items': {'type': 'object', 'properties': {'link': {'type': 'string', 'description': 'Direct URL to the question.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Associated tags.'}, 'score': {'type': 'integer', 'description': 'Net upvote score.'}, 'title': {'type': 'string', 'description': 'Question title.'}, 'is_answered': {'type': 'boolean', 'description': 'True if an accepted answer exists.'}, 'question_id': {'type': 'integer', 'description': 'SO question ID.'}, 'answer_count': {'type': 'integer', 'description': 'Number of answers.'}, 'body_excerpt': {'type': ['string', 'null'], 'description': 'First ~600 chars of question body (HTML stripped). Code blocks replaced with [code block].'}, 'creation_date': {'type': 'string', 'description': 'ISO-8601 creation timestamp.'}, 'last_activity': {'type': 'string', 'description': 'ISO-8601 last activity timestamp.'}}}}, 'total_found': {'type': 'integer', 'description': 'Total matching questions on SO (may exceed returned limit).'}, 'quota_remaining': {'type': 'integer', 'description': 'Remaining API calls in current quota window (300/day unauthenticated).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['rescue_id', 'capability', 'client'], 'properties': {'client': {'type': 'object', 'properties': {'can_fund': {'type': 'boolean', 'default': False}, 'can_swap': {'type': 'boolean', 'default': False}, 'can_bridge': {'type': 'boolean', 'default': False}, 'preferred_method': {'type': 'string', 'pattern': '^[a-z0-9-]{1,80}$'}, 'supported_assets': {'type': 'array', 'items': {'$ref': '#/properties/client/properties/supported_networks/items'}, 'default': [], 'maxItems': 20}, 'can_switch_wallet': {'type': 'boolean', 'default': False}, 'supported_schemes': {'type': 'array', 'items': {'$ref': '#/properties/client/properties/supported_networks/items'}, 'default': [], 'maxItems': 20}, 'supported_networks': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'default': [], 'maxItems': 20}, 'supported_protocols': {'type': 'array', 'items': {'enum': ['x402', 'MPP', 'AP2', 'internal-credit'], 'type': 'string'}, 'default': [], 'maxItems': 8}, 'max_authorized_spend_usd': {'type': 'number', 'maximum': 1000000, 'minimum': 0}}, 'additionalProperties': False}, 'rescue_id': {'type': 'string', 'pattern': '^rescue_[0-9a-f]{24}$'}, 'capability': {'type': 'string', 'pattern': '^[a-z0-9-]+$'}, 'client_note': {'type': 'string', 'maxLength': 500}, 'request_context_id': {'type': 'string', 'pattern': '^ctx_[0-9a-f]{24}$'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AMD, AAPL, NVDA, TSLA). Case-insensitive.'}, 'market_limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Max Limitless prediction markets to return (1â\x80\x9310, default 5). Markets are filtered by ticker keyword.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'name': {'type': 'string'}, 'equity': {'type': 'object', 'properties': {'volume': {'type': 'integer'}, 'day_low': {'type': 'number'}, 'currency': {'type': 'string'}, 'day_high': {'type': 'number'}, 'exchange': {'type': 'string'}, 'price_usd': {'type': 'number'}, 'change_pct': {'type': 'number'}, 'change_usd': {'type': 'number'}, 'market_time': {'type': 'string'}, 'week_52_low': {'type': 'number'}, 'week_52_high': {'type': 'number'}}, 'description': 'Current equity price and intraday metrics from Yahoo Finance.'}, 'ticker': {'type': 'string'}, 'seam_note': {'type': 'string', 'description': 'Data provenance â\x80\x94 the x402 settlement seam this capability collapses.'}, 'generated_at': {'type': 'string'}, 'prediction_markets': {'type': 'array', 'items': {'type': 'object', 'properties': {'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'volume': {'type': 'string'}, 'no_price': {'type': 'number'}, 'yes_price': {'type': 'number', 'description': 'Implied yes probability (0â\x80\x931).'}, 'collateral': {'type': 'string'}, 'expiration': {'type': 'string'}, 'trade_type': {'type': 'string'}}}, 'description': 'Active Limitless prediction markets matching the ticker keyword. Empty array if none found.'}, 'prediction_market_count': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'compare': {'type': 'array', 'items': {'type': 'string'}, 'description': "Up to 4 peer tickers to compare against (e.g. ['AMD','INTC','QCOM']). Case-insensitive."}, 'primary': {'type': 'string', 'description': "The main stock to focus on (e.g. 'NVDA'). Case-insensitive."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'peers': {'type': 'array', 'description': 'Full quote data for each comparison ticker.'}, 'leader': {'type': 'object', 'properties': {'ticker': {'type': 'string'}, 'change_pct': {'type': 'number'}}, 'description': 'Ticker with the highest day change % in the group.'}, 'laggard': {'type': 'object', 'properties': {'ticker': {'type': 'string'}, 'change_pct': {'type': 'number'}}, 'description': 'Ticker with the lowest day change % in the group.'}, 'primary': {'type': 'object', 'description': 'Full quote data for the primary ticker.'}, 'ranking': {'type': 'array', 'description': 'All tickers ranked by day change % (highest first). Each entry includes ticker, change_pct, and rank.'}, 'primary_rank': {'type': 'integer', 'description': 'Rank of the primary ticker (1 = best performer, higher = worse).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'cron': {'type': 'string', 'description': "Cron expression (5 fields) or shortcut (@daily, @hourly, etc.) for when to run the monitor. Example: '0 9 * * 1-5' for weekdays at 9am UTC."}, 'tickers': {'type': 'array', 'items': {'type': 'string'}, 'description': "Up to 5 US stock ticker symbols to monitor (e.g. ['AAPL','NVDA','MSFT'])."}, 'next_runs': {'type': 'number', 'description': 'Number of upcoming schedule run times to include (default 5, max 20).'}, 'monitor_name': {'type': 'string', 'description': "Optional name for this monitoring job (e.g. 'morning-tech-check')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'stocks': {'type': 'array', 'description': 'Current price snapshot for each monitored ticker.'}, 'schedule': {'type': 'object', 'properties': {'valid': {'type': 'boolean'}, 'fields': {'type': 'object', 'properties': {'hour': {'type': 'string'}, 'month': {'type': 'string'}, 'minute': {'type': 'string'}, 'day_of_week': {'type': 'string'}, 'day_of_month': {'type': 'string'}}}, 'expression': {'type': 'string'}, 'normalized': {'type': 'string'}, 'description': {'type': 'string'}, 'next_run_times': {'type': 'array', 'items': {'type': 'string'}}}}, 'job_config': {'type': 'object', 'properties': {'cron': {'type': 'string'}, 'name': {'type': 'string'}, 'tickers': {'type': 'array', 'items': {'type': 'string'}}, 'created_at': {'type': 'string'}, 'baseline_prices': {'type': 'object', 'description': 'ticker â\x86\x92 price_usd at config creation time.'}}, 'description': 'Assembled monitoring job config ready for deployment.'}, 'monitor_name': {'type': 'string', 'description': 'Name of this monitoring job.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Max candles to return (1â\x80\x93500, default 60). Applied from most recent.'}, 'range': {'enum': ['1d', '5d', '1mo', '3mo', '6mo', '1y', '2y', '5y', '10y', 'ytd', 'max'], 'type': 'string', 'description': "Lookback period. Default: '1mo'. Note: intraday intervals cap at 60d max."}, 'ticker': {'type': 'string', 'description': "Stock ticker symbol (e.g. 'AAPL', 'SPY', 'BTC-USD', '^VIX'). Case-insensitive."}, 'interval': {'enum': ['1m', '5m', '15m', '30m', '1h', '1d', '1wk', '1mo'], 'type': 'string', 'description': "Candlestick interval. Intraday ('1m'â\x80\x93'1h') limited to last 60 days. Default: '1d'."}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'count': {'type': 'integer', 'description': 'Number of candles returned.'}, 'range': {'type': 'string', 'description': 'Lookback range requested.'}, 'ticker': {'type': 'string', 'description': 'Normalized ticker symbol.'}, 'candles': {'type': 'array', 'items': {'type': 'object', 'required': [], 'properties': {'low': {'type': 'number', 'description': 'Period low.'}, 'date': {'type': 'string', 'description': 'ISO date (YYYY-MM-DD) for daily+; ISO datetime for intraday.'}, 'high': {'type': 'number', 'description': 'Period high.'}, 'open': {'type': 'number', 'description': 'Opening price.'}, 'close': {'type': 'number', 'description': 'Closing price.'}, 'volume': {'type': 'integer', 'description': 'Shares/units traded.'}}}, 'description': 'OHLCV candles, newest last.'}, 'currency': {'type': 'string', 'description': "Denomination currency (e.g. 'USD')."}, 'interval': {'type': 'string', 'description': 'Candle interval returned.'}, 'pct_change': {'type': 'number', 'description': 'Percent change from first to last close in window.'}, 'period_low': {'type': 'number', 'description': 'Lowest price in the returned window.'}, 'period_high': {'type': 'number', 'description': 'Highest price in the returned window.'}, 'latest_close': {'type': 'number', 'description': 'Most recent closing price.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'tickers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 5 US stock ticker symbols as an array (e.g. ["AAPL","NVDA","MSFT"]). Case-insensitive. A comma-separated string is also accepted.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'error': {'type': 'string', 'description': 'Non-null if this ticker failed; others still returned.'}, 'ticker': {'type': 'string'}, 'volume': {'type': 'integer'}, 'day_low': {'type': 'number'}, 'currency': {'type': 'string'}, 'day_high': {'type': 'number'}, 'exchange': {'type': 'string'}, 'price_usd': {'type': 'number'}, 'change_pct': {'type': 'number'}, 'change_usd': {'type': 'number'}, 'market_time': {'type': 'string'}, 'week_52_low': {'type': 'number'}, 'week_52_high': {'type': 'number'}}}, 'description': 'One entry per ticker, in the order requested.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'count': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x9350, default 25).'}, 'screen': {'enum': ['day_gainers', 'day_losers', 'most_actives', 'undervalued_growth_stocks', 'undervalued_large_caps', 'growth_technology_stocks', 'aggressive_small_caps', 'small_cap_gainers'], 'type': 'string', 'description': 'Which predefined screen to run. Options: day_gainers, day_losers, most_actives, undervalued_growth_stocks, undervalued_large_caps, growth_technology_stocks, aggressive_small_caps, small_cap_gainers.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'count': {'type': 'number', 'description': 'Number of results returned.'}, 'screen': {'type': 'string', 'description': 'Screen ID used.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'price': {'type': ['number', 'null'], 'description': 'Current price USD.'}, 'sector': {'type': ['string', 'null']}, 'ticker': {'type': 'string'}, 'volume': {'type': ['number', 'null'], 'description': "Today's volume."}, 'industry': {'type': ['string', 'null']}, 'avg_volume': {'type': ['number', 'null'], 'description': '3-month avg daily volume.'}, 'change_pct': {'type': ['number', 'null'], 'description': 'Day % change.'}, 'pe_forward': {'type': ['number', 'null']}, 'week52_low': {'type': ['number', 'null']}, 'pe_trailing': {'type': ['number', 'null']}, 'week52_high': {'type': ['number', 'null']}, 'eps_trailing': {'type': ['number', 'null']}, 'market_cap_b': {'type': ['number', 'null'], 'description': 'Market cap in billions USD.'}, 'pct_from_52w_high': {'type': ['number', 'null'], 'description': '% below (negative) or above 52-week high.'}}}}, 'total_found': {'type': ['number', 'null'], 'description': 'Total matching stocks in the screen.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'symbol': {'type': 'string', 'description': 'Ticker or crypto symbol. Examples: AAPL, SPY, QQQ, BTC, ETH, SOL, NVDA.'}, 'include_bars': {'type': 'boolean', 'description': 'If true, include last 5 OHLCV bars in response. Default false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'rsi': {'type': 'number', 'description': 'RSI(14).'}, 'bars': {'type': 'array'}, 'macd': {'type': 'object', 'description': 'MACD line, signal, histogram.'}, 'name': {'type': 'string'}, 'price': {'type': 'number', 'description': 'Current price.'}, 'score': {'type': 'integer'}, 'symbol': {'type': 'string'}, 'posture': {'enum': ['STRONG_BUY', 'BUY', 'NEUTRAL', 'SELL', 'STRONG_SELL'], 'type': 'string'}, 'signals': {'type': 'array', 'description': 'Contributing signal labels.'}, 'currency': {'type': 'string'}, 'strength': {'type': 'number', 'description': 'Signal strength 0â\x80\x931.'}, 'bollinger': {'type': 'object', 'description': 'Upper, middle, lower bands + width.'}, 'data_source': {'type': 'string'}, 'generated_at': {'type': 'string'}, 'volume_trend': {'enum': ['rising', 'stable', 'falling', 'unknown', 'insufficient_data'], 'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'shipping': {'type': 'object', 'properties': {'ups': {'type': 'object'}, 'fedex': {'type': 'object'}, 'dry_bulk_bdry': {'type': 'object'}, 'matson_pacific': {'type': 'object'}}, 'description': 'Ocean and air freight signals.'}, 'narrative': {'type': 'string', 'description': 'Full ~200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence supply chain summary.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'generated_at': {'type': 'string'}, 'freight_signal': {'type': 'string', 'description': 'expansion | stable | softening | contraction | unknown'}, 'ground_freight': {'type': 'object', 'properties': {'ch_robinson': {'type': 'object'}, 'old_dominion': {'type': 'object'}, 'ltl_composite': {'type': 'number', 'description': 'Average % change across LTL carriers.'}, 'xpo_logistics': {'type': 'object'}}, 'description': 'LTL and freight brokerage signals.'}, 'dominant_signal': {'type': 'string', 'description': 'Most important supply chain signal.'}, 'agent_implication': {'type': 'string', 'description': 'Concrete action relevance for AI agents.'}, 'industrial_inputs': {'type': 'object', 'properties': {'nucor_steel': {'type': 'object'}, 'copper_regime': {'type': 'string'}, 'copper_futures': {'type': 'object'}, 'albemarle_minerals': {'type': 'object'}}, 'description': 'Key material input signals.'}, 'supply_chain_regime': {'type': 'string', 'description': 'tight | normal | loose | disrupted | uncertain'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'style': {'enum': ['standard', 'concise'], 'type': 'string', 'description': "Output length. 'standard' = 200-word narrative (default). 'concise' = 100-word summary."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'megacaps': {'type': 'object', 'properties': {'amd': {'type': 'object'}, 'meta': {'type': 'object'}, 'apple': {'type': 'object'}, 'intel': {'type': 'object'}, 'nvidia': {'type': 'object'}, 'alphabet': {'type': 'object'}, 'microsoft': {'type': 'object'}}, 'description': 'Mega-cap tech individual performance.'}, 'narrative': {'type': 'string', 'description': 'Full ~200-word briefing narrative.'}, 'situation': {'type': 'string', 'description': 'One-sentence tech sector summary.'}, 'benchmarks': {'type': 'object', 'properties': {'xlk_tech_etf': {'type': 'object'}, 'qqq_nasdaq100': {'type': 'object'}, 'smh_semis_etf': {'type': 'object'}}, 'description': 'Core tech benchmark performance.'}, 'confidence': {'type': 'number', 'description': 'Synthesis confidence 0â\x80\x931.'}, 'tech_regime': {'type': 'string', 'description': 'near_peak | pullback | correction | bear_market | uncertain'}, 'generated_at': {'type': 'string'}, 'dominant_signal': {'type': 'string', 'description': 'Most important signal from the data.'}, 'semi_leadership': {'type': 'string', 'description': 'Whether semiconductors are outperforming or lagging.'}, 'agent_implication': {'type': 'string', 'description': 'Concrete action relevance for AI agents.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ticker'], 'properties': {'ticker': {'type': 'string', 'description': 'Equity ticker symbol (e.g. AAPL, SPY, QQQ).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'macd': {'type': ['object', 'null'], 'properties': {'line': {'type': ['number', 'null']}, 'cross': {'enum': ['bullish_cross', 'bearish_cross', 'none'], 'type': 'string'}, 'trend': {'enum': ['bullish', 'bearish', 'flat'], 'type': 'string'}, 'histogram': {'type': ['number', 'null']}, 'signal_line': {'type': ['number', 'null']}}}, 'name': {'type': ['string', 'null']}, 'price': {'type': ['number', 'null']}, 'rsi_14': {'type': ['number', 'null'], 'description': 'RSI(14). Overbought >70, oversold <30.'}, 'ticker': {'type': 'string'}, 'volume': {'type': 'object', 'properties': {'last': {'type': ['number', 'null']}, 'sma_20': {'type': ['number', 'null']}, 'vs_avg': {'enum': ['high', 'normal', 'low', None], 'type': ['string', 'null']}, 'vs_avg_pct': {'type': ['number', 'null']}}}, 'data_days': {'type': 'integer'}, 'rsi_signal': {'enum': ['overbought', 'oversold', 'neutral'], 'type': 'string'}, 'tech_signal': {'enum': ['STRONG_BULLISH', 'BULLISH', 'NEUTRAL', 'BEARISH', 'STRONG_BEARISH'], 'type': 'string'}, 'bollinger_bands': {'type': ['object', 'null'], 'properties': {'mid': {'type': ['number', 'null']}, 'lower': {'type': ['number', 'null']}, 'pct_b': {'type': ['number', 'null'], 'description': '0=at lower band, 1=at upper band.'}, 'upper': {'type': ['number', 'null']}, 'squeeze': {'type': 'boolean', 'description': 'True when bandwidth <5% of midpoint (volatility contraction).'}, 'position': {'enum': ['above_upper', 'near_upper', 'mid', 'near_lower', 'below_lower'], 'type': 'string'}, 'bandwidth': {'type': ['number', 'null']}}}, 'moving_averages': {'type': 'object', 'properties': {'ema_20': {'type': ['number', 'null']}, 'sma_20': {'type': ['number', 'null']}, 'sma_50': {'type': ['number', 'null']}, 'sma_200': {'type': ['number', 'null']}, 'death_cross': {'type': 'boolean', 'description': 'SMA50 < SMA200 (long-term bearish setup).'}, 'golden_cross': {'type': 'boolean', 'description': 'SMA50 > SMA200 (long-term bullish setup).'}, 'price_vs_sma20': {'enum': ['above', 'below', None], 'type': ['string', 'null']}, 'price_vs_sma50': {'enum': ['above', 'below', None], 'type': ['string', 'null']}, 'price_vs_sma200': {'enum': ['above', 'below', None], 'type': ['string', 'null']}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'search': {'type': 'string', 'description': "Return a list of timezone names matching this substring (e.g. 'America', 'Paris'). Use to discover valid timezone identifiers."}, 'timezone': {'type': 'string', 'description': "IANA timezone name to look up (e.g. 'America/Chicago', 'Europe/London', 'Asia/Tokyo'). Omit to return UTC."}, 'timezones': {'type': 'array', 'items': {'type': 'string'}, 'description': "Batch: list of IANA timezone names (max 20). If provided, 'timezone' is ignored."}, 'convert_from_iso': {'type': 'string', 'description': "ISO 8601 timestamp to convert (e.g. '2026-06-06T15:00:00Z'). If omitted, uses current UTC time."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'count': {'type': 'integer'}, 'results': {'type': 'array'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'description': 'Number of top holders to return. Default 50, max 100.'}, 'token_address': {'type': 'string', 'description': "Ethereum ERC-20 contract address (0x-prefixed). Example: '0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48' for USDC."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'token': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'symbol': {'type': 'string'}, 'address': {'type': 'string'}, 'decimals': {'type': 'integer'}, 'price_usd': {'type': 'number'}, 'total_supply': {'type': 'number'}, 'holders_count': {'type': 'integer'}, 'market_cap_usd': {'type': 'number'}}}, 'holders': {'type': 'array', 'items': {'type': 'object', 'properties': {'rank': {'type': 'integer'}, 'address': {'type': 'string'}, 'balance': {'type': 'number'}, 'share_pct': {'type': 'number'}, 'balance_raw': {'type': 'string'}}}}, 'timestamp': {'type': 'string'}, 'concentration': {'type': 'object', 'properties': {'hhi': {'type': 'number'}, 'top1_pct': {'type': 'number'}, 'top5_pct': {'type': 'number'}, 'top10_pct': {'type': 'number'}, 'risk_label': {'type': 'string'}, 'whale_count': {'type': 'integer'}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'type': {'type': 'string', 'description': "Security type filter: 'all', 'bill', 'note', 'bond', 'tips', 'frn', 'cmb'. Default: 'all'."}, 'limit': {'type': 'integer', 'description': 'Max number of auctions to return (default: 20, max: 100).'}, 'days_ahead': {'type': 'integer', 'description': 'How many calendar days ahead to include auctions for (1â\x80\x93365). Default: 30.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'as_of': {'type': 'string', 'description': 'Date this data was fetched (YYYY-MM-DD).'}, 'filter': {'type': 'string', 'description': 'Applied type filter.'}, 'auctions': {'type': 'array', 'items': {'type': 'object', 'properties': {'term': {'type': 'string', 'description': "Security term (e.g. '10-Year', '26-Week')."}, 'tips': {'type': 'boolean', 'description': 'True if inflation-protected (TIPS).'}, 'type': {'type': 'string', 'description': 'Security type: Bill, Note, Bond, TIPS, FRN.'}, 'cusip': {'type': 'string', 'description': 'CUSIP identifier.'}, 'is_cmb': {'type': 'boolean', 'description': 'True if Cash Management Bill.'}, 'series': {'type': 'string', 'description': "Series description (e.g. 'Notes of June 2028')."}, 'reopening': {'type': 'boolean', 'description': 'True if this is a reopening of an existing security.'}, 'issue_date': {'type': 'string', 'description': 'Settlement / issue date (YYYY-MM-DD).'}, 'coupon_rate': {'type': ['number', 'null'], 'description': 'Interest/coupon rate (%). Null for discount bills.'}, 'auction_date': {'type': 'string', 'description': 'Date of auction (YYYY-MM-DD).'}, 'floating_rate': {'type': 'boolean', 'description': 'True if floating rate note (FRN).'}, 'maturity_date': {'type': 'string', 'description': 'Date the security matures (YYYY-MM-DD).'}, 'offering_amount_b': {'type': ['number', 'null'], 'description': 'Offering amount in billions USD.'}, 'closing_time_competitive': {'type': 'string', 'description': 'Bid deadline for competitive tenders.'}}}, 'description': 'Upcoming auctions sorted by auction date ascending.'}, 'days_ahead': {'type': 'integer', 'description': 'Look-ahead window used.'}, 'total_found': {'type': 'integer', 'description': 'Total auctions matching filter before limit.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'y3m': {'type': 'number', 'description': '3-Month (13-Week) Treasury Bill yield (%).'}, 'y5y': {'type': 'number', 'description': '5-Year Treasury yield (%).'}, 'y10y': {'type': 'number', 'description': '10-Year Treasury yield (%). Primary risk-free rate for DCF models.'}, 'y30y': {'type': 'number', 'description': '30-Year Treasury yield (%).'}, 'data_ts': {'type': 'string', 'description': 'ISO-8601 timestamp of the latest market observation.'}, 'curve_shape': {'type': 'string', 'description': "Yield curve classification: 'normal' (10Y > 3M), 'inverted' (10Y < 3M), or 'flat' (|spread| <= 25bp)."}, 'spread_10y_3m': {'type': 'number', 'description': '10Y minus 3M spread (bp). Negative = yield curve inverted (recession signal).'}, 'spread_30y_10y': {'type': 'number', 'description': '30Y minus 10Y spread (bp). Measures long-end steepness.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['mode'], 'properties': {'date': {'type': 'string', 'description': 'schedule mode: date in YYYY-MM-DD format (default: today in UTC).'}, 'mode': {'enum': ['search', 'show', 'episodes', 'schedule'], 'type': 'string', 'description': 'search=find shows by name | show=full profile for one show | episodes=episode list (optionally filtered by season) | schedule=TV air schedule for a country on a date'}, 'limit': {'type': 'integer', 'description': 'search mode: max results to return (default 8, max 20).'}, 'query': {'type': 'string', 'description': 'search/show/episodes: show name or numeric TVMaze show ID. schedule: omit or leave empty.'}, 'season': {'type': 'integer', 'description': 'episodes mode: filter to this season number (omit for all seasons).'}, 'country': {'type': 'string', 'description': 'schedule mode: ISO 3166-1 alpha-2 country code (default: US).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'type': 'string'}, 'show': {'type': 'object'}, 'count': {'type': 'integer'}, 'results': {'type': 'array'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'q': {'type': 'string', 'description': 'Search query string (keywords, filters). Required for search_tweets.'}, 'action': {'enum': ['lookup_user', 'search_tweets'], 'type': 'string', 'description': 'lookup_user: profile by @username | search_tweets: keyword tweet search'}, 'username': {'type': 'string', 'description': '@handle without the @. Required for lookup_user.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'data': {'type': 'object', 'description': 'Twitter API response (user or tweets)'}, 'action': {'type': 'string'}, 'upstream_cost_usd': {'type': 'number', 'description': 'Actual upstream cost paid to twit.sh'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chain': {'enum': ['ethereum', 'base', 'polygon', 'arbitrum'], 'type': 'string', 'description': 'Chain to query. Default: ethereum.'}, 'tx_hash': {'type': 'string', 'description': 'Transaction hash â\x80\x94 0x-prefixed, 66 characters total.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'to': {'type': ['string', 'null'], 'description': 'Recipient address (contract or EOA); null for contract creation.'}, 'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'from': {'type': 'string', 'description': 'Sender address.'}, 'hash': {'type': 'string', 'description': 'Transaction hash.'}, 'chain': {'type': 'string', 'description': 'Chain queried.'}, 'method': {'type': ['string', 'null'], 'description': 'Decoded method name if recognized, 4-byte selector if not, null for plain ETH transfer.'}, 'status': {'enum': ['success', 'failed', 'pending'], 'type': 'string', 'description': 'Execution status.'}, 'fee_eth': {'type': ['number', 'null'], 'description': 'Transaction fee in ETH (gas_used Ã\x97 gas_price).'}, 'summary': {'type': 'string', 'description': 'One-sentence agent-readable description of what this transaction did.'}, 'gas_used': {'type': ['integer', 'null'], 'description': 'Gas units consumed.'}, 'timestamp': {'type': ['string', 'null'], 'description': 'ISO-8601 block timestamp, null if pending.'}, 'value_eth': {'type': 'number', 'description': 'ETH value transferred (does not include gas fee).'}, 'block_number': {'type': ['integer', 'null'], 'description': 'Block number, null if pending.'}, 'erc20_transfer': {'type': ['object', 'null'], 'properties': {'to': {'type': 'string', 'description': 'Token recipient.'}, 'amount_raw': {'type': 'string', 'description': 'Raw token amount (before applying decimals).'}, 'token_contract': {'type': 'string', 'description': 'Token contract address.'}}, 'description': 'ERC-20 token transfer details, null if not a token transfer.'}, 'gas_price_gwei': {'type': ['number', 'null'], 'description': 'Gas price in Gwei.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chain': {'enum': ['base', 'ethereum', 'eth', 'arbitrum', 'optimism', 'polygon', 'matic', 'avalanche', 'bsc'], 'type': 'string', 'description': 'EVM chain. Default: base.'}, 'tx_hash': {'type': 'string', 'description': 'Transaction hash (0x-prefixed, 66 chars).'}, 'include_block_context': {'type': 'boolean', 'description': 'Include block-level context (base_fee, tx_count, miner). Collapses the onesource/chain/block seam agents use after tx-explainer. Default: true.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'to': {'type': ['string', 'null']}, 'from': {'type': 'string'}, 'type': {'type': 'string'}, 'chain': {'type': 'string'}, 'status': {'enum': ['success', 'failed', 'pending'], 'type': 'string'}, 'summary': {'type': 'string', 'description': 'Human-readable one-line explanation.'}, 'tx_hash': {'type': 'string'}, 'gas_used': {'type': 'integer'}, 'transfers': {'type': 'array', 'items': {'type': 'object', 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'amount': {'type': 'string'}, 'symbol': {'type': 'string'}, 'contract': {'type': 'string'}}}, 'description': 'ERC20 Transfer events decoded from logs.'}, 'value_eth': {'type': 'string'}, 'tx_fee_eth': {'type': 'string'}, 'block_number': {'type': 'integer'}, 'explorer_url': {'type': 'string'}, 'block_context': {'type': ['object', 'null'], 'properties': {'miner': {'type': 'string'}, 'gas_used': {'type': 'integer'}, 'tx_count': {'type': 'integer'}, 'gas_limit': {'type': 'integer'}, 'block_number': {'type': 'integer'}, 'base_fee_gwei': {'type': ['number', 'null']}, 'timestamp_iso': {'type': 'string'}}, 'description': 'Block-level context (only if include_block_context=true).'}, 'gas_price_gwei': {'type': 'number'}, 'block_timestamp_iso': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'description': 'Target unit. If omitted, returns all units in the same category.'}, 'from': {'type': 'string', 'description': "Source unit (e.g. 'kg', 'mi', 'f', 'kwh', 'mph', 'gb', 'psi'). Case-insensitive."}, 'value': {'type': 'number', 'description': 'Numeric value to convert.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'to': {'type': 'string'}, 'from': {'type': 'string'}, 'value': {'type': 'number'}, 'result': {'type': 'number', 'description': "Converted value (when 'to' is specified)."}, 'category': {'type': 'string'}, 'all_units': {'type': 'object', 'description': 'All units in the same category with converted values.'}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'number', 'description': 'Maximum number of events to return (1â\x80\x93100). Default 20.'}, 'latitude': {'type': 'number', 'description': 'Center latitude for radius search (decimal degrees). Requires longitude and radius_km.'}, 'days_back': {'type': 'number', 'description': 'How many days of events to fetch (1â\x80\x9330). Default 7.'}, 'longitude': {'type': 'number', 'description': 'Center longitude for radius search (decimal degrees). Requires latitude and radius_km.'}, 'radius_km': {'type': 'number', 'description': 'Search radius in km around lat/lon. Max 20001. Default 500 when lat/lon provided.'}, 'min_magnitude': {'type': 'number', 'description': 'Minimum Richter magnitude to include. Default 4.5.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'count': {'type': 'integer', 'description': 'Number of events returned.'}, 'events': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'USGS event ID.'}, 'sig': {'type': 'integer', 'description': 'USGS significance score (0â\x80\x931000). Higher = more impactful.'}, 'url': {'type': 'string', 'description': 'USGS event detail page URL.'}, 'felt': {'type': 'integer', 'description': "Number of 'Did You Feel It?' responses (null if none)."}, 'time': {'type': 'string', 'description': 'ISO-8601 UTC event time.'}, 'alert': {'type': 'string', 'description': 'PAGER alert level: green/yellow/orange/red (null if not assessed).'}, 'place': {'type': 'string', 'description': 'Human-readable location description.'}, 'tsunami': {'type': 'integer', 'description': 'Tsunami warning flag: 1 = warning issued, 0 = none.'}, 'depth_km': {'type': 'number', 'description': 'Hypocenter depth in km.'}, 'latitude': {'type': 'number', 'description': 'Epicenter latitude.'}, 'mag_type': {'type': 'string', 'description': 'Magnitude type (mww, ml, mb, etc.).'}, 'longitude': {'type': 'number', 'description': 'Epicenter longitude.'}, 'magnitude': {'type': 'number', 'description': 'Magnitude (Richter scale).'}}}}, 'window_days': {'type': 'number', 'description': 'Time window searched (days back from now).'}, 'min_magnitude': {'type': 'number', 'description': 'Minimum magnitude filter applied.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'integer', 'description': 'Window end as Unix seconds. Default: now.'}, 'from': {'type': 'integer', 'description': 'Window start as Unix seconds. Default: 90 days ago.'}, 'ticker': {'type': 'string', 'description': 'US ticker symbol (e.g. AAPL, SPY, QQQ, ^VIX, BRK-B). Case-insensitive.'}, 'resolution': {'enum': ['1', '5', '15', '60', '240', 'D', 'W', 'M'], 'type': 'string', 'description': 'Bar resolution: 1/5/15/60/240 = minutes, D = daily, W = weekly, M = monthly. Default: D.'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'to': {'type': 'integer', 'description': 'Window end (Unix seconds).'}, 'bars': {'type': 'array', 'items': {'type': 'object', 'required': [], 'properties': {'c': {'type': 'number', 'description': 'Close price.'}, 'h': {'type': 'number', 'description': 'High price.'}, 'l': {'type': 'number', 'description': 'Low price.'}, 'o': {'type': 'number', 'description': 'Open price.'}, 't': {'type': 'integer', 'description': 'Bar open time (Unix seconds).'}, 'v': {'type': 'number', 'description': 'Volume (shares).'}}}, 'description': 'OHLCV bars sorted ascending by time.'}, 'from': {'type': 'integer', 'description': 'Window start (Unix seconds).'}, 'count': {'type': 'integer', 'description': 'Number of bars returned.'}, 'source': {'type': 'string', 'description': 'Data source identifier.'}, 'symbol': {'type': 'string', 'description': 'Normalized ticker as returned by the exchange.'}, 'resolution': {'type': 'string', 'description': 'Bar resolution requested.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 90, 'minimum': 1, 'description': 'For mode=recent: calendar days back to search (default 14, max 90).'}, 'mode': {'enum': ['company', 'recent'], 'type': 'string', 'description': "'company' (default when company_name given): Form D filings for that company with full detail. 'recent': market-wide Form D feed in last N days."}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max results to return (default 20, max 50).'}, 'filed_after': {'type': 'string', 'description': 'Optional incremental cursor. Return only filings after this YYYY-MM-DD date; reuse next_filed_after on the next poll.'}, 'company_name': {'type': 'string', 'description': 'Company or fund name to search (partial match OK, quoted exact phrase). Used in company mode.'}, 'min_amount_millions': {'type': 'number', 'minimum': 0, 'description': 'For mode=recent: filter to raises with total_amount_sold >= this many USD millions (e.g., 5 = $5M+ raises only). Default 0 = no filter.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'note': {'type': 'string'}, 'source': {'type': 'string'}, 'filings': {'type': 'array'}, 'returned': {'type': 'integer'}, 'days_searched': {'type': 'integer'}, 'total_filings': {'type': 'integer'}, 'next_filed_after': {'type': ['string', 'null']}, 'next_poll_after_utc': {'type': 'string'}, 'total_form_d_in_edgar': {'type': 'integer'}, 'min_amount_filter_millions': {'type': ['number', 'null']}, 'recommended_poll_interval_hours': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'Publicly accessible URL of the image to analyze. Must return image/jpeg, image/png, image/gif, or image/webp content-type. Max file size: 20MB.'}, 'mode': {'enum': ['describe', 'ocr', 'chart', 'ui', 'identify', 'qa'], 'type': 'string', 'description': "Analysis mode: describe (full scene description), ocr (text extraction), chart (data/chart analysis), ui (UI screenshot analysis), identify (object/subject identification), qa (answer a specific question about the image â\x80\x94 requires the 'question' parameter)."}, 'detail': {'enum': ['low', 'high', 'auto'], 'type': 'string', 'description': "OpenAI vision detail level. 'auto' (default): model decides based on image size. 'low': faster, cheaper, less detail (best for simple images). 'high': slower, more detail (best for charts, dense text, complex scenes)."}, 'question': {'type': 'string', 'description': "For mode=qa only: the specific question to answer about the image. E.g., 'What is the total revenue shown in Q3?' or 'What does the error message say?'"}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'The image URL that was analyzed.'}, 'mode': {'type': 'string', 'description': 'The analysis mode that was applied.'}, 'model': {'type': 'string', 'description': 'OpenAI model used for analysis.'}, 'tokens': {'type': 'object', 'properties': {'total': {'type': ['integer', 'null']}, 'prompt': {'type': ['integer', 'null']}, 'completion': {'type': ['integer', 'null']}}}, 'analysis': {'type': 'string', 'description': 'AI-generated analysis of the image based on the selected mode.'}, 'finish_reason': {'type': 'string', 'description': 'OpenAI finish reason (stop, length, content_filter).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'history_days': {'type': 'integer', 'maximum': 252, 'minimum': 20, 'description': 'Trading days of VIX history to use for percentile rank. Default 252 (1 year).'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['vix', 'term_structure', 'vol_regime', 'composite_signal', 'as_of'], 'properties': {'vix': {'type': 'number', 'description': 'Current VIX (30-day implied vol).'}, 'note': {'type': 'string', 'description': 'Context note when data is unavailable or degraded.'}, 'skew': {'type': 'number', 'description': 'Current CBOE SKEW index.'}, 'vvix': {'type': 'number', 'description': 'Current VVIX (vol-of-vol).'}, 'vxmt': {'type': 'number', 'description': 'Current VXMT (93-day implied vol).'}, 'as_of': {'type': 'string', 'description': 'Date of the most recent data point.'}, 'vol_regime': {'type': 'string', 'description': 'CALM (<15) | MODERATE (15-20) | ELEVATED (20-30) | CRISIS (â\x89¥30).'}, 'skew_signal': {'type': 'string', 'description': 'HIGH_TAIL_DEMAND (>145) | MODERATE (130-145) | LOW (<130). Measures tail-risk put demand.'}, 'vvix_signal': {'type': 'string', 'description': 'UNCERTAINTY (>110) | ELEVATED (90-110) | CALM (<90). High VVIX = hedging demand surging.'}, 'term_structure': {'type': 'string', 'description': 'CONTANGO | FLAT | BACKWARDATION (VIX vs VXMT).'}, 'composite_signal': {'type': 'string', 'description': 'RISK_OFF | CAUTION | NEUTRAL | COMPLACENCY. Synthesizes all 4 signals.'}, 'vix_percentile_1yr': {'type': 'number', 'description': 'VIX percentile vs trailing 252-day history (0â\x80\x93100). Higher = more stress than usual.'}, 'spread_vxmt_minus_vix': {'type': 'number', 'description': 'VXMT minus VIX in raw vol points. Positive = contango.'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'cve_id': {'type': 'string', 'description': "CVE identifier (e.g. 'CVE-2024-12345'). Use this OR package+ecosystem â\x80\x94 not both."}, 'package': {'type': 'string', 'description': "OSS package name to query for known vulns (e.g. 'requests', 'lodash', 'log4j'). Requires ecosystem."}, 'ecosystem': {'type': 'string', 'description': 'Package ecosystem: PyPI, npm, Maven, Go, crates.io, NuGet, RubyGems, Packagist, Hex, Pub. Required with package.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'mode': {'enum': ['cve', 'package'], 'type': 'string'}, 'as_of': {'type': 'string'}, 'result': {'type': 'object'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'erp': {'type': 'number', 'description': 'Equity risk premium assumption in % (default 5.5 â\x80\x94 Damodaran mature market estimate). Override for emerging markets or sector adjustments.'}, 'ticker': {'type': 'string', 'description': 'US stock ticker symbol (e.g. AAPL, NVDA, MSFT). Case-insensitive.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Company name.'}, 'notes': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Fallback assumptions applied (e.g. beta defaulted to 1.0, tax rate defaulted to 21%).'}, 'inputs': {'type': 'object', 'properties': {'beta': {'type': 'number', 'description': '5-year monthly beta vs S&P 500.'}, 'risk_free_rate_pct': {'type': 'number', 'description': '10Y Treasury yield used as risk-free rate (%).'}, 'effective_tax_rate_pct': {'type': 'number', 'description': 'Effective tax rate used (%).'}, 'equity_risk_premium_pct': {'type': 'number', 'description': 'ERP assumption used (%).'}, 'pretax_cost_of_debt_pct': {'type': 'number', 'description': 'Pre-tax interest rate on debt (%).'}}}, 'ticker': {'type': 'string', 'description': 'Canonical ticker symbol.'}, 'wacc_pct': {'type': 'number', 'description': 'WACC as a percentage (e.g. 8.43 = 8.43%). Use as discount rate in DCF model.'}, 'retrieved_at': {'type': 'string', 'description': 'ISO-8601 timestamp of data retrieval.'}, 'cost_of_debt_pct': {'type': 'number', 'description': 'After-tax cost of debt in %: (interest_expense / total_debt) Ã\x97 (1 - effective_tax_rate).'}, 'capital_structure': {'type': 'object', 'properties': {'market_cap_usd': {'type': 'number', 'description': 'Market capitalization in USD.'}, 'total_debt_usd': {'type': 'number', 'description': 'Total debt in USD.'}, 'debt_weight_pct': {'type': 'number', 'description': 'Debt as % of total capital (D/V).'}, 'equity_weight_pct': {'type': 'number', 'description': 'Equity as % of total capital (E/V).'}}}, 'cost_of_equity_pct': {'type': 'number', 'description': 'CAPM cost of equity in %: risk_free_rate + beta Ã\x97 ERP.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'address': {'type': 'string', 'description': 'EVM wallet address (0x-prefixed, 42 characters).'}, 'network': {'enum': ['ethereum', 'base', 'polygon', 'arbitrum', 'optimism', 'bsc'], 'type': 'string', 'description': 'Chain to query. Default: ethereum.'}, 'with_usd': {'type': 'boolean', 'description': 'If true, fetches live USD price and returns USD value. Default: false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp.'}, 'address': {'type': 'string', 'description': 'Address queried.'}, 'balance': {'type': 'number', 'description': 'Balance in native token units (up to 18 decimal places).'}, 'network': {'type': 'string', 'description': 'Chain queried.'}, 'price_usd': {'type': ['number', 'null'], 'description': 'Native token USD price used for conversion, or null.'}, 'balance_usd': {'type': ['number', 'null'], 'description': 'USD value at current price, or null if with_usd was false or price unavailable.'}, 'balance_wei': {'type': 'string', 'description': 'Raw balance in smallest unit (wei/gwei-equivalent).'}, 'block_number': {'type': 'integer', 'description': 'Block number at which balance was read.'}, 'native_token': {'type': 'string', 'description': 'Symbol of the native token (ETH, POL, BNB).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'address': {'type': 'string', 'description': 'EVM wallet address (0xâ\x80¦, 40 hex chars). Checksummed or lowercase accepted.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this assessment.'}, 'tier': {'type': 'string', 'description': 'PRIME | ESTABLISHED | ACTIVE | SPARSE | DORMANT'}, 'score': {'type': 'integer', 'description': 'Composite credit score 0â\x80\x93100.'}, 'address': {'type': 'string', 'description': 'Normalized input address.'}, 'factors': {'type': 'object', 'properties': {'pts_usdc': {'type': 'integer', 'description': 'Points from USDC holdings (max 15).'}, 'deductions': {'type': 'integer', 'description': 'Deducted points (dormant, unknown).'}, 'pts_balance': {'type': 'integer', 'description': 'Points from ETH balance (max 25).'}, 'pts_tx_count': {'type': 'integer', 'description': 'Points from tx count (max 35).'}, 'tx_count_eth': {'type': 'integer', 'description': 'Transaction count on Ethereum mainnet (nonce).'}, 'usdc_balance': {'type': 'number', 'description': 'USDC holdings across Ethereum + Base.'}, 'eth_price_usd': {'type': 'number', 'description': 'ETH/USD price used for conversion.'}, 'tx_count_base': {'type': 'integer', 'description': 'Transaction count on Base.'}, 'pts_multichain': {'type': 'integer', 'description': 'Points from multi-chain activity (max 25).'}, 'eth_balance_usd': {'type': 'number', 'description': 'ETH balance across Ethereum + Base in USD.'}, 'tx_count_polygon': {'type': 'integer', 'description': 'Transaction count on Polygon.'}}, 'description': 'Score breakdown by factor.'}, 'recommendation': {'type': 'string', 'description': 'One-sentence routing recommendation.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'address': {'type': 'string', 'description': "Wallet address to screen (EVM hex address, e.g. '0x1234...'). Does not need to be a contract â\x80\x94 any wallet address."}, 'chain_id': {'type': 'string', 'description': 'Chain ID for context (optional, numeric or chain name). If omitted, GoPlus checks cross-chain records.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'address': {'type': 'string'}, 'all_flags': {'type': 'object', 'description': 'Full flag map. true = risk detected, false = clean for that category.'}, 'risk_label': {'type': 'string', 'description': 'CLEAN | LOW | MEDIUM | HIGH | CRITICAL'}, 'risk_score': {'type': 'integer', 'description': '0 (clean) to 100 (critical). Composite of weighted flag scores.'}, 'data_source': {'type': ['string', 'null']}, 'is_contract': {'type': 'boolean', 'description': 'Whether this address is a contract (contract_address flag).'}, 'active_flags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of risk flags that are active (value=1) for this address.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': "URL to look up in the Wayback Machine. May include or omit the scheme (e.g. 'example.com', 'https://sec.gov/edgar/')."}, 'timestamp': {'type': 'string', 'description': "Target date/time for the nearest snapshot. Accepts YYYYMMDD, YYYYMMDDHHMMSS, or ISO 8601 (e.g. '20200101', '2022-06-15'). Omit for the most recent snapshot."}, 'list_snapshots': {'type': 'boolean', 'description': 'If true, also return a list of up to 10 snapshots with timestamps, HTTP status, and direct archive URLs. Useful for tracking how a site changed over time. Default: false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'url': {'type': 'string'}, 'archived': {'type': 'boolean', 'description': 'True if at least one snapshot exists for this URL.'}, 'snapshot': {'type': ['object', 'null'], 'properties': {'timestamp': {'type': 'string', 'description': 'ISO 8601 capture time.'}, 'archive_url': {'type': 'string'}, 'http_status': {'type': 'string'}, 'raw_timestamp': {'type': 'string', 'description': 'Wayback raw timestamp (YYYYMMDDHHmmss).'}}, 'description': 'Closest snapshot to the requested timestamp, or null if never archived.'}, 'snapshots': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'mime_type': {'type': 'string'}, 'timestamp': {'type': 'string'}, 'archive_url': {'type': 'string'}, 'http_status': {'type': 'string'}, 'raw_timestamp': {'type': 'string'}}}, 'description': 'List of up to 10 recent snapshots (populated when list_snapshots=true).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'latitude': {'type': 'number', 'description': 'Latitude in decimal degrees (-90 to 90). Use with longitude instead of location name.'}, 'location': {'type': 'string', 'description': "City name, region, or address (e.g. 'New York', 'London UK', 'Tokyo'). Use this OR latitude/longitude."}, 'longitude': {'type': 'number', 'description': 'Longitude in decimal degrees (-180 to 180). Use with latitude instead of location name.'}, 'forecast_days': {'type': 'integer', 'maximum': 16, 'minimum': 1, 'description': 'Number of forecast days (1â\x80\x9316). Default 7.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string'}, 'current': {'type': 'object', 'properties': {'time': {'type': 'string'}, 'condition': {'type': 'string', 'description': 'Human-readable condition from WMO code.'}, 'humidity_pct': {'type': 'number'}, 'weather_code': {'type': 'integer'}, 'temperature_c': {'type': 'number'}, 'temperature_f': {'type': 'number'}, 'wind_speed_kmh': {'type': 'number'}, 'precipitation_mm': {'type': 'number'}}}, 'forecast': {'type': 'array', 'items': {'type': 'object', 'properties': {'date': {'type': 'string'}, 'condition': {'type': 'string'}, 'max_temp_c': {'type': 'number'}, 'min_temp_c': {'type': 'number'}, 'max_wind_kmh': {'type': 'number'}, 'weather_code': {'type': 'integer'}, 'precipitation_mm': {'type': 'number'}}}, 'description': 'Daily forecast.'}, 'location': {'type': 'object', 'properties': {'name': {'type': ['string', 'null']}, 'country': {'type': ['string', 'null']}, 'latitude': {'type': 'number'}, 'timezone': {'type': ['string', 'null']}, 'elevation': {'type': ['number', 'null'], 'description': 'Elevation in meters.'}, 'longitude': {'type': 'number'}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'event': {'type': 'string', 'description': "Filter by event type (e.g. 'Tornado Warning', 'Flash Flood Watch', 'Hurricane Warning'). Partial matches not supported â\x80\x94 use exact NWS event names."}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max alerts to return (1â\x80\x93100, default 25). Sorted by severity descending.'}, 'state': {'type': 'string', 'description': "2-letter US state code to filter by (e.g. 'TX', 'FL'). Omit to get all active US alerts."}, 'severity': {'enum': ['Extreme', 'Severe', 'Moderate', 'Minor'], 'type': 'string', 'description': 'Minimum severity level to return: Extreme, Severe, Moderate, Minor. Default: no filter (all severities).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'alerts': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'area': {'type': 'string'}, 'ends': {'type': 'string', 'nullable': True}, 'sent': {'type': 'string'}, 'event': {'type': 'string'}, 'onset': {'type': 'string', 'nullable': True}, 'sender': {'type': 'string'}, 'status': {'type': 'string'}, 'expires': {'type': 'string', 'nullable': True}, 'urgency': {'type': 'string'}, 'headline': {'type': 'string', 'nullable': True}, 'response': {'type': 'string', 'nullable': True}, 'severity': {'type': 'string'}, 'certainty': {'type': 'string'}, 'description': {'type': 'string', 'nullable': True}, 'instruction': {'type': 'string', 'nullable': True}}}}, 'filters': {'type': 'object'}, 'returned': {'type': 'integer'}, 'total_active': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 30, 'minimum': 7, 'description': 'Days of weather history to analyse (default 14, max 30). ERA5 data lags ~5 days, so end date is always 5 days before today.'}, 'tickers': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 5 equity or ETF tickers (default: ["XLE","XLU","MOO"]). Use weather-sensitive names â\x80\x94 energy, utilities, agriculture, airlines.'}, 'location': {'type': 'string', 'description': 'City or region for weather history (default "Chicago"). Accepts city names like "Kansas City", "Des Moines", "Houston".'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'brief': {'type': 'string', 'description': 'AI-synthesized 3-4 sentence weather-market brief.'}, 'weather': {'type': 'object', 'description': 'Period summary: temp highs/lows, precip, wind, anomalies.'}, 'equities': {'type': 'array', 'description': 'Ticker prices and % change.'}, 'location': {'type': 'object', 'description': 'Resolved location with name and coordinates.'}, 'generated_at': {'type': 'string', 'description': 'ISO-8601 timestamp.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'vars': {'type': 'string', 'description': 'Comma-separated variable names to include. Defaults to temperature_2m_max, temperature_2m_min, temperature_2m_mean, precipitation_sum, wind_speed_10m_max, sunshine_duration. Valid options: apparent_temperature_max, apparent_temperature_mean, apparent_temperature_min, cloud_cover_mean, et0_fao_evapotranspiration, precipitation_hours, precipitation_sum, rain_sum, shortwave_radiation_sum, snowfall_sum, sunshine_duration, temperature_2m_max, temperature_2m_mean, temperature_2m_min, weather_code, wind_direction_10m_dominant, wind_gusts_10m_max, wind_speed_10m_max'}, 'units': {'enum': ['metric', 'imperial'], 'type': 'string', 'description': "Unit system. 'metric' = °C / mm / km/h (default). 'imperial' = °F / inch / mph."}, 'end_date': {'type': 'string', 'description': 'End date YYYY-MM-DD (latest: ~5 days before today). Defaults to yesterday if omitted.'}, 'location': {'type': 'string', 'description': "City name (e.g. 'Phoenix, AZ') or 'lat,lng' (e.g. '33.45,-112.07'). Defaults to 'New York, NY'."}, 'start_date': {'type': 'string', 'description': 'Start date YYYY-MM-DD (e.g. 2024-01-01). Earliest: 1940-01-01. Defaults to 30 days ago.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'daily': {'type': 'array'}, 'units': {'type': 'object'}, 'period': {'type': 'object'}, 'summary': {'type': 'object'}, 'location': {'type': 'object'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'days': {'type': 'integer', 'maximum': 30, 'minimum': 7, 'description': 'Days of weather history to analyse (default 14, max 30). ERA5 data lags ~5 days, so the period ends 5 days before today.'}, 'query': {'type': 'string', 'description': "Research topic to investigate (e.g. 'drought impact on corn yields', 'extreme heat energy demand', 'hurricane insurance market risk', 'climate adaptation agriculture'). Omit for a default climate-markets report."}, 'location': {'type': 'string', 'description': 'City or region for weather history (default "Chicago"). Accepts city names like "Kansas City", "Miami", "Phoenix", "Des Moines".'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'brief': {'type': 'string', 'description': 'AI executive synthesis connecting weather context to research.'}, 'query': {'type': 'string', 'description': 'Research topic queried.'}, 'trends': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Emerging trends.'}, 'weather': {'type': 'object', 'description': 'Weather period summary: highs, lows, precip, wind, anomalies.'}, 'location': {'type': 'object', 'description': 'Resolved location with name and coordinates.'}, 'action_items': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Recommended actions.'}, 'generated_at': {'type': 'string', 'description': 'ISO-8601 timestamp.'}, 'key_findings': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Top research findings.'}, 'weather_signal': {'type': 'string', 'description': 'positive | negative | neutral | amplifying'}, 'sources_queried': {'type': 'integer', 'description': 'Number of research sources attempted.'}, 'sources_responded': {'type': 'integer', 'description': 'Sources that returned results.'}, 'weather_research_connection': {'type': 'string', 'description': 'Specific connection between weather conditions and research topic.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'HTTPS or HTTP URL to poll. Must be a publicly accessible endpoint.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this check.'}, 'url': {'type': 'string', 'description': 'URL as passed.'}, 'etag': {'type': ['string', 'null'], 'description': 'ETag header value if returned by the server.'}, 'method_used': {'type': 'string', 'description': '"HEAD" (preferred) or "GET" (fallback when HEAD yields no change markers).'}, 'status_code': {'type': 'integer', 'description': 'HTTP status code returned by the server.'}, 'content_hash': {'type': ['string', 'null'], 'description': 'SHA-256 hex of first 32 KB of body â\x80\x94 only populated when ETag and Last-Modified are both absent.'}, 'content_type': {'type': ['string', 'null'], 'description': 'Content-Type header, if present.'}, 'last_modified': {'type': ['string', 'null'], 'description': 'Last-Modified header value if returned by the server.'}, 'content_length': {'type': ['integer', 'null'], 'description': 'Content-Length in bytes, if present.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': "URL of the company website to analyze (e.g. 'https://stripe.com')."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'og': {'type': 'object'}, 'url': {'type': 'string'}, 'logo': {'type': 'string'}, 'name': {'type': 'string'}, 'type': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}, 'emails': {'type': 'array'}, 'phones': {'type': 'array'}, 'address': {'type': 'string'}, 'founded': {'type': 'string'}, 'schema_org': {'type': 'object'}, 'description': {'type': 'string'}, 'fetch_status': {'type': 'integer'}, 'generated_at': {'type': 'string'}, 'social_links': {'type': 'object'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'url': {'type': 'string', 'description': 'URL of the webpage to extract links from (http or https).'}, 'limit': {'type': 'integer', 'description': 'Maximum links to return (default 200, max 500).'}, 'deduplicate': {'type': 'string', 'description': 'Pass "false" to allow duplicate hrefs. Default: true (each unique URL returned once).'}, 'include_anchors': {'type': 'string', 'description': 'Pass "true" to include anchor-only links (#section). Default: false.'}, 'same_domain_only': {'type': 'string', 'description': 'Pass "true" to return only links pointing to the same domain as the input URL. Default: false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp.'}, 'url': {'type': 'string', 'description': 'Input URL.'}, 'links': {'type': 'array', 'items': {'type': 'object', 'properties': {'href': {'type': 'string', 'description': 'Absolute URL.'}, 'text': {'type': 'string', 'description': 'Visible link text (stripped of HTML tags).'}, 'scheme': {'type': 'string', 'description': 'URL scheme: http or https.'}}}, 'description': 'Extracted links.'}, 'domain': {'type': 'string', 'description': 'Hostname of the input URL.'}, 'returned': {'type': 'integer', 'description': 'Links returned in this response.'}, 'final_url': {'type': 'string', 'description': 'URL after redirects.'}, 'truncated': {'type': 'boolean', 'description': 'True if page body was capped at 512 KB.'}, 'total_found': {'type': 'integer', 'description': 'Total distinct links extracted before limit.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'wallet': {'type': 'string', 'description': 'Polymarket proxy wallet address (0x, 42 hex chars). Obtain from recent Polymarket trades or on-chain Polygon activity. Example: 0x7a9dc87be2c72791fd86fad5f67be7c5dc89ba5d'}, 'activity_limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max recent trades to return (1â\x80\x9350, default 10).'}, 'include_closed': {'type': 'boolean', 'description': 'If true, include zero-value (closed/redeemable) positions. Default false.'}, 'positions_limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max open positions to return (1â\x80\x9350, default 10).'}}, 'additionalProperties': False}

{'type': 'object', 'required': [], 'properties': {'wallet': {'type': 'string'}, 'summary': {'type': 'object'}, 'whale_tier': {'enum': ['whale', 'shark', 'dolphin', 'minnow', 'unknown'], 'type': 'string'}, 'recent_trades': {'type': 'array'}, 'activity_count': {'type': 'integer'}, 'open_positions': {'type': 'array'}, 'positions_count': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'lang': {'type': 'string', 'description': "Wikipedia language edition (ISO 639-1 code, e.g. 'en', 'es', 'fr', 'de'). Default: 'en'."}, 'exact': {'type': 'boolean', 'description': "If true, treat 'query' as an exact page title for a direct lookup (faster, returns one article). If false, run a search and return the top matches."}, 'limit': {'type': 'integer', 'maximum': 8, 'minimum': 1, 'description': 'Number of articles to return when exact=false (1â\x80\x938). Default: 3.'}, 'query': {'type': 'string', 'description': "Search query or article title (e.g. 'transformer neural network', 'Warren Buffett', 'CRISPR'). Used for full-text search when exact=false."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'query': {'type': 'string'}, 'articles': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'title': {'type': 'string'}, 'pageid': {'type': 'integer'}, 'extract': {'type': 'string', 'description': 'First ~800 chars of the article extract.'}, 'thumbnail': {'type': 'string'}, 'description': {'type': 'string'}, 'display_title': {'type': 'string'}, 'last_modified': {'type': 'string'}}}}, 'generated_at': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'years': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of most-recent years to return (1â\x80\x9310). Default: 5.'}, 'country': {'type': 'string', 'description': "ISO 2-letter country code(s), semicolon-separated for multiple (e.g. 'US', 'US;CN;DE'). Use 'WLD' for world average."}, 'indicator': {'type': 'string', 'description': "Indicator alias or WB code. Aliases: gdp, gdp_growth, gdp_per_capita, population, inflation, unemployment, fdi, debt_gdp, exports_gdp, imports_gdp, co2_per_capita, internet_users, life_expectancy, gini, literacy, ease_of_biz, current_account, market_cap_gdp, forex_reserves. Or any WB indicator code like 'NY.GDP.MKTP.CD'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'note': {'type': 'string'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'trend': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Year-value pairs, most-recent first.'}, 'latest_year': {'type': 'string'}, 'country_code': {'type': 'string'}, 'country_name': {'type': 'string'}, 'latest_value': {}, 'yoy_change_pct': {'type': 'number', 'description': '% change from previous year (null if only 1 data point).'}, 'latest_formatted': {'type': 'string'}}}, 'description': 'One entry per country, with yearly values.'}, 'generated_at': {'type': 'string'}, 'indicator_code': {'type': 'string'}, 'indicator_name': {'type': 'string'}, 'indicator_unit': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'target': {'type': 'string', 'description': 'Resource URL (https://â\x80¦) or operator wallet address (0xâ\x80¦40 hex chars). Type is auto-detected.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'name': {'type': 'string', 'description': 'Endpoint name from x402 bazaar catalog (if indexed).'}, 'target': {'type': 'string', 'description': 'Input target as provided.'}, 'category': {'type': 'string', 'description': 'Endpoint category from bazaar catalog (if indexed).'}, 'endpoints': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Endpoint list for wallet queries (up to 20).'}, 'last_seen': {'type': 'string', 'description': 'ISO-8601 timestamp of most recent settlement.'}, 'first_seen': {'type': 'string', 'description': 'ISO-8601 timestamp of first observed settlement.'}, 'active_days': {'type': 'integer', 'description': 'Number of distinct calendar days with at least one settlement.'}, 'description': {'type': 'string', 'description': 'Endpoint description from x402 bazaar catalog (if indexed).'}, 'price_range': {'type': 'object', 'properties': {'max': {'type': 'number'}, 'min': {'type': 'number'}}, 'description': 'Min and max observed price.'}, 'settlements': {'type': 'integer', 'description': 'Total settled calls observed in archive.'}, 'target_type': {'type': 'string', 'description': 'url | wallet'}, 'avg_price_usd': {'type': 'number', 'description': 'Average amount paid per call in USD.'}, 'unique_payers': {'type': 'integer', 'description': 'Distinct wallets that paid this endpoint/operator.'}, 'archive_window': {'type': 'object', 'properties': {'latest': {'type': 'string'}, 'earliest': {'type': 'string'}, 'total_settlements': {'type': 'integer'}}, 'description': 'Coverage window of the archive this response was drawn from.'}, 'reputation_tier': {'type': 'string', 'description': 'HIGH_VOLUME (â\x89¥10K) | ESTABLISHED (â\x89¥1K) | ACTIVE (â\x89¥100) | EMERGING (â\x89¥10) | LISTED (â\x89¥1) | UNKNOWN (0)'}, 'unique_resources': {'type': 'integer', 'description': 'Number of distinct endpoints operated by this wallet (wallet queries only).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'chain': {'type': 'string', 'description': "Filter by blockchain (e.g. 'Ethereum', 'Base', 'Polygon', 'Arbitrum', 'Solana'). Case-insensitive. Omit for all chains."}, 'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Number of pools to return (1â\x80\x9350, default 20).'}, 'min_apy': {'type': 'number', 'minimum': 0, 'description': 'Minimum APY percentage to include (based on 30-day mean). Default 0. E.g. 5 returns pools yielding â\x89¥5% annualized.'}, 'sort_by': {'enum': ['apy_30d', 'apy_current', 'tvl'], 'type': 'string', 'description': "Sort order: 'apy_30d' (30-day average APY, default and most stable), 'apy_current' (live APY, more volatile), 'tvl' (largest pools first)."}, 'protocol': {'type': 'string', 'description': "Filter by protocol name (e.g. 'aave-v3', 'uniswap-v3', 'curve', 'lido'). Case-insensitive substring match."}, 'min_tvl_usd': {'type': 'number', 'minimum': 0, 'description': 'Minimum Total Value Locked in USD. Default 1000000 ($1M). Lower values include smaller pools with potentially higher (but riskier) yields.'}, 'stablecoin_only': {'type': 'boolean', 'description': 'If true, returns only stablecoin pools (no impermanent loss from token price volatility). Default false.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'pools': {'type': 'array', 'items': {'type': 'object', 'properties': {'rank': {'type': 'integer', 'description': 'Position in sorted result set (1-based).'}, 'chain': {'type': 'string', 'description': "Blockchain (e.g. 'Ethereum')."}, 'symbol': {'type': 'string', 'description': 'LP or single-asset token symbol.'}, 'il_risk': {'type': 'string', 'description': "Impermanent loss risk: 'no', 'low', 'medium', 'high', 'very high'."}, 'tvl_usd': {'type': 'number', 'description': 'Total Value Locked in USD.'}, 'apy_base': {'type': 'number', 'description': 'Base (non-reward) APY component (%).'}, 'exposure': {'type': 'string', 'description': "'single' (no IL risk) or 'multi' (exposed to IL)."}, 'protocol': {'type': 'string', 'description': "Protocol name (e.g. 'aave-v3')."}, 'pool_meta': {'type': 'string', 'description': 'Extra pool context (e.g. fee tier, lock duration). May be null.'}, 'apy_reward': {'type': 'number', 'description': 'Reward token APY component (%).'}, 'stablecoin': {'type': 'boolean', 'description': 'True if this is a stablecoin-only pool.'}, 'apy_current': {'type': 'number', 'description': 'Current APY (%).'}, 'apy_30d_mean': {'type': 'number', 'description': '30-day mean APY (%) â\x80\x94 more reliable signal than spot.'}}}}, 'generated_at': {'type': 'string', 'description': 'ISO-8601 timestamp of this response.'}, 'total_matching': {'type': 'integer', 'description': 'Pools matching filters before limit.'}, 'total_returned': {'type': 'integer'}, 'filters_applied': {'type': 'object'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Number of recent videos to analyze (1â\x80\x9350, default 20).'}, 'channel': {'type': 'string', 'description': 'Channel @handle (e.g. @MrBeast), full channel URL, or UC... channel ID.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'analytics': {'type': 'object', 'properties': {'view_trend': {'type': 'string', 'description': 'ACCELERATING | STABLE | DECLINING | INSUFFICIENT_DATA'}, 'recent_flop': {'type': 'object', 'properties': {'url': {'type': ['string', 'null']}, 'title': {'type': ['string', 'null']}, 'video_id': {'type': ['string', 'null']}, 'view_count': {'type': ['integer', 'null']}}, 'description': 'Lowest-view video in the analyzed set.'}, 'median_views': {'type': ['integer', 'null'], 'description': 'Median views across recent videos.'}, 'top_performer': {'type': 'object', 'properties': {'url': {'type': ['string', 'null']}, 'title': {'type': ['string', 'null']}, 'video_id': {'type': ['string', 'null']}, 'view_count': {'type': ['integer', 'null']}}, 'description': 'Highest-view video in the analyzed set.'}, 'channel_momentum': {'type': 'string', 'description': 'GROWING | STEADY | DECLINING | UNKNOWN'}, 'upload_cadence_days': {'type': ['number', 'null'], 'description': 'Median days between uploads (null if dates unavailable).'}}}, 'channel_url': {'type': 'string'}, 'recent_videos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': ['string', 'null']}, 'title': {'type': ['string', 'null']}, 'video_id': {'type': ['string', 'null']}, 'duration_s': {'type': ['integer', 'null']}, 'view_count': {'type': ['integer', 'null']}, 'upload_date': {'type': ['string', 'null'], 'description': 'YYYY-MM-DD'}}}, 'description': 'Most recent uploads, newest first.'}, 'videos_analyzed': {'type': 'integer'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel'], 'properties': {'channel': {'type': 'string', 'description': 'YouTube channel identifier: @handle (e.g. @mkbhd), full channel URL, or UC channel ID (UCxxxxxxxx).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Channel tags (max 20).'}, 'handle': {'type': ['string', 'null'], 'description': 'Channel @handle (without URL prefix).'}, 'source': {'enum': ['yt-dlp'], 'type': 'string', 'description': 'Data source.'}, 'thumbnail': {'type': ['string', 'null'], 'description': 'Highest-resolution channel thumbnail URL.'}, 'channel_id': {'type': ['string', 'null'], 'description': 'YouTube channel ID (UCxxxxxxxx).'}, 'handle_url': {'type': ['string', 'null'], 'description': '@handle URL (youtube.com/@...).'}, 'channel_url': {'type': ['string', 'null'], 'description': 'Canonical channel URL.'}, 'description': {'type': ['string', 'null'], 'description': 'Channel description (max 1000 chars).'}, 'channel_name': {'type': ['string', 'null'], 'description': 'Channel display name.'}, 'subscriber_count': {'type': ['integer', 'null'], 'description': 'Subscriber count (null if hidden).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'video': {'type': 'string', 'description': 'YouTube video URL (any format: watch?v=, youtu.be, /shorts/) or bare 11-character video ID.'}, 'max_comments': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum number of top comments to return (default 20, max 50).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'url': {'type': 'string', 'description': 'Canonical YouTube watch URL.'}, 'comments': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Comment ID.'}, 'text': {'type': 'string', 'description': 'Comment text.'}, 'likes': {'type': 'integer', 'description': 'Like count on the comment.'}, 'author': {'type': 'string', 'description': 'Display name of the commenter.'}, 'is_pinned': {'type': 'boolean', 'description': 'Whether the comment is pinned by the channel.'}, 'timestamp': {'type': 'integer', 'description': 'Unix timestamp of the comment.'}, 'is_favorited': {'type': 'boolean', 'description': 'Whether the comment is hearted by the creator.'}, 'timestamp_text': {'type': 'string', 'description': "Human-readable relative time (e.g. '2 years ago')."}}}, 'description': 'Top comments sorted by like count descending.'}, 'video_id': {'type': 'string', 'description': '11-character YouTube video ID.'}, 'comment_count': {'type': 'integer', 'description': 'Number of comments returned.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'video': {'type': 'string', 'description': 'YouTube video URL (any format: watch?v=, youtu.be, /shorts/, /embed/) or bare 11-character video ID.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'url': {'type': 'string', 'description': 'Canonical YouTube watch URL.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Video tags (max 20).'}, 'title': {'type': ['string', 'null'], 'description': 'Video title.'}, 'author': {'type': ['string', 'null'], 'description': 'Channel/uploader display name.'}, 'source': {'enum': ['yt-dlp', 'oembed'], 'type': 'string', 'description': 'Data source used.'}, 'heatmap': {'type': 'array', 'items': {'type': 'object', 'properties': {'end_time': {'type': 'number', 'description': 'Segment end in seconds.'}, 'intensity': {'type': 'number', 'description': 'Replay intensity (1.0 = peak).'}, 'start_time': {'type': 'number', 'description': 'Segment start in seconds.'}}}, 'description': 'Top-20 replay-intensity segments (0.0â\x80\x931.0). Highlights most-watched moments.'}, 'is_live': {'type': 'boolean', 'description': 'True if currently a live stream.'}, 'chapters': {'type': 'array', 'items': {'type': 'object', 'properties': {'title': {'type': ['string', 'null'], 'description': 'Chapter title.'}, 'end_time_seconds': {'type': ['number', 'null'], 'description': 'Chapter end in seconds.'}, 'start_time_seconds': {'type': ['number', 'null'], 'description': 'Chapter start in seconds.'}}}, 'description': 'Structured chapters/timestamps if the video has them.'}, 'video_id': {'type': 'string', 'description': '11-character YouTube video ID.'}, 'thumbnail': {'type': ['string', 'null'], 'description': 'Best available thumbnail URL.'}, 'categories': {'type': 'array', 'items': {'type': 'string'}, 'description': 'YouTube content categories.'}, 'channel_id': {'type': ['string', 'null'], 'description': 'YouTube channel ID (UC...).'}, 'like_count': {'type': ['integer', 'null'], 'description': 'Total likes (null if hidden by channel).'}, 'view_count': {'type': ['integer', 'null'], 'description': 'Total view count.'}, 'channel_url': {'type': ['string', 'null'], 'description': 'Channel URL.'}, 'description': {'type': ['string', 'null'], 'description': 'Video description (max 2000 chars).'}, 'live_status': {'type': ['string', 'null'], 'description': 'not_live, is_live, was_live, etc.'}, 'upload_date': {'type': ['string', 'null'], 'description': 'Upload date (YYYY-MM-DD).'}, 'availability': {'type': ['string', 'null'], 'description': 'public, needs_auth, premium, etc.'}, 'comment_count': {'type': ['integer', 'null'], 'description': 'Total comments (null if disabled).'}, 'channel_handle': {'type': ['string', 'null'], 'description': 'Channel handle (@name), if set.'}, 'duration_string': {'type': ['string', 'null'], 'description': 'Duration formatted as M:SS or H:MM:SS.'}, 'duration_seconds': {'type': ['integer', 'null'], 'description': 'Duration in seconds.'}, 'related_capabilities': {'type': 'array', 'items': {'type': 'object', 'properties': {'cap': {'type': 'string', 'description': 'Capability name (use as the x402 endpoint path).'}, 'price': {'type': 'string', 'description': 'Per-call price in USDC.'}, 'description': {'type': 'string', 'description': 'What it returns.'}}}, 'description': 'Other STALL YouTube caps to deepen the analysis pipeline.'}, 'channel_follower_count': {'type': ['integer', 'null'], 'description': 'Subscriber count.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "Seed keyword or topic (e.g. 'passive income', 'python for beginners', 'meal prep 2026')."}, 'expand': {'type': 'boolean', 'description': 'Probe query+a through query+z for deeper coverage (26 extra lookups, ~2â\x80\x933 s added latency). Default false.'}, 'country': {'type': 'string', 'description': "ISO 3166-1 alpha-2 country code. Default 'us'."}, 'language': {'type': 'string', 'description': "BCP-47 language code. Default 'en'."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'expanded': {'type': 'boolean', 'description': 'Whether expand mode was used.'}, 'seed_query': {'type': 'string', 'description': 'Normalized input query.'}, 'total_count': {'type': 'number', 'description': 'Total unique suggestions collected.'}, 'all_suggestions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'All unique suggestions collected (base + expanded if requested).'}, 'top_suggestions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Up to 10 highest-ranked autocomplete suggestions.'}, 'question_variants': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Question-intent keywords (how, what, why, when, is, canâ\x80¦).'}, 'trending_variants': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Year-tagged keywords (2024, 2025, 2026) indicating recency demand.'}, 'tutorial_variants': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Tutorial/learning keywords (how to, tutorial, guide, beginnerâ\x80¦).'}, 'comparison_variants': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Comparison keywords (vs, versus, best, alternative, reviewâ\x80¦).'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "YouTube search query representing the niche or keyword (e.g. 'machine learning tutorial', 'vegan cooking', 'options trading')."}, 'results': {'type': 'integer', 'description': 'Number of top results to analyze (3â\x80\x9315, default 10). More results yield a more accurate concentration score.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'query': {'type': 'string'}, 'coverage': {'type': 'object', 'properties': {'total_results': {'type': 'integer'}, 'views_fraction': {'type': 'number'}, 'view_stats_scope': {'type': 'string'}, 'measured_view_results': {'type': 'integer'}, 'attributed_channel_results': {'type': 'integer'}}}, 'top_videos': {'type': 'array', 'items': {'type': 'object', 'properties': {'rank': {'type': 'integer'}, 'title': {'type': ['string', 'null']}, 'channel': {'type': ['string', 'null']}, 'video_url': {'type': ['string', 'null']}, 'view_count': {'type': ['integer', 'null']}, 'duration_minutes': {'type': ['number', 'null']}}}}, 'view_stats': {'type': 'object', 'properties': {'mean_views': {'type': ['integer', 'null']}, 'median_views': {'type': ['number', 'null']}, 'top_video_views': {'type': ['integer', 'null']}, 'view_range_label': {'type': 'string', 'description': 'MEGA (>1M median) | HIGH (>100k) | MEDIUM (>10k) | LOW (>1k) | MINIMAL | UNKNOWN (no measured views)'}, 'bottom_video_views': {'type': ['integer', 'null']}}}, 'data_quality': {'enum': ['COMPLETE', 'PARTIAL', 'NO_VIEWS', 'ZERO_VIEWS', 'CHANNELS_MISSING'], 'type': 'string'}, 'retrieved_at': {'type': 'string'}, 'results_analyzed': {'type': 'integer'}, 'distinct_channels': {'type': 'integer'}, 'dominant_channels': {'type': 'array', 'items': {'type': 'object', 'properties': {'channel': {'type': 'string'}, 'channel_id': {'type': ['string', 'null']}, 'total_views': {'type': ['integer', 'null']}, 'videos_in_top': {'type': 'integer'}, 'view_share_pct': {'type': ['number', 'null']}}}}, 'opportunity_grade': {'type': 'string', 'description': 'A (wide open) / B / C / D / F (highly saturated) / UNKNOWN (insufficient measurements).'}, 'saturation_signal': {'type': 'string', 'description': 'SATURATED (hard to enter) | MODERATE | OPEN (low competition) | UNKNOWN (insufficient measurements).'}, 'avg_duration_minutes': {'type': ['number', 'null']}, 'channel_concentration': {'type': ['number', 'null'], 'description': 'Null when views/channel attribution are incomplete or total views are zero. HHI-style score (0 = fragmented, 1 = monopoly). <0.25 = open, 0.25â\x80\x930.5 = moderate, >0.5 = concentrated.'}, 'opportunity_rationale': {'type': 'string'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['playlist_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Max videos to return (1â\x80\x9350, default 25).'}, 'playlist_id': {'type': 'string', 'description': "YouTube playlist ID (e.g. 'PLrAXtmErZgOeiKm4sgNOknc9TTnufFTL') or full playlist URL."}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'count': {'type': 'integer', 'description': 'Number of videos returned.'}, 'videos': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': ['string', 'null'], 'description': 'Canonical YouTube watch URL.'}, 'title': {'type': ['string', 'null'], 'description': 'Video title.'}, 'channel': {'type': ['string', 'null'], 'description': 'Channel display name.'}, 'video_id': {'type': ['string', 'null'], 'description': '11-character YouTube video ID.'}, 'thumbnail': {'type': ['string', 'null'], 'description': 'Best available thumbnail URL.'}, 'channel_id': {'type': ['string', 'null'], 'description': 'YouTube channel ID.'}, 'view_count': {'type': ['integer', 'null'], 'description': 'Total view count.'}, 'duration_string': {'type': ['string', 'null'], 'description': 'Duration formatted as M:SS or H:MM:SS.'}, 'duration_seconds': {'type': ['integer', 'null'], 'description': 'Duration in seconds.'}}}}, 'playlist_url': {'type': 'string', 'description': 'Resolved playlist URL.'}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['channel'], 'properties': {'channel': {'type': 'string', 'description': 'YouTube channel @handle (e.g. @MrBeast), full URL, or UC... channel ID.'}, 'currency': {'enum': ['USD'], 'type': 'string', 'description': 'Output currency. Only USD supported.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'source': {'enum': ['yt-dlp'], 'type': 'string'}, 'category': {'type': 'string'}, 'rpm_tier': {'enum': ['premium', 'mid', 'value'], 'type': 'string', 'description': 'premium=$5+/1k views, mid=$2-5, value=<$2.'}, 'channel_id': {'type': ['string', 'null']}, 'confidence': {'enum': ['high', 'medium', 'low'], 'type': 'string'}, 'channel_name': {'type': ['string', 'null']}, 'cpm_bracket_usd': {'type': 'object', 'properties': {'hi': {'type': 'number'}, 'lo': {'type': 'number'}}}, 'videos_analyzed': {'type': 'integer'}, 'confidence_notes': {'type': 'string'}, 'subscriber_count': {'type': ['integer', 'null'], 'description': 'Subscriber count (null if hidden).'}, 'videos_per_month': {'type': ['number', 'null']}, 'avg_views_per_video': {'type': ['integer', 'null']}, 'monthly_revenue_usd': {'type': 'object', 'properties': {'low': {'type': 'number'}, 'mid': {'type': 'number'}, 'high': {'type': 'number'}}, 'description': 'Monthly ad revenue estimate (USD). Creator receives ~45% of advertiser CPM.'}, 'monthly_views_estimate': {'type': ['integer', 'null']}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['query'], 'properties': {'query': {'type': 'string', 'description': "Search query string (e.g. 'bitcoin price 2024', 'machine learning tutorial')."}, 'max_results': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'Number of results to return (1â\x80\x9310, default 5).'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'ts': {'type': 'string', 'description': 'ISO-8601 response timestamp.'}, 'count': {'type': 'integer', 'description': 'Number of results returned.'}, 'query': {'type': 'string', 'description': 'Search query as submitted.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': ['string', 'null'], 'description': 'Canonical YouTube watch URL.'}, 'title': {'type': ['string', 'null'], 'description': 'Video title.'}, 'channel': {'type': ['string', 'null'], 'description': 'Channel display name.'}, 'video_id': {'type': ['string', 'null'], 'description': '11-character YouTube video ID.'}, 'thumbnail': {'type': ['string', 'null'], 'description': 'Best available thumbnail URL.'}, 'channel_id': {'type': ['string', 'null'], 'description': 'YouTube channel ID.'}, 'view_count': {'type': ['integer', 'null'], 'description': 'Total view count.'}, 'channel_url': {'type': ['string', 'null'], 'description': 'Channel URL.'}, 'description': {'type': ['string', 'null'], 'description': 'Video description (max 300 chars).'}, 'live_status': {'type': ['string', 'null'], 'description': 'Live status (e.g. not_live, is_live, was_live).'}, 'duration_string': {'type': ['string', 'null'], 'description': 'Duration formatted as M:SS or H:MM:SS.'}, 'duration_seconds': {'type': ['integer', 'null'], 'description': 'Duration in seconds.'}}}}}}

{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['video'], 'properties': {'video': {'type': 'string', 'description': 'YouTube video URL (youtube.com/watch?v=...), youtu.be short link, Shorts URL (/shorts/ID), or bare 11-character video ID.'}}, 'additionalProperties': False}

{'type': 'object', 'properties': {'raw': {'type': 'object', 'properties': {'like_count': {'type': ['integer', 'null']}, 'view_count': {'type': ['integer', 'null']}, 'comment_count': {'type': ['integer', 'null']}, 'duration_string': {'type': ['string', 'null']}, 'duration_seconds': {'type': ['integer', 'null']}, 'channel_subscriber_count': {'type': ['integer', 'null']}}, 'description': 'Raw counts as reported by YouTube.'}, 'url': {'type': 'string'}, 'title': {'type': ['string', 'null']}, 'channel': {'type': ['string', 'null']}, 'age_days': {'type': ['integer', 'null']}, 'video_id': {'type': 'string'}, 'analytics': {'type': 'object', 'properties': {'view_velocity': {'type': ['number', 'null'], 'description': 'Average views per day since upload.'}, 'interpretation': {'type': 'object', 'properties': {'summary': {'type': 'string'}, 'reach_signal': {'type': 'string'}, 'velocity_signal': {'type': 'string'}, 'engagement_signal': {'type': 'string'}}, 'description': 'Human-readable signal summaries.'}, 'engagement_rate': {'type': ['number', 'null'], 'description': '(likes + comments) / views. Null if views = 0.'}, 'performance_tier': {'type': 'string', 'description': 'VIRAL | HIGH_PERFORMING | AVERAGE | UNDERPERFORMING'}, 'duration_category': {'type': 'string', 'description': 'SHORT (<3 min) | STANDARD (3â\x80\x9320 min) | LONG (>20 min) | UNKNOWN'}, 'view_to_sub_ratio': {'type': ['number', 'null'], 'description': 'total_views / channel_subscribers. >1.0 = viral spread beyond subscriber base. Null if subs unavailable.'}, 'engagement_rate_pct': {'type': ['number', 'null'], 'description': 'engagement_rate as a percentage.'}}}, 'age_bucket': {'type': 'string', 'description': 'FRESH | RECENT | ESTABLISHED | MATURE | UNKNOWN'}, 'upload_date': {'type': ['string', 'null'], 'description': 'ISO date YYYY-MM-DD'}}}